Manuel, hors ligne : Restauration du cluster

Avant de commencer

• Assurez-vous d'avoir suivi les prérequis.
• Assurez-vous que la sauvegarde est désactivée sur le cluster de sauvegarde. Des incohérences se produiront si une nouvelle sauvegarde est créée lors de la restauration du cluster. Pour plus de détails, consultez Automatisé : Désactivation de la sauvegarde sur le cluster.
• Assurez-vous que les packages wget, unzip, jq sont disponibles sur tous les nœuds de restauration.
• Toutes les sources de données externes doivent être identiques (SQL Server).
• Vous devez redémarrer le serveur NFS avant la restauration du cluster. Pour ce faire, exécutez la commande suivante sur le nœud du serveur NFS : systemctl restart nfs-server .
• Le cluster de restauration doit avoir le même nom de domaine complet que le cluster de sauvegarde.
• Assurez-vous d'avoir préparé votre environnement pour l'utilisation de la commande uipathctl.sh . Pour plus de détails, consultez Utilisation de uipathctl.sh.
• Au moment de la restauration du cluster, vous devez fournir le fichier inventory.ini contenant l'adresse IP du nœud hôte Ansible et des informations sur la façon de connecter SSH à tous les nœuds. Le script uipathctl.sh ne peut pas générer ce fichier automatiquement car le cluster n'est pas présent au moment du processus de restauration.

  Type d'installation	Instructions de configuration	Prérequis
  Mode d'évaluation à nœud unique hors ligne	Configuration des machines Configuration du DNS	Téléchargez les fichiers suivants : sf-installer.zip - Obligatoire. Voir sf-installer.zip pour les instructions de téléchargement. sf-infra.tar.gz - Obligatoire. Voir sf-infra.tar.gz pour les instructions de téléchargement.
  Mode de production hors ligne multi-nœuds compatible haute disponibilité	Configuration des machines Configurer l'équilibreur de charge Configuration du DNS	Téléchargez les fichiers ci-dessous sf-installer.zip - Obligatoire. Voir sf-installer.zip pour les instructions de téléchargement. sf-infra.tar.gz - Obligatoire. Voir sf-infra.tar.gz pour les instructions de téléchargement.

Ansible automatise le processus de restauration du cluster Automation Suite. Dans l'illustration suivante, le nœud Server 1 , qui est le nœud hôte Ansible, utilise Ansible pour orchestrer la restauration de tous les nœuds du cluster.

Préparation du processus de restauration

1. Connectez-vous au nœud de serveur que vous avez identifié comme étant le nœud hôte Ansible.
2. Créez le dossier /opt/UiPathAutomationSuite/{version}/installer pour héberger le programme d'installation.

   # Become root
   sudo su -
   
   # Replace {version} with actual installer version
   
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer
   chmod -R 777 /opt/UiPathAutomationSuite

3. Copiez le fichier restore.json contenant la configuration de restauration dans le dossier /opt/UiPathAutomationSuite/{version}/installer . Pour plus de détails, voir Préparation de la configuration de restauration.

   # Replace {version} with actual installer version
   
   cp /path/to/restore.json /opt/UiPathAutomationSuite/{version}/installer
   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}

4. Décompressez le fichier sf-installer.zip .

   # Navigate to installer folder. Replace {version} with actual installer version
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   unzip sf-installer.zip -d .

Restauration du cluster

Pour restaurer le cluster, vous devez fournir les fichiers suivants au script uipathctl.sh :

• inventory.ini : ce fichier contient des informations sur tous les nœuds du cluster et des détails SSH. Le script uipathctl.sh ne génère pas le fichier inventory.ini automatiquement car le cluster n'est pas présent au moment de la restauration du cluster.
• restore.json : ce fichier contient la configuration de restauration. Pour plus de détails, consultez la section Préparation de la configuration de restauration.

Pour restaurer le cluster, exécutez la commande suivante avec les paramètres de base. Assurez-vous d'utiliser les valeurs de paramètre qui vous concernent.

./uipathctl.sh restore --install-type online --restore-config ./restore.json --inventory ./inventory.ini --offline-infra-bundle ../sf-infra.tar.gz

Paramètres de base

Paramètre	Description
--install-type	Valeurs possibles : online et offline . Étant donné que cette page fournit des instructions de restauration pour en ligne, choisissez la valeur offline .
--restore-config	Le fichier contient la configuration de restauration. Pour plus de détails, voir Préparation de la configuration de restauration.
--inventory	Le fichier contient des informations sur tous les nœuds du cluster et des détails SSH. Pour plus de détails, voir Génération du fichier Inventory.ini Ansible.

Paramètres avancés

Paramètre

Description

--ansible-username

Spécifiez le nom d'utilisateur que vous utiliserez pour les connexions SSH à tous les nœuds. La valeur par défaut est l'utilisateur actuel. Si vous utilisez un nom d'utilisateur différent pour tous les nœuds, au lieu d'utiliser ce paramètre, définissez le nom d'utilisateur pour tous les nœuds dans inventory.ini et transmettez-le au script. Exemple : lors de l'exécution du script, vous êtes connecté en tant que nom d'utilisateur myadminuser . Cependant, si vous souhaitez utiliser le nom d'utilisateur testadmin pour vous connecter via SSH, vous devez fournir testadmin à une valeur pour ce paramètre.

Restauration de Cluster_config.json

Après la récupération du cluster, vous souhaiterez peut-être récupérer le cluster_config.json pour référence future. Vous aurez peut-être besoin du fichier lors de l'ajout de nouveaux nœuds au cluster, lors de la mise à niveau, etc.

Pour restaurer cluster_config.json , exécutez la commande suivante à partir de l'un des nœuds du serveur :

./configureUiPathAS.sh config get -o ./cluster_config.json

Important :

La sauvegarde n'est pas activée sur le cluster restauré. Si vous souhaitez l'activer, reportez-vous à Activation de la sauvegarde sur le cluster.

La restauration du cluster n'est pas une opération idempotente. En cas d'échec de la restauration, suivez l'une des étapes suivantes avant de relancer l'opération :

• Désinstallez Automation Suite sur tous les nœuds. Pour obtenir des instructions, consultez Résolution des problèmes ( Troubleshooting).
• Suivez les étapes de restauration manuelle. Pour obtenir des instructions, consultez Manuel, en ligne : Restauration du cluster.

Ajout de certificats CA au magasin approuvé

Après avoir restauré le cluster, assurez-vous d'ajouter vos certificats CA au magasin approuvé des machines virtuelles restaurées. Pour en savoir plus, consultez :

• Accéder au certificat TLS
• Ajout du certificat CA au magasin d'approbations hôte