EndecaServer.propertiesファイル

構成ファイルEndecaServer.propertiesは、必須ファイルおよびディレクトリのデフォルトの場所など、Endeca Serverのグローバル・パラメータを設定します。

EndecaServer.propertiesファイルは、ドメインのconfigディレクトリにあります。たとえば、endeca_server_domainがEndeca ServerのWebLogic Serverドメインの名前とすると、Linuxのデフォルトの場所は次のようになります。 
$MW_HOME/user_projects/domains/endeca_server_domain/config/EndecaServer.properties
Windowsのパスも同様です。構成ファイルに含まれるものは次のとおりです。 ファイルのデフォルト値は、Endeca Serverインストーラによって設定されます。
注意: これらのパラメータのほとんどは、Endeca Serverアプリケーションによって使用され、変更しないでください。変更する必要がある場合は、パラメータを変更するマシンのEndeca Serverを停止してから、Endeca Serverを再起動します。Endeca ServerがEndeca Serverクラスタとしてデプロイされている場合は、すべてのマシンのEndecaServer.propertiesに変更を加えてから、Endeca Serverインスタンスを再起動します。Endeca Serverは、すべてのインスタンスで同じであるこのファイルに依存します。

Endeca.Server.propertiesのSSL固有のパラメータ(endeca-ssl-keystoreなど)は、インストールの時点では空です。これらの値は、SSLキーおよび証明書を作成するgenerate_ssl_keysユーティリティを後で実行すると入力されます。

Endeca Serverパラメータ

EndecaServer.propertiesの次の構成設定は、Endeca Server操作に固有のものです。
Endeca Serverパラメータ 説明
endeca-require-https trueに設定すると、Endeca ServerでHTTPSポートの使用を強制するように指定します。falseに設定すると、HTTPポートが使用されます。
endeca-runtime-basedir Endeca Serverのendeca-serverディレクトリの場所。デフォルトの場所は$ENDECA_HOME/endeca-serverです。
endeca-data-dir このEndeca Serverインスタンスに対してすべてのEndecaデータ・ドメインのデータ・ファイルが格納される場所。デフォルトの場所は、$DOMAIN_HOME/EndecaServer/dataディレクトリです。ディレクトリは1つのみ指定できることに注意してください(つまり、複数のディレクトリを指定することはできません)。
endeca-offline-dir Endecaデータ・ドメインのデータファイルがendeca-cmdのexport-ddによってエクスポートされる場所。デフォルトは$DOMAIN_HOME/EndecaServer/offlineディレクトリです。ディレクトリは1つのみ指定できることに注意してください(つまり、複数のディレクトリを指定することはできません)。
endeca-logs-dir Dgraphプロセス標準の場所。 out/errログとリクエスト・ログ、およびPIDファイルです。デフォルトは$DOMAIN_HOME/EndecaServer/logsディレクトリです。ディレクトリは1つのみ指定できます(つまり、複数のディレクトリを指定することはできません)。
endeca-dgraph-install Endeca ServerのDgraphアプリケーション・ディレクトリの場所。デフォルトは$ENDECA_HOME/endeca-server/dgraphディレクトリです。
endeca-webserver-port Endeca Serverがリクエストをリスニングするポート。デフォルトは7001 (非SSLデプロイメント)または7002 (SSLデプロイメント)です。
endeca-ds-port-minおよびendeca-ds-port-max Endeca ServerがDgraphプロセスのHTTP/HTTPSポートおよびバルク・ロード・ポートを選択する際のポート番号の範囲。ポートがDgraphプロセスに一度割り当てられると、そのポートは、データ・ドメインが無効でないかぎり、後続のDgraphポート割当てに使用されません。このポート割当て計画によって、Dgraphプロセス間でのポート衝突が回避されます。

endeca-ds-port-minのデフォルトは、7011 (非SSLデプロイメント)または7012 (SSLデプロイメント)です。

endeca-ds-port-maxのデフォルトは、8011 (非SSLデプロイメント)または8012 (SSLデプロイメント)です。

endeca-ds-pin-timeout-min デフォルトの最小値は60000ミリ秒(ms)です。これは、PinDataVersionリクエストが発行されたときにDgraphプロセスが使用できる最小のタイムアウト値です。索引のバージョン固定リクエストを有効にするには、このパラメータとendeca-ds-pin-timeout-maxおよびendeca-ds-pin-timeout-defaultが使用されます。索引データのバージョン固定の詳細は、Oracle Endeca Server開発者ガイドを参照してください。
endeca-ds-pin-timeout-max デフォルトの最大値は300000 msです。これは、PinDataVersionリクエストが発行されたときにDgraphプロセスが使用できる最大のタイムアウト値です。
endeca-ds-pin-timeout-default タイムアウトのデフォルト値は120000 msです。これは、PinDataVersionリクエストで値を指定していない場合にDgraphで使用されるデフォルトのタイムアウト値です(データ・バージョンを固定するには、通常は対話Webサービスのこのリクエストを使用します)。
endeca-ds-cert-file SSL証明書ファイルのパス。証明書ファイルは、SSLを使用してOracle Endeca Serverに接続する場合にそのアイデンティティを指定するために、すべてのクライアントおよびサーバーによって使用されます。generate_ssl_keysユーティリティが実行された場合、デフォルトのパスは$DOMAIN_HOME/config/ssl/dgraphCert.pemファイルになります。ユーティリティが実行されなかった場合、この設定は空になります。
endeca-ds-ca-file 認証局ファイルのパス。このファイルは、通信チャネルの他のエンドポイントを認証するために、すべてのクライアントおよびサーバーによって使用されます。generate_ssl_keysユーティリティが実行された場合、デフォルトのパスは$DOMAIN_HOME/config/ssl/dgraphCA.pemファイルになります。ユーティリティが実行されなかった場合、この設定は空になります。
endeca-secure-mode trueに設定すると、Endeca ServerでSSLが使用され、DgraphがSSLモードで起動されるように指定します。falseに設定すると、Endeca ServerおよびDgraphはSSLを使用しません。
endeca-memory-to-index-size-ratio データ・ドメインに割り当てられる仮想メモリーの索引サイズに対する割合を指定します。デフォルトは2.0です。この設定は、ノードでデータ・ドメインを割り当てるためにEndeca Serverで使用されます。これは、Endeca Serverが新規に作成されたデータ・ドメインにメモリーを割り当てるのに十分なメモリー量がそのノード上にあるかどうかを計算する方法に影響します。たとえば、索引サイズが40MBでデフォルトの割合(2)が使用される場合、Endeca Serverはデータ・ドメインに80 MBを割り当てようと試みます。
注意: この設定は、Endeca Serverデプロイメント全体(クラスタなど)のシステム管理者のみが変更するようにし、Endeca Serverでホストされる固有のデータ・ドメインのシステム管理者は変更しないでください。この設定を変更する前に、この設定の使用方法を習得し、ご使用のデプロイメントへの適用方法を評価してください。この設定の使用方法の詳細は、Oracle Endeca Serverクラスタ・ガイドのデータ・ドメイン割当に関するトピックを参照してください。
endeca-threads-allowed-per-core 各Endeca Serverノードの単一のコアで実際に許可されるスレッドの数を指定します。デフォルトは1です。この設定は、データ・ドメインを割り当てるためにEndeca Serverで使用されます。これは、Endeca Serverが新規に作成されたデータ・ドメインに割り当てるのに十分な数の処理スレッドがそのノード上にあるかどうかを計算する方法に影響します。
注意: この設定は、Endeca Serverデプロイメント全体(クラスタなど)のシステム管理者のみが変更するようにし、Endeca Serverでホストされる固有のデータ・ドメインのシステム管理者は変更しないでください。この設定の詳細は、Oracle Endeca Serverクラスタ・ガイドのデータ・ドメイン割当に関するトピックを参照してください。
endeca-cgroups-enabled、endeca-cgroups-specified-by-percentage、endeca-cgroups-reserved-ram-mb、endeca-cgroups-reserved-swap-mb、endeca-cgroups-reserved-ram-percentage、endeca-cgroups-reserved-swap-percentage これらの設定は、Linux 6 (Red Hat Enterprise Linux 6)上のEndeca Serverデプロイメントにのみ適用されます。これらの設定は、Endeca ServerがLinux 6のcgroups機能を使用する方法を制御します。詳細は、データ・ドメインのコントロール・グループ(cgroups)の使用についてを参照してください。

クラスタ・コーディネータ・パラメータ

EndecaServer.propertiesの次の構成設定は、Endeca Serverクラスタ・コーディネータに固有のものです。
クラスタ・コーディネータ・パラメータ 説明
endeca-cluster-coordinator-dir Endecaクラスタ・コーディネータのルート・ディレクトリの場所。

デフォルトは$ENDECA_HOME/endeca-server/cluster-coordinatorディレクトリです。

endeca-cluster-coordinator-hosts デフォルトはlocalhostです(単一ノード・インストールにはこれを使用する必要があります)。

Endeca Serverクラスタ・デプロイメントでは、このパラメータには、クラスタ・コーディネータEnsembleの一部であるすべての管理対象サーバーのカンマ区切りのlocalhost名を含める必要があります。このフィールドには、常にhost1、host2、host3などのlocalhost名(トップレベル・ドメイン名とも呼ばれます)を使用します。完全修飾ドメイン名は使用しないでください。

endeca-cluster-coordinator-clientPort クラスタ・コーディネータが実行されているサーバーのポート。これは、クライアントが接続するポートです。

デフォルトは2181です。

endeca-cluster-coordinator-tickTime クラスタ・コーディネータの基本時間単位である、単一ティックの長さ。

ティックはミリ秒で測定されます。ハートビートとタイムアウトの制御に使用されます。

デフォルトは2000ミリ秒です。

endeca-cluster-coordinator-initLimit 初期同期フェーズに要するティック数。この数によって、ノードがリーダー・ノードに接続する必要のある時間の長さを指定します。

デフォルトは10ティックです。

endeca-cluster-coordinator-syncLimit あるノードが更新のためにリクエストを送信し、リーダー・ノードから確認応答を受信するまでの間に要するティック数。

デフォルトは5ティックです。

endeca-cluster-coordinator-dataDir クラスタ・コーディネータのメモリー内データベース・スナップショットと、そのデータベースに対する更新のトランザクション・ログが格納されるディレクトリの場所。

デフォルトは$DOMAIN_HOME/EndecaServer/dataディレクトリです。

endeca-cluster-coordinator-serverPort フォロワ・ノードがリーダー・ノードとの接続に使用するポート。

デフォルトのサーバー・ポートは3181です。

endeca-cluster-coordinator-leaderPort クラスタ・コーディネータ・サーバーがリーダー選択の実行に使用するポート。

デフォルトのリーダー・ポートは4181です。

endeca-cluster-coordinator-maxClientCnxns IPアドレスで識別される単一クライアントがクラスタEnsembleの単一メンバーに対して実行可能な同時接続数(ソケット・レベル)を制限します。

ファイル・ディスクリプタ不足を含む、特定のクラスのDoS攻撃を防ぐために使用されます。

これを0 (デフォルト)に設定すると、同時接続の制限が完全になくなります。

endeca-cluster-coordinator-minSessionTimeout サーバーがクライアントにネゴシエートを許可するセッション・タイムアウトの最小値(ミリ秒)を指定します。

デフォルトは4000ミリ秒です。

このパラメータは、Oracle Endecaサポートでの使用のみを対象にしています。

endeca-cluster-coordinator-maxSessionTimeout サーバーがクライアントにネゴシエートを許可するセッション・タイムアウトの最大値(ミリ秒)を指定します。

デフォルトは180000ミリ秒です。

このパラメータは、Oracle Endecaサポートでの使用のみを対象にしています。

データ・エンリッチメント・パラメータ

EndecaServer.propertiesの次の構成設定は、Endeca Serverデータ・エンリッチメント・モジュールに固有のものです。データ・エンリッチメント・モジュールはStudioによってエンリッチメントに使用されます。

データ・エンリッチメント・パラメータ 説明
endeca-data-enrichment-pluginsDir、endeca-data-enrichment-resourceDir、endeca-data-enrichment-collectionBatchSize、endeca-data-enrichment-collectionMatchRetries、 endeca-data-enrichment-taskHistorySize これらのプロパティは、データ・エンリッチメント・モジュールの構成を定義します。データ・エンリッチメント・モジュールはEndeca Serverに同梱されており、Studioで使用されます。
Studioでデータ・エンリッチメント・モジュールを使用しない場合、これらのパラメータは無視してください。Studioのコンテキストでデータ・エンリッチメント・モジュールを使用する場合、変更しなくてもこれらのパラメータのデフォルトを使用できます。これらのパラメータについて次の点に注意してください。
  • *-pluginsDirおよび*-resourcesDirディレクトリは、共有ファイル・システム上の位置を指す必要があります(これは特に、ご使用のデプロイメントが複数のEndeca Serverマシンを持つEndeca Serverクラスタでホストされている場合に当てはまります)。
  • *-collectionBatchSizeは、データをデータ・エンリッチメント・モジュールにロードするためのバッチ・サイズを定義します。ほとんどの場合デフォルト値で十分ですが、データの特性に応じて変更が必要な場合があります。この値を調整すると、パフォーマンスに影響する可能性があります。
  • *-collectionMaxRetriesは、データ・エンリッチメント・パイプラインがEndeca Server内のデータ・ドメインの索引から読取り操作を実行しているときに現在の索引バージョンを取得できない場合に実行する再試行数を定義します。デフォルトは3です。
  • *-taskHistorySizeは、パイプラインごとに保存する以前の実行(およびそれに関する情報)の数を決定します。デフォルトは10です。