Offline upgrade

Preparación

ADVERTENCIA:

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. Identify the server (not agent) node that has additional UiPath bundle disk attached at /uipath mount point. This node is referred to as primary server node throughout the document. In the case of a single-node evaluation profile, where you have only one server node, you must log into that node.

   Nota:

   Perform the following steps on all the nodes in the cluster. Start with the server nodes and continue with the agent nodes.

2. Conéctate a un nodo mediante SSH.

3. Hazte usuario raíz:

   sudo su -
   

4. 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>
   

5. Download sf-installer.zip and copy it to /opt/UiPathAutomationSuite/{version}/installer. For download instructions, see sf-installer.zip.

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

6. Download sf-infra.tar.gz and copy it to /opt/UiPathAutomationSuite/{version}. For download instructions, see sf-infra.tar.gz:

   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
   

7. (Only on the primary server node). Download sf.tar.gz and copy it to /uipath/{version}. For download instructions, see sf.tar.gz:

   cp /path/to/sf.tar.gz /uipath/{version}
   

8. Descomprime sf-installer.zip:

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

9. Proporciona los permisos necesarios al instalador:

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

10. Generate the latest cluster_config.json on the first server node and copy it to the rest of the nodes. For details on how to configure the cluster_config.json parameters, see Using the configuration file.

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

  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 el momento de 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>",
   },
   

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 nodos servidor:

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

   • Para nodos 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 --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --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 la estructura y los componentes de servicio que se ejecutan con el clúster. Debes seguir estos pasos únicamente en el nodo servidor primario.

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 in both the commands
   cd /opt/UiPathAutomationSuite/{version}/installer
   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -f -i /path/to/cluster_config.json --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --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 --offline-bundle "/path/to/sf.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --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