Modo de producción multinodo preparado para HA en línea

Preparación

1. Identifique cualquier servidor (no agente) que cumpla los requisitos del disco para una instalación en línea. En este documento nos referiremos a él como servidor principal. Si utiliza un certificado autofirmado, ejecute el siguiente comando:

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   sudo ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   
   ### Update the trust store
   sudo update-ca-trust

2. Descargue y descomprima el nuevo instalador (installer.zip) en todos los nodos.
   Aviso: Otorga los permisos adecuados a la carpeta ejecutando sudo chmod 755 -R <installer-folder>.
3. Haga que el archivo cluster_config.json original esté disponible en el servidor principal.
4. Genere el nuevo archivo cluster_config.json de la siguiente manera:
   • Si tiene el archivo cluster_config.json antiguo, utilice el siguiente comando para generar el archivo de configuración desde el clúster:

     cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

   • Si no tiene el archivo antiguo de configuración, ejecute el siguiente comando:

     cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

     Nota: Consulte Experiencia de instalación avanzada para completar los parámetros restantes.
5. Copie este archivo cluster_config.json en la carpeta del instalador en todos los nodos.

Ejecución

Mantenimiento y copia de seguridad

1. Asegúrese de haber activado la copia de seguridad en el clúster. Para obtener más detalles, consulta Activar la copia de seguridad del clúster.
2. Conéctese a uno de los nodos de servidor mediante SSH.
3. Compruebe que todos los volúmenes deseados tengan copias de seguridad en el clúster ejecutando /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup.
   Aviso: La copia de seguridad puede tardar algún tiempo, así que espera de 15 a 20 minutos y vuelve a verificar la copia de seguridad de los volúmenes.
4. Para verificar si Automation Suite está en buen estado, ejecute:

   kubectl get applications -n argocd

5. Ponga el clúster en modo de mantenimiento de la siguiente manera:
   1. Ejecute el siguiente comando:

      /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

   2. Comprueba que el clúster está en modo de mantenimiento ejecutando el siguiente comando:

      /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

6. Cree la copia de seguridad de la base de datos SQL.

Actualizar la infraestructura en los servidores

1. Conéctese a cada servidor mediante SSH.
2. Obtenga acceso a la raíz ejecutando sudo su -.
3. Ejecute el siguiente comando en todos los servidores:

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

Como parte de este comando, también se toma la copia de seguridad del estado del clúster y se pausan todas las copias de seguridad posteriores programadas.

Aviso: Este comando también crea una copia de seguridad del estado del clúster y pausa el resto de copias de seguridad programadas.

Actualizar la infraestructura en los agentes

1. Conéctese a cada servidor mediante SSH.
2. Obtenga acceso a la raíz ejecutando sudo su -.
3. Ejecute el siguiente comando:

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

Ejecutar el resto de la actualización en el servidor principal

1. Conéctese al servidor principal mediante SSH.
2. Obtenga acceso a la raíz ejecutando sudo su -.
3. Ejecute el siguiente comando:

   /path/to/new-installer/install-uipath.sh --upgrade -f -s -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

   Aviso: Este comando desactiva el modo de mantenimiento que activaste antes de la actualización, ya que todos los servicios deben estar activos al actualizar.
4. Después de la actualización y comprobación correctas, reanude la programación de copia de seguridad en el nodo mediante la ejecución del siguiente comando:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Reversión por error

Preparación

1. Cree una carpeta independiente para almacenar los paquetes antiguos y realice las siguientes operaciones dentro de esa carpeta.
2. Descargue y descomprima la versión anterior del instalador (installer.zip) en todos los nodos.
   Aviso: Otorga los permisos adecuados a la carpeta ejecutando sudo chmod 755 -R <installer-folder>.
3. Cree el archivo restore.json y cópielo en todos los nodos. Para obtener más información, consulta Copia de seguridad y restauración del clúster.
4. Compruebe que los datos etcd de copia de seguridad estén presentes en el nodo principal en la siguiente ubicación: /mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots.
   • etcdBackupPath: es el mismo que el especificado en backup.json en el momento de activar el node-name de la copia de seguridad
   • node-name: el nombre de host de la máquina virtual principal del servidor.

Limpieza del clúster

1. Copie y ejecute el script dedicado para desinstalar todo de ese nodo. Haga esto para todos los nodos. Para más detalles, consulta Solución de problemas.
2. Restaure todas las bases de datos de UiPath a la copia de seguridad anterior creada antes de la actualización.

Restaurar la infraestructura en los nodos de servidor

1. Conéctese al servidor principal. Debe ser el mismo nodo de servidor que seleccionó durante la actualización.
2. Restaure la infraestructura mediante la ejecución del siguiente comando:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r --accept-license-agreement --install-type online

3. Conéctese al resto de los nodos de servidor (uno por uno) mediante SSH.
4. Restaure la infraestructura en estos nodos ejecutando el siguiente comando en los nodos de servidor, uno por uno. Su ejecución en paralelo no es compatible.

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j server --accept-license-agreement --install-type online

Restaurar la infraestructura en los nodos agente

1. Conéctese a cada máquina virtual agente mediante SSH.
2. Restaure la infraestructura en estos nodos ejecutando el siguiente comando:

   /path/to/older-installer/install-uipath.sh -i /path/to/restore.json -o /path/to/output.json -r -j agent --accept-license-agreement --install-type online

Restaurar los datos de los volúmenes

1. Conéctese al servidor principal mediante SSH.
2. Vaya a la carpeta del instalador más reciente.
   Aviso: Los comandos de restauración de la infraestructura anteriores se ejecutaron utilizando el instalador antiguo, y los siguientes comandos se ejecutan con el nuevo paquete de instalador.
3. Desactive el modo de mantenimiento en el clúster mediante la ejecución del siguiente comando:

   /path/to/new-installer/configureUiPathAS.sh disable-maintenance-mode

4. Compruebe que el modo de mantenimiento esté desactivado mediante la ejecución del siguiente comando:

   /path/to/new-installer/configureUiPathAS.sh is-maintenance-enabled

5. Copie el archivo restore.json que se utilizó en la etapa de restauración de la infraestructura a la carpeta del paquete del nuevo instalador.
6. Lleve a cabo la restauración de los volúmenes del paquete del nuevo instalador ejecutando el siguiente comando:

   /path/to/new-installer/install-uipath.sh -i /path/to/new-installer/restore.json -o /path/to/new-installer/output.json -r --volume-restore --accept-license-agreement --install-type online

7. Una vez completada la restauración, compruebe que todo se restaura y funciona correctamente.
8. Durante la actualización, las copias de seguridad programadas se desactivaron en el nodo principal. Para volver a activarlas, ejecute el siguiente comando:

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups