Copia de seguridad y restauración del clúster

Para poder utilizar las funciones de copia de seguridad y restauración, debe activar el servidor NFS, el clúster de copia de seguridad y el clúster de restauración. Los tres conceptos se definen a continuación.

Terminología

El servidor NFS es el servidor que almacena los datos de la copia de seguridad y facilita la restauración. Puedes configurar el servidor NFS en cualquier máquina o un servicio PaaS ofrecido por los proveedores de la nube. Ten en cuenta que no admitimos NFS basado en Windows y NFS basado en Azure blob.

El clúster de copia de seguridad es donde se instala Automation Suite. Se refiere al clúster que configuró durante la instalación.

El clúster de restauración es el clúster donde querría restaurar todos los datos del clúster de copia de seguridad. Se convertirá en el nuevo clúster en el momento en que ejecute Automation Suite tras completar la restauración.

Los siguientes pasos indican cómo configurar estos tres elementos.

Requisitos previos del entorno

Importante:

• Este paso no permitirá hacer copias de seguridad de ninguna copia de seguridad de fuentes de datos externas (SQL Server). Deberá activar por separado la copia de seguridad de fuentes de datos externas.
• No admitimos las copias de seguridad y restauraciones multizona.

Descargar los paquetes de instalación

• El servidor NFS debe ser accesible desde todos los nodos del clúster de copia de seguridad y del clúster de restauración.
• El clúster del que se quiere hacer una copia de seguridad y el servidor NFS deben estar en la misma región.
• Antes de restaurar el clúster, asegúrese de deshabilitar la copia de seguridad como se describe en Deshabilitar la copia de seguridad del clúster

• Active los siguientes puertos:

  Puerto	Protocolo	Origen	Destination	Propósito	Requisitos
  2049, 111	TCP	Servidor NFS	Todos los nodos del clúster de copia de seguridad	Sincronización de datos entre el clúster y el servidor NFS	Esta comunicación desde el servidor NFS hasta el nodo del clúster de copia de seguridad debe permitirse antes de continuar con el Paso 2: Activar la copia de seguridad del clúster.
  2049, 111	TCP	Todos los nodos del clúster de copia de seguridad	Servidor NFS	Sincronización de datos entre el clúster y el servidor NFS	Esta comunicación desde el nodo del clúster de copia de seguridad hasta el servidor NFS debe permitirse antes de continuar con el Paso 2: Activar la copia de seguridad del clúster.
  2049, 111	TCP	Servidor NFS	Todos los nodos del clúster de restauración	Sincronización de datos entre el servidor NFS y el clúster de restauración	Esta comunicación desde el servidor NFS hasta el nodo del clúster de restauración debe permitirse antes de continuar con el Paso 3: Configurar el clúster de restauración.
  2049, 111	TCP	Todos los nodos del clúster de restauración	Servidor NFS	Sincronización de datos entre el clúster y el servidor NFS	Esta comunicación desde el servidor NFS hasta el nodo del clúster de copia de seguridad debe permitirse antes de continuar con el Paso 3: Configurar el clúster de restauración.

Paso 1: Configurar el servidor NFS externo

Requisitos

El servidor NFS debe cumplir los siguientes requisitos:

• Puedes configurar el servidor NFS en cualquier máquina y cualquier sistema operativo de tu elección o, como alternativa, utilizar cualquier servicio PaaS ofrecido por los proveedores de la nube. Ten en cuenta que no admitimos NFS basado en Windows y NFS basado en Azure blob.

• La versión del servidor NFS debe ser NFSv4 en Linux.

• El servidor NFS debe ejecutarse fuera del clúster de copia de seguridad y del clúster de restauración.

• El tamaño del disco del servidor NFS debe ser mayor que el tamaño del disco de datos del nodo del servidor principal.

Consulta Requisitos de hardware para obtener más detalles.

Paso 1.1: Instalar las bibliotecas NFS

Importante: ignora el paso 1.1 si ya tienes un servidor NFS.

Instala la biblioteca nfs-utils en el nodo que tengas previsto utilizar como servidor NFS.

dnf install nfs-utils -y
systemctl start nfs-server.service
systemctl enable nfs-server.service

Paso 1.2: Configurar la ruta de montaje

Configura la ruta de montaje que desees mostrar desde el servidor NFS.

chown -R nobody: "/datadisk"
chmod -R 777 "/datadisk"
systemctl restart nfs-utils.service

Paso 1.3: Desactivar el cortafuegos

Firewalld es una biblioteca de seguridad que gestiona las reglas de red y de cortafuegos.

Consulta la documentación oficial de Firewalld para obtener más detalles.

Para desactivar Firewalld, ejecuta el siguiente comando.

systemctl stop firewalld
systemctl disable firewalld

Paso 1.4: Permitir el acceso a la ruta de montaje NFS a todos los nodos de copia de seguridad y restauración

Todos los nodos deben poder acceder a la ruta de montaje NFS. En el servidor NFS, vaya al archivo /etc/exports y agregue una entrada para el FQDN en cada nodo (tanto en el nodo de servidor como en el nodo agente) para ambos clústeres, el de copia de seguridad y el de restauración.

A continuación, se incluye un ejemplo de cómo agregar una entrada en la que se especifica el FQDN de una máquina y los permisos correspondientes en la misma:

echo "/datadisk sfdev1868610-d053997f-node.eastus.cloudapp.azure.com(rw,sync,no_all_squash,root_squash)" >> /etc/exports

A continuación, ejecuta el siguiente comando para exportar la ruta de montaje:

exportfs -arv
exportfs -s

Paso 2: Activar la copia de seguridad del clúster

Importante:

• Asegúrate de haber seguido el paso Requisitos previos del entorno.
• Asegúrese de hacer una copia de seguridad del archivo cluster_config.json utilizado para la instalación.
• Este paso no activará la copia de seguridad de ninguna copia de seguridad de una fuente de datos externa (SQL Server, por ejemplo). Deberá activar por separado la copia de seguridad de fuentes de datos externas.
• No se recomienda reducir el intervalo de copia de seguridad a menos de 15 minutos.
• Automation Suite no realiza una copia de seguridad de todos los volúmenes persistentes, como los volúmenes adjuntos al proceso de formación en AI Center. Se crea una copia de seguridad solo para algunos Volúmenes Persistentes como Alert Manager, Prometheus, Docker Registry, MongoDB, RabbitMQ, Ceph Objectstore, y Insights.

Crea un archivo y nómbralo backup.json. Complete los campos en función de las definiciones siguientes.

Backup.json

{
  "backup": {
    "etcdBackupPath": "PLACEHOLDER",
    "nfs": {
      "endpoint": "PLACEHOLDER",
      "mountpath": "PLACEHOLDER"
    }
  },
  "backup_interval": "15"
}

• backup.etcdBackupPath: ruta relativa donde se almacenarán los datos de copia de seguridad en el servidor NFS
• backup.nfs.endpoint: el punto final del servidor NFS (dirección IP o nombre DNS)
• backup.nfs.mountpath : ruta en el servidor NFS (punto final)
• backup_interval: intervalo de tiempo de la copia de seguridad (en minutos)

En el siguiente ejemplo, los datos de la copia de seguridad se almacenarán en /datadisk/backup/cluster0, en el servidor NFS:

{
  "backup": {
    "etcdBackupPath": "cluster0",
    "nfs": {
      "endpoint": "20.224.01.66",
      "mountpath": "/datadisk"
    }
  }
}

Paso 2.1: Activar la copia de seguridad en el nodo principal del clúster

Para habilitar la copia de seguridad en el nodo principal del clúster, ejecuta el siguiente comando:

./install-uipath.sh -i backup.json -o output.json -b --accept-license-agreement

Paso 2.2: Activar la copia de seguridad en nodos secundarios del clúster

Para habilitar la copia de seguridad en los nodos secundarios del clúster, ejecuta el siguiente comando en el nodo agente:

./install-uipath.sh -i backup.json -o output.json -b -j server --accept-license-agreement

Paso 2.3: Activar la copia de seguridad en los nodos agente del clúster

Para habilitar la copia de seguridad en los nodos agente del clúster, ejecuta el siguiente comando:

./install-uipath.sh -i backup.json -o output.json -b -j agent --accept-license-agreement

Paso 3: Configurar el clúster de restauración

Importante:

• Confirme que ha desactivado la copia de seguridad antes de restaurar el clúster. Consulta Desactivar la copia de seguridad del clúster.
• Confirme que todos los nodos de restauración tienen disponible los archivos package wget, unzip y jq.
• Asegúrate de haber seguido el paso Requisitos previos del entorno.
• Todas las fuentes de datos externas deben ser la misma (SQL Server).
• Reinicie el servidor NFS antes de restaurar el clúster. Ejecute el siguiente comando en el nodo del servidor NFS: systemctl restart nfs-server.

Restaurar los requisitos del clúster

• El clúster de restauración debe tener el mismo fqdn que el clúster de copia de seguridad.
• El clúster de restauración debe tener el mismo número de nodos de servidor (server) y nodos agente (agent) que el clúster de copia de seguridad.
• El clúster de restauración debe tener el mismo número de recursos de nodos de servidor (server) y recursos de nodos agente (agent) que el clúster de copia de seguridad, como se muestra a continuación:
  • Configuración del hardware para la CPU
  • Configuración del hardware para la memoria
  • Configuración de hardware para el espacio en disco

  • Nombre del host del nodo

    Tipo de instalación	Instrucciones de instalación	Requisitos
    Modo de evaluación de nodo único en línea	Configurar las máquinas Configurar el DNS Instalación de evaluación de nodo único sin conexión	Descargue solamente el archivo sf-installer zip e inclúyalo en la carpeta chmod -R 755 <sf_installer_folder> extraída. en la carpeta chmod -R 755 <sf_installer_folder> extraída.
    Modo de evaluación de nodo único sin conexión	Configurar las máquinas Configurar el DNS Instalación de evaluación de nodo único sin conexión	Descargue solo el archivo sf-installer zip y sf-infra-bundle.tar.gz. en la carpeta chmod -R 755 <sf_installer_folder> extraída.
    Modo de producción multinodo preparado para HA en línea	Configurar las máquinas Instalación de producción multinodo preparada para alta disponibilidad sin conexión	Descargue solamente el archivo sf-installer zip e inclúyalo en la carpeta chmod -R 755 <sf_installer_folder> extraída.
    Modo de producción multinodo preparado para HA sin conexión	Configurar las máquinas Instalación de producción multinodo preparada para alta disponibilidad sin conexión	Descargue solo el archivo sf-installer zip y sf-infra-bundle.tar.gz. en la carpeta chmod -R 755 <sf_installer_folder> extraída.

    Crea un archivo y nómbralo restore.json. Complete los campos en función de las definiciones siguientes.

Restore.json

{
  "fixed_rke_address": "PLACEHOLDER",
  "gpu_support": false,
  "fqdn": "PLACEHOLDER",
  "rke_token": "PLACEHOLDER",
  "restore": {
    "etcdRestorePath": "PLACEHOLDER",
    "nfs": {
      "endpoint": "PLACEHOLDER",
      "mountpath": "PLACEHOLDER"
    }
  },
  "infra": {
    "docker_registry": {
      "username": "PLACEHOLDER",
      "password": "PLACEHOLDER"
    }
  }
}

• fqdn: el FQDN del equilibrador de carga para el modo de producción multinodo preparado para alta disponibilidad, o bien el FQDN de la máquina para el modo de evaluación de nodo único
• fixed_rke_address: el nombre de dominio completo del equilibrador de carga si se ha configurado alguno. De no ser así, corresponde al nombre de dominio completo del primer nodo de servidor de restauración. Se utiliza para equilibrar la carga del registro del nodo y las solicitudes de la API de Kubernetes. Consulta Dirección fija y Configurar el equilibrador de carga para obtener más información.
• gpu_support: utilice true o false para activar o desactivar la compatibilidad con GPU para el clúster (utilícelo si dispone de nodos agente con GPU).
• rke_token: un secreto previamente compartido y específico del clúster. Debe coincidir con el del clúster de copia de seguridad y puede encontrarse en el archivo cluster_config.json. Es necesario para todos los nodos que se unan al clúster.
• restore.etcdRestorePath: ruta en la que se almacenan los datos de copia de seguridad para el clúster del servidor NFS. Se configura en la copia de seguridad con etcdBackupPath.
• restore.nfs.endpoint: punto de conexión del servidor NFS.
• restore.nfs.mountpath: ruta de montaje del servidor NFS.
• infra.docker_registry.username: el nombre de usuario que estableció en el clúster de copia de seguridad. Puede encontrarse en el archivo cluster_config.json y se necesita para el registro de Docker.
• infra.docker_registry.password: la contraseña que estableció en el clúster de copia de seguridad. Puede encontrarse en el archivo cluster_config.json y se necesita para la instalación del registro de Docker.

Instalación en línea

Paso 3.1: Restaurar etcd en el nodo principal del clúster

Para restaurar etcd en el nodo principal del clúster, ejecuta el siguiente comando:

./install-uipath.sh -i restore.json -o output.json -r --accept-license-agreement --install-type online

Paso 3.2: Restaurar etcd en los nodos secundarios del clúster

Para restaurar etcd en los nodos secundarios del clúster, ejecuta el siguiente comando:

./install-uipath.sh -i restore.json -o output.json -r -j server --accept-license-agreement --install-type online

Importante: El rol de nodo es obligatorio para todos los nodos servidor secundarios.

Paso 3.3: Restaurar etcd en los nodos agente del clúster

Para restaurar etcd en los nodos agente del clúster, ejecuta el siguiente comando:

./install-uipath.sh -i restore.json -o output.json -r -j agent --accept-license-agreement --install-type online

Paso 3.4: deshabilitar el modo de mantenimiento

Nota: este paso solo es necesario si la restauración forma parte de la operación de reversión durante la actualización.

Una vez finalizada la restauración etcd, asegúrate de deshabilitar el modo de mantenimiento:

/path/to/old-installer/configureUiPathAS.sh disable-maintenance-mode

Para verificar que el modo de mantenimiento está desactivado, ejecuta el siguiente comando:

/path/to/old-installer/configureUiPathAS.sh is-maintenance-enabled

Paso 3.5: Ejecutar la restauración de volúmenes en el nodo principal

Una vez completada la restauración de etcd, ejecuta la restauración de volúmenes en el nodo principal utilizando el siguiente comando:

./install-uipath.sh -i restore.json -o output.json -r --volume-restore --accept-license-agreement --install-type online

Paso 3.6: Instalar el certificado de clúster de Automation Suite en el nodo de restauración principal

sudo ./configureUiPathAS.sh tls-cert get --outpath /opt/
cp /opt/ca.crt /etc/pki/ca-trust/source/anchors/
update-ca-trust

Habilitar AI Center en el clúster restaurado

Después de restaurar un clúster de Automation Suite con AI Center ™ habilitado, sigue los pasos del procedimiento Habilitar AI Center en Clúster restaurado .

Instalación sin conexión

Paso 3.1: Restaurar etcd en el nodo principal del clúster

Para restaurar etcd en el nodo principal del clúster, ejecuta el siguiente comando:

./install-uipath.sh -i restore.json -o output.json -r --offline-bundle "/uipath/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

Paso 3.2: Restaurar etcd en los nodos secundarios del clúster

./install-uipath.sh -i restore.json -o output.json -r -j server --offline-bundle "/uipath/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

Paso 3.3: Restaurar etcd en los nodos agente del clúster

Para restaurar etcd en los nodos agente del clúster, ejecuta el siguiente comando:

./install-uipath.sh -i restore.json -o output.json -r -j agent --offline-bundle "/uipath/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

Paso 3.4: deshabilitar el modo de mantenimiento

Nota: este paso solo es necesario si la restauración forma parte de la operación de reversión durante la actualización.

Una vez finalizada la restauración etcd, asegúrate de deshabilitar el modo de mantenimiento:

/path/to/old-installer/configureUiPathAS.sh disable-maintenance-mode

Para verificar que el modo de mantenimiento está desactivado, ejecuta el siguiente comando:

/path/to/old-installer/configureUiPathAS.sh is-maintenance-enabled

Paso 3.5: Ejecutar la restauración de volúmenes en el nodo principal

Una vez completada la restauración de etcd, ejecuta la restauración de volúmenes en el nodo principal utilizando el siguiente comando:

./install-uipath.sh -i restore.json -o ./output.json -r --volume-restore --accept-license-agreement --install-type offline

Paso 3.6: Instalar el certificado de clúster de Automation Suite en el nodo de restauración principal

sudo ./configureUiPathAS.sh tls-cert get --outpath /opt/
cp /opt/ca.crt /etc/pki/ca-trust/source/anchors/
update-ca-trust

Habilitar AI Center en el clúster restaurado

Después de restaurar un clúster de Automation Suite con AI Center ™ habilitado, sigue los pasos del procedimiento Habilitar AI Center en Clúster restaurado .

Desactivar la copia de seguridad del clúster

Importante: puedes habilitar la copia de seguridad del clúster para guardar datos en un periodo especificado utilizando el parámetrobackup_interval. Desactivar la copia de seguridad del clúster provocará la pérdida de los datos que se crearon entre la última ejecución programada y el momento en que desactivó la copia de seguridad.

Para desactivar la copia de seguridad, ejecuta los siguientes comandos por orden:

1. Desactive la copia de seguridad en el nodo principal del clúster.

   ./install-uipath.sh -i backup.json -o output.json -b --disable-backup --accept-license-agreement

2. Desactive la copia de seguridad en los nodos secundarios del clúster.

   ./install-uipath.sh -i backup.json -o output.json -b -j server --disable-backup --accept-license-agreement

3. Desactive la copia de seguridad en los nodos agentes del clúster.

   ./install-uipath.sh -i backup.json -o output.json -b -j agent --disable-backup --accept-license-agreement

Configuraciones adicionales

Actualizar el servidor NFS

Importante: asegúrese de que la copia de seguridad esté deshabilitada antes de actualizar el servidor NFS. Consulta Deshabilitar la copia de seguridad del clúster para obtener más información.

Para actualizar el servidor NFS, haz lo siguiente:

1. Vuelva a realizar los siguientes pasos:
   1. Paso 1: Configurar el servidor NFS externo
   2. Paso 2: Configurar el clúster de copia de seguridad
   3. Paso 3: Configurar el clúster de restauración
2. Actualice la información del servidor NFS y, a continuación, incluya el nuevo nfs.endpoint tanto en el archivo backup.json como en el archivo restore.json.

Inclusión de un nuevo nodo en el clúster

Para añadir un nodo nuevo al clúster, vuelve a ejecutar los siguientes pasos:

1. Paso 1: Configurar el servidor NFS externo
2. Paso 2: Configurar el clúster de copia de seguridad

Problemas conocidos

Restaurar Redis

La restauración de Redis falla cuando se ejecuta la restauración, por lo que deberá ejecutar algunos pasos adicionales.

Sigue los pasos de la sección Resolución de problemas.

Importante: una vez restaurado Redis, asegúrese de reiniciar los pods orchestrator.

El pod Looker de Insights no se inicia después de una restauración

Puede solucionar este problema eliminando el pod Looker de la aplicación Insights en la interfaz de usuario de ArgoCD. La implementación creará un nuevo pod que debería iniciarse con éxito.