Actualización en línea

Preparación

Advertencia: realiza los pasos siguientes en el primer nodo del servidor y, a continuación, en todos los demás nodos (tanto del servidor como del 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. Inicia sesión en cualquier máquina servidor utilizando SSH. En el caso del perfil de evaluación de nodo único, en el que solo dispones de un nodo servidor, inicia sesión en ese nodo.
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ópialo en /opt/UiPathAutomationSuite/{version}/installer. Para obtener instrucciones de descarga, consulta sf-installer.zip.

   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.
   Nota: Para obtener más detalles sobre cómo configurar los parámetros cluster_config.json, consulta Usar el archivo de configuración.

• 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

Añadir configuración específica de AI Center

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"
   },

   Aviso: Document Understanding se habilita por defecto si AI Center™ está habilitado.
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 API de Document Understanding de la cuenta en la nube de AI Center, como en la captura de pantalla a continuación.
   
   

   

   
   

Ejecución

Advertencia: si se produce algún error o problema durante o después de la actualización, puedes revertir la versión anterior, siempre que hayas configurado previamente una copia de seguridad. Para obtener instrucciones, consulta Reversión por error.

Configurar la copia de seguridad

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

1. Asegúrese de haber activado la copia de seguridad en el clúster. Debes crear la copia de seguridad utilizando la misma versión del instalador que la que utilizaste para la implementación actual. Para obtener instrucciones, consulta la documentación de copia de seguridad y restauración correspondiente a la versión de UiPath AI Center™ desde la que piensas actualizar.
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

   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.

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

Poner el clúster en modo de mantenimiento

La puesta del clúster en modo de mantenimiento apagará el controlador de entrada y todos los servicios UiPath, bloqueando todo el tráfico entrante al clúster AI Center™.

Advertencia: esta operación ocasionará tiempo de inactividad, y la automatización de tu empresa se suspenderá durante todo el proceso de actualización.

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: Crea una copia de seguridad de tu SQL Server después de activar el modo de mantenimiento para que no se registren más transacciones en tu base de datos SQL.

Actualizar Kubernetes y otros componentes de infraestructura

Advertencia: debes actualizar 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: Asegúrate de haber actualizado cluster_config.json como se describe en los pasos de Preparación.

   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: Si aparece un error, sigue las instrucciones en Desactualizar Ceph de 16.2.6 a 15.2.9.

Actualizar componentes compartidos y servicios de productos UiPath

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 deshabilitará automáticamente.

Habilitar la copia de seguridad posterior a la actualización

Advertencia: Asegúrate de que AI Center está en funcionamiento y de que tu automatización continúa según lo previsto antes de continuar con los pasos siguientes.

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