Actualizar las cadenas de conexión SQL

Hay varios escenarios en los que es posible que desee actualizar la cadena de conexión utilizada por los productos de Automation Suite para conectarse a la base de datos SQL, como los siguientes:

• Al rotar periódicamente la contraseña utilizada para conectarse a la base de datos, por seguridad y cumplimiento

• Al cambiar el FQDN para el servidor SQL

• Al migrar la base de datos a otro servidor SQL con fines de mantenimiento

• Al añadir, modificar o eliminar uno o más atributos de conexión, como MultiSubnetFailover

• Al cambiar de la autenticación básica a la autenticación integrada mediante Kerberos y AD

  Importante:

  Los productos de Automation Suite no crean tablas o esquemas en el momento de actualizar la cadena de conexión de la base de datos SQL. Asegúrese de que su nueva cadena de conexión haga referencia a la misma base de datos que usa actualmente.

  Para evitar tiempo de inactividad durante el proceso de actualización, asegúrese de que su cadena de conexión actual sea válida en el momento del proceso de actualización. Puede revocar su cadena de conexión anterior después de la actualización.

Actualizar las cadenas de conexión para los productos instalados

Para actualizar la cadena de conexión de los productos instalados en Automation Suite, conéctese a cualquiera de los nodos del servidor y realice las siguientes operaciones.

1. Si utilizas la configuración de política de umbral de bloqueo de la cuenta, habilita el modo de mantenimiento.
2. Genere el archivo cluster_config.json .
3. Proporciona las nuevas cadenas de conexión para los productos instalados en el cluster_config.json.
4. Ejecuta el instalador.
5. Si utilizas la configuración de política de umbral de bloqueo de la cuenta, deshabilita el modo de mantenimiento.

Generando el archivo cluster_config.json

Genere el archivo cluster_config.json más reciente usando el siguiente comando:

./bin/uipathctl manifest get-revision > ./cluster_config.json

Nota:

Para obtener más información sobre cómo configurar los parámetros de cluster_config.json , consulta Experiencia de instalación avanzada.

Proporcionar las nuevas cadenas de conexión para los productos instalados

Hay dos formas de proporcionar las cadenas de conexión para productos que se ejecutan en Automation Suite:

• R: Proporcione una plantilla de cadena de conexión que será común para todos los productos que se ejecutan en Automation Suite. Este enfoque asumirá los nombres de las bases de datos predeterminadas para todos los productos.
• B: proporciona cadenas de conexión específicas para cada producto.

Importante:

Asegúrate de escapar de las contraseñas NET, JDBC u ODBC de la siguiente manera:

• para NET: añade ' al principio y al final de la contraseña, y duplica cualquier otra '.
• para JDBC/ODBC: añade { al principio de la contraseña y } al final, y duplica cualquier otra }. No duplicar {.

Si estableces TrustServerCertificate=False, es posible que tengas que proporcionar un certificado de CA adicional para SQL Server. Esto es necesario si el certificado de SQL Server está autofirmado o firmado por una CA interna. Para obtener más información, consulta Actualizar los certificados de CA.

Para codificar o decodificar cadenas Base64 utilizando PowerShell, puedes utilizar los siguientes comandos:

• decodificar cadena Base64: [System.Text.Encoding]::Default.GetString([System.Convert]::FromBase64String('<base64_string>'))
• codificar cadena Base64: [System.Convert]::ToBase64String([System.Text.Encoding]::Default.GetBytes('<plain_text>'))

R: Proporcionar una cadena de conexión común para todos los productos

All the products running in Automation Suite refer to a common template connection string. One use case for choosing this method would be when you want to change the password for all the products at once. Note that, in this case, the password will be the same for all the products.

En estos escenarios, los nombres de la base de datos para todos los productos deben ser los predeterminados, según lo requiera Automation Suite. Si los nombres de las bases de datos que configuraste no cumplen los requisitos de Automation Suite, sigue el siguiente paso.

Consejo:

Compruebe la lista de bases de datos y sus nombres predeterminados:

• Evaluación de nodo único: configurar Microsoft SQL Server
• Producción multinodo preparada para alta disponibilidad: configurar Microsoft SQL Server

La siguiente tabla explica qué formato de plantilla aceptan los servicios del producto:

Parámetro	Descripción	Productos
sql_connection_string_template	Cadena de conexión ADO.NET completa en la que el nombre del catálogo se establece como DB_NAME_PLACEHOLDER. El instalador reemplazará este marcador de posición con los nombres de base de datos predeterminados para los servicios de la suite instalada.	Plataforma, Orchestrator, Robots de Automation Suite, Test Manager, Automation Hub, Automation Ops, Insights, Data Service, Process Mining, ECS, Puerta de enlace de LLM, Observabilidad de LLM, Soluciones
sql_connection_string_template_jdbc	Cadena de conexión JDBC completa donde el nombre de la base de datos se establece en DB_NAME_PLACEHOLDER. El instalador reemplazará este marcador de posición con los nombres de base de datos predeterminados para los servicios de la suite instalada.	AI Center
sql_connection_string_template_odbc	Cadena de conexión ODBC completa en la que el nombre de la base de datos está establecido en DB_NAME_PLACEHOLDER. El instalador reemplazará este marcador de posición con los nombres de base de datos predeterminados para los servicios de la suite instalada.	Document Understanding, Apps
sql_connection_string_template_sqlalchemy_pyodbc	Cadena de conexión PYODBC de alquimia SQL completa donde el nombre de la base de datos se establece en DB_NAME_PLACEHOLDER. El instalador reemplazará este marcador de posición con los nombres de base de datos predeterminados para los servicios de la suite instalada.	Document Understanding
postgresql_connection_string_template_sqlalchemy_pyodbc	Cadena de conexión PSYCOPG2 de alquimia SQL completa donde el nombre de la base de datos se establece en DB_NAME_PLACEHOLDER. El instalador reemplazará este marcador de posición con los nombres de base de datos predeterminados para los servicios de la suite instalada.	Process Mining

ejemplo: plantilla_cadena_conexión_sql

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;

ejemplo: plantilla_cadena_conexión_jdbc_sql

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"

ejemplo: plantilla_cadena_conexión_odjbc_sql

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

Ejemplo de sql_connection_string_template_sqlalchemy_pyodbc

"mssql+pyodbc://testadmin%40sfdev4515230-sql.database.windows.net:<password>@sfdev4515230-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

Ejemplo de postgresql_connection_string_template_sqlalchemy_pyodbc

"postgresql+psycopg2://testadmin:<password>@sfdev8454496-postgresql.postgres.database.azure.com:5432/DB_NAME_PLACEHOLDER"

Nota:

Update the cluster_config.json with the new connection string template you want to update.

B: Proporcionar cadenas de conexión específicas para cada producto

Plataforma

El servicio de la Plataforma proporciona capacidades administrativas como la gestión de la organización y los tenants, la gestión de las licencias, la gestión de los usuarios, etc. El servicio de la plataforma está habilitado de forma predeterminada y no se puede eliminar. Su nombre de base de datos predeterminado es AutomationSuite_Platform.

Para proporcionar una cadena de conexión para el servicio de la Plataforma, añade o actualiza la siguiente sección en el archivo cluster_config.json :

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

Orchestrator

El nombre de la base de datos predeterminada para Orchestrator es AutomationSuite_Orchestrator.

Para proporcionar una cadena de conexión al servicio Orchestrator, añade o actualiza la siguiente sección en el archivo cluster_config.json:

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

Automation Suite Robots

Automation Suite Robots and Orchestrator share the same database by default. The database name is AutomationSuite_Orchestrator.

To provide a connection string for Automation Suite Robots, add or update the following section in the cluster_config.json file:

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

Automation Hub

El nombre de la base de datos predeterminada para Automation Hub es AutomationSuite_Automation_Hub.

Para proporcionar una cadena de conexión al servicio Automation Suite, añade o actualiza la siguiente sección en el archivo cluster_config.json:

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

Automation Ops

El nombre de base de datos predeterminado para Automation Ops es AutomationSuite_Platform.

Para proporcionar una cadena de conexión al servicio Automation Ops, añade o actualiza la siguiente sección en el archivo cluster_config.json:

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

AI Center

El nombre de base de datos predeterminado para AI Center es AutomationSuite_AICenter.

Para proporcionar una cadena de conexión al servicio AI Center, añade o actualiza la siguiente sección en el archivo cluster_config.json:

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

Importante:

Para habilitar FIPS 140-2 en la máquina en la que está instalado AI Center, debes anexar lo siguiente a sql_connection_string_template_jdbc: encrypt=true;trustServerCertificate=false;fips=true;

Apps

El nombre predeterminado de la base de datos para Apps es AutomationSuite_Apps.

Para proporcionar una cadena de conexión al servicio Apps, añade o actualiza la siguiente sección en el archivo cluster_config.json:

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

Data Service

El nombre predeterminado de la base de datos para Data Service es AutomationSuite_DataService.

Para proporcionar una cadena de conexión al servicio Data Service, añade o actualiza la siguiente sección en el archivo cluster_config.json:

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

Document Understanding

El nombre de la base de datos predeterminada para Document Understanding es AutomationSuite_DU_Datamanager.

Para proporcionar una cadena de conexión al servicio Document Understanding, añade o actualiza la siguiente sección en el archivo cluster_config.json:

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

Insights

El nombre de base de datos predeterminado para Insights es AutomationSuite_Insights.

Para proporcionar una cadena de conexión al servicio Insights, añade o actualiza la siguiente sección en el archivo cluster_config.json:

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

Process Mining

The default database name for Process Mining is AutomationSuite_ProcessMining_Metadata.

To provide a connection string for the Process Mining service, add or update the following section in the cluster_config.json file:

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

Test Manager

El nombre de base de datos predeterminado para Test Manager es AutomationSuite_Test_Manager.

Para proporcionar una cadena de conexión al servicio Test Manager, añade o actualiza la siguiente sección en el archivo cluster_config.json:

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

Servicios de integración

El nombre predeterminado de la base de datos para Integration Services es AutomationSuite_Integration_Services .

Para proporcionar una cadena de conexión, añade o actualiza la siguiente sección en el archivo cluster_config.json :

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

Ejecutar el instalador

Para ejecutar el instalador, utiliza el siguiente comando:

cd /opt/UiPathAutomationSuite/{version}/installer

./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json