# 新しいバージョンへのアップグレード
定期的にオンプレミスエージェントをアップグレードすることをお勧めします。各リリースでは、新機能とともにパフォーマンス、安定性、セキュリティが向上しています。すべての変更については、リリースノート (opens new window)を参照してください。
アップグレードの方法
既存のオンプレミスエージェントをアップグレードする方法はいくつかあります：
WORKATO IP ホワイトリスト
オンプレミスエージェントのバージョン2.11.0以降では、最新のWorkatoゲートウェイが使用されています。2.11.0より古いバージョンからアップグレードする場合は、新しいゲートウェイのIPアドレスをホワイトリストに登録してください。
# 既存のエージェントを置き換えてアップグレードする
既存のエージェントのアップグレードでは、既存のWorkatoオンプレミスエージェントを停止し、最新バージョンに置き換える必要があります。以下の手順に従って、オペレーティングシステムに応じて進めてください。
# Windows
- Workatoにアクセスし、オンプレミスグループページ (opens new window)に移動します。
- オンプレミスグループを開き、アップグレードしたいエージェントを見つけます。現在のエージェントのバージョンを確認し、「
<latest_agent_version>にアップデート」をクリックします。
最新バージョンのオンプレミスエージェントにアップデート
- アップグレードウィザードが開きます。リリースノートを確認し、ウィザードの手順に従います（以下にも記載されています）。
オンプレミスエージェントのアップグレードウィザード
- エージェントが停止していることを確認します（Workato AgentのWindowsサービスまたはコンソールベースのエージェントを終了します）。
- エージェントをアンインストールします（例：スタートメニュー → Workato → アンインストール）。これにより、
C:\Program Files\Workato Agent/conf内のconfig.ymlファイルと証明書ファイル（cert.key、cert.pem）は変更されません。 - ダウンロードしたインストーラを実行します（これにより、同じ場所に自動的にインストールされます）。
- エージェントを実行します。セットアップに応じて、Workato AgentのWindowsサービスを開始するか、コマンドラインからエージェントを実行します。
- エージェントがアクティブであることを確認し、オンプレミスエージェントページ (opens new window)でバージョン番号を確認します。
# Linux/MacOS
- エージェントプロセスが停止していることを確認します。実行中のエージェントが検出されると、アップグレードは失敗します。
- エージェントディレクトリに移動します（例：
cd ~/programs/workato-agent/）。/bin/ディレクトリ以下には進まないでください。 - アップグレードスクリプトを実行します：
bin/upgrade.sh。十分な権限があることを確認してください。 - アップグレードスクリプトによって提供される指示に従います。プロンプトが表示されたらアップグレードを確認します。
- アップグレードが正常に完了したら、エージェントを実行します（例：
bin/run.sh）。 - エージェントがアクティブであることを確認し、オンプレミスエージェントページ (opens new window)でバージョン番号を確認します。
- 新しいバージョンが利用可能でない場合、アップグレードプロセスはトリガされません。ただし、破損したインストールを修復する必要がある場合は、アップグレードを実行する際にコマンドラインオプションを使用します：
bin/upgrade.sh --force。
# トラブルシューティング
- Linux/MacOSユーザーの場合、ターミナルにanacondaがインストールされている場合は、
conda deactivateでconda環境を無効にするようにしてください。これにより、アップグレード時にエラーが発生します。
# ゼロダウンタイムで既存のエージェントをアップグレードする
本番環境でエージェントを実行しており、中断を避けたい場合は、別のエージェントをオンプレミスグループに追加することでアップグレードできます。
オンプレミスエージェントページ (opens new window)に移動し、アップグレードしたいオンプレミスグループを開きます。
グループに複数のエージェントがある場合は、アップグレードしたいエージェントを停止または無効にします。他のエージェントは引き続きジョブを処理します。
オンプレミスグループにエージェントが1つしかない場合は、これらの手順 (opens new window)に従って別のエージェントを追加します。
その後、新しいエージェントを起動します。新しいエージェントは一部のジョブを受け入れるようになります。新しいエージェントのログを確認して正常に動作していることを確認できます。
注意：接続の設定にconfig.ymlファイルを使用している場合は、古いエージェントから新しいエージェントにコピーしてください。これにより、
エージェントが同じリソースに接続するように設定します。
警告: パスワードの暗号化にパスワードの暗号化を使用している場合、新しいエージェントのために再度暗号化する必要があります。暗号化は特定のエージェントキーに基づいており、各エージェントごとに異なります。
古いエージェントを停止します。Windowsサービスを停止するか、Workatoでエージェントを無効にすることでこれを行うことができます。
前の手順で追加したエージェントは、古いオンプレミスエージェントに置き換えられました。新しいエージェントが正常に動作し、実行中のレシピにエラーがないことを確認した後、古いエージェントを削除またはアンインストールすることができます。問題が発生した場合は、新しいエージェントを無効にして古いエージェントを再起動します。
# 2.15.0より古い既存のエージェントをアップグレードし、接続の設定を直接Workatoで開始する
オンプレミスエージェントバージョン2.15.0では、接続の設定を行う新しい簡単な方法を導入しました。config.ymlファイルを使用する代わりに、接続を直接Workatoで設定することができます。こちらで詳細をご覧ください (opens new window)。
クラウドプロファイルを使用するには、前述のリンクで新しいオンプレミスグループを追加する必要があります。
新しいオンプレミスグループを開き、エージェントをインストール (opens new window)します。古いエージェントと同じマシンにインストールしてください。
必要な接続を直接Workatoで設定します。新しいオンプレミスエージェントを使用して正常に接続できることを確認してください。
レシピをクローンまたは編集し、新しい接続に切り替えます。レシピ内のすべての接続が更新されていることを確認してください。
古いエージェントを停止して無効にします。おめでとうございます、これでオンプレミス接続を直接Workatoで設定することができます！
アップグレードプロセスに関するヘルプが必要な場合は、Workatoのアカウント担当者に連絡してサポートを受けてください。
Last updated: 2024/2/8 16:50:56