定義ファイル・プロパティの更新と構成

定義ファイルの更新と構成の概要

定義プロパティは、DataStax Enterpriseのさまざまなリリースをサポートできるように、定義ファイルを自動的にダウンロードして更新するOpsCenter更新ツールを構成するためのものです。更新が見つかると、definition_files.tgzというリモート・ファイルがダウンロードされ、適切な定義ディレクトリーに適用されます。

定義ファイルの構成プロパティ

定義ファイル・プロパティはopscenterd.confファイルで構成します。自動更新を有効または無効にします。定義ファイルの更新をチェックする間隔を設定します。デフォルトのダウンロード・ファイル名、ディレクトリー、またはポートをオーバーライドします。

[definitions] use_ssl

定義ファイルの更新を取得するためにSSLを使用するかどうかを指定します。このオプションを使用するには、OpsCenterホストにOpenSSLが必要です。デフォルト値はTrueです。

[definitions] definitions_dir

定義ファイルを格納するファイル・システムの場所。デフォルトの場所は、パッケージ・インストールの場合は/var/lib/opscenter/definitions、tarボール・インストールの場合はinstall_location/definitionsです。

[definitions] auto_update

OpsCenterが定期的に定義ファイルを自動更新するかどうかを指定します。デフォルト値はTrueです。

[definitions] download_host

定義ファイルの更新要求の送信先のホスト。デフォルトのホストはopscenter.datastax.comです。

[definitions] download_port

定義ファイルの更新を要求するために使用するdownload_hostのポート。デフォルト・ポートは443です。

[definitions] download_filename

定義ファイルの更新が格納されているdownload_host上のtarファイルの名前。デフォルトの名前はdefinitions_files.tgzです。

[definitions] hash_filename

定義ファイルの更新が必要かどうかを確認するために使用するdownload_host上のハッシュ・ファイルの名前。デフォルト・ファイルはversion.md5です。

[definitions] sleep

定義ファイルの更新をチェックする間隔（秒）。デフォルト間隔は3,600秒（1時間）です。

更新間隔の変更

デフォルトでは、定義ファイルは1時間ごとに自動的に更新されます。デフォルトの間隔を変更するには、opscenterd.confの[definitions]セクションでsleepオプションを設定します。sleep間隔は、秒単位で指定する必要があります。たとえば、更新間隔を7200秒（2時間ごと）に設定します。

[definitions]
  sleep = 7200

定義ファイルの自動更新の無効化

自動更新プロセスを無効にするには、opscenterd.confの[definitions]セクションでauto_updateをFalseに設定します。

[definitions]
  auto_update = False

API呼び出しを使用した定義ファイルの手動更新

APIを使用して手動で更新する場合は、直接OpsCenterにAPI呼び出しを行って更新がないかどうかをチェックし、更新があればダウンロードします。自動更新が有効になっているかどうかにかかわらず、呼び出しを行うことができます。

curl -X POST http://my.opscenter.host:8888/rc/definition/update

更新が適用されると、trueが返され、更新が見つからなかった場合は、falseが返されます。

LCMの定義の更新を含むOpsCenter API呼び出しの詳細については、「定義の取得」を参照してください。

オフラインのOpsCenterインスタンスの定義ファイルの手動更新

OpsCenterマシンがインターネットに接続されていない場合は、手動で定義を更新できます。

1. 定義tarボールをダウンロードします。
   https://opscenter.datastax.com/definitions/6.1.0/definition_files.tgz

   注: URLは、現在インストールされているOpsCenterのバージョンによって異なります。上記のURLの6.1.0を現在インストールされているOpsCenterのバージョンに置き換えてください。
2. 定義ディレクトリー（definitions_dir）にファイルがある場合は、それらのファイルを削除します。

   [definitions] definitions_dir

   定義ファイルを格納するファイル・システムの場所。デフォルトの場所は、パッケージ・インストールの場合は/var/lib/opscenter/definitions、tarボール・インストールの場合はinstall_location/definitionsです。

3. 定義ファイルのtarボールを定義ディレクトリーに解凍します。
4. opscenterdを再起動します。