オンプレミスエージェントの停止
Workatoオンプレミスエージェントは、お客様のネットワークとWorkatoのオンプレミスグループダッシュボード間のアクティブなコネクションを維持します。 エージェントを再起動またはアップグレードする際に、このコネクションを一時的に無効化する必要がある場合があります。
オンプレミスエージェントプロセスは通常、SIGTERMによって停止されます。 このシグナルをエージェントに送信するには、次のいずれかの方法を使用します。
- オンプレミスエージェントに付属している
./bin/shutdown.shシャットダウンスクリプトを使用します。 - 実行中のエージェントで
kill -s TERMコマンドを実行します。
エージェントは正常なシャットダウンを自動的に実行します。 これにより、エージェントが安全に終了し、保留中のリクエストの中断を防ぎ、ジョブの失敗やデータ損失を回避できます。 デフォルトのシャットダウンタイムアウトは30秒です。
Workatoでエージェントを無効化する
新しいアクションがエージェントにルーティングされないように、エージェントを停止する前にWorkatoで無効化することをお勧めします。
Workatoでエージェントを無効化するには、次の手順を実行します。
API連携
または、Developer APIまたはEmbedded APIを使用して、エージェントのenabledステータスをfalseに更新します。
Workatoにサインインします。
ツール＞オンプレミスグループに移動し、無効化する予定のエージェントを含むオンプレミスグループを選択します。
レシピの中断を防ぐため、グループにアクティブなバックアップエージェントが存在することを確認します。 バックアップエージェントを作成する必要がある場合は、エージェントの追加を参照してください。
エージェントのバージョン列に移動し、...（省略記号）をクリックします。
Disableをクリックします。
Workatoでエージェントを無効化します。
Linux、Mac、またはDockerでエージェントを停止する
Linux、Mac、またはDockerで正常なシャットダウンを開始するには、次のコマンドを使用してシャットダウンスクリプトを実行します。
./shutdown.shスクリプトはSIGTERMを送信し、エージェントプロセスを正常に終了します。 シャットダウンが完了していない場合、エージェントは設定済みのタイムアウト後に終了します。
PIDファイルの作成
デフォルトでは、エージェントは起動時にPIDファイルを作成しません。 PIDファイルが見つからないためにエラーが発生した場合は、次のオプションを使用してエージェントを起動および停止します。
./run.sh --pid-file=/var/run/workato-agent/workato-agent.pid./shutdown.sh --pid-file=/var/run/workato-agent/workato-agent.pidオプション引数
シャットダウンスクリプトは、次のオプション引数をサポートしています。
| 引数 | 説明 |
|---|---|
| --pid-file | エージェントプロセスIDを含むPIDファイルへのパスを指定します。 デフォルトは/var/run/workato-agent/workato-agent.pidです。 |
| --pid-file-purge | シャットダウン前にPIDファイルを削除します。 |
| --kill-signal | 使用するシグナルを指定します。 デフォルトはTERMです。 |
| --help | 受け入れられるすべての引数のリストを表示します。 |
次の例は、オプション引数を指定してシャットダウンスクリプトを実行する方法を示しています。
./shutdown.sh --pid-file=/var/run/workato-agent/workato-agent.pid --pid-file-purge
./shutdown.sh --kill-signal=TERM
./shutdown.sh --helpWindowsでエージェントを停止する
設定に応じて、Windowsサービスとして、またはコマンドを使用してエージェントを停止するには、次の手順を実行します。
エージェントをWorkatoに再接続する
停止すると、エージェントはWorkatoへのコネクションを失います。 エージェントをWorkatoに再接続するには、次の手順を実行します。
API連携
または、Developer APIまたはEmbedded APIを使用して、エージェントのenabledステータスをtrueに更新します。
ホストマシンでエージェントを起動するには、次のいずれかのセクションを参照してください。
ツール > オンプレミスグループに移動し、再接続するエージェントを含むオンプレミスグループを選択します。
エージェントのバージョン列に移動し、...（省略記号）をクリックして、エージェントを有効化を選択します。
Workatoはコネクションを確立するために、オンプレミスエージェントにリクエストを送信します。 正常なコネクションリクエストにより、アクティブステータスが返されます。
Last updated: