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

準備

重要:

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

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

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

1. /uipath マウント ポイントに追加の UiPath bundle ディスクが接続されているサーバー ノード (エージェント ノードではありません) を特定します。このノードは、このドキュメントでは、プライマリ サーバー ノードと呼ばれています。シングルノードの評価プロファイルで、サーバー ノードが 1 つのみである場合、そのノードにログインする必要があります。

   注:

   クラスター内のすべてのノードで次の手順を実行します。サーバー ノードから開始し、エージェント ノードで続行します。

2. SSH を使用してノードに接続します。

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

   sudo su -
   

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

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

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

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

6. Download sf-infra.tar.gz and copy it to /opt/UiPathAutomationSuite/{version}. For download instructions, see sf-infra.tar.gz:

   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
   

7. (Only on the primary server node). Download sf.tar.gz and copy it to /uipath/{version}. For download instructions, see sf.tar.gz:

   cp /path/to/sf.tar.gz /uipath/{version}
   

8. sf-installer.zip を解凍します。

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

9. インストーラーに必要な権限を付与します。

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

10. Generate the latest cluster_config.json on the first server node and copy it to the rest of the nodes. 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 are upgrading from a previous version of AI CenterTM standalone, and your 2022.10 version of AI Center needs to be connected to an external Orchestrator, 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.

    • Automation Suite を以前のバージョンからアップグレードし、続いて Process Mining を有効化する場合は、sql_connection_string_template_sqlalchemy_pyodbc を更新する必要があります。以下に例を示します。

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

    See also Manual: Advanced installation experience.

実行

重要:

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.

Docker レジストリと Containerd をハイドレートする

必要なダウンタイムを最小限に抑えるには、次の手順を実行して、アップグレード前に docker-registry と containerd を新しいバージョンの製品のコンテナー イメージでハイドレートします。

重要:

• アップグレードの 10 時間以上前に、コンテナー内および/またはその他のインフラ イメージをハイドレートしないでください。
• If you upgrade Document Understanding and Computer Vision, you must download the base images that match your upgraded Automation Suite version (use the base image that corresponds with your ML Package version) and hydrate them to your docker registry prior to upgrade to avoid disruption to your running DU skills. To download the Document Understanding and Computer Vision installation packages, see Downloading the installation packages.

1. docker-registry をハイドレートするには、最初のサーバー ノードで次のコマンドを実行します。

   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/sf.tar.gz --offline-tmp-folder /uipath/tmp
   

2. 注:

   zstd がインストールされていることを確認します。zstd をインストールするには dnf install zstd コマンドを実行します。

   containerd をハイドレートするには、すべてのノードで次のコマンドを実行します。

   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./configureUiPathAS.sh containerd --offline-bundle ../sf-infra.tar.gz --offline-tmp-folder ../../tmp
   

バックアップを構成する

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

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 --offline-bundle ../sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --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 製品サービスを更新する

この手順では、クラスターで実行されるファブリック コンポーネントとサービス コンポーネントをアップグレードします。この手順は、プライマリ サーバー ノードでのみ実行する必要があります。

1. プライマリ サーバー ノードに接続します。

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

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

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

   重要:

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

   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
  

• 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.

• After upgrading to Automation Suite 2022.10.13 or newer, you can clean up the previous version images after the upgrade from the in-cluster Docker registry. For instructions, see How to delete images from the old installer after upgrade.

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

重要:

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

クラスターのアップグレードを開始する前に、アップグレード スクリプトによってクラスターのバックアップが自動的に作成され、その後一時的に無効化されます。アップグレードが完了したら、手動でバックアップを有効化できます。

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