Manuel : mise à niveau hors ligne

Préparation

Important :

Assurez-vous d'avoir 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édent, à 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 :

   # Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer
   

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

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

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

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

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

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

8. Décompresser as-installer.zip :

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip as-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 Advanced installation experience.

    • 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
      

    • If you upgrade from Automation Suite 2022.10 to Automation Suite 2023.4 or later, and Orchestrator is enabled on both the old and new versions, you must set the orchestrator.block_classic_executions flag to true in the cluster_config.json file. Using the flag shows that you agree with blocking classic folders executions. Not using the flag causes the upgrade operation to fail. For a configuration example, see Orchestrator-specific configuration.

    • If you are using AI Center^TM connected to an external Orchestrator, make sure that you have the Orchestrator certificate in the cluster_config.json file. If you upgrade from a version older than 2022.10, copy the Orchestrator certificate to the virtual machine. After you copy the certificate, the following configuration details are needed in cluster_config.json:

      "aicenter": {
          "enabled": true,
          "orchestrator_url": "https://orchestrator.example.com", //Specify the Orchestrator URL for AI Center
          "identity_server_url": "https://orchestrator.example.com/identity", //Specify the Identiy URL for AI Center
          "orchestrator_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to the Orchestrator certificate
          "identity_cert_file_path": "/opt/UiPathAutomationSuite/UiPath_Installer/orch.cer", //Specify the path to Identity certificate file
          "metering_api_key": "test" //Specify the metering API key
        }
      

      Remarque :

      If AI Center requires an external Orchestrator, add sql_connection_string_template and sql_connection_string_template_odbc in the cluster_config.json file.

    • If you upgrade Automation Suite from a previous version and now enable Process Mining as well, you must update the sql_connection_string_template_sqlalchemy_pyodbc. Below is an example.

      "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://[e-mail]:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
      

    • If you upgrade Automation Suite from a version previous to 2023.4 and you have Apps enabled, you must create the SQL database for Apps, and then update the cluster_config.json file with the following configuration:

      "apps": {
      "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
      "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
      }
      

      Remarque :

      Utilisez le fichier cluster_config.json mis à jour dans les prochaines étapes de mise à niveau.

    See also Manual: Advanced installation experience.

Exécution

Important :

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.

Hydrater le registre Docker et le conteneur

Pour minimiser les temps d'arrêt requis, hydratez docker-registry et containerd avec des images de conteneur pour la nouvelle version des produits avant la mise à niveau en procédant comme suit.

Important :

• Assurez-vous de ne pas hydrater avec des images conteneur et/ou d'autres images d'infrastructure plus de 10 heures avant la mise à niveau.
• If you upgrade Document Understanding and Computer Vision, you must download the base images that match your upgraded Automation Suite version (use the base image that corresponds with your ML Package version) and hydrate them to your docker registry prior to upgrade to avoid disruption to your running DU skills. To download the Document Understanding and Computer Vision installation packages, see Downloading the installation packages.

1. Pour hydrater docker-registry , exécutez la commande suivante sur le premier nœud du serveur :

   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./configureUiPathAS.sh registry upload --offline-bundle /uipath/{version}/as.tar.gz --offline-tmp-folder /uipath/tmp
   

2. Remarque :

   Assurez-vous que zstd est installé. Pour installer zstd, exécutez la commande suivante : dnf install zstd.

   Pour hydrater containerd , exécutez la commande suivante sur tous les nœuds :

   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./configureUiPathAS.sh containerd --offline-bundle ../as-infra.tar.gz --offline-tmp-folder ../../tmp
   

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 Automation Suite version from which you plan to upgrade. For instance, if you plan to upgrade from Automation Suite 2021.10, follow the instructions in the 2021.10 guide.

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/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 Automation Suite.

Important :

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
   

   Important :

   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

Important :

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 :

   Important :

   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
   
   ./install-uipath.sh --upgrade -k -i ./cluster_config.json -o ./output.json --offline-bundle ../as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement
   

   Important :

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

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

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

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
   ./install-uipath.sh --upgrade -f -s -i ./cluster_config.json -o ./output.json --install-type offline --accept-license-agreement
   

   Important :

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

   After manually upgrading from Automation Suite 2021.10, you must also migrate to Cilium CNI. For instructions, see Migrating from Canal to Cilium CNI.

Une fois la mise à niveau effectuée, vous pouvez effectuer les étapes supplémentaires suivantes :

• Pour vérifier si Automation Suite est sain, exécutez :

  kubectl get applications -n argocd
  

• Lors de la mise à niveau à partir d'une version d'Automation Suite antérieure à 2023.4.0, vérifiez si Apps est en cours d'exécution, puis supprimez MongoDB :

  ./configureUiPathAS.sh mongodb uninstall --force
  

• Si vous rencontrez une erreur lors de la suppression de MongoDB avec la commande ./configureUiPathAS.sh mongodb uninstall --force, essayez d'exécuter la commande suivante

  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
  
  ./configureUiPathAS.sh mongodb uninstall --force
  
  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'
  

• If you experience issues with image vulnerabilities or storage consumption after performing an upgrade, delete the images from the old installer. For details, see the Troubleshooting section.

• After upgrading to Automation Suite 2023.4.8 or newer, you can clean up the previous version images after the upgrade from the in-cluster Docker registry. For instructions, see How to delete images from the old installer after upgrade.

Activation de la sauvegarde après la mise à niveau

Important :

Assurez-vous qu'Automation Suite est opérationnelle 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.

To enable the backup, follow the instructions in described in the Backing up and restoring the cluster documentation.