droonga-http-server-configure
は、そのコンピュータ自身をdroonga-http-server
のノードとして設定します。
このコマンドの最も代表的な用途は、コンピュータをクリーンな状態のHTTPサーバー用ノードとしてリセットする事です。 このコマンドはコンピュータをどのように設定するかを対話的に尋ねてきます:
# droonga-http-server-configure
Do you want the configuration file "droonga-http-server.yaml" to be regenerated? (y/N): y
IP address to accept requests from clients (0.0.0.0 means "any IP address") [0.0.0.0]:
port [10041]:
hostname of this node [nodeX]:
hostnames of droonga-engine nodes (comma, vertical bar, or white-space separated) [nodeX]:
port number of the droonga-engine node [10031]:
tag of the droonga-engine node [droonga]:
default dataset [Default]:
timeout for unresponsive connections (in seconds) [3]:
path to the access log file [droonga-http-server.access.log]:
path to the system log file [droonga-http-server.system.log]:
log level for the system log (silly,debug,verbose,info,warn,error) [warn]:
maximum size of the response cache [100]:
time to live of cached responses, in seconds [60]:
enable "trust proxy" configuration (y/N):
path to the document root [/usr/local/lib/node_modules/droonga-http-server/public/groonga-admin]:
environment [production]:
プランが既に固まっているのであれば、コマンドラインオプションを使ってサイレントに実行する事もできます:
# droonga-http-server-configure \
--no-prompt \
--reset-config \
--host 0.0.0.0 \
--port 10041 \
--droonga-engine-host-names node0,node1,node2 \
--droonga-engine-port 10031 \
--tag droonga \
--system-log-level info
droonga-http-server
サービスがサービスとして正しく設定されている場合、このコマンドはインストール済みのサービスを設定するためだけに動作し、(サービスの利用においては使われない)いくつかのオプションは無視されます。
--no-prompt
--reset-config
droonga-http-server.yaml
を新しい物に置き換えます。
このオプションが指定された場合、droonga-http-server.yaml
は確認無しに上書きされます。
オプションが指定されず、既存のdroonga-http-server.yaml
が存在する場合、上書きして良いかどうかが尋ねられます。--host=HOST
0.0.0.0
(そのコンピュータに割り当てられた全てのIPアドレスとホスト名で接続を受け付ける)です。--port=PORT
10041
です。--receiver-host-name=NAME
--droonga-engine-host-names=NAME1,NAME2,...
--droonga-engine-port=PORT
10031
です。--tag=TAG
droonga
です。--default-dataset=NAME
Default
です。--default-timeout=SECONDS
3
です。--access-log-file=PATH
-
を指定した場合、ログは標準出力に出力されます。
既定値は-
です。--system-log-file=PATH
-
を指定した場合、ログは標準出力に出力されます。
既定値は-
です。--system-log-level=LEVEL
silly
/trace
、debug
、verbose
、info
、warn
、error
のうちのいずれかです。
既定値はwarn
です。--cache-size=N
/d/select
などのいくつかのエンドポイントについてのみ反映されます。
既定値は100
です。--cache-ttl-in-seconds=SECONDS
/d/select
などのいくつかのエンドポイントについてのみ反映されます。
既定値は60
です。--enable-trust-proxy
, --disable-trust-proxy
droonga-http-server
のサービスをリバースプロキシの背後で動作させる場合、この設定を有効化する必要があります。
既定値は--disable-trust-proxy
です。--document-root=PATH
(droonga-http-serverのインストール先ディレクトリ)/public/groonga-admin
です。--plugins=PLUGIN1,PLUGIN2,...
./api/rest
: search
コマンドのためのREST形式のエンドポイントを提供します。./api/groonga
: Groonga互換のエンドポイントを提供します。./api/droonga
: Droongaネイティブコマンド用の一般的なエンドポイントを提供します。既定の状態では、全てのプラグインが有効化されます。
--daemon
service droonga-http-server start
コマンドで開始されるサービスについては常にデーモンとして実行されます。--pid-file=PATH
service droonga-http-server start
コマンドで開始されるサービスについては、プロセスIDは常にプラットフォームごとの適切な位置に出力されます。--environment=ENVIRONMENT
development
production
(既定値)testing
-h
, --help
このコマンドは、npmのパッケージdroonga-http-server
の一部としてインストールされます。
# npm install -g droonga-http-server