コマンドライン
コマンドラインからの起動・停止
Windows以外のプラットフォームでのパイプラインサービスの起動・停止、およびWindowsのコマンドプロンプトからの起動・停止を行いたい場合には、以下の実行ファイルがありますので、これらをコマンドラインから実行してください。
| UNIX | 起動 | [INSTALL_DIR]/pipeline/bin/plsvc |
| 停止 | [INSTALL_DIR]/pipeline/bin/plstop | |
| Windows | 起動 | [INSTALL_DIR]/pipeline/bin/plsvc.exe |
| 停止 | [INSTALL_DIR]/pipeline/bin/plstop.exe |
これらのコマンドを実行したOSユーザーの権限で各種リソースへのアクセスを行います。 必要に応じてこれらをOSの起動・終了スクリプトに組み込むことで、OSの起動・終了とパイプラインサービスの起動・終了を連動させることが可能です。組み込み方法の詳細は、それぞれのOSのマニュアルを参照してください。
サービスプロセスのコントロール
よりきめ細かなサービスの制御を行うために、「plctrl」というコマンドラインツールが用意されています。plctrlのオプションには以下のものがあります。
| plctrl shutdown | パイプラインサービス全体を終了させます。 plstopと同等です。 |
| plctrl shutdown killall | パイプラインサービス停止時に、停止要求を出さずに次々とプロセスを強制終了していきます。 |
| plctrl shutdown <Timeout> | パイプラインサービス停止時に、停止要求を出してから指定時間経っても終了しないサービスを強制終了します。時間内に終了できる場合は通常終了と同等です。それぞれのサービス毎にタイムアウト時間が適用されます。単位は秒です。 例） plctrl shutdown 15 |
| plctrl start <ServiceName> | 指定サービスを開始させます。 例） plctrl start FlowService |
| plctrl stop <ServiceName> | 指定サービスを停止させます。 |
| plctrl restart <ServiceName> | 指定サービスを再起動させます。 |
| plctrl kill <ServiceName> | 指定サービスを強制終了させます。 |
| plctrl status [<ServiceName>] | 指定サービス（指定がなければパイプラインサービス全体）のステータスを表示します。 |
| plctrl gc <ServiceName> | 指定サービスでガベージコレクションを実行します。 |
メモ
現在、パイプラインサービスにはPIPELINE-Serviceしかありませんので、<ServiceName>にはPIPELINE-Serviceを指定します。パイプラインサービスごと起動・停止するのとほとんどかわりませんが、パイプラインサービスのメインプロセスをクラスタソフトなどの監視対象としている場合に再起動をかけたい場合などにこの方法が有効です。
終了コード
plctrlコマンドの終了コードは以下のとおりです。（statusオプションを除く）
| 終了コード | 説明 |
|---|---|
| -1 | コマンドの送信に失敗（サーバーに接続できない場合） |
| 0 | コマンドの実行に成功 |
| 1 | コマンドの実行に失敗 |
statusオプションの終了コード
| 終了コード | 説明 |
|---|---|
| 0 | Unknown（不明） |
| 1 | StartPending（開始中） |
| 2 | Running（起動） |
| 3 | StopPending（停止中） |
| 4 | Stopped（停止） |
| 5 | Down（異常終了） |