- Primeros pasos
- Requisitos de red
- Requisitos de nodo único e instalación
- Requisitos multinodo e instalación
- Después de la instalación
- Acceso a AI Center
- Aprovisionar un tenant de AI Center
- Actualizar los certificados de Orchestrator e Identity Server
- Cambiar el tamaño de PVC
- Añadir un nuevo nodo al clúster
- Instalación sin conexión de paquetes ML
- Configurar el clúster
- Configurar la instalación posterior a FQDN
- Copia de seguridad y restauración del clúster
- Utilizar la pila de supervisión
- Configurar una autenticación de Kerberos
- Aprovisionar una GPU
- Utilizar el archivo de configuración
- Programación de nodos
- Migración y actualización
- Guía básica de resolución de problemas
Offline upgrade
/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.
df -h /opt/UiPathAutomationSuite
.
Para preparar la actualización, realiza los pasos siguientes:
- 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. - Conéctate a un nodo mediante SSH.
- Hazte usuario raíz:
sudo su -
sudo su - - 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>
<h1>Please replace {version} with installer version mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1> - Descarga
sf-installer.zip
y cópialo en/opt/UiPathAutomationSuite/{version}/installer
. Para obtener instrucciones de descarga, consulte sf-instalador.zip.cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer - Descarga
sf-infra.tar.gz
y cópialo en/opt/UiPathAutomationSuite/{version}
. Para obtener instrucciones de descarga, consulte sf-infra.tar.gz:cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version} - (Solo en el nodo del servidor principal).
Descarga
sf.tar.gz
y cópialo en/uipath/{version}
. Para obtener instrucciones de descarga, consulte sf.tar.gz:cp /path/to/sf.tar.gz /uipath/{version}
cp /path/to/sf.tar.gz /uipath/{version} - Descomprime
sf-installer.zip
:cd /opt/UiPathAutomationSuite/{version}/installer unzip sf-installer.zip -d .
cd /opt/UiPathAutomationSuite/{version}/installer unzip sf-installer.zip -d . - Proporciona los permisos necesarios al instalador:
chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer - Genere el
cluster_config.json
más reciente en el primer nodo del servidor y cópielo en el resto de nodos. Para obtener más información sobre cómo configurar los parámetroscluster_config.json
, consulta Uso del archivo de configuración.
- 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
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
cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh config get -o ./cluster_config.json
- Open the
cluster_config.json
with your editor (for example, vi).vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json
vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json - Sustituye el siguiente bloque:
"aicenter": { "enabled": "false" },
"aicenter": { "enabled": "false" },Aviso: Document Understanding está habilitado si AI Center está habilitado. - 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>", },
"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>", },
Para configurar la copia de seguridad, sigue los siguientes pasos:
- Asegúrate de haber habilitado 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 planeas actualizar.
- Conéctese a uno de los nodos de servidor mediante SSH.
- 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
/path/to/old-installer/configureUiPathAS.sh verify-volumes-backupAviso: 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 will shut down the ingress controller and all the UiPath services, blocking all the incoming traffic to the AI Center cluster.
- Para poner el clúster en Modo de mantenimiento, ejecuta:
cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh enable-maintenance-mode
cd /opt/UiPathAutomationSuite/{version}/installer ./configureUiPathAS.sh enable-maintenance-mode - Para verificar que el clúster está en modo de mantenimiento, ejecuta:
./configureUiPathAS.sh is-maintenance-enabled
./configureUiPathAS.sh is-maintenance-enabledAdvertencia: 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.
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.
- Inicia sesión en cada nodo en el que desees actualizar la infraestructura.
- Obtenga acceso a la raíz ejecutando
sudo su -
. - 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
[[ $(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
[[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service
- Para nodos servidor:
- 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 --offline-bundle "/path/to/sf-infra.tar.gz" --offline-tmp-folder /uipath/tmp --install-offline-prereqs --accept-license-agreement -o /path/to/output.json
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.jsonImportante: Si aparece un error, sigue las instrucciones en Desactualizar Ceph de 16.2.6 a 15.2.9.
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.
- Conéctate a cualquier nodo servidor.
- Obtenga acceso a la raíz ejecutando
sudo su -
. - 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
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 - 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
/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.jsonAdvertencia: una vez realizada la actualización, el modo de mantenimiento se deshabilitará automáticamente.
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
replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups
replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups