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.

   Nota:

   Otorgue 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:

     See Advanced installation experience to fill up the remaining parameters.

5. Copie este archivo cluster_config.json en la carpeta del instalador en todos los nodos.

Ejecución

Mantenimiento y copia de seguridad

1. Make sure you have enabled the backup on the cluster. For details, see Enabling the cluster backup.

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.

   Nota:

   La copia de seguridad puede tardar un tiempo. Espere unos 15 o 20 minutos aproximadamente y, después, verifique la copia de seguridad de nuevo.

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.

Nota:

Este comando también crea una copia de seguridad del estado del clúster y detiene todas las demás 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
   

Execute Rest of the Upgrade on the Primary Server

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
   

   Nota:

   Este comando desactiva el modo de mantenimiento que activó antes de la actualización, ya que todos los servicios deben estar activos durante esta.

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
   

Rollback on 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.

   Nota:

   Otorgue los permisos adecuados a la carpeta ejecutando sudo chmod 755 -R <installer-folder>.

3. Create the restore.json file and copy it to all the nodes. For details, see Backing up and restoring the cluster.

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. Copy and run the dedicated script to uninstall everything from that node. Do this for all the nodes. For details, see Troubleshooting.
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
   

Restore Infra on Agent Nodes

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
   

Restore Volumes Data

1. Conéctese al servidor principal mediante SSH.

2. Vaya a la carpeta del instalador más reciente.

   Nota:

   Los comandos de restauración de la infraestructura anteriores se ejecutaron utilizando el antiguo instalador y los siguientes comandos se ejecutan utilizando el paquete del nuevo 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