Mise à niveau d'AI Center

Pour mettre à niveau AI Center™ d'une version mineure vers une autre (par exemple, de 2021.10.1 à 2021.10.2), utilisez les procédures de cette page.

Remarque : assurez-vous qu'il n'y a pas de nouveaux déploiements lors de la mise à niveau.

Important :

Si vous effectuez une mise à niveau depuis AI Center 2021.10.3 ou 2021.10.4 vers une version plus récente, une rétrogradation de Ceph 16.2.6 à 15.2.9 est requise pour éviter la corruption des données.

Pour plus d'informations, consultez la page Rétrogradation de Ceph de la version 16.2.6 à la version 15.2.9.

Mode de déploiement	Instructions de mise à niveau
Évaluation à nœud unique en ligne	Mode d'évaluation à nœud unique en ligne
Évaluation à nœud unique hors ligne	Mode d'évaluation à nœud unique hors ligne
Production en ligne multi-nœuds compatible haute disponibilité	Mode de production en ligne multi-nœuds compatible haute disponibilité
Production hors ligne multi-nœuds compatible haute disponibilité	Mode de production hors ligne multi-nœuds compatible haute disponibilité

Mode d'évaluation à nœud unique en ligne

Préparation

1. Assurez-vous qu'il y a suffisamment d'espace disque sur le nœud.
2. Téléchargez et décompressez le nouveau programme d'installation (installer.zip) sur le serveur.
3. Rendez le fichier cluster_config.json d'origine disponible sur le serveur.
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 cluster_config.json, exécutez la commande suivante :

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

Remarque : pour plus de détails sur la configuration des paramètres cluster_config.json, consultez Utilisation du fichier de configuration.

Exécution

Maintenance et sauvegarde

1. Assurez-vous d'avoir activé la sauvegarde sur le cluster. Pour plus de détails, voir Sauvegarder et restaurer le cluster.
2. Connectez-vous au nœud du serveur via SSH.
3. Vérifiez que tous les volumes souhaités ont des sauvegardes dans le cluster en exécutant la commande suivante :

   /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. Mettez le cluster en mode maintenance comme suit :
5. Exécutez la commande suivante :

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

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

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

7. Faites une sauvegarde de la base de données SQL.

Mettre à niveau l'infrastructure et les services sur les serveurs

1. Connectez-vous au serveur via SSH.
2. Devenez super utilisateur en exécutant sudo su -.
3. Supprimez la section redis dans le fichier json du correctif.
   En raison d'un problème connu de mise à niveau, nous devons modifier manuellement le fichier /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json . Ce problème est résolu dans la version 2022.4.
   Pour ce faire, ouvrez le fichier à l'aide d'un éditeur de texte et supprimez les lignes 22 à 25 et la fin , à la ligne 21 :

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Une fois les modifications effectuées, les fichiers devraient ressembler à ceci :

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Mettez à niveau l'infrastructure et les serveurs en exécutant la commande suivante :

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

5. Mettez à niveau la structure en exécutant la commande suivante :

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

6. Exécutez le programme d'installation du logiciel à l'aide de la commande ci-dessous.

   Vous devez d'abord vous connecter au serveur d'identité et récupérer un jeton d'installation. Copiez ensuite ce jeton et collez-le dans l'espace réservé à partir du fichier `cluster_config.json.

   Une fois le jeton disponible, vous pouvez exécuter l'installation d'AI Center.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -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. La commande crée également une sauvegarde de l'état du cluster et suspend toutes les autres sauvegardes planifiées.
7. 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 le nœud.
   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 serveur 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, consultez la section Comment désinstaller le cluster sur la page Résolution des problèmes.
2. Restaurez toutes les bases de données UiPath sur la sauvegarde créée avant la mise à niveau.

Restaurer l'infra sur les nœuds de serveur

1. Connectez-vous au serveur via SSH.
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

Restaurer les données des volumes

1. Connectez-vous au serveur 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 en exécutant la commande suivante à partir du nouveau groupe d'installation :

   /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

Mode d'évaluation à nœud unique hors ligne

Préparation

1. Assurez-vous qu'il y a suffisamment d'espace disque sur le nœud.
2. Téléchargez le bundle hors ligne complet (sf.tar.gz) sur le serveur choisi.
3. Téléchargez et décompressez le nouveau programme d'installation (installer.zip) sur le serveur principal.
   Remarque : donnez les autorisations appropriées au dossier en exécutant sudo chmod 755 -R <installer-folder>.
4. Rendez le fichier cluster_config.json d'origine disponible sur le serveur.
5. 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 : voir Utilisation du fichier de configuration pour remplir les paramètres restants.

Exécution

Maintenance et sauvegarde

1. Assurez-vous d'avoir activé la sauvegarde sur le cluster.
2. Connectez-vous au nœud du serveur via SSH.
3. Vérifiez que tous les volumes ont des sauvegardes dans le cluster en exécutant la commande suivante :

   /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. Mettez le cluster en mode maintenance comme suit :
5. Exécutez la commande suivante :

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

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

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

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

Mettre à niveau l'infrastructure et les services sur les serveurs

1. Connectez-vous au serveur via SSH.
2. Devenez super utilisateur en exécutant sudo su -.
3. Supprimez la section redis dans le fichier json du correctif.
   En raison d'un problème connu de mise à niveau, nous devons modifier manuellement le fichier /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json . Ce problème est résolu dans la version 2022.4.
   Pour ce faire, ouvrez le fichier à l'aide d'un éditeur de texte et supprimez les lignes 22 à 25 et la fin , à la ligne 21 :

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Une fois les modifications effectuées, les fichiers devraient ressembler à ceci :

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Mettez à niveau l'infrastructure en exécutant la commande suivante :

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -k -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

5. Mettez à niveau la structure en exécutant la commande suivante :

   /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

6. Exécutez le programme d'installation du logiciel à l'aide de la commande ci-dessous.

   Vous devez d'abord vous connecter au serveur d'identité et récupérer un jeton d'installation. Copiez ensuite ce jeton et collez-le dans l'espace réservé à partir du fichier `cluster_config.json.

   Une fois le jeton disponible, vous pouvez exécuter l'installation d'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

   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. Notez que cette commande crée également une sauvegarde de l'état du cluster et suspend toutes les autres sauvegardes planifiées.

7. 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 le bundle hors ligne infra-only (sf-infra-bundle.tar.gz) correspondant à l'ancienne version sur tous les nœuds.
3. 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>.
4. Créez un fichier restore.json et copiez-le sur le nœud. Pour plus de détails, voir Sauvegarder et restaurer le cluster.
5. Vérifiez que les données de sauvegarde etcd sont présentes sur le serveur 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. Pour plus de détails, consultez la section Comment désinstaller le cluster sur la page Résolution des problèmes.
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 nœud du serveur.
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 --offline-bundle "/path/to/older-version/sf-infra-bundle.tar.gz" --offline-tmp-folder /uipath --install-offline-prereqs --accept-license-agreement --install-type offline

Restaurer les données des volumes

1. Connectez-vous au serveur 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 offline

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

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 :

   <h3>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</h3>

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

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.
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. Mettez le cluster en mode maintenance comme suit :
5. Exécutez la commande suivante :

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

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

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

7. 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 --install-standalone-aicenter -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 --install-standalone-aicenter -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. Supprimez la section redis dans le fichier json du correctif.
   En raison d'un problème connu de mise à niveau, nous devons modifier manuellement le fichier /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json . Ce problème est résolu dans la version 2022.4.
   Pour ce faire, ouvrez le fichier à l'aide d'un éditeur de texte et supprimez les lignes 22 à 25 et la fin , à la ligne 21 :

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Une fois les modifications effectuées, les fichiers devraient ressembler à ceci :

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Mettez à niveau la structure en exécutant la commande suivante :

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

5. Exécutez le programme d'installation du logiciel à l'aide de la commande ci-dessous.

   Vous devez d'abord vous connecter au serveur d'identité et récupérer un jeton d'installation. Copiez ensuite ce jeton et collez-le dans l'espace réservé à partir du fichier `cluster_config.json.

   Une fois le jeton disponible, vous pouvez exécuter l'installation d'AI Center.

   /path/to/new-installer/install-uipath.sh --upgrade --install-standalone-aicenter -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.
6. 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.
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 ;
5. 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, consultez la section Comment désinstaller le cluster sur la page Résolution des problèmes.
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

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

Préparation

1. Identifiez tout serveur (n'étant pas un agent) qui répond aux exigences de disque pour une installation hors 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 :

   <h3>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</h3>

2. Téléchargez le bundle hors ligne complet (sf.tar.gz) sur le serveur sélectionné.
3. Téléchargez le bundle hors ligne infra uniquement (sf-infra.tar.gz) sur tous les autres nœuds.
4. 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>.
5. Rendez le fichier cluster_config.json d'origine disponible sur le serveur principal.
6. Générez le nouveau fichier cluster_config.json comme suit :
   • Si vous avez l'ancien ``cluster_config.json Si vous avez l'ancien fichier, 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 cluster config, exécutez la commande suivante :

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

7. 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.
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 la commande suivante :

   /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. Mettez le cluster en mode maintenance comme suit :
5. Exécutez la commande suivante :

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

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

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

7. 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 nœuds de serveur :

   /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

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

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. Supprimez la section redis dans le fichier json du correctif.
   En raison d'un problème connu de mise à niveau, nous devons modifier manuellement le fichier /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json . Ce problème est résolu dans la version 2022.4.
   Pour ce faire, ouvrez le fichier à l'aide d'un éditeur de texte et supprimez les lignes 22 à 25 et la fin , à la ligne 21 :

   vi /opt/UiPathAutomationSuite/Installer/Upgrade/paths/patch.json
   remove the lines: 
   {
       "upgradeScriptName": "redis_remove.sh",
       "upgradeScriptArguments": ""
   }
   remove comma on above line.

   Une fois les modifications effectuées, les fichiers devraient ressembler à ceci :

   {
       "minSourceVersion": "<version_number>",
       "maxSourceVersion": "<version_number>",
       "minTargetVersion": "<version_number>",
       "maxTargetVersion": "<version_number>",
       "pre_infra_steps": [
           {
               "upgradeScriptName": "longhorn-single-to-multiple-replicas.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_infra_steps": [],
       "pre_fabric_steps": [
           {
               "upgradeScriptName": "delete-immutable-jobs.sh",
               "upgradeScriptArguments": ""
           },
           {
               "upgradeScriptName": "rook-ceph-pre-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "post_fabric_steps": [
           {
               "upgradeScriptName": "rook-ceph-post-1.7.9.sh",
               "upgradeScriptArguments": ""
           }
       ],
       "pre_services_steps": [],
       "post_services_steps": []
   }

4. Mettez à niveau la structure en exécutant la commande suivante :

   /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

5. Exécutez le programme d'installation du logiciel à l'aide de la commande ci-dessous.

   Vous devez d'abord vous connecter au serveur d'identité et récupérer un jeton d'installation. Copiez ensuite ce jeton et collez-le dans l'espace réservé à partir du fichier `cluster_config.json.

   Une fois le jeton disponible, vous pouvez exécuter l'installation d'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

   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.
6. 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.
4. Vérifiez que les données de sauvegarde etcd sont présentes sur le serveur 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, consultez la section Comment désinstaller le cluster sur la page Résolution des problèmes.
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 (qui est le même que celui choisi 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 :

   /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

   Remarque : exécutez cette commande sur les nœuds de serveur un par un. Leur exécution simultanée n'est pas prise en charge.

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 restore.jsonfile 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

Rétrogradation de Ceph de la version 16.2.6 à la version 15.2.9

Pour plus d'informations sur la rétrogradation de Ceph, consultez la section Rétrogradation de Ceph de la version 16.2.6 à la version 15.2.9 du guide Automation Suite .