- Información general
- Requisitos
- Instalación
- Comprobaciones de requisitos previos
- Descarga de los paquetes de instalación
- clúster uipathctl
- mantenimiento del clúster de uipathctl
- uipathctl cluster maintenance disable
- uipathctl cluster maintenance enable
- uipathctl cluster maintenance is-enabled
- uipathctl cluster migration
- uipathctl cluster migration export
- uipathctl cluster migration import
- uipathctl cluster migration run
- actualización del clúster de uipathctl
- configuración de uipathctl
- uipathctl config add-host-admin
- uipathctl config additional-ca-certificates
- uipathctl config additional-ca-certificates get
- uipathctl config additional-ca-certificates update
- Alertas de configuración de uipathctl
- Complemento de alertas de configuración de uipathctl
- uipathctl config alerts remove-email
- uipathctl config alerts update-email
- uipathctl config argocd
- uipathctl config argocd ca-certificates
- uipathctl config argocd ca-certificates get
- uipathctl config argocd ca-certificates update
- uipathctl config argocd generate-dex-config
- uipathctl config argocd generate-rbac
- uipathctl config argocd registry
- uipathctl config argocd registry get
- uipathctl config argocd registry update
- uipathctl config enable-basic-auth
- orchestrator de configuración de uipathctl
- get-config de uipathctl config del orquestador
- uipathctl config orchestrator update-config
- uipathctl config saml-certificates get
- uipathctl config saml-certificates rotate
- uipathctl config saml-certificates update
- uipathctl config tls-certificates
- uipathctl config tls-certificates get
- uipathctl config tls-certificates update
- uipathctl config token-signing-certificates
- uipathctl config token-signing-certificates get
- uipathctl config token-signing-certificates rotate
- uipathctl config token-signing-certificates update
- salud de uipathctl
- Paquete de salud de uipathctl
- comprobación de estado de uipathctl
- uipathctl health diagnose
- uipathctl health test
- manifiesto de uipathctl
- uipathctl manifest apply
- uipathctl manifest diff
- uipathctl manifest get
- uipathctl manifest get-revision
- lista de manifiesto de aplicaciones de uipathctl
- uipathctl manifest list-revisions
- uipathctl manifest render
- prerrequisito de uipathctl
- uipathctl prereq create
- uipathctl prereq run
- recurso uipathctl
- informe de recursos uipathctl
- instantánea de uipathctl
- copia de seguridad de instantánea de uipathctl
- uipathctl snapshot backup create
- uipathctl snapshot backup disable
- uipathctl snapshot backup enable
- uipathctl snapshot delete
- uipathctl snapshot list
- uipathctl snapshot restore
- uipathctl snapshot restore create
- uipathctl snapshot restore delete
- uipathctl snapshot restore history
- uipathctl snapshot restore logs
- versión de uipathctl
- Después de la instalación
- Migración y actualización
- Actualizar Automation Suite en EKS / AKS
- Paso 1: Mover los datos de la organización de identidad de independiente a Automation Suite
- Paso 2: restaurar la base de datos del producto independiente
- Paso 3: Realizar una copia de seguridad de la base de datos de la plataforma en Automation Suite
- Paso 4: Fusionar organizaciones en Automation Suite
- Paso 5: actualizar las cadenas de conexión de los productos migrados
- Paso 6: migrar el Orchestrator independiente
- Paso 7: migrar Insights independiente
- Paso 8: eliminar el tenant predeterminado
- B) Migración de tenant único
- Migrar de Automation Suite en Linux a Automation Suite en EKS / AKS
- Supervisión y alertas
- Administración de clústeres
- Realizar el mantenimiento de la base de datos
- Forwarding application logs to Splunk
- Configuración específica del producto
- Uso de la herramienta de configuración de Orchestrator
- Configurar parámetros de Orchestrator
- Configuración de Orchestrator
- Configurar AppSettings
- Configurar el tamaño máximo de la solicitud
- Anular la configuración de almacenamiento a nivel de clúster
- Configurar almacenes de credenciales
- Configurar clave de cifrado por tenant
- Solución de problemas
Realizar el mantenimiento de la base de datos
Es importante mantener las bases de datos ordenadas. Para ello, recomendamos:
La solución de mantenimiento de SQL Server es un conjunto de scripts que te permiten ejecutar copias de seguridad, comprobaciones de integridad y mantenimiento de índices y estadísticas en todas las ediciones de Microsoft SQL Server a partir de la versión 2005. Para obtener más detalles, consulta este proyecto de GitHub.
Recomendamos implementar copias de seguridad regulares de la base de datos de SQL Server, como copias de seguridad incrementales completas semanales o diarias.
Además, recomendamos utilizar el procedimiento almacenado en DatabaseBackup creado mediante el script en esta ubicación.
Cree una base de datos independiente en la que guardar los elementos antes de eliminarlos. Esta base de datos actúa como un archivo para los elementos que puede necesitar almacenar por ciertas razones, como las auditorías.
Cree una base de datos independiente en la que guardar los elementos antes de eliminarlos. Esta base de datos actúa como un archivo para los elementos que puede necesitar almacenar por ciertas razones, como las auditorías.
Limpieza de la base de datos
Los siguientes scripts reemplazan a todos y cada uno de los scripts de limpieza de bases de datos anteriores. Cubren todas las tareas de mantenimiento necesarias y pueden configurarse según las necesidades.
Puedes descargar los scripts de mantenimiento de la base de datos de Customer Portal.
Script SQL
Requisitos previos
CreateOrchestratorCleanupObjects.sql
:
-
Debes tener acceso a la base de datos de archivo desde el contexto de tu base de datos de Orchestrator.
-
Debes poder acceder al archivo utilizando nombres de 3 partes, como
Archive.dbo.QueueItemsTableArchive
.
Cómo usarla
CreateOrchestratorCleanupObjects.sql
para crear los siguientes objetos:
-
La tabla
dbo.__CleanupLog
, que alberga los registros de ejecución. -
El procedimiento
dbo.GetOrCreateArchiveTable
, que crea o devuelve la tabla de archivo. -
El procedimiento
dbo.RunOrchestratorCleanup
, que realiza la eliminación y, opcionalmente, el archivo de los datos antiguos.
dbo.RunOrchestratorCleanup
con el archivo de configuración XML de programación para realizar la limpieza.Para obtener más información sobre el archivo XML, consulta la sección Programar la limpieza a continuación.
También puedes utilizar el agente de SQL Server para realizar la limpieza.
Ejemplo de script
DECLARE @cleanupConfigXml XML =
'<CleanupConfig totalRunMaxMinutes="180">
<Table name="QueueItems" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="Status IN (2, 3, 4, 5, 6)" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="1" />
</CleanupConfig>';
EXEC dbo.RunOrchestratorCleanup
@cleanupConfigXml = @cleanupConfigXml,
@archiveDatabaseName = 'OrchestratorArchive';
DECLARE @cleanupConfigXml XML =
'<CleanupConfig totalRunMaxMinutes="180">
<Table name="QueueItems" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="Status IN (2, 3, 4, 5, 6)" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="1" />
</CleanupConfig>';
EXEC dbo.RunOrchestratorCleanup
@cleanupConfigXml = @cleanupConfigXml,
@archiveDatabaseName = 'OrchestratorArchive';
secuencia de comandos de powershell
Esto es adecuado para situaciones en las que no puedas utilizar el script SQL.
El script de PowerShell es compatible con Powershell 5.1 y se puede utilizar con los runbooks de automatización de Azure.
Requisitos previos
RunOrchestratorCleanup.ps1
debe poder comunicarse con estas dos cadenas de conexión:
-
SourceConnectionString
- esta es la cadena de conexión de base de datos de Orchestrator. -
DestinationConnectionString
- esta es la cadena de conexión de base de datos de archivo. Ten en cuenta que la base de datos de archivo debe crearse y configurarse con antelación.
Objetos que crea
-
La tabla
dbo.__CleanupLog
, que alberga los registros de ejecución. -
La tabla
dbo.__CleanupIds
, que almacena un lote temporal de ID que deben limpiarse.
Limitaciones
SourceConnectionString
) y una a la base de datos de archivo (a través de DestinationConnectionString
). Por ello, no se trata de ninguna transacción real, ya que los datos se copian de Orchestrator al archivo, después de lo cual se eliminan de Orchestrator.
Esto significa que si se produce una excepción en cualquier lugar entre las dos acciones, lo que hace que el script se vuelva a ejecutar, los mismos datos podrían copiarse de nuevo, lo que provocaría duplicados en la base de datos de archivo.
Sin embargo, como la singularidad no se aplica en la base de datos de archivo, esto no genera ningún problema.
Ejemplo de script
.\RunOrchestratorCleanup
-SourceConnectionString "Data Source=.;Initial Catalog=UiPath;User ID=sa;Password=******"
-DestinationConnectionString "Data Source=.;Initial Catalog=<OrchestratorArchive>;User ID=sa;Password=******"
-CleanupConfigXml '<CleanupConfig totalRunMaxMinutes="180"><Table name="QueueItems" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="Status IN (2, 3, 4, 5, 6)" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="1" /></CleanupConfig>'
.\RunOrchestratorCleanup
-SourceConnectionString "Data Source=.;Initial Catalog=UiPath;User ID=sa;Password=******"
-DestinationConnectionString "Data Source=.;Initial Catalog=<OrchestratorArchive>;User ID=sa;Password=******"
-CleanupConfigXml '<CleanupConfig totalRunMaxMinutes="180"><Table name="QueueItems" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="Status IN (2, 3, 4, 5, 6)" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="1" /></CleanupConfig>'
Programación de la limpieza
Puedes elegir qué datos limpiar de tu base de datos, cuándo y durante cuánto tiempo se debe realizar la actividad de limpieza para cada ejecución, entre otros.
Para ello, utiliza el siguiente archivo XML con el SQL o el script de PowerShell. Está preconfigurado con nuestros parámetros recomendados, pero puedes editarlo si quieres características más avanzadas. Asegúrate de comprender lo que hace cada parámetro antes de editar el script, ya que esto puede tener consecuencias graves.
<CleanupConfig totalRunMaxMinutes="180">
<Table name="QueueItems" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="Status IN (2, 3, 4, 5, 6)" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="1" />
<Table name="Jobs" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="State IN (4, 5, 6)" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="1" />
<Table name="Logs" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="TimeStamp" additionalFilter="" daysOld="90" batchSize="1000" forceCascade="0" shouldArchive="1" />
<Table name="AuditLogs" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="ExecutionTime" additionalFilter="" daysOld="365" batchSize="25" forceCascade="1" shouldArchive="1" />
<Table name="Tasks" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="DeletionTime" additionalFilter="IsDeleted = 1" daysOld="180" batchSize="10" forceCascade="0" shouldArchive="1" />
<Table name="QueueProcessingRecords" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="ProcessingTime" additionalFilter="ReportType != -1" daysOld="30" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="Sessions" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="ReportingTime" additionalFilter="" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="0" />
<Table name="RobotLicenseLogs" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="StartDate" additionalFilter="" daysOld="180" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="UserNotifications" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="" daysOld="90" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="TenantNotifications" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="" daysOld="90" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="Ledger" runMaxMinutes="-1" idColumn="LedgerId" dateTimeColumn="CreationTime" additionalFilter="" daysOld="7" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="LedgerDeliveries" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="LastUpdatedTime" additionalFilter="" daysOld="7" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="__CleanupLog" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="ExecutionTimeUtc" additionalFilter="" daysOld="7" batchSize="1000" forceCascade="0" shouldArchive="0" />
</CleanupConfig>
<CleanupConfig totalRunMaxMinutes="180">
<Table name="QueueItems" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="Status IN (2, 3, 4, 5, 6)" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="1" />
<Table name="Jobs" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="State IN (4, 5, 6)" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="1" />
<Table name="Logs" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="TimeStamp" additionalFilter="" daysOld="90" batchSize="1000" forceCascade="0" shouldArchive="1" />
<Table name="AuditLogs" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="ExecutionTime" additionalFilter="" daysOld="365" batchSize="25" forceCascade="1" shouldArchive="1" />
<Table name="Tasks" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="DeletionTime" additionalFilter="IsDeleted = 1" daysOld="180" batchSize="10" forceCascade="0" shouldArchive="1" />
<Table name="QueueProcessingRecords" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="ProcessingTime" additionalFilter="ReportType != -1" daysOld="30" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="Sessions" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="ReportingTime" additionalFilter="" daysOld="180" batchSize="50" forceCascade="1" shouldArchive="0" />
<Table name="RobotLicenseLogs" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="StartDate" additionalFilter="" daysOld="180" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="UserNotifications" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="" daysOld="90" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="TenantNotifications" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="CreationTime" additionalFilter="" daysOld="90" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="Ledger" runMaxMinutes="-1" idColumn="LedgerId" dateTimeColumn="CreationTime" additionalFilter="" daysOld="7" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="LedgerDeliveries" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="LastUpdatedTime" additionalFilter="" daysOld="7" batchSize="1000" forceCascade="0" shouldArchive="0" />
<Table name="__CleanupLog" runMaxMinutes="-1" idColumn="Id" dateTimeColumn="ExecutionTimeUtc" additionalFilter="" daysOld="7" batchSize="1000" forceCascade="0" shouldArchive="0" />
</CleanupConfig>
Incluso si una ejecución solo consigue limpiar parcialmente una o algunas tablas, las ejecuciones posteriores continuarán la limpieza, hasta que el script se ponga al día con todo el trabajo atrasado. Por lo tanto, es importante que no acumules un retraso mayor del que el script puede gestionar. Si esto sucede, valora la posibilidad de programar el script para que se ejecute con más frecuencia.
Parámetros del XML de limpieza
Parámetro |
Explicación |
Valores posibles |
---|---|---|
|
El número máximo de minutos que el script puede ejecutarse para todas las tablas durante una ejecución. |
Debe ser mayor que 1. |
|
El nombre de la tabla que contiene los datos que quieres eliminar. |
Ejemplo:
QueueItems |
|
El número máximo de minutos que el script puede ejecutarse para una tabla en particular durante una ejecución. Importante:
La cantidad de tiempo que establezcas aquí a veces puede durar un par de minutos más. Además de eso, el valor
totalRunMaxMinutes tiene prioridad y siempre se aplicará, incluso si estableces este parámetro en -1 .
|
-1 : el script se ejecutará durante un número ilimitado de minutos.
0 : el script no se ejecutará para esa tabla en particular.
>0 (es decir, un número elegido por ti): el número máximo de minutos que el script se ejecutará.
|
|
El ID de la columna que contiene los datos que quieres eliminar. |
Ejemplo:
Id de la tabla QueueItems
|
|
Esto difiere en función del tipo de datos. Se utiliza en combinación con
daysOld .
|
Ejemplo:
CreationTime para QueueItems |
|
Cualquier instrucción SQL válida para un filtro. Esto se puede dejar vacío. |
Ejemplo:
Status IN (2, 3, 4, 5, 6) . Esto se incluye en el archivo XML recomendado por nosotros.
|
daysOld |
Te permite mantener un cierto número de días de datos . Se utiliza en combinación con
dateTimeColumn .
|
Esto debe establecerse en un mínimo de
2 .
Ejemplo: establecer este parámetro en
5 mantiene todos los datos que tienen 5 días de antigüedad.
|
|
El número de filas de la tabla que se eliminarán en una iteración. Importante:
Esto no se utiliza para las tablas donde se definen claves extranjeras. |
Ejemplo: establecer este parámetro en
50 para la tabla QueueItems elimina 50 elementos de esa tabla en particular.
|
forceCascade |
Te permite ejecutar el script para las tablas donde se definen claves extranjeras. Importante:
El ejemplo ya usa
forceCascade para las tablas donde es necesario. Por lo tanto, no necesitas cambiarlo.
|
0 : no en cascada.
1 : en cascada. Por ejemplo, establecer esta opción para la tabla QueueItems procesará tanto las tablas QueueItemEvents como las tablas QueueItemComments .
|
shouldArchive |
Te permite elegir si quieres archivar los datos. |
0 : no archivar.
1 : archivar.
|
Scripts de SQL y PowerShell comparados
Función | Script SQL | secuencia de comandos de powershell |
---|---|---|
XML de limpieza |
Ambos utilizan la lógica descrita en la sección Programar la limpieza. | |
Registro de ejecución |
Ambos crean una tabla
dbo.__CleanupLogs para almacenar los registros de la ejecución.
Puedes consultar los registros de una ejecución utilizando
SELECT * FROM dbo.__CleanupLog WHERE ExecutionId = '<execution_id>' ORDER BY Id .
Puedes comprobar si una ejecución contenía errores utilizando
SELECT * FROM dbo.__CleanupLog WHERE ExecutionId = '<execution_id>' AND IsError = 1 .
El parámetro
ExecutionId se genera con cada ejecución de cualquiera de estos scripts.
| |
Tabla de archivo |
La tabla de archivo no contiene ningún índice, claves extranjeras ni columnas de identidad. Las columnas de tipo de marca de tiempo no se archivan. | |
Nombre de la tabla de archivo |
Los nombres siguen la misma lógica e incluyen una cadena basada en el esquema de la tabla. | |
Lote de ID que se archivarán/eliminarán |
Almacenado en una tabla temporal. |
Almacenado en la tabla
dbo.__CleanupIds .
|
Transaction |
Se realiza una sola transacción para cada lote, durante la cual los datos se archivan y se eliminan. El tamaño del lote, es decir, el número de filas de la tabla que se procesarán, se define en el archivo XML, a través del parámetro
batchSize .
|
SqlBulkCopy se utiliza para copiar los datos. No existe una transacción única realizada para el archivo y la eliminación. |