Online upgrade

Preparación

ADVERTENCIA:

Realiza los siguientes pasos en el primer nodo servidor y, a continuación, en todos los demás nodos (tanto servidor como agente) del clúster.

Asegúrate de tener 10 GiB de espacio libre en la carpeta /opt/UiPathAutomationSuite en todos los nodos. Si no dispones de espacio suficiente, puedes aumentar la capacidad de esta carpeta o eliminar todos los archivos del instalador anterior excepto cluster_config.json. Siempre puedes volver a descargar el instalador anterior.

Para verificar el espacio disponible, ejecuta el siguiente comando: df -h /opt/UiPathAutomationSuite.

Para preparar la actualización, realiza los pasos siguientes:

1. Log into any server machine using SSH. In the case of single-node evaluation profile, where you have only one server node, log into that node.

2. Hazte usuario raíz:

   sudo su -
   

3. Crea una carpeta de instalación en el directorio /opt/UiPathAutomationSuite:

   <h1>Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1>
   

4. Descarga sf-installer.zip y cópiala en /opt/UiPathAutomationSuite/{version}/installer.

   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
   

5. Descomprime sf-installer.zip:

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip sf-installer.zip -d .
   

6. Concede permiso al instalador:

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
   

7. Genera el último archivo cluster_config.json en el primer nodo servidor y cópialo en el resto de nodos.

• Si tienes el cluster_config.json antiguo, genera el archivo de configuración desde el clúster:

  cd /opt/UiPathAutomationSuite/{version}/installer
  ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json
  

• Si no dispones del archivo cluster_config.json antiguo, anula los valores predeterminados que hayas podido realizar en la instalación de la versión anterior

  cd /opt/UiPathAutomationSuite/{version}/installer
  ./configureUiPathAS.sh config get -o ./cluster_config.json
  

Adding AI Center specific configuration

1. Open the cluster_config.json with your editor (for example, vi).

   vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json
   

2. Sustituye el siguiente bloque:

   "aicenter": {
     "enabled": "false"
   },
   

   Nota:

   Document Understanding is enabled by default if AI Center is enabled.

3. Con la información siguiente (sustituyendo la información entre <>" id="1"/> con tus valores):

   "aicenter": {
     "orchestrator_url":"<a href="https://orchestrator-url.com">https://orchestrator-url.com</a>",
     "identity_server_url": "<a href="https://orchestrator-url.com/identity">https://orchestrator-url.com/identity</a>",
     "orchestrator_cert_file_path": "</opt/UiPathAutomationSuite/orch.cer or custom path>",
     "identity_cert_file_path":  "</opt/UiPathAutomationSuite/orch.cer or custom path>",
     "identity_access_token": "<placeholder will be replaced later>",
     "metering_api_key": "<placeholder will be replaced later>"
   },
   

   Nota:

   metering_api_key es la clave de API de Document Understanding de la cuenta de AI Center en la nube, como en la siguiente captura de pantalla.

   

Ejecución

ADVERTENCIA:

If any errors or issues occur during or following the upgrade, you can rollback to the previous version, provided that you previously configured a backup. For instructions, see Rollback on error.

Configuring the backup

Para configurar la copia de seguridad, sigue los siguientes pasos:

1. Make sure you have enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the UiPath AI Center version from which you plan to upgrade.

2. Conéctese a uno de los nodos de servidor mediante SSH.

3. Para verificar que todos los volúmenes deseados tienen copias de seguridad en el clúster, ejecuta:

   /path/to/old-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.

Una vez creada la copia de seguridad, continúa con los pasos siguientes.

Putting the cluster in maintenance mode

Putting the cluster in maintenance mode will shut down the ingress controller and all the UiPath services, blocking all the incoming traffic to the AI Center cluster.

ADVERTENCIA:

This operation will cause downtime, and your business automation will be suspended during the entire upgrade process.

1. Para poner el clúster en Modo de mantenimiento, ejecuta:

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./configureUiPathAS.sh enable-maintenance-mode
   

2. Para verificar que el clúster está en modo de mantenimiento, ejecuta:

   ./configureUiPathAS.sh is-maintenance-enabled
   

   ADVERTENCIA:

   Create a backup of your SQL Server after enabling maintenance mode so that no further transactions are recorded in your SQL database.

Updating Kubernetes and other infrastructure components

ADVERTENCIA:

Debes realizar la actualización de la infraestructura en todos los nodos del clúster.

No puedes realizar este paso en varios nodos al mismo tiempo; debes esperar a que finalice la actualización en cada nodo antes de pasar a otro.

1. Inicia sesión en cada nodo en el que desees actualizar la infraestructura.

2. Obtenga acceso a la raíz ejecutando sudo su -.

3. Asegúrate de que rke service está habilitado en los nodos servidor y agente.

   Si el servicio está deshabilitado, habilítalo ejecutando el siguiente comando:

   • Para un nodo servidor:

     [[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service
     

   • Para un nodo agente:

     [[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service
     

4. Para iniciar la actualización, ejecuta el siguiente comando:

   ADVERTENCIA:

   Make sure you have updated cluster_config.json generated as described in the Preparation steps.

   replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json
   

   Importante:

   If you get an error, follow the instructions in Downgrading Ceph from 16.2.6 to 15.2.9.

Updating shared components and UiPath product services

Este paso actualiza los componentes de estructura y servicio que se ejecutan con el clúster. Debes seguir estos pasos una sola vez desde cualquier nodo del servidor.

1. Conéctate a cualquier nodo servidor.

2. Obtenga acceso a la raíz ejecutando sudo su -.

3. Ejecuta el siguiente comando:

   replace {version} with the version you are upgrading to
   cd /opt/UiPathAutomationSuite/{version}/installer
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json
   

4. Ejecuta el instalador de software mediante el siguiente comando.

   En primer lugar, debes conectarte al servidor de identidad y recuperar un token de instalación. A continuación, copia este token y pégalo en el marcador de posición del archivo cluster_config.json.

   Una vez que el token se ha copiado, puedes ejecutar la instalación de AI Center.

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

   ADVERTENCIA:

   Una vez realizada la actualización, el modo de mantenimiento se desactivará automáticamente.

Enabling the backup post-upgrade

ADVERTENCIA:

Make sure AI Center is up and running and your automation continues as expected before proceeding with the next steps.

Antes de comenzar a actualizar el clúster, el script de actualización crea automáticamente una copia de seguridad del clúster y, luego, la desactiva temporalmente. Puede que quieras habilitar la copia de seguridad manualmente una vez finalizada la actualización

Para habilitar la copia de seguridad, ejecuta el siguiente comando desde cualquier nodo servidor:

replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups