オンプレミスのアップグレードと設定に関する問題 ​

このガイドでは、オンプレミスエージェント（OPA）をアップグレードする場合、またはその設定を再構成する場合に発生する可能性がある一般的な問題について説明します。 これらの問題は多くの場合、OPAバージョン間でのサービスの動作、設定パス、またはコネクションロジックの変更によって発生します。

アップグレード前のconfig.ymlのバックアップ ​

アップグレードを開始する前に、現在のconfig.ymlファイルのコピーを作成します。 これにより、アップグレードで設定が上書きされた場合に、認証設定とコネクション設定を復元できます。 ファイルに暗号化されたパスワードが含まれている場合は、アップグレード後に再暗号化する必要があります。 暗号化された値はエージェントの秘密鍵に紐付けられており、エージェント間で転送されません。

ファイアウォールポートの有効化 ​

OPAバージョン2.10.0以前からアップグレードする前に、sg3.workato.comおよびsg4.workato.comへのアウトバウンドTCPポート443を開きます。

アップグレードでリセットされた場合に元のサービスアカウントを復元 ​

アップグレードにより、OPAサービスが、以前に設定されたユーザーアカウントではなくローカルアカウントを使用するようにリセットされる場合があります。 この変更により、integrated security=trueを使用するSQL Serverコネクションや共有ドライブへのファイルコネクションなど、既存のコネクションが中断される可能性があります。

コネクションエラー

この問題を解決するには、Windowsサービス設定を以前に設定されたユーザーアカウントに戻します。

各エージェントに個別のキーを使用 ​

同じサーバー上の各エージェントに一意のキーファイルセットを割り当てます。 cert、key、cert.pemなどのファイルを共有すると、認証エラーが発生する可能性があります。

アップグレード後のHAエージェントの再接続 ​

高可用性（HA）構成では、アップグレードしたエージェント間で設定を再確立します。 config.ymlファイルを新規または復元した各エージェントにコピーし、サービスアカウントがすべてのマウントパスにアクセスできることを確認します。 ファイルに暗号化されたパスワードが含まれている場合は、エージェントごとに再暗号化する必要があります。 暗号化された値はエージェント固有のキーに依存しており、異なるエージェント間では機能しません。

新しいバージョンでのコネクションプロファイル ​

OPAバージョン2.15.0以降を使用する場合は、新しいオンプレミスグループを作成し、古いエージェントで使用されている同じグループにクラウドコネクションプロファイルを割り当てないようにします。 Workatoで直接オプションを使用してグループを作成し、その後、新しいエージェントを追加してこれらのプロファイルを管理できます。

コネクションの設定