SQL 接続文字列を更新する

Automation Suite 製品が SQL データベースへの接続に使用する接続文字列を更新する状況として、次のような複数のシナリオがあります。

• セキュリティとコンプライアンスのために、データベースへの接続に使用するパスワードを定期的にローテーションする場合
• SQL Server の FQDN を変更する場合
• メンテナンスのためにデータベースを別の SQL Server に移行する場合
• 次のような 1 つ以上の接続属性を追加、変更、または削除するとき MultiSubnetFailover
• 基本認証から、Kerberos と Active Directory を使った統合認証に切り替える場合
  重要:

  Automation Suite の製品は、SQL データベースの接続文字列を更新する際に、テーブルやスキーマを作成しません。新しい接続文字列が、現在使用しているものと同じデータベースを参照していることを確認してください。

  更新プロセス中のダウンタイムを回避するために、更新プロセスの時点で現在の接続文字列が有効であることを確認してください。更新後に、古い接続文字列を取り消すことができます。

インストール済み製品の接続文字列を更新する

Automation Suite のインストール済み製品の接続文字列を更新するには、任意のサーバー ノードに接続し、次の操作を実行します。

1. cluster_config.json ファイルを生成します。
2. インストール済み製品の新しい接続文字列を指定します。
3. サービス インストーラーを実行します。

手順 1: cluster_config.json ファイルを生成する

次のように、最新の cluster_config.json ファイルを生成します。

• A: 古い cluster_config.json がある場合は、次のコマンドを使用して、クラスターから構成ファイルを生成します。

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

• B: 古い cluster_config.json ファイルがない場合は、次のコマンドを使用して、前のバージョンのインストール時に作成された既定値の上書きを生成します。

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

注: cluster_config.json パラメーターを設定する方法の詳細については、「高度なインストール」をご覧ください。

手順 2: インストール済み製品の新しい接続文字列を指定する

Automation Suite で実行される製品の接続文字列を指定する方法は 2 つあります。

• A: Automation Suite で実行されるすべての製品に共通する接続文字列テンプレートを指定します。この方法では、すべての製品に既定のデータベース名が使用されます。

• B: 各製品に固有の接続文字列を指定します。

重要:

.NET、JDBC、または ODBC のパスワードは、必ず次のようにエスケープしてください。

• .NET の場合: パスワードの先頭と末尾に ' を追加し、他のすべての ' を 2 個に増やします。

• JDBC/ODBC の場合: パスワードの先頭に { を追加し、末尾に } を追加し、他のすべての } を 2 個に増やします。

TrustServerCertificate=False を設定した場合、SQL Server 用に追加の CA 証明書を指定する必要が生じることがあります。SQL Server の証明書が自己署名証明書の場合、または社内 CA によって署名された証明書の場合はこれが必須になります。詳しくは、「CA 証明書を更新する」をご覧ください。

A: すべての製品に共通の接続文字列を指定する

Automation Suite で実行されるすべての製品は、共通のテンプレートの接続文字列を参照します。この方法を選択するユース ケースの 1 つとして、すべての製品のパスワードを一度に変更する場合があります。この場合、パスワードはすべての製品で同じになります。

このシナリオでは、すべての製品のデータベース名が、Automation Suite で必要とされる既定の名前である必要があります。設定したデータベース名が Automation Suite の要件を満たさない場合は、次の手順に従います。

ヒント:

データベースのリストとその既定の名前を確認します。

• シングルノードの評価モード: 「Microsoft SQL Server を構成する」

• マルチノードの HA 対応の運用モード: 「Microsoft SQL Server を構成する」

次の表は、製品サービスで使用できるテンプレート形式を示しています。

パラメーター	説明	製品
sql_connection_string_template	カタログ名を DB_NAME_PLACEHOLDER に設定した ADO.NET の完全な接続文字列。インストーラーは、このプレースホルダーを、インストールするスイートのサービスの既定データベース名に置き換えます。	Platform、Orchestrator、Test Manager、Automation Hub、Automation Ops、Insights、Task Mining、Data Service
sql_connection_string_template_jdbc	データベース名を DB_NAME_PLACEHOLDER に設定した JDBC の完全な接続文字列。インストーラーは、このプレースホルダーを、インストールするスイートのサービスの既定データベース名に置き換えます。	AI Center
sql_connection_string_template_odbc	データベース名を DB_NAME_PLACEHOLDER に設定した ODBC の完全な接続文字列。インストーラーは、このプレースホルダーを、インストールするスイートのサービスの既定データベース名に置き換えます。	Document Understanding

sql_connection_string_template の例

Server=tcp:sfdev1804627-c83f074b-sql.database.windows.net:1433;Initial Catalog=DB_NAME_PLACEHOLDER;Persist Security Info=False;User Id=testadmin;Password=***;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;Max Pool Size=100;

sql_connection_string_template_jdbc の例

jdbc:sqlserver://sfdev1804627-c83f074b-sql.database.windows.net:1433;database=DB_NAME_PLACEHOLDER;user=testadmin;password=***;encrypt=true;trustServerCertificate=false;Connection Timeout=30;hostNameInCertificate=sfdev1804627-c83f074b-sql.database.windows.net"

sql_connection_string_template_odbc の例

SERVER=sfdev1804627-c83f074b-sql.database.windows.net,1433;DATABASE=DB_NAME_PLACEHOLDER;DRIVER={ODBC Driver 17 for SQL Server};UID=testadmin;PWD=***;MultipleActiveResultSets=False;Encrypt=YES;TrustServerCertificate=NO;Connection Timeout=30;"

注: cluster_config.json を、更新する新しい接続文字列テンプレートで更新します。

B: 各製品に固有の接続文字列を指定する

プラットフォーム

Platform サービスは、組織とテナントの管理、ライセンス管理、ユーザー管理などの管理機能を提供します。Platform サービスは既定で有効化されており、削除することはできません。既定のデータベース名は AutomationSuite_Platform です。

Platform サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"platform": {
  "sql_connection_str": "***" // dotnet connection string 
}

Orchestrator

Orchestrator の既定のデータベース名は AutomationSuite_Orchestrator です。

Orchestrator サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"orchestrator": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Hub

Automation Hub の既定のデータベース名は AutomationSuite_Automation_Hub です。

Automation Suite サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"automation_hub": {
  "sql_connection_str": "***" // dotnet connection string
}

Automation Ops

Automation Ops の既定のデータベース名は AutomationSuite_Platform です。

Automation Ops サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"automation_ops": {
  "sql_connection_str": "***" // dotnet connection string
}

AI Center

AI Center の既定のデータベース名は AutomationSuite_AICenter です。

AI Center サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"aicenter": {
  "sql_connection_str": "***" // jdbc connection string
}

Data Service

Data Service の既定のデータベース名は AutomationSuite_DataService です。

Data Service サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"dataservice": {
  "sql_connection_str": "***" // dotnet connection string
}

Document Understanding

Document Understanding の既定のデータベース名は AutomationSuite_DU_Datamanager です。

Document Understanding サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"documentunderstanding": {
  "datamanager": {
    "sql_connection_str": "***" // odbc connection string
  }
}

Insights

Insights の既定のデータベース名は AutomationSuite_Insights です。

Insights サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"insights": {
  "sql_connection_str": "***" // dotnet connection string
}

Task Mining

Task Mining の既定のデータベース名は AutomationSuite_Task_Mining です。

Task Mining サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"task_mining": {
  "sql_connection_str": "***" // dotnet connection string
}

Test Manager

Test Manager の既定のデータベース名は AutomationSuite_Test_Manager です。

Test Manager サービスの接続文字列を指定するには、次のセクションを cluster_config.json ファイルに追加するか、更新します。

"test_manager": {
  "sql_connection_str": "***" // dotnet connection string
}

手順 3: サービス インストーラーを実行する

オンライン

サービス インストーラーをオンライン環境で実行するには、次のコマンドを使用します。

cd /opt/UiPathAutomationSuite/{version}/installer

./install-uipath.sh -i ./cluster_config.json -s -o output.json --accept-license-agreement

オフライン

サービス インストーラーをオフライン環境で実行するには、次のコマンドを使用します。

cd /opt/UiPathAutomationSuite/{version}/installer

./install-uipath.sh -i ./cluster_config.json -s --install-type offline -o output.json --accept-license-agreement

手順 4: Test Manager と Document Understanding のポッドを再起動する

注:

この手順が必要になるのは、Test Manager または Document Understanding の SQL 接続文字列を変更した場合のみです。

1. Test Manager/Document Understanding のポッドの全リストを取得します。

   // for Test Manager
   kubectl get pods -A | grep testmanager | awk '{print $2}'
   
   //for Document Understanding
   kubectl get pods -A | grep du-datamanager | awk '{print $2}'

2. リストのすべてのポッドを削除します。これにより、ポッドは強制的に適切な SQL 接続文字列で再起動します。

   kubectl delete pods <pod name>