更新凭据

准则

要更新不同 Automation Suite 组件的凭据，请执行以下步骤：

1. 生成 input.json 文件。
2. 在 input.json 中提供给定组件的新凭据，如每个组件部分中所述。
3. 按照每个组件部分中的说明运行 uipathctl CLI。

生成 input.json 文件

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

• 答：运行以下命令以获取input.json文件的最新修订：

  uipathctl manifest get-revision
  

• B ：运行以下命令，以列出所有过去的input.json文件，并确定要选择的文件：

  uipathctl manifest list-revisions
  

Guidelines

更新 SQL 连接字符串

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

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

• 更改 SQL Server 的 FQDN 时

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

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

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

  重要提示：

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

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

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

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

1. 生成 input.json 文件。
2. 在input.json中为已安装的产品提供新的连接字符串。
3. 运行 uipathctl。

为已安装的产品提供新的连接字符串

有两种方法可以为 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 要求，请执行下一步。

提示：

Check the list of databases and their default names in SQL database.

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

参数	描述	产品
sql_connection_string_template	完整的 ADO.NET 连接字符串，其中目录名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	Platform、Orchestrator、Automation Suite Robots、Test Manager、Automation Hub、Automation Ops、Insights、Task Mining、Data Service、Process Mining
sql_connection_string_template_jdbc	完整的 JDBC 连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	AI Center
sql_connection_string_template_odbc	完整的 ODBC 连接字符串，其中数据库名称设置为 DB_NAME_PLACEHOLDER。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	Document Understanding、Apps
sql_connection_string_template_sqlalchemy_pyodbc	完整的 SQL alchemy ODBC连接字符串，其中数据库名称设置为DB_NAME_PLACEHOLDER 。安装程序将使用已安装的套件服务的默认数据库名称替换此占位符。	Process Mining

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;"

sql_connection_string_template_sqlalchemy_pyodbc 示例

"mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:07%3Cl%5Bxj-%3D~[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

备注：

使用要更新的新连接字符串模板更新input.json 。

B：提供特定于每个产品的连接字符串

平台

Platform 服务提供管理功能，例如组织和租户管理、许可管理、用户管理等。 Platform 服务默认处于启用状态，并且无法删除。 其默认数据库名称为AutomationSuite_Platform 。

要为 Platform 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

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

Orchestrator

Orchestrator 的默认数据库名称为AutomationSuite_Orchestrator 。

要为 Orchestrator 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

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

Automation Suite 机器人

默认情况下，Automation Suite 机器人和 Orchestrator 共享同一数据库。 数据库名称为AutomationSuite_Orchestrator 。

要为 Automation Suite 机器人提供连接字符串，请在input.json文件中添加或更新以下部分：

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

Automation Hub

Automation Hub 的默认数据库名称为AutomationSuite_Automation_Hub 。

要为 Automation Suite 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

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

Automation Ops

Automation Ops 的默认数据库名称为AutomationSuite_Platform 。

要为 Automation Ops 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

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

AI Center

AI Center 的默认数据库名称为AutomationSuite_AICenter 。

要为 AI Center 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

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

Apps

Apps 的默认数据库名称为 AutomationSuite_Apps。

要为 Apps 服务提供连接字符串，请在 input.json 文件中添加或更新以下部分：

"apps": {
  "sql_connection_str": "***" // odbc connection string
}

Data Service

Data Service 的默认数据库名称为AutomationSuite_DataService 。

要为 Data Service 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

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

Document Understanding

Document Understanding 的默认数据库名称为AutomationSuite_DU_Datamanager 。

要为 Document Understanding 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

"documentunderstanding": {
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"datamanager": {
 "sql_connection_str": "***" // odbc connection string
 }
}

Insights

Insights 的默认数据库名称为AutomationSuite_Insights 。

要为 Insights 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

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

Process Mining

Process Mining 的默认数据库名称为AutomationSuite_ProcessMining_Metadata 。

要为 Process Mining 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

"process_mining": {
  "enabled": true,
  "sql_connection_str": "***" // dotnet connection string
  "sqlalchemy_pyodbc_sql_connection_str": "",
  "warehouse": {
     "sql_connection_str": "",
     "master_sql_connection_str": "",
     "sqlalchemy_pyodbc_sql_connection_str": ""
  }
}

Task Mining

Task Mining 的默认数据库名称为AutomationSuite_Task_Mining。

要为 Task Mining 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

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

Test Manager

Test Manager 的默认数据库名称为 AutomationSuite_Test_Manager。

要为 Test Manager 服务提供连接字符串，请在input.json文件中添加或更新以下部分：

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

运行 uipathctl 安装程序

要完成更新，请使用以下命令运行uipathctl安装程序：

uipathctl manifest apply input.json --versions versions.json

更新 Redis 凭据

为 Redis 提供新凭据

使用新密码和/或主机名更新 input.json 文件中的以下部分：

"fabric": {
  "redis": {
    "hostname": "new_hostname",
    "password": "new_password",
    "port": 6380,
    "tls": true
  }

运行 uipathctl 安装程序

要完成 Redis 凭据的更新，请使用以下命令运行 uipathctl 安装程序：

uipathctl manifest apply input.json --only redis --versions versions.json

备注：

您可以将空运行标志与 uipathctl 一起使用，以打印命令的结果，而无需应用它。

更新对象存储凭据

使用新的 access_key、secret_key 或 acount_key 和 account_name 更新 input.json 文件中的以下部分：

"external_object_storage": {
  "enabled": false, // <true/false>
  "create_bucket": true, // <true/false>
  "storage_type": "s3", // <s3,azure,aws>
  "fqdn": "",  // <needed in case of aws non instance profile>
  "port": 443, // <needed in case of aws non instance profile>
  "region": "",
  "access_key": "", // <needed in case of aws non instance profile>
  "secret_key": "", // <needed in case of aws non instance profile>
  "use_managed_identity": false, // <true/false>
  "bucket_name_prefix": "",
  "bucket_name_suffix": "",
  "account_key": "", // <needed only when using non managed identity>
  "account_name": "",
  "azure_fqdn_suffix": "core.windows.net",
  "client_id": "" // <optional field in case of managed identity>
},

运行 uipathctl 安装程序

要完成对象存储凭据的更新，请使用以下命令运行 uipathctl 安装程序：

uipathctl manifest apply input.json --versions versions.json

备注：

您可以将空运行标志与 uipathctl 一起使用，以打印命令的结果，而无需应用它。

更新注册表凭据

当使用的容器注册表要求身份验证才能拉取映像时，Pod 必须使用名为 uipathpullsecret 的密码。要更新 uipathpullsecret，请执行以下步骤：

1. 更新 input.json 文件的注册表部分：

     "registries": {
       "docker": {
         "url": "yourContainerRegistryUrl",
         "username": "username",
         "password": "newpassword"
       },
       "helm": {
         "url": "yourContainerRegistryUrl",
         "username": "username",
         "password": "newpassword"
       }
     }
   

2. 删除现有的 uipathpullsecret：

   kubectl delete secret  uipathpullsecret -n uipath
   kubectl delete secret  uipathpullsecret -n uipath-installer
   

3. 重新运行安装命令：

   uipathctl manifest apply input.json --versions versions.json