ホーム>Web サイト構築リソース>ウェブサイトデータ
ダウンロード

このリポジトリの非難

このリポジトリは非推奨です。ビルドコードをOpenNMSリポジトリに移動しました。パブリッシュおよびビルドワークフローは、CI/CDワークフローの一部として統合されています。

このリポジトリをHorizo​​n 25でアーカイブし、このリポジトリを維持しなくなります。

一般的なプロジェクト情報

  • Dockerコンテナ画像リポジトリ：DockerHub
  • 問題とバグ追跡：Jira
  • ソースコード：github
  • チャット：ウェブチャット

バージョンタグ

  • bleeding 、Horizo​​n 24の毎日の出血エッジバージョンOpenJDK 11を使用
  • 24.1.0 、OpenJDK 11を使用したHorizo​​nの最後の安定したリリース

Horizo​​n Dockerファイル

このリポジトリは、Docker画像としてHorizo​​nのスナップショットを提供します。この画像は、Horizo​​n Core Monitoring ServicesとWebアプリケーションを提供します。

docker-composeを使用して、公式のPostgreSQL画像を使用してサービススタックを構築することをお勧めします。既にpostgreSQLデータベースを実行している場合は、 .opennms.envおよび.postgres.env環境ファイルでデータベース構成を提供できます。そうでなければ、ユーザーとデータベースが作成されます。

デフォルトでは、次のデータに対してローカルボリュームドライバーを使用して、Dockerホストにデフォルトで持続します。 

 # PostgreSQL database
psql.data :
  driver : local

# OpenNMS Horizon RRD files, logs and generated PDF reports
opennms.data :
  driver : local

# OpenNMS Horizon configuration files
opennms.etc :
  driver : local

OpenNMS Horizo​​n構成ファイルを手動で編集する必要があります。ET etc-overlayディレクトリを提供して、独自の構成ファイルを追加できます。起動時に、ファイルはデフォルトの構成を上書きします。 

- ./etc-overlay:/opt/opennms-etc-overlay

特定のディレクトリのDockerホストにHorizo​​n構成を開いておきたい場合は、このような構成でディレクトリをマウントできます。 

 volumes :
    - ./myHorizonConfig:/opt/opennms/etc

ディレクトリが空の場合、 /opt/opennms/share/etc-pristineからのデフォルトのプリスチン構成で初期化されます。

重要：ファイルシステムsnmp-config.xml持続groups.xml Web UIを介して変更できる構成surveillance-categories.xml注意してくださいusers.xml

要件

  • 現在の安定したバージョンのDocker
  • 現在の安定したバージョンのDocker-Compose
  • git

使用法

git clone https://github.com/opennms-forge/docker-horizon-core-web.git
cd docker-horizon-core-web
docker-compose up -d

WebアプリケーションはTCPポート8980に公開されています。パスワード管理者を使用してデフォルトのユーザー管理者でログインできます。デフォルトのパスワードをすぐに安全なパスワードに変更してください。

利用可能なすべてのコンテナオプションのヘルプを取得するには、実行するだけです。 

docker run --rm opennms/horizon-core-web

Javaオプションを設定します

パフォーマンスの調整やデバッグのためにJVMの動作を制御するためにJavaオプションを追加することができます。環境変数JAVA_OPTSはJavaコマンドに渡され、JVMオプションを拡張または上書きするために使用できます。

重要： opennms.confのdocker-entrypoint.shおよびjavaオプションでjavaバイナリコマンドをネイティブに制御することは評価されません。 JavaプロセスにはPID 1およびがあります

環境ファイルで使用： 

 env_file :
  - .java.env

cat .java.env
JAVA_OPTS=-XX:+UseParallelGC -XX:+PrintGCDetails -XX:+PrintFlagsFinal

Docker-Compose Service環境定義で使用： 

 opennms :
  container_name : opennms.core.web
  image : opennms/horizon-core-web:latest
  environment :
    - JAVA_OPTS=-XX:+UseParallelGC -XX:+PrintGCDetails -XX:+PrintFlagsFinal

Javaとコンテナヒープメモリ

プロセスのリソース使用量を制御および分離するために、カーネル機能cgroup（コントロールグループ）が使用されます。 Javaの組み合わせにより、最大のヒープサイズとコンテナのメモリ使用量を制限することに関して、いくつかの追加のことがあります。

デフォルトでは、JVM Ergonomicsは、 cgroupsを使用したメモリセットではなく、Dockerホストメモリに基づいて最大ヒープサイズを計算します。

JVMが最大ヒープサイズを正しく計算することを確認するには、2つのオプションがあります。

  1. -Xmxで正しい最大ヒープサイズを手動で設定して、上記のセクションを参照してくださいJavaオプションを設定します
  2. No -XMXオプションが設定されている場合、実験的なCGROUP認識機能を有効にして、最大ヒープサイズを自動的に計算できます
JAVA_OPTS=-XX:+UnlockExperimentalVMOptions -XX:+UseCGroupMemoryLimitForHeap

Java SE 8U131の時点で、JVMはDocker-Awareで、Docker CPU制限が透過的に制限されています。 -XX:ParallelGCThreadsまたは-XX:CICompilerCountが指定されていない場合、JVMはdocker CPU制限を数字として適用し、ベアメタルで実行するのと同じようにGCおよびJITコンパイラスレッドの数を計算します。

更新とメンテナンス

エントリポイントスクリプトは、開始動作を制御するために使用されます。 

-f: Apply overlay configuration if exist and just start OpenNMS Horizon
-h: Show help
-i: If necessary initialize database, create pristine configuration, do an upgrade and apply the overlay config but do * not * start OpenNMS Horizon
-s: Same as -i but start OpenNMS Horizon, this should be your default
-n: Initialize Newts on Cassandra and the PostgreSQL database, do * not * start OpenNMS Horizon
-c: Same as -n but start OpenNMS Horizon, this should be your default when you want to use Newts on Cassandra
-t: Just test you configuration

更新を強制する場合は、A /opt/opennms/etc/do-upgradeファイルを作成します。 -iまたは-sで始まると、 install -disコマンドが1回実行され、構成とデータベーススキーマが更新されます。

アップグレードまたは開始するすべてのオプションは、構成が有効であるかどうかを確認し、構成テストに合格します。

カスタム構成にetc-overlayを使用します

OpenNMS以外でカスタム構成ファイルを保持したい場合は、ETC-Overlayディレクトリを使用できます。このディレクトリ内のすべてのファイルは、実行中のコンテナ内の/opt/opennms/etcにコピーされます。このようなローカルディレクトリをマウントできます。 

 volumes :
  - ./etc-overlay:/opt/opennms-etc-overlay

Jetty-Overlayを使用してJetty WebInfをカスタマイズします

Jettyアプリケーションコンテナのカスタム構成ファイルを保持するだけの場合は、Jetty-Overlayディレクトリを使用できます。このディレクトリ内のすべてのファイルは、実行中のコンテナの/opt/opennms/jetty-webapps/opennms/web-infにコピーされます。このようなローカルディレクトリをマウントできます。 

 volumes :
  - ./jetty-overlay:/opt/opennms-jetty-webinf-overlay

カスタム任意の構成にオーバーレイを使用します

任意の構成ファイル/ディレクトリ構造をオーバーレイするには、OpenNMS-Overlayディレクトリを使用できます。このディレクトリの内容は、実行中のコンテナに/opt/opennms/にコピーされます。このようなローカルディレクトリをマウントできます。 

 volumes :
  - ./opennms-overlay:/opt/opennms-overlay

構成ファイルをテストします

この画像により、有効なXMLであり、起動時にロードできる場合、構成ファイルをテストできます。起動時に自動的に実行されますが、単一ショットコマンドとして実行することもできます。

config testerの使用出力を取得します。 

docker run --rm opennms/horizon-core-web:latest -t

いくつかの例この画像でconfig testerを使用する方法：

すべての構成ファイルをテストします： 

 docker run --rm opennms/horizon-core-web:latest -t -a

verbose出力を使用した特定の構成ファイルのみをテスト-v ： 

 docker run --rm opennms/horizon-core-web:latest -t -v snmp-config.xml

ETC-Overlayディレクトリを使用して構成ファイルをテストします。 

 docker run --rm -v $(pwd)/etc-overlay:/opt/opennms-etc-overlay opennms/horizon-core-web:latest -t -v snmp-config.xml

環境変数

  • POSTGRES_HOST ：postgresqlデータベースホスト、デフォルト： database
  • POSTGRES_PORT ：postgresqlデータベースにアクセスするポート、デフォルト： 5432
  • POSTGRES_USER ：postgresql admin user、default： postgres
  • POSTGRES_PASSWORD ：postgresql管理パスワード、デフォルト： postgres
  • OPENNMS_DBNAME ：opennms Horizo​​nのデータベース名、デフォルト： opennms
  • OPENNMS_DBUSER ：opennms Horizo​​nデータベースにアクセスするユーザー、デフォルト： opennms
  • OPENNMS_DBPASS ：opennms Horizo​​nデータベースユーザーのパスワード、デフォルト： opennms
  • OPENNMS_KARAF_SSH_HOST ：Karaf SSHポートのリスニングアドレス、デフォルト： 0.0.0.0
  • OPENNMS_KARAF_SSH_PORT ：KARAFのSSHポート、デフォルト： 8101

Cassandraクラスターの使用：

  • ${OPENNMS_CASSANDRA_HOSTNAMES} ：cassandraクラスターのホスト名またはIPアドレス、コンマ分離リストも受け入れます
  • ${OPENNMS_CASSANDRA_KEYSPACE} ：パフォーマンスデータを持続するためのスペースを名前、デフォルト： newts
  • ${OPENNMS_CASSANDRA_PORT} ：cassandraポート、デフォルト： 9042
  • ${OPENNMS_CASSANDRA_USERNAME} ：ユーザー名Cassandraへのアクセス
  • ${OPENNMS_CASSANDRA_PASSWORD} ：Cassandraへのパスワードアクセス

ニュートと一緒にカサンドラで走っています

デフォルトでは、 OpenNMS Horizo​​nイメージはRrdToolを使用してパフォーマンスデータストレージを使用して実行されます。ただし、 OpenNMS Horizo​​nは、 Newts時系列スキーマを使用してCassandraで実行するように構成することもできます。

構成オプションは、環境変数セクションにあります。 opennms-cassandra-helm.ymlが提供されています。これは、同じマシンに小さな単一のCassandraノードを使用してOpenNMS Horizo​​nを実行する方法を示しています。

引数を構築します

  • MIRROR_HOST ：RPMパッケージを備えたサーバー、デフォルト： yum.opennms.org
  • OPENNMS_VERSION ：opennms horizo​​n rpmファイルのバージョン、デフォルト： stable
拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて