Credenciales de actualización

Directrices

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

1. Genera el archivo input.json .
2. Proporcione las nuevas credenciales para los componentes dados en input.jsoncomo 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

Genera el último archivo input.jsonde la siguiente manera:

• 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.jsonanteriores y determinar el que deseas elegir:

  uipathctl manifest list-revisions

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. Genera el archivo input.json .
2. Proporcione las nuevas cadenas de conexión para los productos instalados en 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 duplicar cualquier otra '.
• para JDBC/ODBC: añade { al principio de la contraseña y } al final, y duplica cualquier otro }. No duplicar {.

Si configuras 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 está 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

Todos los productos que se ejecutan en Automation Suite hacen referencia a una cadena de conexión de plantilla común. Un caso práctico para elegir este método sería si desea cambiar la contraseña de todos los productos a la vez. Tenga en cuenta que, en este caso, la contraseña será la misma para todos los productos.

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: compruebe la lista de bases de datos y sus nombres predeterminados en la base de datos SQL.

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 sustituirá este marcador de posición por 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 sustituirá este marcador de posición por 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 sustituirá este marcador de posición por 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, Process Mining
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 (2024.10.3 o posterior)

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 (Process Mining 2024.10.3 o posterior)

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

Nota: Actualiza input.jsoncon la nueva plantilla de cadena de conexión que quieres actualizar.

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 para el servicio de 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.

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

"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 para el servicio de 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 para el 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 para el servicio de 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 para el servicio de 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 para el servicio de 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 para el 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
 "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 para el servicio de 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.

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

Para PostgreSQL:

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

Para Microsoft SQL Server:

"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

The default database name for Task Mining is AutomationSuite_Task_Mining.

Para proporcionar una cadena de conexión para el 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 para el 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 en el archivo input.jsoncon la nueva contraseña y/o nombre de host:

"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.jsoncon la nueva clave_acceso, clave_secreta o clave_cuenta y nombre_cuenta:

"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