Credenciales de actualización

Directrices

Para actualizar las credenciales de los diferentes componentes de Automation Suite , siga estos pasos:

1. Genere el archivo input.json .
2. Proporciona las nuevas credenciales para los componentes dados en el input.json como se describe en la sección de cada componente.
3. Ejecuta la CLI uipathctlcomo se describe en cada sección de componente.

Generando el archivo input.json

Generate the latest input.json file as follows:

• R: Ejecuta el siguiente comando para obtener la última revisión de tu archivo input.json :

  uipathctl manifest get-revision
  

• B: Ejecuta el siguiente comando para enumerar todos los archivos input.json anteriores y determinar el que deseas elegir:

  uipathctl manifest list-revisions
  

Guidelines

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. Genere el archivo input.json .
2. Proporciona las nuevas cadenas de conexión para los productos instalados en el input.json.
3. Ejecutar uipathctl.

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 '.
• 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.

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 las bases de datos para todos los productos deben ser los predeterminados, como requiere Automation Suite. Si los nombres de las bases de datos que configuraste no cumplen con los requisitos de Automation Suite, sigue el siguiente paso.

Consejo:

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

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 la suite de automatización, Gestor de pruebas, Automation Hub, Automation Ops, Insights, Task Mining, Data Service, Process Mining
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.	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:07%3Cl%5Bxj-%3D~[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

Nota:

Update the input.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 input.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 input.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 input.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 input.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 input.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 input.json:

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

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 input.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 input.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 input.json:

"documentunderstanding": {
"enabled": true,
"sql_connection_str": "***" // dotnet connection string,
"datamanager": {
 "sql_connection_str": "***" // odbc 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 input.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 input.json file:

"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

El nombre de base de datos predeterminado para Task Mining es AutomationSuite_Task_Mining.

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

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

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 input.json:

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

Ejecutar el instalador de uipathctl

Para completar la actualización, ejecuta el instalador uipathctl utilizando el siguiente comando:

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

Actualizar las credenciales de Redis

Proporcionar las nuevas credenciales para Redis

Actualiza la siguiente sección del archivo input.json con la contraseña o el nombre de host nuevos:

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

Ejecutar el instalador de uipathctl

Para completar la actualización de las credenciales de Redis, ejecuta el instalador uipathctl con el siguiente comando:

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

Nota:

Puede utilizar la marca de ensayo de ejecución con uipathctl para imprimir el resultado del comando sin aplicarlo.

Actualizar las credenciales del objectstore

Actualiza la siguiente sección en el archivo input.json con la nueva access_key, secret_key o acount_key y account_name:

"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>
},

Ejecutar el instalador de uipathctl

Para completar la actualización de las credenciales del almacén de objetos, ejecuta el instalador uipathctl con el siguiente comando:

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

Nota:

Puede utilizar la marca de ensayo de ejecución con uipathctl para imprimir el resultado del comando sin aplicarlo.

Actualizar las credenciales de registro

Cuando el registro del contenedor en uso requiere la autenticación para extraer imágenes, los pods deben utilizar un secreto llamado uipathpullsecret. Para actualizar uipathpullsecret, sigue los siguientes pasos:

1. Actualizar la sección de registro del archivo input.json:

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

2. Eliminar el existente uipathpullsecret:

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

3. Volver a ejecutar el comando de instalación:

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