Mode de production en ligne multi-nœuds compatible haute disponibilité

Préparation

1. Identifiez tout serveur (pas agent) qui répond aux exigences de disque pour une installation en ligne. Référencé comme serveur principal tout au long de ce document. Si vous utilisez un certificat auto-signé, exécutez la commande suivante :

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   sudo ./configureUiPathAS.sh tls-cert get --outpath /path/to/cert
   
   ### Now copy the ca.crt file generated in above location to trust store location
   sudo cp --remove-destination /part/to/cert/ca.crt /etc/pki/ca-trust/source/anchors/
   
   ### Update the trust store
   sudo update-ca-trust

2. Téléchargez et décompressez le nouveau programme d'installation (installer.zip) sur tous les nœuds.
   Remarque : donnez les autorisations appropriées au dossier en exécutant sudo chmod 755 -R <installer-folder>.
3. Rendez le fichier cluster_config.json d'origine disponible sur le serveur principal.
4. Générez le nouveau fichier cluster_config.json comme suit :
   • Si vous avez l'ancien fichier cluster_config.json, utilisez la commande suivante pour générer le fichier de configuration à partir du cluster :

     cd /path/to/new-installer ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o /path/to/store/generated/cluster_config.json

   • Si vous n'avez pas l'ancien fichier de configuration, exécutez la commande suivante :

     cd /path/to/new-installer ./configureUiPathAS.sh config get -o /path/to/store/generated/cluster_config.json

     Remarque : Consultez Expérience d'installation avancée pour compléter les paramètres restants.
5. Copiez ce cluster_config.json dans le dossier du programme d'installation sur tous les nœuds.

Exécution

Maintenance et sauvegarde

1. Assurez-vous d'avoir activé la sauvegarde sur le cluster. Pour plus de détails, voir Activation de la sauvegarde du cluster.
2. Connectez-vous à un des nœuds du serveur via SSH.
3. Vérifiez que tous les volumes souhaités ont des sauvegardes dans le cluster en exécutant /path/to/new-installer/configureUiPathAS.sh verify-volumes-backup.
   Remarque : la sauvegarde peut prendre un certain temps, attendez environ 15 à 20 minutes, puis vérifiez à nouveau la sauvegarde des volumes.
4. Pour vérifier si Automation Suite est sain, exécutez :

   kubectl get applications -n argocd

5. Mettez le cluster en mode maintenance comme suit :
   1. Exécutez la commande suivante :

      /path/to/new-installer/configureUiPathAS.sh enable-maintenance-mode

   2. Vérifiez que le cluster est en mode maintenance en exécutant la commande suivante :

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

6. Créez la sauvegarde de la base de données SQL.

Mettre à niveau l'infrastructure sur les serveurs

1. Connectez-vous à chaque serveur via SSH.
2. Devenez super utilisateur en exécutant sudo su -.
3. Exécutez la commande suivante sur tous les serveurs :

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

Dans le cadre de cette commande, nous utilisons également une sauvegarde de l'état du cluster et suspendons toutes les autres sauvegardes planifiées.

Remarque : notez que cette commande crée également une sauvegarde de l'état du cluster et suspend toutes les autres sauvegardes planifiées.

Mettre à niveau l'infrastructure des agents

1. Connectez-vous à chaque serveur via SSH.
2. Devenez super utilisateur en exécutant sudo su -.
3. Exécutez la commande suivante :

   /path/to/new-installer/install-uipath.sh --upgrade -k -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

Exécuter le reste de la mise à niveau sur le serveur principal

1. Connectez-vous au serveur via SSH.
2. Devenez super utilisateur en exécutant sudo su -.
3. Exécutez la commande suivante :

   /path/to/new-installer/install-uipath.sh --upgrade -f -s -i /path/to/cluster_config.json --accept-license-agreement -o /path/to/output.json

   Remarque : cette commande désactive le mode de maintenance que vous avez activé avant la mise à niveau car tous les services doivent être activés pendant la mise à niveau.
4. Une fois la mise à niveau et la vérification réussies, reprenez la planification de la sauvegarde sur le nœud en exécutant la commande suivante :

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups

Annulation en cas d'erreur

Préparation

1. Créez un dossier séparé pour stocker les anciens bundles et effectuez les opérations suivantes dans ce dossier.
2. Téléchargez et décompressez le programme d'installation de l'ancienne version (installer.zip) sur tous les nœuds.
   Remarque : donnez les autorisations appropriées au dossier en exécutant sudo chmod 755 -R <installer-folder>.
3. Créez un fichier restore.json et copiez-le sur tous les nœuds. Pour plus de détails, voir Sauvegarder et restaurer le cluster.
4. Vérifiez que les données de sauvegarde etcd sont présentes sur le nœud principal à l'emplacement suivant : /mnt/backup/backup/<etcdBackupPath>/<node-name>/snapshots
   • etcdBackupPath - c'est le même que celui spécifié dans backup.json lors de l'activation du node-name de la sauvegarde ;
   • node-name : le nom d'hôte de la machine virtuelle du serveur principal.

Nettoyage de cluster

1. Copiez et exécutez le script dédié pour tout désinstaller de ce nœud. Répétez l'opération pour tous les nœuds. Pour plus de détails, voir Dépannage.
2. Restaurez toutes les bases de données UiPath sur l'ancienne sauvegarde créée avant la mise à niveau.

Restaurer l'infra sur les nœuds de serveur

1. Connectez-vous au serveur principal. Il doit s'agir du même nœud de serveur que vous avez sélectionné lors de la mise à niveau.
2. Restaurez infra en exécutant la commande suivante :

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

3. Connectez-vous aux autres nœuds du serveur un par un via SSH.
4. Restaurez infra sur ces nœuds en exécutant la commande suivante sur les nœuds de serveur un par un. Leur exécution simultanée n'est pas prise en charge.

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

Restaurer l'infra sur les nœuds d'agent

1. Connectez-vous à chaque MV d'agent via SSH.
2. Restaurez infra sur ces nœuds en exécutant la commande suivante :

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

Restaurer les données des volumes

1. Connectez-vous au serveur principal via SSH.
2. Accédez au nouveau dossier d'installation.
   Remarque : les commandes de restauration infra précédentes ont été exécutées à l'aide de l'ancien programme d'installation, et les commandes suivantes sont exécutées à l'aide du nouvel ensemble d'installation.
3. Désactivez le mode maintenance sur le cluster en exécutant la commande suivante :

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

4. Vérifiez que le mode de maintenance est désactivé en exécutant la commande suivante :

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

5. Copiez le fichier restore.json qui a été utilisé dans l'étape de restauration de l'infra dans le nouveau dossier du bundle d'installation.
6. Restaurez les volumes à partir du nouveau bundle d'installation en exécutant la commande suivante :

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

7. Une fois la restauration terminée, vérifiez si tout est restauré et fonctionne correctement.
8. Lors de la mise à niveau, les sauvegardes planifiées ont été désactivées sur le nœud principal. Pour les réactiver, exécutez la commande suivante :

   /path/to/new-installer/configureUiPathAS.sh resume-scheduled-backups