2023.10.0

公開日: 2024 年 4 月 25 日

ライセンス関連のテナント制限の変更

以下のいずれかのサービスを含むライセンスをお持ちの場合は、ライセンスを更新すると、100 個のテナントそれぞれでこれらのサービスを有効化できるようになりました。

• Automation Hub
• Process Mining
• Test Manager
• Insights

公開日: 2023 年 11 月 22 日

UiPath.OrganizationMigrationApp の新しいバージョンが公開

UiPath.OrganizationMigrationApp の新しいバージョンをリリースしました。このツールはスタンドアロン製品から Automation Suite への移行に役立ちます。新しいバージョンでは、Automation Suite v2023.10.0 に移行できるようになりました。

詳しくは、「 スタンドアロン製品を Automation Suite に移行する」をご覧ください。

公開日: 2023 年 11 月 3 日

更新内容

Kerberos 認証の変更

追記 (2024 年 8 月 14 日): CLI ツールを使用した Kerberos 認証の更新はサポートされなくなりました。 別の方法として、「 cluster_config.json を介した Kerberos 認証を構成する」に示す方法を使用して、Kerberos 認証を更新することもできます。

インストール エクスペリエンスの効率化

インストール エクスペリエンスを刷新し、オンライン/オフライン、シングルノード/マルチノードのいずれのインストール モードでも、同様の手順が共有され、共通のコマンドを活用できるようにしました。この改良は、より一貫性のあるシームレスなインストール エクスペリエンスをすべてのユーザーに提供することを目的としています。

対話型インストーラーは、現在は少し異なる目的で使用されています。このインストーラーは cluster_config.json ファイルを生成するためにのみ使用でき、実際のインストールは実行できません。

詳しくは、以下のドキュメントをご覧ください。

• ハードウェアおよびソフトウェアの要件

• 手動: インストールを準備する

• 手動: Automation Suite をインストールする

サイドバイサイド アップグレードの導入

並列クラスターを使用して Automation Suite のアップグレードを実行できるようになりました。この新しいアップグレード方法はサイドバイサイド アップグレードと呼ばれ、古い Automation Suite クラスター (業界ではブルー デプロイと呼ばれることが多い) から新しいクラスター (グリーン デプロイ) にトラフィックを切り替えることができます。この方法のメリットの 1 つは、現在の環境がアップグレード操作の影響を全く受けないことです。さらに、アップグレード中に問題が発生した場合は、古いデプロイに簡単にロールバックできます。

詳細な要件、アップグレード マトリクス、手順については、「サイドバイサイド アップグレードを実行する」をご覧ください。

サイドバイサイド アップグレードは効率的で、ワークフローの運用を中断するリスクが少ないため、Automation Suite インスタンスのアップグレードに推奨される方法です。

インプレース アップグレードの強化

サイドバイサイド アップグレード メカニズムの代わりに、インプレース アップグレードを使用して Automation Suite のバージョンを移行することもできます。過去に Automation Suite をアップグレードしたことがある場合は、この方法をよくご存じのはずです。

このアップグレード プロセスに固有の点は、設定とデータを同一のハードウェア上で完全な状態で維持できることです。使用されるクラスターは 1 つだけです。つまり、前のステートに戻す場合は、バックアップと復元の操作に頼る必要があります。

このアップグレード メカニズムはこれまでも使用されていた方法ですが、今回のリリースではこのメカニズムの複雑さが大幅に軽減されました。インプレース アップグレードは、オンラインとオフラインの両方のシナリオで同一となりました。さらに、以前はアップグレード プロセスを自動または手動のどちらで行うかを選択する必要がありましたが、新しくなったアップグレード フローではこの区別は関係ありません。つまり、すべてのユーザーに対して単一の指示が適用されます。この改良の結果、オートメーションのアップグレードの実行にこれまで使用されていた uipathctl.sh ツールが削除されました。

詳細な要件、アップグレード マトリクス、手順については、「インプレース アップグレードを実行する」をご覧ください。

Linux の Automation Suite から EKS/AKS の Automation Suite への移行

Linux の Automation Suite を既に使用しているものの、EKS/AKS の Automation Suite のほうが自社のニーズに適していると考えるユーザーに朗報があります。EKS/AKS の Automation Suite の新しいインストールに移行できるようになりました。

ただし、現在のところ、埋め込みの Automation Suite から EKS/AKS 上の Automation Suite の既存インストールに移行することはできません。

要件、必要なデータ移行操作、ステップバイステップの手順について詳しくは、「Linux の Automation Suite から EKS/AKS の Automation Suite に移行する」をご覧ください。

Longhorn の削除による安定性と品質の向上

安定性と品質を向上させるため、Longhorn に代わるメカニズムを実装しました。この変更の概要は、データとボリュームがサーバー マシンにアタッチされたディスクと直接連携するというもので、以下のようないくつかの影響があります。

• Insights、Docker レジストリ、監視アプリケーションが、サーバー ノードでのみ実行されるようになりました。

• Insights に対して外部 ObjectStore バケットを構成できるようになりました。詳しくは、「外部 ObjectStore の構成」をご覧ください。

• NFSv3 のサポートが追加されました。

• Longhorn から移行せずにアップグレード プロセスが完了すると、バックアップから復元されたクラスターには Longhorn が含まれなくなります。

• AI Center のパイプラインには追加のストレージが必要になりました。このパイプラインは、追加の AI Center ディスクがマウントされているマシン (サーバー マシンまたはエージェント マシンのいずれか) で動作します。

uipathctl のご紹介

CLI ツールを統一する取り組みの一環として、uipathctl をご紹介します。現在、この新しいツールの主な目的は、Automation Suite のインストールに影響する問題の診断とトラブルシューティング、サイドバイサイド アップグレードの実行、Linux の Automation Suite から EKS/AKS の Automation Suite への移行、外部の OCI 準拠のレジストリへの移行、および cluster_config.json ファイルの生成を支援することです。

今後、他の多くのシナリオでも uipathctl が頼りになるツールになります。ご期待ください。

署名付き URL を使用しない ObjectStore へのアクセス

署名付き URL を介したアクセスを無効化できる機能が導入され、外部 ObjectStore に対する権限が強化されました。

この設定を一度有効化すると元に戻せなくなり、グローバルに適用されますのでご注意ください。個々の製品レベルでの変更はできません。

この特定の設定では、Task Mining、および特定のアクティビティ ([ストレージ テキストを書き込み]、[ストレージ ファイルをアップロード]、[ストレージ ファイルのリストを取得]、[ストレージ テキストを読み込み]、[ストレージ ファイルをダウンロード]、[ストレージ ファイルを削除]) はサポートされていない点を考慮してください。

外部 Docker レジストリの改良機能

外部 Docker レジストリを大幅に改良しました。新機能のメリットは以下のとおりです。

• 外部の Docker レジストリにプライベート証明書を備えて、セキュリティをさらに強化できます。

• ミラー レジストリ スクリプトでは Automation Suite の成果物をコピーするためにインターネットへのアクセスが必要ですが、これに加えて、hydrate-registry.sh スクリプトがサポートされるようになりました。このスクリプトは、オフラインの tar バンドルを使用してそれを解凍し、中身を外部 Docker レジストリに直接アップロードします。このため、レジストリを管理する選択肢を柔軟に選択できるようになりました。

ネットワーク アクセスに制限がある顧客向けのオフライン バンドルの分割

ネットワーク アクセスに制限があるユーザーに対応するため、分割 as.tar.gz ファイルを導入し、オフライン インストールの実行に使用できるようにしました。このオフライン バンドルは、ダウンロードしやすいように 52 のパーツに分割されており、すべてのパーツがダウンロードされると再構築できます。

ただし、完全な as.tar.gz ファイルを一度にダウンロードするオプションも、十分な帯域幅を持つユーザーに対して引き続き利用可能です。

分割ファイルをダウンロードして結合する方法について詳しくは、公式ドキュメントをご覧ください。

RHEL のサポート対象のバージョンの追加

Red Hat Enterprise Linux (RHEL) 8.8 を実行するマシンに Automation Suite をインストールできるようになりました。

重要:

RHEL kernel version kernel-4.18.0-477.10.1.el8_8 は、Automation Suite クラスターのインストールまたは管理を中断させる問題の影響を受けます。どの Automation Suite ノードも、インストール前またはインストール後にこのバージョンのカーネルを使用していないことを確認してください。以下のコマンドを実行するとカーネルのバージョンを更新できます。

dnf install -y kernel kernel-tools kernel-tools-libs

SELinux のサポート

Automation Suite のすべてのバージョンで、すぐに使える SELinux がサポートされており、既定のポリシーが有効化されています。

IMDSv2 のサポート

インスタンス プロファイルを使用して AWS S3 に接続できるよう、IMDSv2 がサポートされました。

ArgoCD UI ドキュメントの非推奨化

ベスト プラクティスに確実に従い操作の安定性を維持するため、UiPath では設定やパラメーターを変更する手段として ArgoCD UI の使用を避けることにしました。

代わりに、そういった目的には cluster_config.json ファイルを使用することを強くお勧めします。この変更は、信頼できる情報源の一貫性を構成に対して確保することを目的としています。

ただし、トラブルシューティング、ログの表示、その他の同様の操作に対しては引き続き ArgoCD UI を使用できます。

Kerberos 認証の構成に関する変更

追記 (2024 年 8 月 17 日): Kerberos 認証の構成プロセスを更新しました。 configureUiPathAS.sh スクリプトや CLI ツールを使用する代わりに、cluster_config.json ファイルを使用して認証を設定できるようになりました。詳細については、「 cluster_config.json を介した Kerberos 認証を構成する」をご覧ください。

ライセンスに関するニュース

監査ログのメッセージの変更

管理者によってユーザーが削除され、そのライセンスの割り当てが解除された場合に表示される監査データのメッセージを改良して分かりやすくしました。「User <administrator_name> deallocated all licenses of user(s) <user_names>」というメッセージが表示されるようになりました。

AI Unit の割り当て

AI Unit をテナント レベルでも割り当てられるようになりました。この操作は [管理] セクションで、目的のテナントに対応するライセンスの割り当てウィンドウから実行します。

ライセンス割り当てエンドポイント

API からライセンスを割り当てるための 2 つの新しいエンドポイントを追加しました。

• GET/api​/account​/{accountId}​/user-license​/group​/{groupId} - グループの作成または編集に利用可能なすべてのユーザー ライセンスのリストを取得するには、このエンドポイントを呼び出します。

• このエンドポイントを使用するには、ライセンス の [表示] 権限が必要です。

• PUT/api/account/{accountId}/user-license/group/{groupId} - グループ ルールの割り当てまたは更新をするには、このエンドポイントを呼び出します。

• このエンドポイントを使用するには、ライセンス の [書き込み] 権限が必要です。

Citizen Developers ユーザー グループ

プラットフォームのアクセス制御機能として、新しいユーザー グループ「Citizen Developers」を追加しました。この新しいグループは組織レベルで定義され、プラットフォーム内のすべてのサービスとシームレスに連携します。

Citizen Developers グループでは、市民開発者が不要なアクセス権に混乱させられず、業務に関連するリソースにアクセスできるため、管理者の負担が軽減されます。

このユーザー グループがプラットフォームのさまざまなサービスにどのように連携するかについて詳しくは、製品ドキュメントをご覧ください。

AAD のカスタム属性マッピング

既存の AAD との連携では自動属性マッピングが提供されていますが、このリリースでは、組織がカスタム属性マッピングを使用する機能が導入されました。

事業部門属性のカスタム マッピングのサポートを開始しました。これにより、組織部門などの属性を UiPath® Platform の「事業部門」フィールドにマッピングできます。このマッピングにより、組織内のユーザーのコンテキストの理解が深まり、ユーザー ID を Automation Hub などのサービスと連携させることができます。

事業部門属性は、Azure AD 属性に基づいて、または SAML を介してマッピングできます。

Deployment Assistant のサポート終了

Deployment Assistant のサポートを終了します。これにより、より大きなメリットをもたらすツールの開発や改良を集中して進めることができます。

公式ドキュメントを詳しく確認して既存のツールや機能を理解することを、すべてのユーザーに対して推奨します。公式ドキュメントに関するフィードバックをお寄せください。皆さまのご意見は、ユーザーのニーズに最適なサービスを提供するための、製品の継続的な改良や調整のために不可欠です。

改良点

トラブルシューティングのユーザー エクスペリエンスの向上

Automation Suite のトラブルシューティングとデバッグに役立つ新しい CLI ツールを導入しました。新しいツールは uipathtools と呼ばれ、健全性コマンドに固有の uipathctl 機能のサブセットが含まれています。軽減手順にタイムリーにアクセスできるように、標準リリースよりも高い頻度で uipathtools の更新プログラムを提供する予定です。

uipathtools と uipathctl の CLI ツールでは、以前の Automation Suite 診断ツール diagnostics-report.sh (現在は提供されていない) に含まれていたすべての診断機能を利用できます。

SSO 認証の改良

ArgoCD のシングル サインオン (SSO) を有効化する手順を更新しました。現在は、Dex 構成ファイルと指定したパラメーターを使用する必要があります。

詳しくは、こちらのドキュメントをご覧ください。

バグ修正

• 追記 (2024 年 1 月): レプリカのクリーンアップ スクリプトによって、ノード上のストレージが誤って再利用されていました。詳しくは、トラブルシューティングに関するドキュメント「ストレージ再利用パッチ」をご覧ください。

• 以前は、スケジュールされたバックアップとオンデマンド バックアップの両方が、1 時間のタイムアウト後に失敗していました。現在は、タイムアウト期間を 3 時間に延長できるようになりました。詳細については、「スナップショットのバックアップを有効化する」と「スナップショットのオンデマンド バックアップ」をご覧ください。

• configureUiPathAS.sh スクリプトで ODBC 接続文字列が正しく更新されなかったり読み取られなかったりすることがありました。現在、この問題は修正されています。

• 最初の実行から 90 日後に Automation Suite インストーラーを再実行しようとすると、エラーが発生していました。インストーラーは、有効期間が 90 日間の自己署名証明書を生成し、それが再実行されたときに、既に期限が切れている証明書については再検証を求めていました。

管理者のバグ修正

• Automation Express ライセンスはクラウド環境専用ですが、オンプレミスのデプロイでも割り当てが可能になっていました。この問題は現在は修正されました。

• Action Center - Named User ライセンスを持つ組織には、Data Service ユニットが付与されていませんでした。この問題は現在は修正されました。

• 組織を削除しても、そのライセンスは解放されませんでした。現在は、組織が削除されると、その組織に割り当てられていたライセンスはすべてライセンス プールに戻ります。

• 構成マップの NLog 設定 minLevel が適用されていませんでした。既定の minLevel は、重要度が「Info」以上のログが記録されることを示す「Info」です。にもかかわらず、minLevel の設定が適用されておらず、重要度レベルが低い「Trace」や「Debug」のログも書き込まれていました。

• 以前は、セキュリティ グループを取得するときに既知の SID が誤って含まれ、予期しない動作が発生するという問題がありました。セキュリティ グループを取得するときに既知の SID が含まれることがなくなり、よりスムーズで予測可能な機能が保証されます。

• v2022.10.1 以降にアップグレードした後に、ホスト テナントにログインしてからログアウトし、その後で別のテナントに切り替えると、選択したテナントではなく、以前のログアウト場所にリダイレクトされていました。現在は、ログアウトしてテナントを切り替えた後は、以前のログアウト場所ではなく、選択したテナントのページに正しくリダイレクトされるようになりました。

既知の問題

Insights の PVC サイズが上書きされたことによるアップグレードの失敗

追記 (2024 年 12 月 18 日): 既存の Insights の PVC サイズが誤って上書きされると、アップグレードが失敗します。 この問題を解決するには、ArgoCD UI で PVC のサイズを手動で変更する必要があります。 詳しくは、「 トラブルシューティング」 セクションをご覧ください。

この問題は、 Automation Suite 2023.10.7 で修正されています。

Automation Suite のアップグレード後に Insights を再インストールまたはアップグレードするとデータが失われる

追記 (2024 年 12 月 18 日): Automation Suite をバージョン 2023.4 以前からアップグレードした後に Insights を再インストールまたはアップグレードすると、Insights のストレージ クラスの変更に伴う問題によりデータが失われます。 この問題を解決するには、「 トラブルシューティング」をご覧ください。

Automation Suite 2023.10.7 の問題を修正しました。

非 HA Redis でのノード メンテナンスの問題

追記 (2024 年 12 月 18 日): HA Redis 以外のシナリオでノード ドレインを実行すると、 redis-cluster-0 ポッドが終了ステートでスタックする問題があります。 この問題を解決するには、次のコマンドを使用してポッドを強制的に削除する必要があります。

kubectl -n redis-system delete pod redis-cluster-0 --force

Automation Suite 2023.10.7 の問題を修正しました。

アクティブ/パッシブ チェック中の不要な Redis DNS 解決の検証

追記 (2024 年 12 月 18 日): ある問題により、アクティブ/パッシブの前提条件の確認中に、 redis.<primary-fqdn> と redis-db.<primary-fqdn> に対する Redis DNS 解決の検証が不必要に行われます。 この問題は、 Automation Suite 2023.10.7 で修正されています。

Insights の注釈、課題がブロックされる、インストーラー

追記 (2024 年 12 月 18 日): Insights の注釈の問題により、Automation Suite インストーラーがブロックされます。 Automation Suite 2023.10.7 の問題を修正しました。

追加ノードでの RKE2 サービスの意図しないアップグレード

追記 (2024 年 11 月 26 日): 最初のサーバー以外のノードの /etc/yum.conf ファイルに exclude= rke2-* が追加されない問題を確認しました。特定の環境 (特にオンラインの環境) では、すべてのコンポーネントをアップグレードしようとすると、最初のサーバー以外のノードで RKE2 サービスが意図せずアップグレードされる可能性があります。

この問題を修正するには、Automation Suite クラスターのすべてのノード上の /etc/yum.conf ファイルに手動で exclude=rke2-*を追加する必要があります。

サイドバイサイド アップグレード中に AI Center のスキルの同期が失敗する

追記 (2024 年 12 月 18 日): 構文の問題により、サイドバイサイド アップグレード中に aicenter skill sync コマンドと aicenter skill status コマンドが失敗します。

この問題を修正するには、構文を手動で編集する必要があります。 詳しくは、「 トラブルシューティング」 セクションをご覧ください。

Test Automation SQL の接続文字列は無視されます

追記 (2024 年 10 月 17 日): cluster_config.json ファイルの orchestrator.testautomation セクションで SQL 接続文字列を指定すると、uipathctlバイナリは接続文字列を無視し、代わりに orchestrator セクションの下の接続文字列を使用します。この問題を解決するには、「 トラブルシューティング」 セクションをご覧ください。

ノード ラベルの設定中にインストールが失敗する

追記 (2024 年 10 月 17 日): IMDSv2 のみが有効化されている AWS マシンに Automation Suite をデプロイすると、ノード ラベルの設定中にインストールが失敗します。 この問題を解決するには、「 任意: マルチノードの HA 対応の運用クラスターにおけるゾーン障害に対する復元設定を有効化する」の重要事項をご覧ください。

システム アップグレード名前空間でジョブが失敗したためアップグレードできない

追記 (2024 年 10 月 17 日): system-upgrade 名前空間に失敗したジョブが存在するため、Automation Suite のアップグレードが失敗します。 アップグレード コマンドがいずれかの段階(インフラ、ファブリック、またはサービスのアップグレード)で失敗した場合は、アップグレードを再試行する前に次の手順を実行します。

1. system-upgrade名前空間の既存のジョブをリスト表示します。

   kubectl get jobs -n system-upgrade

2. 失敗したジョブを削除します。

   kubectl -n system-upgrade delete jobs <failed_jobs>

   コマンドの実行時に、 <failed_jobs> プレースホルダーを、失敗したジョブの名前をスペースで区切って置き換えます。

Automation Suite 2023.10.6 の問題を修正しました。

プロキシ環境でポッドが FQDN と通信できない

追記 (2024 年 10 月 17 日): プロキシ環境で、プロキシ サーバーが Istio サービス内の他のサービスの TCP ポートと同じポートを使用している場合 メッシュ (ポート 8080 など) では、ポッドは FQDN と通信できません。 この問題により、次のエラーが発生します。

System.Net.Http.HttpRequestException: The proxy tunnel request to proxy 'http://<proxyFQDN>:8080/' failed with status code '404'.

この問題を修正するには、「トラブルシューティング」セクションをご覧ください。

TLS 1.2 の弱い暗号

追記 (2024 年 8 月 29 日): TLS 1.2 での弱い暗号の使用に関連する特定の脆弱性を特定しました。 この問題を軽減する方法の詳細については、「 TLS 1.2 で脆弱な暗号に対処する方法」を参照してください。

サポート バンドルのログ収集の失敗

追記 (2024 年 8 月 14 日): オフライン環境で外部 OCI レジストリを使用する場合のサポート バンドルの生成に影響する問題があります。 このような状況では、生成されたサポート バンドルには履歴ログがないため、選択した外部オブジェクト ストレージにアップロードできません。 この問題を修正するには、「 トラブルシューティング」 をご覧ください。

外部 ObjectStore に対して不要な ListBucket API の前提条件の確認が失敗する

追記 (2024 年 8 月 14 日): AI Center と Task Mining で外部 ObjectStore を使用すると、 ListBucket API 前提条件の確認が失敗します。 ただし、AI Center と Task Mining では ListBucket API 権限は使用されません。 Automation Suite 2023.10.5 で不要なチェックを削除しました。

ArgoCD の SSO を有効化できない

追記 (2024 年 8 月 14 日): Dex イメージのバージョンに問題があるため、ArgoCD の SSO を有効化できません。 Automation Suite 2023.10.5 の問題を修正しました。

アップグレード後に snapshot-controller-crds ポッドが CrashLoopBackOff ステートになる

追記 (2024 年 8 月 14 日): アップグレード後、 snapshot-controller-crds ポッドが CrashLoopBackOff ステートのままになる問題があります。 この問題は、RKE2 のアップグレード時に、新しく取り付けた snapshot-controller と既存のが競合したために発生します。 この問題を修正するには、 トラブルシューティング ページをご覧ください。

クラスター内の ObjectStore から外部 ObjectStore への移行が失敗する

追記 (2024 年 8 月): 構成の問題が原因で、クラスター内の ObjectStore から外部 ObjectStore への移行が失敗します。 このため、このバージョンの Automation Suite では、Ceph のクラスター内 ObjectStore から外部 ObjectStore への移行を試みないでください。 Automation Suite 2023.10.2 の問題を修正しました。 Ceph から外部 ObjectStore に安全に移行できる場所。

プロキシ環境で外部オブジェクト ストレージを使用するとコンポーネントが失敗する

追記 (2024 年 7 月 24 日): プロキシ環境で外部ストレージを使用すると、Orchestrator、Automation Suite サポート バンドル ツール、Prometheus、Thanos、Fluentd などが失敗します。 Automation Suite 2023.10.3 の問題を修正しました。

Azure Government 上の AKS に対して誤った FQDN で生成されたサポート バンドル

サポート バンドルの生成時に、Azure Government 上の AKS に誤った FQDN が使用されます。 Automation Suite 2023.10.4 の問題を修正しました。

Airflow のネットワーク ポリシーが原因で DNS が正しく機能しない可能性があります

追記 (2024 年 6 月 3 日): まれに、Airflow のネットワーク ポリシーにより DNSが正しく機能しない場合があります。この問題を回避するには、次のコマンドを実行します。

sudo networkPolicyTool.sh --createNetworkPolicy ./Configs/networkPolicyTool/airflow.yaml --add

ネットワーク ポリシー ツールをインストールするには、トラブルシューティングの記事「Network Policy Tool」の手順に従います。この問題は、Automation Suite 23.10.3 で修正されています。

シングルノードのアップグレードがファブリック ステージで失敗する

追記 (2024 年 5 月 20 日): クラスター内のストレージを使用するシングルノード デプロイでバージョン 2022.4.1 以前からのアップグレードを行うと、rook-ceph の移行の問題により、ファブリックの段階で失敗します。この問題を回避するには、「シングルノードのアップグレードがファブリック ステージで失敗する」の手順に従ってください。

CephMgrIsAbsent のアラートに関する問題

追記 (2024 年 4 月 19 日): ストレージに問題がなくても CephMgrIsAbsent の誤検知アラートが表示されます。この問題は、Automation Suite 23.10.3 で修正されています。

S3 ObjectStore への移行後に rook-ceph をアンインストールする際のエラー メッセージ

追記 (2024 年 4 月 19 日): rook-ceph をアンインストールする際に、外部オブジェクト ストレージの構成が見つからないことに関するエラー メッセージが表示されます。 この問題は、移行が成功しても発生します。 この問題は、Automation Suite 23.10.3 で修正されています。

Ceph のメトリックとアラートに影響する問題

追記 (2024 年 4 月 19 日): 特定の状況下で、Ceph のメトリックとアラートが監視ダッシュボードに表示されないことがあります。この問題を修正するには、「トラブルシューティング」セクションをご覧ください。

SQL Server と SQL データベースの照合順序の違いがサポートされない

追記 (2024 年 2 月 28 日): ストアド プロシージャで SQL Server と SQL データベースの照合順序の違いがサポートされていません。潜在的な問題を回避するには、SQL Server と SQL データベースの両方の照合順序の設定を同一にする必要があります。

MongoDB から SQL Server への移行によりアップグレードが失敗する

追記 (2024 年 2 月 28 日): Automation Suite 2022.10 以前から Automation Suite 2023.10.0 以降へのサイドバイサイド アップグレードおよびインプレース アップグレードに影響する問題を特定しました。Apps を有効化していて、SQL Server データベースに Kerberos 認証を使用している場合は、MongoDB から SQL Server への移行に失敗したため、アップグレード操作が失敗します。

追記 (2025 年 4 月 15 日): 推奨される解決策は、 Automation Suite 2023.10.9 へのアップグレードです。

既存の Automation Suite に新しい製品を追加する際にインストールが失敗する

追記 (2024 年 2 月 28 日): Automation Suite の既存のインストールに新しい製品を追加しようとすると、一時レジストリを指定するようインストーラーによって誤って要求され、インストール プロセスが失敗します。

この問題を解決するには、次の回避策を適用してください。

1. 一時レジストリが稼働していることを確認します。
2. 次のコマンドを実行して、Docker レジストリ StatefulSet の readinessProbe 設定を変更します。

   kubectl patch statefulset docker-registry -n docker-registry --type json -p '[{"op": "replace", "path": "/spec/template/spec/containers/0/readinessProbe", "value": {"httpGet":{"scheme":"HTTPS", "path": "/", "port": 5000}}}]'

政府機関向けクラウド ストレージへのログ転送に影響する問題

追記 (2023 年 12 月 19 日): Fluentd および Fluent Bit のログを Azure および AWS の政府機関向けクラウド ストレージに転送することはできません。

Splunk を使用し、そちらでアプリケーション ログを転送することをお勧めします。

オフライン インストール実行後のゾンビ プロセス

追記 (2023 年 12 月 19 日): オフライン インストールの実行後、Docker レジストリの Readiness Probe によってゾンビ プロセスがトリガーされます。

この問題を解決するには、v2023.10.0 のオフライン インストールを実行した後に次のコマンドを実行して、既存の Readiness Probe を更新します。この手順は、オンライン インストールでは不要です。

kubectl patch statefulset docker-registry -n docker-registry --type json -p  '[{"op": "replace", "path": "/spec/template/spec/containers/0/readinessProbe", "value": {"exec":{"command":["sh","-c", "[ -f /var/lib/registry/ready ] || { echo \"Registry is not seeded\"; exit 1; } "]}}}]'

障害復旧後 Dapr が Process Mining と Task Mining で正しく機能しない

障害復旧後、Dapr が正常に復元されず、Process Mining と Task Mining のサービスを提供するために Dapr が必要とする証明書が正しくありません。dapr、processmining、および taskmining アプリケーションは、最初は正常であるように見えますが、その後は進行中ステートに戻り、環境が不安定になります。Process Mining または Task Mining にログインしても、アプリケーションが読み込まれなかったり、予期しないエラーが返されたりすることがあります。

問題を解決するために必要な手順について詳しくは、「Process Mining のトラブルシューティング」をご覧ください。

Document Understanding のすぐに使えるパッケージのバージョンが見つからない

特定の状況下で、すぐに使えるパッケージのインストーラーが失敗することがあります。失敗した場合、一部の ML パッケージのバージョンが Document Understanding に表示されなくなります。これを修正するには、ArgoCD の同期をトリガーするか、ArgoCD の同期によってインストーラーが自動的にトリガーされてパッケージが再インストールされるのを待ちます。

Document Understanding の接続文字列を設定する際に使用できない文字がある

構成ファイルで接続文字列を手動で設定する場合、PYODBC では Document Understanding データベースのパスワードの先頭に { を使用できません。

v2023.10 へのアップグレード後に AI Center をプロビジョニングできない

v2023.4.3 から v2023.10 にアップグレードすると、AI Center のプロビジョニングで問題が発生します。

システムに「"exception":"sun.security.pkcs11.wrapper.PKCS11Exception: CKR_KEY_SIZE_RANGE」という例外が表示され、テナントの作成が失敗します。

この問題を解決するには、ai-trainer のデプロイで、ロールアウトの再起動を実行する必要があります。これを行うには、次のコマンドを実行します。

kubectl -n uipath rollout restart deploy ai-trainer-deployment

Kerberos keytab ローテーションでトークンの再生成がトリガーされない

追記 (2025 年 9 月 24 日): 問題が発生し、Kerberos keytab のローテーションで認証トークンがすぐには再生成されず、サービスとデータベース間の接続が一時的に中断する可能性があります。

この問題を解決するには、次のコマンドを実行して、Kerberos チケットの更新 cronjob を手動でトリガーする必要があります。

kubectl delete job tgt-rotate-manual -n uipath --ignore-not-found ; kubectl create job tgt-rotate-manual --from=cronjob/kerberos-tgt-update -n uipath

Automation Suite 2023.10.11 の問題を修正しました。

ユーザー割り当てマネージド ID を使用すると Orchestrator が起動しない

追記 (2025 年 9 月 24 日): 問題により、オブジェクト ストレージにユーザー割り当てマネージド ID を選択するときに storage.useClientID パラメーターを設定できません。そのため、アクセスがユーザー割り当てマネージド ID に制限されている環境では tOrchestrator を起動できません。

この問題を解決するには、ArgoCD で次のようにパラメーターを手動で設定する必要があります。

1. ArgoCD Orchestrator アプリケーションで、[ 詳細 ] > [パラメーター] に移動します。
2. [値] テキスト ボックスで [storage.isExternal : true] を設定し、保存します。

Automation Suite 2023.10.11 の問題を修正しました。

Thanos コンパクターは破損したブロックで停止します

追記 (2025 年 9 月 24 日): ある問題により、Thanos コンパクターは、オブジェクトストアで破損したブロックを検出すると、メトリクスの圧縮を停止します。これにより、コンパクションが防止され、ストレージの使用量が増加します。

この問題に対処するには、「 トラブルシューティング」 セクションを参照してください。

Automation Suite 2023.10.11 の問題を修正しました。

オフライン環境でエージェント ノードの追加に失敗する

追記 (2025 年 6 月 26 日): オフライン環境でエージェント ノードの追加プロセスが失敗する問題があります。エージェント ノードを追加するには、一時レジストリが実行されている必要があります。この問題を解決するには、一時レジストリを再度有効化して、エージェント ノードに正常に参加できるようにする必要があります。

Automation Suite 2023.10.10 の問題を修正しました。

大きなポリシー OID を持つ CA 証明書が原因でインストールが失敗する

追記 (2025 年 6 月 26 日): ポリシー OID 値が 4 バイトを超える CertificatePolicies セクションを含む証明機関 (CA) 証明書を使用すると、Automation Suite のインストールが失敗する問題を修正しました。この問題により、Automation Suite がこれらの CA 証明書を認識できず、インストール プロセスが中断します。

この問題に対処するには、 CertificatePolicies セクション内のポリシー OID 値が 4 バイトを超えないようにするか、証明書に CertificatePolicies セクションを追加する CA ジェネレーターを使用しないようにする必要があります。

Automation Suite 2023.10.10 の問題を修正しました。

ライセンス SQL 接続エラー

追記 (2025 年 6 月 26 日): ライセンス SQL 接続エラーは、[データ ソース] プロパティで名前付きインスタンスとポートの両方が指定されている場合に発生します。

Automation Suite 2023.10.10 の問題を修正しました。

Grafana ダッシュボードのエラー

追記 (2025 年 6 月 10 日): マルチノード (HA) 設定では、Grafana は 2 つのレプリカで実行されますが、レプリカ間に共通のデータ ソースがないため、ユーザー セッション管理で問題が発生します。Dashboard not found や Invalid dashboard UID in the request などのエラーが Grafana ダッシュボードに表示されます。

回避策として、Grafana は重要なアプリケーションではないため、次の手順を実行してレプリカの数を 1 に減らすことができます。

1. fabric-installer アプリケーションの helm パラメーターを変更します。これにより、 fabric-installer アプリケーションの同期操作が自動的にトリガーされます。

   kubectl patch   application fabric-installer -n argocd    --type='json'  -p='[{"op": "add", "path": "/spec/source/helm/parameters/-", "value": {"name": "global.rancherMonitoring.grafana.replicas", "value": "1"}}]'

2. ArgoCD UI から rancher-monitoring アプリケーションを同期します。

この問題は、Automation Suite 2023.10.7 で修正されました。

uipathctl health check コマンド

追記 (2025 年 5 月 21 日): 外部 Docker レジストリを使用した Automation Suite のオフライン インストールでは、既知の問題により、 uipathctl 健全性チェック コマンド が機能しません。この問題は 、Automation Suite 2023.10.6 で修正されています。

回避策として、Automation Suite 2023.10.6 から uipathctl バイナリをダウンロードし、それを使用して uipathctl の健全性チェック コマンドを実行します。

Kubernetes のアップグレードの失敗

追記 (2025 年 4 月 15 日):deployment.appsにcertificate-injector-webhookがないために、Kubernetes のアップグレードが失敗します。この問題を解決するには、次のコマンドを実行する必要があります。

kubectl delete configmap -n uipath-infra certificate-injector-webhook-configmap --ignore-not-found

Automation Suite 2023.10.9 の問題を修正しました。

アップグレード後の Document Understanding のデプロイに関する問題

追記 (2025 年 4 月 15 日): Automation Suite 2023.10.x にアップグレードした後、AI Center の DM セッションにファイルをインポートできない問題を修正しました。この問題は、アップグレード後に、古いバージョンの Automation Suite からの du-digitizer-worker デプロイが完全にクリーンアップされていないために発生します。Automation Suite 2023.10.0 以降、デプロイの名前が du-digitizer-worker-deploymentに変更されました。

この問題を解決するには、ArgoCD UI に移動し、 documentunderstanding アプリケーションから古い du-digitizer-worker デプロイを手動で削除する必要があります。削除後、 documentunderstanding アプリケーションを再同期します。

Automation Suite 2023.10.8 の問題を修正しました。

Docker レジストリのクリーンアップ プロセスが不完全です

追記 (2025 年 4 月 15 日): ある問題により、レジストリのクリーンアップ コマンドを実行しても、すべてのレジストリ ポッドから未使用の Docker イメージが効果的にクリアされません。この問題に対処するには、「 トラブルシューティング」 セクションを参照してください。

Automation Suite 2023.10.9 の問題を修正しました。

kube-proxyヘルスチェックが機能しない

追記 (2025 年 4 月 15 日):node-monitor コンポーネントは、kube-proxyの健全性チェックや ip_forward が有効化されているかどうかなどの問題がないかノードを監視し、問題が発生した場合はノードを遮断しますが、GPU、task-mining、as-robotなどの特定のノードでは機能しません。この問題は、Automation Suite 2023.10.9 で修正されました。

Kerberos チケットは自動的に更新されません

追記 (2025 年 4 月 15 日): クラスターの復元後に Kerberos チケットの自動更新に失敗するため、Windows 認証アプリを手動で同期する必要があります。

この問題は、Automation Suite 2023.10.9 で修正されています。

AI Center のストレージの移行の失敗

追記 (2025 年 2 月 13 日): AI Center で Ceph のクラスター内ストレージから外部オブジェクト ストレージに移行するプロセス中に、 uipathctl が正しく executeMigration を true に正しく設定できない問題が発生しました。

この問題を修正するには、AI Center の ArgoCD で executeMigration を手動で true に設定し、再同期を続行してプルーニングする必要があります。 この問題は、 Automation Suite 2023.10.8 で修正されています。

アップグレード後のメール アラートの設定エラー

追記 (2025 年 2 月 13 日): Automation Suite 2022.10 からアップグレードした後、メール アラートの設定機能と複数の受信者の設定に影響する問題が発生しました。 この問題に対処するには、「 トラブルシューティング」をご覧ください。

この問題は、 Automation Suite 2023.10.8 で修正されています。

既定の組織の初期化によるアップグレードの失敗

追記 (2025 年 6 月 26 日): Automation Suite 2022.10 以前からバージョン 2023.10.0 から 2023.10.2 にアップグレードすると、アップグレードが失敗します。この問題は、 platform-services-initialize-default-organization-jobの不明なソケット エラーが原因で発生し、既定の組織が初期化されないためです。

Automation Suite 2023.10.3 の問題を修正しました。

非推奨化のタイムライン

非推奨化および削除される機能に関する最新情報については、非推奨化のタイムラインを定期的に確認することをお勧めします。

バンドルの詳細

製品バージョン

Automation Suite の各製品における変更点は、以下のリンクから確認できます。

製品が灰色表示されている場合は、この新しいバージョンの Automation Suite ではそのコンポーネントに対する変更はありません。

発見	開発	管理	協働
Automation Hub 2023.10.0	Automation Ops 2023.10.0	AI Center 2023.10.0	Action Center 2023.10.0
Task Mining 2023.10.0	AI Computer Vision 2023.4.3	Insights 2023.10.0	Apps 2023.10.0
Process Mining 2023.10.0	Document Understanding 2023.10.0	Orchestrator 2023.10.0
		Test Manager 2023.10.0
		Data Service 2023.10.0

内部コンポーネントのバージョン

この Automation Suite のリリースには、次のコンポーネントがバンドルされています。

コンポーネント	バージョン
RKE2	1.26.5
ArgoCD	2.7.7
logging-operator	3.17.10
logging-operator-logging	3.17.10
Gatekeeper	3.11.0
rook-ceph	1.9.4
prometheus-pushgateway	2.1.6
cert-manager	1.12.3
rancher-istio	102.2.0-up1.17.2
rancher-logging	102.0.1-up3.17.10
rancher-logging-crd	102.0.1-up3.17.10
rancher-monitoring-crd	102.0.1-up40.1.2
rancher-gatekeeper-crd	100.2.0-up3.8.1
rancher-gatekeeper	100.2.0-up3.8.1
rancher-monitoring	102.0.1-up40.1.2
longhorn	1.4.3
longhorn-crd	1.1.100
reloader	0.0.129
csi-driver-smb	1.8.0
velero	3.1.6
redis-operator	6.2.18-41
redis-cluster	6.2.18-65

移行ツールのバージョン

必要な移行ツールのバージョンは、移行するスタンドアロン製品と対象となる Automation Suite のバージョンによって異なります。 詳しくは、「 移行の相互運用性マトリクス」をご覧ください。

スタンドアロン製品を Automation Suite の現在のバージョンに移行する手順については、「 完全な移行」をご覧ください。