コマンド・ラインの Watson Explorer Engine の管理コマンド

注: Watson™ Explorer Engine バージョン 11.0.0.3 以降で使用可能なコマンド・ライン・ツールについては、追加のコマンド・ライン・ツールを参照してください。

このセクションでは、コマンド・プロンプトから実行できるいくつかの Watson Explorer Engine の関数について説明します。このセクションで説明するコマンドには、velocity-startup、velocity-shutdown、velocity-webserver、および velocity-cmd があります。Watson Explorer Engine の組み込み Web サーバーの構成の資料の文脈で説明されている関連コマンドの velocity-config コマンドを使用すると、組み込み Web サーバーなどの Watson Explorer Engine コンポーネントおよび Watson Explorer Results Module などのモジュールに必須の情報を提供する構成変数を設定できます。

重要: Watson Explorer Engine のコマンド・ラインの管理コマンドのいずれかを使用するときに、「(ID: API_INVALID_SU_TOKEN) The current session could not be authenticated with a su-token」のようなエラーが発生するのは多くの場合、Watson Explorer Engine がインストールされているシステムからホスト名または IP アドレスを解決できなくなった api-url 構成を使用して Watson Explorer Engine インストール済み環境が初期化されたことを示しています。velocity-config コマンドで説明しているように、velocity-config コマンドを使用してこのエラー・メッセージを除去できます。

Watson Explorer Engine は、所定のシステムで Watson Explorer Engine を始動または停止するために任意のコマンド・プロンプトから使用できる 2 つのコマンドを提供します。これらのコマンドは、Watson Explorer Engine、または Watson Explorer Engine を使用するその他のアプリケーションの可用性を保証するために、システムの始動およびシャットダウンの手順に簡単に統合できるよう設計されています。これらのアプリケーションは、velocity-startup コマンドおよび velocity-shutdown コマンドであり、Watson Explorer Engine インストール・ディレクトリーの bin サブディレクトリーにあります。

注: velocity-startup コマンドは、Web サーバーがインストールされて使用可能に設定されている場合、Watson Explorer Engine の組み込み Web サーバーを常に始動します。この組み込み Web サーバーの構成および使用可能化について詳しくは、Watson Explorer Engine の組み込み Web サーバーの構成を参照してください。 velocity-webserver コマンドを使用して、組み込み Web サーバーを手動で始動、停止、および再始動することもできます。

Linux システムおよび Microsoft Windows システムでは、始動または停止しようとしている Watson Explorer Engine インストール済み環境の data/su-tokens サブディレクトリーへの書き込みアクセス権を持つ任意のユーザーとして、velocity-startup コマンドおよび velocity-shutdown コマンドを実行できます。これは通常、Watson Explorer Engine ソフトウェアのインストールに使用したユーザーです。Linux システムの root ユーザーと Microsoft Windows システムの管理者ユーザーは、このディレクトリーへの書き込みアクセス権を必ず持っている必要があります。

注: Watson Explorer Engine は、シャットダウン時に、そのシャットダウンの理由を maintenance-mode というファイルに記録します。このファイルは、/path/to/data/explorer/engine/installation の最上位ディレクトリーと bin ディレクトリーにあります。これらのファイルの存在は、Watson Explorer Engine が正常にシャットダウンされたことを示します。

以下のセクションでは、Watson Explorer Engine のコマンド・ラインの始動コマンドとシャットダウン・コマンドに関する完全な参照情報について説明します。これらのコマンドのシステムの始動プロセスへの統合については、システムの開始プロセスおよびシャットダウン・プロセスへの Watson Explorer Engine の統合を参照してください。後続のセクションでは、velocity-webserver コマンドについても説明します。このコマンドは、Watson Explorer の組み込み Web サーバーを手動で始動、停止、および始動するために使用できます。組み込み Web サーバーの構成については、Watson Explorer Engine の組み込み Web サーバーの構成を参照してください。

Watson Explorer Engine は、すべてのプロセスを正しい順序で開始および停止することができる単一コマンドを提供します。Watson Explorer Engineの始動に使用するコマンドについては、velocity-startup を参照してください。Watson Explorer Engine のシャットダウンに使用するコマンドについては、velocity-shutdown を参照してください。これらのコマンドのシステムの始動プロセスへの統合については、システムの開始プロセスおよびシャットダウン・プロセスへの Watson Explorer Engine の統合を参照してください。

ヒント: velocity-shutdown は通常、すべての実行中の Watson Explorer Engine プロセスを正常に終了するよう指示します。そのため、これらのプロセスは、進行中の処理のチェックポイントを指定できます。すべての Watson Explorer Engine プロセスを即時に終了する必要がある場合は、velocity-shutdown コマンドで --force オプションを使用できます。ただし、--force オプションを使用すると、Watson Explorer Engine の始動時にさらに長い時間が必要になる可能性があります。これは、プロセスによる進行中の処理のリカバリーと再実行依頼が必要になることがあるためです。