Manuel : mise à niveau en ligne

Préparation

Important :

Effectuez les étapes suivantes sur le premier nœud de serveur, puis sur tous les autres nœuds (serveur et agent) du cluster.

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. Connectez-vous à n'importe quelle machine serveur à l'aide de SSH. Dans le cas d'un profil d'évaluation à nœud unique, où vous n'avez qu'un seul nœud de serveur, connectez-vous à ce nœud.
2. Devenir utilisateur racine :

   sudo su -

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

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

4. Téléchargez sf-installer.zip et copiez-le dans /opt/UiPathAutomationSuite/{version}/installer. Pour obtenir des instructions de téléchargement, consultez sf-installer.zip.

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

5. Décompresser sf-installer.zip :

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

6. Accordez l’autorisation au programme d’installation :

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

7. Générez le dernier fichier cluster_config.json sur le premier nœud de serveur et copiez-le sur le reste des nœuds.
   Remarque : Pour plus de détails sur la configuration des paramètres cluster_config.json, voir Expérience d'installation avancée.

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

     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 tout remplacement des valeurs par défaut, ce que vous avez peut-être fait au moment de l'installation de la version précédente :

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

   • Si vous effectuez une mise à niveau à partir d'une version antérieure d' AI CenterTM autonome et que votre version 2022.10 d'AI Center doit être connectée à un Orchestrator externe, copiez le certificat Orchestrator sur la machine virtuelle. Après avoir copié le certificat, les détails de configuration suivants sont nécessaires dans 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 : si AI Center nécessite une installation Orchestrator externe, ajoutez sql_connection_string_template et sql_connection_string_template_odbc au fichier cluster_config.json.

     Après la mise à niveau vers AI Center 2022.10 et le passage vers le stockage externe, il sera impossible de rendre publique une compétence créée dans la version 2022.4. Pour résoudre ce problème, exécutez le script à partir d’ici.

   • Si vous mettez à niveau Automation Suite à partir d'une version précédente et activez également Process Mining, vous devez mettre à jour l'élément sql_connection_string_template_sqlalchemy_pyodbc. Voici un exemple.

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

     Consultez également la section Manuel : expérience d’installation avancée.

8. (Facultatif) Si vous utilisez toujours un certificat auto-signé généré par le programme d'installation, exécutez la commande suivante. Cette étape est requise sur le premier nœud de serveur, où vous effectuerez la mise à niveau des produits UiPath.

   ### Please replace /path/to/cert with path to location where you want to store certificates.
   ./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

Exécution

Attention : Si des erreurs ou des problèmes se produisent pendant ou après la mise à niveau, vous pouvez revenir à la version précédente, à condition d'avoir préalablement configuré une sauvegarde. Pour obtenir des instructions, consultez la section Annulation en cas d'erreur.

Configuration de la sauvegarde

Pour configurer la sauvegarde, procédez comme suit :

1. Assurez-vous d’avoir activé la sauvegarde sur le cluster. Vous devez créer la sauvegarde à l’aide de la même version du programme d’installation que celle que vous avez utilisée pour le déploiement actuel. Pour obtenir des instructions, consultez la documentation de sauvegarde et de restauration correspondant à la version d’Automation Suite à partir de laquelle vous prévoyez d’effectuer la mise à niveau. Par exemple, si vous prévoyez d’effectuer une mise à niveau à partir d’Automation Suite 2021.10, suivez les instructions du guide 2021.10.
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 Automation Suite.

Attention : Cette opération entraînera des temps d'arrêt et l'automatisation de votre entreprise sera suspendue pendant tout le 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

   Attention : Créez une sauvegarde de votre serveur SQL après avoir activé le mode 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 un nœud de serveur :

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

   • Pour un nœud 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 :
   Attention : 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 --accept-license-agreement

   Important :

   Si vous obtenez l'erreur suivante, suivez les instructions de Rétrogradation de Ceph de la version 16.2.6 à la version 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

Important : si vous avez précédemment déployé votre installation à nœud unique à l'aide de n'importe quelle version de modèle Azure antérieure à 2022.10.3, et que vous souhaitez désormais effectuer une mise à niveau vers une version plus récente d'Automation Suite, vous devez définir l'indicateur zone_resilience sur false dans le fichier cluster_config.json sous /opt/UiPathAutomationSuite/Installer.

Cette étape met à niveau les composants Fabric et de service exécutés avec le cluster. Vous ne devez suivre ces étapes qu'une seule fois à partir de l'un des nœuds de serveur.

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
   cd /opt/UiPathAutomationSuite/{version}/installer
   
   ./install-uipath.sh --upgrade -f -s -i ./cluster_config.json --accept-license-agreement -o ./output.json

   Important :

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

   Après la mise à niveau manuelle depuis Automation Suite 2021.10, vous devez également migrer vers Cilium CNI. Pour obtenir des instructions, consultez la section Migration depuis Canal vers le CNI Cilium.

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

• Si vous rencontrez des problèmes de vulnérabilité d’image ou de consommation de stockage après avoir effectué une mise à niveau, supprimez les images de l’ancien programme d’installation. Pour plus de détails, consultez la section Résolution des problèmes (Troubleshooting).

Activation de la sauvegarde après la mise à niveau

Vous devez reprendre la sauvegarde après avoir mis à niveau et effectué les opérations de nettoyage et de migration.

Important :

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

Pour activer la sauvegarde, suivez les instructions décrites dans la documentation Sauvegarder et restaurer le cluster.

Finalisation d'une mise à niveau avec un modèle de déploiement

Après avoir effectué une mise à niveau du cluster Automation Suite, les déploiements de modèles Azure et AWS nécessitent quelques modifications pour garantir qu'un nouveau nœud rejoint correctement le cluster via des opérations de mise à l'échelle. Pour automatiser les modifications, nous vous recommandons d'utiliser les scripts dédiés. Pour obtenir des instructions, consultez la documentation relative aux modèles de déploiement Azure et la documentation relative aux modèles de déploiement AWS.

Considérations spéciales

Lors de l'exécution d'une mise à niveau pour un cluster déployé avec des modèles Azure, une erreur similaire à celle illustrée dans l'image suivante peut se produire :

Cela est dû au mode de fonctionnement de l’équilibreur de charge Azure. Pour résoudre le problème, modifiez le champ fixed_rke_address dans le fichier cluster_config.json. Vous devez remplacer la valeur de ce champ par l’adresse IP de la première instance de serveur avant d’exécuter la commande de mise à niveau. Le fichier cluster_config.json téléchargé vers le coffre de clés doit continuer à avoir l’adresse IP de l’ILB, car le nœud n’est pas sain et le trafic ne sera pas équilibré.