手動: オンライン アップグレード

準備

重要:

次の手順を最初のサーバー ノードで実行し、次にクラスター内のその他すべてのノード (サーバーとエージェントの両方) で実行します。

すべてのノードの /opt/UiPathAutomationSuite フォルダーに 10 GB の空き領域があることを確認します。 十分な領域がない場合は、このフォルダーの容量を増やすか、以前のインストーラー ファイル ( cluster_config.jsonを除く) をすべて削除できます。 以前のインストーラーはいつでも再度ダウンロードできます。

利用可能な領域を確認するには、コマンド df -h /opt/UiPathAutomationSuite を実行します。

アップグレードの準備をするには、次の手順に従います。

1. SSH を使用して任意のサーバー マシンにログインします。シングルノードの評価プロファイルで、サーバー ノードが 1 つのみである場合、そのノードにログインします。

2. ルート ユーザーになります。

   sudo su -
   

3. /opt/UiPathAutomationSuite ディレクトリの下にインストール フォルダーを作成します。

   # Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer
   

4. Download as-installer.zip and copy it to /opt/UiPathAutomationSuite/{version}/installer. For download instructions, see sf-installer.zip.

   cp /path/to/as-installer.zip /opt/UiPathAutomationSuite/{version}/installer
   

5. as-installer.zip を解凍します。

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip as-installer.zip -d .
   

6. インストーラーに権限を付与します。

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
   

7. 最初のサーバー ノードで最新の cluster_config.json ファイルを生成し、残りのノードにコピーします。

   注:

   For details on how to configure the cluster_config.json parameters, see Advanced installation experience.

   • 古い cluster_config.json がある場合は、クラスターから構成ファイルを生成します。

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json
     

   • 古い cluster_config.json ファイルがない場合は、既定値の上書きを生成します。これは、以前のバージョンのインストール時に生成済みである可能性があります。

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -o ./cluster_config.json
     

   • If you upgrade from Automation Suite 2022.10 to Automation Suite 2023.4 or later, and Orchestrator is enabled on both the old and new versions, you must set the orchestrator.block_classic_executions flag to true in the cluster_config.json file. Using the flag shows that you agree with blocking classic folders executions. Not using the flag causes the upgrade operation to fail. For a configuration example, see Orchestrator-specific configuration.

   • If you are using AI Center^TM connected to an external Orchestrator, make sure that you have the Orchestrator certificate in the cluster_config.json file. If you upgrade from a version older than 2022.10, copy the Orchestrator certificate to the virtual machine. After you copy the certificate, the following configuration details are needed in cluster_config.json:

     "aicenter": {
         "enabled": true,
         "orchestrator_url": "https://orchestrator.example.com", //Specify the Orchestrator URL for AI Center
         "identity_server_url": "https://orchestrator.example.com/identity", //Specify the Identiy URL for AI Center
         "orchestrator_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to the Orchestrator certificate
         "identity_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to Identity certificate file
         "metering_api_key": "test" //Specify the metering API key
       }
     

     注:

     If AI Center requires an external Orchestrator, add sql_connection_string_template and sql_connection_string_template_odbc in the cluster_config.json file.

     After upgrading to AI Center 2023.4 and moving to external storage, making a skill created in 2022.4 public will fail. To fix this, run the script from here.

   • If you upgrade Automation Suite from a previous version and now enable Process Mining as well, you must update the sql_connection_string_template_sqlalchemy_pyodbc. Below is an example.

     "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://[e-mail]:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
     

   • If you upgrade Automation Suite from a version previous to 2023.4 and you have Apps enabled, you must create the SQL database for Apps, and then update the cluster_config.json file with the following configuration:

     "apps": {
     "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
     "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
     }
     

     注:

     アップグレードの以降の手順では、更新後の cluster_config.json ファイルを使用してください。

   See also Manual: Advanced installation experience.

8. (任意) インストーラーによって生成された自己署名証明書を引き続き使用する場合は、次のコマンドを実行します。この手順は、UiPath 製品のアップグレードを実行する最初のサーバー ノードで必要となります。

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   
   ### Update the trust store
   sudo update-ca-trust
   

実行

重要:

If any errors or issues occur during or following the upgrade, you can rollback to the previous version, provided that you previously configured a backup. For instructions, see Rollback on error.

バックアップを構成する

バックアップを構成するには、次の手順に従います。

1. Make sure you have enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the Automation Suite version from which you plan to upgrade. For instance, if you plan to upgrade from Automation Suite 2021.10, follow the instructions in the 2021.10 guide.

2. SSH を介していずれかのサーバー ノードに接続します。

3. 必要なすべてのボリュームがクラスターにバックアップされていることを確認するには、以下を実行します。

   /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
   

   注:

   バックアップには時間がかかることがあるため、その場合は 15 分から 20 分ほど待ってから再度ボリュームのバックアップを確認してください。

バックアップが作成されたら、続いて次の手順を実行します。

クラスターをメンテナンス モードにする

クラスターをメンテナンス モードにすると、イングレス コントローラーとすべての UiPath サービスがシャットダウンし、Automation Suite クラスターへのすべての受信トラフィックがブロックされます。

重要:

この操作によりダウンタイムが発生し、ビジネス オートメーションはアップグレード プロセス全体で中断されます。

1. クラスターをメンテナンス モードにするには、以下を実行します。

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./configureUiPathAS.sh enable-maintenance-mode
   

2. クラスターがメンテナンス モードであることを確認するには、以下を実行します。

   ./configureUiPathAS.sh is-maintenance-enabled
   

   重要:

   メンテナンス モードを有効化した後に、SQL Server のバックアップを作成し、トランザクションがこれ以上 SQL データベースに記録されないようにします。

Kubernetes およびその他のインフラストラクチャ コンポーネントを更新する

重要:

クラスター内のすべてのノードでインフラストラクチャのアップグレードを実行する必要があります。

この手順を複数のノードで同時に実行することはできません。各ノードでアップグレードが完了するまで待ってから、別のノードに移る必要があります。

1. インフラストラクチャのアップグレードを実行する各ノードにログインします。

2. sudo su - を実行してルートになります。

3. サーバー ノードとエージェント ノードで rke service が有効化されていることを確認します。

   このサービスが無効化されている場合は、次のコマンドを実行して有効化します。

   • サーバー ノードの場合:

     [[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service
     

   • エージェント ノードの場合:

     [[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service
     

4. アップグレードを開始するには、次のコマンドを実行します。

   重要:

   準備手順の説明に従って生成した cluster_config.json を更新したことを確認してください。

   # replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./install-uipath.sh --upgrade -k -i ./cluster_config.json -o ./output.json --accept-license-agreement
   

   重要:

   If you get the following error, follow the instructions in Downgrading Ceph from 16.2.6 to 15.2.9.

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

共有コンポーネントと UiPath 製品サービスを更新する

重要:

If you previously deployed your single-node installation using any Azure template version prior to 2022.10.3, and you now want to upgrade to a newer Automation Suite version, you must set the zone_resilience flag to false in the cluster_config.json file in /opt/UiPathAutomationSuite/Installer.

この手順では、クラスターで実行されるファブリック コンポーネントとサービス コンポーネントをアップグレードします。この手順は、どのサーバー ノードからも 1 回のみ行える点にご注意ください。

1. サーバー ノードに接続します。

2. sudo su - を実行してルートになります。

3. 次のコマンドを実行します。

   # replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./install-uipath.sh --upgrade -f -s -i ./cluster_config.json --accept-license-agreement -o ./output.json
   

   重要:

   アップグレードが完了すると、メンテナンス モードは自動的に無効化されます。

   After manually upgrading from Automation Suite 2021.10, you must also migrate to Cilium CNI. For instructions, see Migrating from Canal to Cilium CNI.

アップグレードの実行後、次の追加手順を実行できます。

• Automation Suite が正常かどうかを確認するには、以下を実行します。

  kubectl get applications -n argocd
  

• 2023.4.0 より前のバージョンの Automation Suite からアップグレードする場合は、Apps が実行されているかどうかを確認してから MongoDB を削除します。

  ./configureUiPathAS.sh mongodb uninstall --force
  

• ./configureUiPathAS.sh mongodb uninstall --force コマンドで MongoDB を削除するとエラーが発生する場合は、次のコマンドを実行してください。

  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
  
  ./configureUiPathAS.sh mongodb uninstall --force
  
  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'
  

• If you experience issues with image vulnerabilities or storage consumption after performing an upgrade, delete the images from the old installer. For details, see the Troubleshooting section.

アップグレード後にバックアップを有効化する

アップグレードしてクリーンアップ操作と移行操作を実行した後、バックアップを再開する必要があります。

重要:

次の手順に進む前に、Automation Suite が稼働中でありオートメーションが期待どおり続行されていることを確認します。

To enable the backup, follow the instructions in described in the Backing up and restoring the cluster documentation.

デプロイ テンプレートを使用したアップグレードを完了する

After performing an Automation Suite cluster upgrade, Azure and AWS template deployments require some changes to ensure a new node joins the cluster correctly through scale-out operations. To automate the changes, we recommend using the dedicated scripts. For instructions, see the Azure deployment template docs and the AWS deployment template docs.

特別な考慮事項

Azure テンプレートを使用してデプロイされたクラスターに対してアップグレードを実行すると、次の画像のようなエラーが発生する場合があります。

これは 、Azure ロード バランサーの動作の仕組みが原因です。この問題を修正するには、cluster_config.json ファイルの [fixed_rke_address] フィールドを変更します。アップグレード コマンドを実行する前に、このフィールドの値を最初のサーバー インスタンスの IP アドレスに変更する必要があります。Key Vault にアップロードされる cluster_config.json は、ノードが正常ではなく、トラフィックのバランスが取れないため、ILB の IP アドレスが引き続き設定されている必要があります。