automation-suite
2023.4
false
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique.
Guide d'installation d'Automation Suite sur Linux
Last updated 2 oct. 2024

Manuel : mise à niveau hors ligne

Préparation

Important :
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 : suivez 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 -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# Please replace {version} with installer version
    mkdir -p /opt/UiPathAutomationSuite/{version}/installer
  5. Téléchargez as-installer.zip et copiez-le dans /opt/UiPathAutomationSuite/{version}/installer. Pour obtenir des instructions de téléchargement, consultez as-installer.zip.
    cp /path/to/as-installer.zip /opt/UiPathAutomationSuite/{version}/installercp /path/to/as-installer.zip /opt/UiPathAutomationSuite/{version}/installer
  6. Téléchargez as-infra.tar.gz et copiez-le dans /opt/UiPathAutomationSuite/{version}. Pour obtenir des instructions de téléchargement, voir as-infra.tar.gz :
    cp /path/to/as-infra.tar.gz /opt/UiPathAutomationSuite/{version}cp /path/to/as-infra.tar.gz /opt/UiPathAutomationSuite/{version}
  7. (Uniquement sur le nœud du serveur principal). Téléchargez as.tar.gz et copiez-le dans /uipath/{version}. Pour obtenir des instructions de téléchargement, consultez as.tar.gz :
    cp /path/to/as.tar.gz /uipath/{version}cp /path/to/as.tar.gz /uipath/{version}
  8. Décompresser as-installer.zip :
    cd /opt/UiPathAutomationSuite/{version}/installer
    unzip as-installer.zip -d .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}/installerchmod 755 -R /opt/UiPathAutomationSuite/{version}/installer
  10. Générez le dernier cluster_config.json sur le premier nœud de serveur et copiez-le sur le reste des nœuds. 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 en exécutant :
      cd /opt/UiPathAutomationSuite/{version}/installer
      
      ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.jsoncd /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.jsoncd /opt/UiPathAutomationSuite/{version}/installer
      
      ./configureUiPathAS.sh config get -o ./cluster_config.json
    • Si vous effectuez une mise à niveau d'Automation Suite 2022.10 vers Automation Suite 2023.4 ou une version ultérieure, et qu'Orchestrator est activé sur l'ancienne et la nouvelle version, vous devez définir l'indicateur orchestrator.block_classic_executions sur true dans le fichier cluster_config.json. L'utilisation de l'indicateur montre que vous êtes d'accord avec le blocage des exécutions de dossiers classiques. La non-utilisation de l'indicateur entraîne l'échec de l'opération de mise à niveau. Pour obtenir un exemple de configuration, consultez Configuration spécifique à Orchestrator.
    • Si vous utilisez AI CenterTM connecté à un Orchestrator externe, assurez-vous que vous disposez du certificat Orchestrator dans le fichier cluster_config.json. En cas de mise à niveau à partir d'une version antérieure à 2022.10, copiez le certificat Orchestrator vers 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
        }"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.
    • 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://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server""sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://testadmin@sfmfup20211043125452-8926d153-sql.database.windows.net:sgTQrg%40R%40dvoYddYBoKn045ncoC9WhWU@sfmfup20211043125452-8926d153-sql.database.windows.net:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"
    • Si vous mettez à niveau Automation Suite à partir d'une version antérieure à 2023.4 et qu'Apps est activé, vous devez créer la base de données SQL pour Apps , puis mettre à jour le fichier cluster_config.json avec la configuration suivante :
      "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
      }"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.

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

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.

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.
  • Si vous mettez à niveau Document Understanding et Computer Vision, vous devez télécharger les images de base qui correspondent à votre version mise à niveau d'Automation Suite (utilisez l'image de base qui correspond à la version de votre paquet ML) et les intégrer dans votre registre Docker avant la mise à niveau pour éviter d'interrompre l'exécution de vos compétences DU. Pour télécharger les packages d'installation de Document Understanding et Computer Vision, consultez Téléchargement des packages d'installation.
  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/tmpcd /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 ../../tmpcd /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. 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'UiPath AI Center™ à 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. 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/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-modecd /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./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 les nœuds de serveur :

      [[ $(systemctl is-enabled rke2-server.service) != "enabled" ]] && systemctl enable rke2-server.service[[ $(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[[ $(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 --offline-bundle ../as-infra.tar.gz --offline-tmp-folder /opt/UiPathAutomationSuite/tmp --install-offline-prereqs --accept-license-agreement# 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 :

    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

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# 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é.

    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 argocdkubectl 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./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 }}}}'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 }}}}'
  • 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

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.

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

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.