更新 SQL 连接字符串

在多种情况下，您可能需要更新 Automation Suite 产品用于连接 SQL 数据库的连接字符串，例如：

• 出于安全性和合规性考虑，定期轮换用于连接到数据库的密码时

• 更改 SQL Server 的 FQDN 时

• 出于维护目的将数据库迁移到另一个 SQL Server 时

• 添加、修改或删除一个或多个连接属性，例如MultiSubnetFailover

• 从基本身份验证切换到使用 Kerberos 和 AD 的集成身份验证时

  重要提示：

  Automation Suite 中的产品在更新 SQL 数据库连接字符串时不会创建表或架构。 确保新的连接字符串引用您当前使用的同一数据库。

  为避免在更新过程中出现停机，请确保当前连接字符串在更新过程中有效。 您可以在更新后撤销旧的连接字符串。

更新已安装产品的连接字符串

要更新 Automation Suite 中已安装产品的连接字符串，请连接到任何服务器节点并执行以下操作。

1. 生成 cluster_config.json 文件。
2. 为已安装的产品提供新的连接字符串。
3. 运行服务安装程序。

步骤 1：生成 cluster_config.json 文件

生成最新的 cluster_config.json 文件，如下所示：

• 答：如果您有旧的 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
  

备注：

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

步骤 2：为已安装的产品提供新的连接字符串

有两种方法可以为 Automation Suite 中运行的产品提供连接字符串：

• 答：提供一个对在 Automation Suite 中运行的所有产品通用的连接字符串模板。 此方法将假定所有产品的默认数据库名称。
• B：提供特定于每个产品的连接字符串。

重要提示：

请确保对 NET、JDBC 或 ODBC 密码进行转义，如下所示：

• 对于 NET：在密码的开头和结尾添加' ，并将任何其他'添加一倍。
• for JDBC/ODBC: add { at the beginning of the password and } at the end, and double any other }.

If you set TrustServerCertificate=False, then you may have to provide an additional CA certificate for the SQL Server. This is required if the SQL Server certificate is self-signed or signed by an internal CA. For details, see Updating the CA certificates.

答：为所有产品提供通用连接字符串

Automation Suite 中运行的所有产品都引用一个通用模板连接字符串。 选择此方法的一个用例是，您想一次更改所有产品的密码。请注意，在这种情况下，所有产品的密码都相同。

在这种情况下，所有产品的数据库名称必须是默认名称，这是 Automation Suite 的要求。 如果您配置的数据库名称不满足 Automation Suite 要求，请执行下一步。

提示：

检查数据库列表及其默认名称：

• Single-node evaluation: Configuring Microsoft SQL server
• Multi-node HA-ready production: Configuring Microsoft SQL Server

下表说明了产品服务接受的模板格式：

参数	描述	产品
sql_connection_string_template	完整的 ADO.NET 连接字符串，其中目录名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	平台、Orchestrator、Test Manager、Automation Hub、Automation Ops、Insights、Task Mining、Data Service
sql_connection_string_template_jdbc	完整的 JDBC 连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	AI Center
sql_connection_string_template_odbc	完整的 ODBC 连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	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 的 Pod

备注：

仅当您修改了 Test Manager 或 Document Understanding 的 SQL 连接字符串时，才需要执行此步骤。

1. 获取所有 Test Manager/Document Understanding Pod 的列表：

   // 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. 删除所有列出的 Pod。这将强制 Pod 使用正确的 SQL 连接字符串重新启动。

   kubectl delete pods <pod name>