Manual: Actualización sin conexión

Preparación

Importante:

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. Identifica el nodo servidor (no agente) que tiene un disco UiPath bundle adicional conectado en el punto de montaje /uipath. Este nodo se denomina nodo servidor primario en todo el documento. En el caso de un perfil de evaluación de nodo único, en el que dispones de un solo nodo servidor, debes iniciar sesión en ese nodo.
   Nota: realiza los siguientes pasos en todos los nodos del clúster. Comienza por los nodos servidores y continúa con los nodos agentes.
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:

   # Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer

5. Descarga sf-installer.zip y cópiala en /opt/UiPathAutomationSuite/{version}/installer. Para obtener instrucciones de descarga, consulta sf-installer.zip.

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

6. Descarga sf-infra.tar.gz y cópiala en /opt/UiPathAutomationSuite/{version}. Para obtener instrucciones de descarga, consulta sf-infra.tar.gz:

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

7. (Solamente en el nodo servidor primario.) Descarga sf.tar.gz y cópiala en /uipath/{version}. Para obtener instrucciones de descarga, consulta 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. Genera el cluster_config.json más reciente en el primer nodo servidor y cópialo al resto de nodos. Para obtener más información sobre cómo configurar los parámetros cluster_config.json, consulta Experiencia de instalación avanzada.
    • 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

    • Si actualizas desde una versión anterior de AI CenterTM independiente y tu versión 2022.10 de AI Center necesita estar conectada a un Orchestrator externo, copia el certificado de Orchestrator en la máquina virtual. Después de copiar el certificado, se necesitan los siguientes detalles de configuración en cluster_config.json:

      "aicenter": {
          "enabled": true,
          "orchestrator_url": "https://orchestrator.example.com", //Specify the Orchestrator URL for AI Center
          "identity_server_url": "https://orchestrator.example.com/identity", //Specify the Identiy URL for AI Center
          "orchestrator_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to the Orchestrator certificate
          "identity_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to Identity certificate file
          "metering_api_key": "test" //Specify the metering API key
        }

      Nota: si AI Center requiere un Orchestrator externo, añade sql_connection_string_template y sql_connection_string_template_odbc en el archivo cluster_config.json .

    • Si actualizas Automation Suite desde una versión anterior y ahora habilitas Process Mining también, debes actualizar sql_connection_string_template_sqlalchemy_pyodbc. A continuación se muestra un ejemplo.

      "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://[e-mail]:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

    Consulta también Manual: Experiencia de instalación avanzada.

Ejecución

Importante: si se produce algún error o problema durante o después de la actualización, puedes revertir a la versión anterior, siempre que hayas configurado una copia de seguridad. Para obtener instrucciones, consulta Revertir en caso de error.

Hidratación de Docker-registry y Containerd

Para minimizar el tiempo de inactividad requerido, hidrata docker-registry y containerd con imágenes de contenedores para la nueva versión de productos antes de la actualización siguiendo los pasos a continuación:

Importante:

• Asegúrate de no hidratar el contenedor y/u otras imágenes infra más de 10 horas antes de la actualización.

• Si actualizas Document Understanding y Computer Vision, debes descargar las imágenes base que coincidan con tu versión actualizada de Automation Suite (utiliza la imagen base que corresponde a tu versión de Paquete ML) e hidratarlas en tu registro de docker antes de la actualización para evitar alteraciones en tus habilidades de DU en ejecución. Para descargar los paquetes de instalación de Document Understanding y Computer Vision, consulta Descargar los paquetes de instalación.

1. Para hidratar docker-registry, ejecuta el siguiente comando en el primer nodo del servidor:

   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/sf.tar.gz --offline-tmp-folder /uipath/tmp

2. Nota:

   Asegúrate de que zstdesté instalado. Para instalar zstd, ejecuta el siguiente comando: dnf install zstd.
   Para hidratar containerd, ejecuta el siguiente comando en todos los nodos:

   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./configureUiPathAS.sh containerd --offline-bundle ../sf-infra.tar.gz --offline-tmp-folder ../../tmp

Configuring the backup

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 Automation Suite desde la que piensas actualizar. Por ejemplo, si planeas actualizar desde Automation Suite 2021.10, sigue las instrucciones de la guía 2021.10.
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/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.

Putting the cluster in maintenance mode

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 Automation Suite.

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

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

Importante:

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:
   Importante: 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
   
   ./install-uipath.sh --upgrade -k -i ./cluster_config.json -o ./output.json --offline-bundle ../sf-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement

   Importante:

   Si recibes el siguiente error, sigue las instrucciones de Degradación de Ceph de la versión 16.2.6 a la 15.2.9.

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

Actualizar componentes compartidos y servicios de productos UiPath

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. Conectar al nodo principal del 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
   ./install-uipath.sh --upgrade -f -s -i ./cluster_config.json -o ./output.json --install-type offline --accept-license-agreement

   Importante:

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

   Después de actualizar manualmente desde Automation Suite 2021.10, también debes migrar a Cilium CNI. Para obtener instrucciones, consulta Migrar de Canal a Cilium CNI.

Después de realizar la actualización, puedes seguir los siguientes pasos adicionales:

• Para verificar si Automation Suite está en buen estado, ejecute:

  kubectl get applications -n argocd

• Si experimentas incidencias con las vulnerabilidades de imagen o el consumo de almacenamiento después de realizar una actualización, elimina las imágenes del instalador antiguo. Para obtener más detalles, consulta la sección Solucionar problemas.

Enabling the backup post-upgrade

Importante:

Make sure Automation Suite 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, sigue las instrucciones descritas en la documentación del clúster Hacer copia de seguridad y restaurar.