Mise à niveau hors ligne

Préparation

Avertissement :

Assurez-vous que vous disposez de 10 Go d'espace libre dans le dossier /opt/UiPathAutomationSuite sur tous les nœuds. Si vous ne disposez pas de suffisamment d'espace, vous pouvez augmenter la capacité de ce dossier ou supprimer tous les fichiers du programme d'installation précédents, à l'exception de cluster_config.json . Vous pouvez toujours télécharger à nouveau le programme d'installation précédent.

Pour vérifier l'espace disponible, exécutez la commande suivante : df -h /opt/UiPathAutomationSuite .

Pour préparer la mise à niveau, procédez comme suit :

1. Identifiez le nœud du serveur (pas l'agent) auquel un disque UiPath bundle supplémentaire est attaché au point de montage /uipath . Ce nœud est appelé nœud de serveur principal dans tout le document. Dans le cas d'un profil d'évaluation à nœud unique, où vous n'avez qu'un seul nœud de serveur, vous devez vous connecter à ce nœud.

   Remarque :

   Effectuez les étapes suivantes sur tous les nœuds du cluster. Commencez par les nœuds de serveur et continuez avec les nœuds d'agent.

2. Connectez-vous à un nœud à l'aide de SSH.

3. Devenir utilisateur racine :

   sudo su -
   

4. Créez un dossier d'installation sous le répertoire /opt/UiPathAutomationSuite :

   <h1>Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer</h1>
   

5. Download sf-installer.zip and copy it to /opt/UiPathAutomationSuite/{version}/installer. For download instructions, see sf-installer.zip.

   cp /path/to/sf-installer.zip /opt/UiPathAutomationSuite/{version}/installer
   

6. Download sf-infra.tar.gz and copy it to /opt/UiPathAutomationSuite/{version}. For download instructions, see sf-infra.tar.gz:

   cp /path/to/sf-infra.tar.gz /opt/UiPathAutomationSuite/{version}
   

7. (Only on the primary server node). Download sf.tar.gz and copy it to /uipath/{version}. For download instructions, see sf.tar.gz:

   cp /path/to/sf.tar.gz /uipath/{version}
   

8. Décompresser sf-installer.zip :

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip sf-installer.zip -d .
   

9. Fournissez les autorisations nécessaires au programme d'installation :

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
   

10. Generate the latest cluster_config.json on the first server node and copy it to the rest of the nodes. For details on how to configure the cluster_config.json parameters, see Using the configuration file.

• Si vous avez l'ancien cluster_config.json , générez le fichier de configuration à partir du cluster en exécutant :

  cd /opt/UiPathAutomationSuite/{version}/installer
  ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json
  

• Si vous ne disposez pas de l'ancien fichier cluster_config.json , générez un remplacement de toutes les valeurs par défaut que vous avez pu effectuer au moment de l'installation de la version précédente :

  cd /opt/UiPathAutomationSuite/{version}/installer
  ./configureUiPathAS.sh config get -o ./cluster_config.json
  

Adding AI Center specific configuration

1. Ouvrez le cluster_config.json avec votre éditeur (par exemple, vi).

   vi /opt/UiPathAutomationSuite/{version}/installer/cluster_config.json
   

2. Remplacez le bloc suivant :

   "aicenter": {
     "enabled": "false"
   },
   

   Remarque :

   Document Understanding is enabled by default if AI Center is enabled.

3. Avec les informations suivantes (en remplaçant les informations entre <> par vos valeurs) :

   "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>",
   },
   

Exécution

Avertissement :

If any errors or issues occur during or following the upgrade, you can rollback to the previous version, provided that you previously configured a backup. For instructions, see Rollback on error.

Configuration de la sauvegarde

Pour configurer la sauvegarde, procédez comme suit :

1. Make sure you have enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the UiPath AI Center version from which you plan to upgrade.

2. Connectez-vous à un des nœuds du serveur via SSH.

3. Pour vérifier que tous les volumes souhaités ont des sauvegardes dans le cluster, exécutez :

   /path/to/old-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.

Une fois la sauvegarde créée, passez aux étapes suivantes.

Mettre le cluster en mode maintenance

Mettre le cluster en mode maintenance arrêtera le contrôleur d'entrée et tous les services UiPath, bloquant ainsi tout le trafic entrant vers le cluster AI Center.

Avertissement :

Cette opération entraînera des temps d'arrêt et l'automatisation de votre entreprise sera suspendue pendant l'ensemble du processus de mise à niveau.

1. Pour mettre le cluster en mode maintenance, exécutez :

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./configureUiPathAS.sh enable-maintenance-mode
   

2. Pour vérifier que le cluster est en mode maintenance, exécutez :

   ./configureUiPathAS.sh is-maintenance-enabled
   

   Avertissement :

   Créez une sauvegarde de votre serveur SQL après avoir activé le mode de maintenance afin qu'aucune autre transaction ne soit enregistrée dans votre base de données SQL.

Mise à jour de Kubernetes et d'autres composants d'infrastructure

Avertissement :

Vous devez effectuer la mise à niveau de l'infrastructure sur tous les nœuds du cluster.

Vous ne pouvez pas effectuer cette étape sur plusieurs nœuds en même temps ; vous devez attendre la fin de la mise à niveau sur chaque nœud avant de passer à un autre.

1. Connectez-vous à chaque nœud sur lequel vous souhaitez effectuer la mise à niveau de l'infrastructure.

2. Devenez super utilisateur en exécutant sudo su -.

3. Assurez-vous que rke service est activé sur les nœuds du serveur et de l'agent.

   Si le service est désactivé, activez-le en exécutant la commande suivante :

   • Pour les nœuds de serveur :

     [[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service
     

   • Pour les nœuds d'agent :

     [[ $(systemctl is-enabled rke2-agent.service) != "enabled" ]] && systemctl enable rke2-agent.service
     

4. Pour démarrer la mise à niveau, exécutez la commande suivante :

   Avertissement :

   Assurez-vous d'avoir mis à jour cluster_config.json généré comme décrit dans les étapes de préparation.

   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
   

   Important :

   If you get an error, follow the instructions in Downgrading Ceph from 16.2.6 to 15.2.9.

Mise à jour des composants partagés et des services produit UiPath

Cette étape met à niveau les composants Fabric et de service exécutés avec le cluster. Vous devez suivre ces étapes uniquement sur le nœud du serveur principal.

1. Connectez-vous à n'importe quel nœud de serveur.

2. Devenez super utilisateur en exécutant sudo su -.

3. Exécutez la commande suivante :

   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
   

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

   Avertissement :

   Une fois la mise à niveau terminée, le mode maintenance sera automatiquement désactivé.

Activation de la sauvegarde après la mise à niveau

Avertissement :

Assurez-vous qu'AI Center est opérationnel et que votre automatisation se poursuit comme prévu avant de passer aux étapes suivantes.

Avant de commencer à mettre à niveau le cluster, le script de mise à niveau crée automatiquement une sauvegarde du cluster, puis la désactive temporairement. Vous souhaiterez peut-être activer la sauvegarde manuellement une fois la mise à niveau terminée.

Pour activer la sauvegarde, exécutez la commande suivante à partir de n'importe quel nœud de serveur :

replace {version} with the version you are upgrading to
cd /opt/UiPathAutomationSuite/{version}/installer
./configureUiPathAS.sh resume-scheduled-backups