- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- Longhorn のスナップショットを自動的にクリーンアップする方法
- TX チェックサム オフロードを無効化する方法
- TLS 1.2 で弱い暗号に対処する方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- Longhorn のセットアップ中に最初のインストールが失敗する
- SQL 接続文字列の検証エラー
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- プロキシ設定がある場合に Automation Hub と Apps を起動できない
- 管理ポータルのタイムアウト期間を設定する
- 基になるディレクトリ接続を更新する
- 移行後に認証が機能しない
- Kinit: Cannot find KDC for realm <AD Domain> while getting initial credentials
- kinit: Keytab contains no suitable keys for *** while getting initial credentials
- 無効なステータス コードが原因で GSSAPI 操作が失敗した
- Alarm received for failed kerberos-tgt-update job
- SSPI Provider: Server not found in Kerberos database
- アカウントが無効なため AD ユーザーのログインに失敗した
- ArgoCD へのログインに失敗した
- サンドボックス イメージを取得できない
- ポッドが ArgoCD UI に表示されない
- Redis プローブの障害
- RKE2 サーバーの起動に失敗する
- UiPath 名前空間でシークレットが見つからない
- 初回インストール後に ArgoCD が進行中ステートになる
- Unexpected inconsistency; run fsck manually
- MongoDB ポッドが CrashLoopBackOff になるか、削除後に PVC プロビジョニングの保留中になる
- MongoDB ポッドを 4.4.4-ent から 5.0.7-ent にアップグレードできない
- クラスターの復元またはロールバック後にサービスが異常になる
- Init:0/X でポッドがスタックする
- Prometheus が CrashloopBackoff ステートにあり、メモリ不足 (OOM) エラーを伴う
- Ceph-rook のメトリックが監視ダッシュボードに表示されない
- プロキシ環境でポッドが FQDN と通信できない
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドルを使用する
- ログを確認する
データベース
専用の「要件」セクションで特に指定がない限り、これらの要件はすべての Automation Suite 製品に適用されます。
Automation Suite の各製品は、それぞれ対応する仕様を満たす独自の SQL データベースを必要とします。
既定で、インストーラーによってすべてのデータベースがインストール プロセス中に作成されます。SQL Server でこの操作が行えるように、インストーラーに必要な権限を付与する必要があります。
また、自分でデータベースを作成することもできます。使用する必要がある名前は次の表をご覧ください。
Automation Suite の新規インストールに独自のデータベースを利用する場合は、既存のデータベースを使用するのではなく、新しいデータベースをセットアップすることを強くお勧めします。この予防措置は、古いデータベースのメタデータが残っているために、Automation Suite の動作との競合が発生するのを防ぐために必要です。
以下の表にデータベース名と対応する形式を示します。
| 製品/サービス | 既定のデータベース名 | 接続文字列の形式 |
|---|---|---|
| 共有プラットフォーム機能 | AutomationSuite_Platform | ADO.NET |
| Orchestrator | AutomationSuite_Orchestrator | ADO.NET |
| Action Center | AutomationSuite_Orchestrator | ADO.NET |
| Automation Suite ロボット | AutomationSuite_Orchestrator | ADO.NET |
| Automation Hub | AutomationSuite_Automation_Hub | ADO.NET |
| Data Service | AutomationSuite_DataService | ADO.NET |
| Insights | AutomationSuite_Insights | ADO.NET |
| Test Manager | AutomationSuite_Test_Manager | ADO.NET |
| Task Mining | AutomationSuite_Task_Mining | ADO.NET |
| AI Center | AutomationSuite_AICenter | JDBC |
| Document Understanding | AutomationSuite_DU_Datamanager | ODBC |
| Process Mining | AutomationSuite_ProcessMining_MetadataAutomationSuite_ProcessMining_Warehouse1AutomationSuite_Airflow2 | ADO.NET PYODBC |
1 AutomationSuite_ProcessMining_Warehouse uses both ADO.NET and PYODBC formats.
2 AutomationSuite_Airflow uses PYODBC connection string format. AutomationSuite_Airflow must have READ_COMMITTED_SNAPSHOT enabled when creating databases manually. The connection to the AutomationSuite_Airflow database can not begin with a { character.
構成ファイルに接続文字列を手動で設定する場合、次の方法で SQL、JDBC、または ODBC のパスワードをエスケープできます。
- SQL の場合: パスワードの最初と末尾に
'を追加し、他の'を 2 個に増やします。 - JDBC/ODBC の場合: パスワードの先頭に
{を追加し、末尾に}を追加し、他のすべての}を 2 個に増やします。
エラスティック プールでデータベースを使用すればコスト効果を高めることができます。
Apps の場合、独自の MongoDB を利用することはできません。
SQL 照合順序
Automation Suite では、サーバー レベルとデータベース レベルの両方において、照合順序を SQL_Latin1_General_CP1_CI_AS に設定した SQL がサポートされています。最適なパフォーマンスと安定性のために、この特定の設定を強くお勧めします。
任意の照合順序を柔軟に使用できますが、テストされていない構成は予期しない問題につながる可能性があることに注意してください。
バイナリ SQL や大文字と小文字を区別する照合順序は、Automation Suite のインストール中に既知の問題を引き起こすため、お勧めしません。
権限
インストーラーが指定した SQL Server 上にデータベースを作成するようにする場合は、データベースへの接続に使用する SQL アカウントに、最低でも dbcreator のロールを付与してください。
すべての製品に独自のデータベースを作成する場合は、SQL アカウントに Automation Suite のすべてのデータベースに対する db_owner ロールと db_securityadmin ロールを付与する必要があります。
セキュリティの制約により db_owner の使用が許可されない場合は、すべてのデータベースに対する次のロールと権限を SQL アカウントに付与する必要があります。唯一の例外は Insights で、db_owner が必須です。
db_securityadmindb_ddladmindb_datawriterdb_datareader- dbo スキーマに対する
EXECUTE権限
db_securityadmin ロールと db_ddladmin ロールは、インストール中、またはデータベースが再プロビジョニングされる場合にのみ使用されます。このため、ユーザーはこの権限を後で取り消すことができます。
フルテキスト検索のための SQL の要件
Document Understanding では SQL Server が SQL Server データベース エンジンのフルテキスト検索コンポーネントを備えている必要があります。このコンポーネントは既定でインストールされるとは限りません。
SQL Server のインストール時にフルテキスト検索を選択しなかった場合、Document Understanding を構成する前に、再度 SQL Server のセットアップを実行してコンポーネントを追加してください。
詳細については、このガイドにあるSQL Server での機能の追加/インストール方法をご覧ください。さらに、フルテキスト検索を含む、SQL Server に追加できるすべてのコンポーネントは、こちらより確認できます。
Insights のための SQL の要件
Insights は Azure AD 認証をサポートしていません。Azure AD を使用して認証する場合、ダッシュボードを読み込んだり、Microsoft SQL データベースからデータを取得したりすることはできません。
Insights では、SQL Server 2019 または 2022 が列ストア インデックスと .json 関数をサポートしている必要があります。スレッド処理が効率的でスケーラビリティが高いため、SQL Server Enterprise が推奨されます。
Azure SQL の場合は、データベースが S3 サービスの目的以上であることを確認します。
Insights データベースの互換性レベルが 130 以上に設定されていることを確認します。ほとんどの場合、既定の設定はこの要件を満たしています。詳しくは、SQL Server についてのドキュメントの、「View/Change the Compatibility level of a Database」をご覧ください。
インストールでは両方の条件を検証し、最小要件が満たされていない場合、アラートを表示します。
Data Service のための SQL の要件
Data Service には、SQL Server バージョン 2016 以降が必要です。
SQL Server バージョン 2019 以降を使用して独自のデータベースを作成する場合は、次の Data Service 権限をユーザーに付与してください。
GRANT ALTER ANY SENSITIVITY CLASSIFICATION TO {userName};
GRANT VIEW ANY SENSITIVITY CLASSIFICATION TO {userName};
GRANT ALTER ANY SENSITIVITY CLASSIFICATION TO {userName};
GRANT VIEW ANY SENSITIVITY CLASSIFICATION TO {userName};
Process Mining のための SQL の要件
Airflow データベース接続には、既定のサーバー ポート 1433 を使用する必要があります。
非標準の SQL Server ポートはサポートされていません。
Microsoft SQL Server をセットアップする際は、Airflow データベースがインストールされている SQL Server マシンのタイムゾーンが UTC に設定されていることを確認します。
Process Mining on Automation Suite requires a separate Microsoft SQL Server for the AutomationSuite_ProcessMining_Warehouse for data storage for Process Mining process apps.
以下に、Microsoft SQL Server データベース マシンを AutomationSuite_ProcessMining_Warehouse 用に設定するためのハードウェア要件と推奨事項の概要を示します。
ハードウェア要件を計算するには、以下を指定する必要があります。
- プロセス内の (100 万件の) イベントの数。
- 出力データのケース フィールドとイベント フィールドの数。たとえば、TemplateOne では 30 です。
開発環境では、パフォーマンス上の理由から、レコード数が限られた小規模な開発データセットで作業することをお勧めします。
You can use the Capacity calculator to determine the hardware requirements for setting up a dedicated Microsoft SQL Server machine for Process Mining. When you add Process Mining to the Product section, the minimum requirements for 1 Dedicated SQL Server are displayed.
See also Hardware requirements.
HA のための SQL の要件
SQL Server の高可用性構成では、Always On 可用性グループを選択します。詳細については、Always On 可用性グループの概要をご覧ください。
Orchestrator のための SQL の要件
パフォーマンスを向上させ、デッドロックを回避し、SQL のダーティー リードを防ぐため、READ_COMMITTED_SNAPSHOT オプションが ON に設定されていることを確認してください。
次のクエリを使用して、READ_COMMITTED_SNAPSHOT が有効か無効かを確認します。
SELECT is_read_committed_snapshot_on FROM sys.databases
WHERE name like 'PLACEHOLDER'
SELECT is_read_committed_snapshot_on FROM sys.databases
WHERE name like 'PLACEHOLDER'
必ず PLACEHOLDER を Orchestrator のデータベース名に置き換えてください。
有効化されている場合、戻り値は 1 になります。
無効化されている場合、戻り値は 0 になります。有効化するには、以下のクエリを使用します。
ALTER DATABASE PLACEHOLDER
SET READ_COMMITTED_SNAPSHOT ON
ALTER DATABASE PLACEHOLDER
SET READ_COMMITTED_SNAPSHOT ON
Test Automation や更新サーバーで異なるデータベースを使用する場合は、それらのデータベースでも READ_COMMITTED_SNAPSHOT を有効化する必要があります。