Mise à niveau

Pour mettre à niveau vers une nouvelle version d'Insights, vous devez suivre les étapes en fonction de votre scénario de mise à niveau.

Important :

• Veuillez noter qu'il s'agit d'un changement par rapport à nos spécifications matérielles/logicielles d'Insights 2021.10. Insights 2021.10 nécessite une seule machine Windows, tandis qu'Insights 2024.10 nécessite une machine Windows et une machine Linux avec RHEL. En version 2021.10, la machine Insights Windows exécutait Docker qui hébergeait le conteneur Linux Looker. À partir de Windows 2022, le pilote utilisé pour imbriquer les conteneurs Linux dans le système d'exploitation Windows (appel lcow) n'est plus pris en charge par Microsoft pour les applications d'entreprise. Par conséquent, nous avons dû modifier notre architecture de déploiement pour exiger deux machines : une machine Windows pour exécuter les composants UiPath Insights et une machine Linux pour exécuter le conteneur Looker. Avec cette modification, la prise en charge des applications d'entreprise est disponible auprès des fournisseurs de systèmes d'exploitation pour les composants nécessaires à l'exécution des produits UiPath. Les versions prises en charge du système d'exploitation Linux sont les mêmes que celles prises en charge par Automation Suite.

Remarque :

Consulter Prérequis logiciels et matériels. Si vous avez une grande base de données, envisagez d' indexer manuellement le Journal de Robot à l'aide d'un script. Envisagez de faire de même pour les colonnes ProcessingExceptionDetails et HostMachineName . L'installation peut échouer lors de la migration de la base de données Insights si elle doit indexer un grand nombre de données.

Scénarios de mise à niveau

Mise à niveau de la version 2021.4 ou d’une version antérieure vers 2024.10

Tâche	Description
1. Migrer les utilisateurs	Lors de la mise à niveau à partir d'une version antérieure à 2021.10, les utilisateurs disposant d'autorisations Insights ne sont pas automatiquement migrés vers votre nouvelle installation. Ils peuvent éventuellement être migrés via l'outil de migration des utilisateurs (User Migration tool).
2. Installer la nouvelle version d'Insights sur une machine distincte de l'installation existante	Suivez les instructions d'installation d'Insights pour l'installer sur une machine distincte. Après avoir installé la dernière version d'Insights sur une nouvelle machine, l'ingestion des anciennes données s'arrêtera.
3. Désinstaller l'ancienne version d'Insights	Une fois que vous avez terminé la création des nouveaux tableaux de bord et formules personnalisés sur la version nouvellement installée d'Insights, vous pouvez désinstaller l'ancienne version en toute sécurité.

Remarque :

• L'ancienne et la nouvelle installation d'Insights utiliseront la même base de données lors du déplacement des tableaux de bord.
• Pour vous connecter à Insights, vous pouvez utiliser l'ancienne URL https://<old Insights url>/app/account/login et le même compte administrateur qui a été configuré lors de l'installation.

Pour désactiver les anciennes versions, suivez les étapes ci-dessous :

1. Connectez-vous à l'ancienne URL (https://<old Insights url>/app/account/login).
2. Accédez à https://<old Insights url>/app/data .
3. Cliquez sur l'icône à trois points sur chaque cube et accédez à la planification des builds pour désactiver les builds.

Mise à niveau de 2021.10 vers 2024.10

Remarque :

Si vous mettez à niveau depuis la version 2021.10.0, exportez les volumes Looker à l'aide de l'OutilPréinstallationLooker et importez-les lors de l'initialisation de Looker pour migrer vos tableaux de bord depuis l'ancienne machine Insights vers la nouvelle machine. Lors de la mise à niveau depuis la version 2021.10, vous devez également tronquer la colonne Raw Message dans votre table de base de données. La règle nlog par défaut a changé. Pour plus d'informations, consultez la page Règles de journalisation par défaut pour les versions 2022.4 et supérieures .

Tâche	Description
1. Examiner la comparaison des fonctionnalités	Consultez l' aide-mémoire pour la mise à niveau pour comparer les fonctions et les fonctionnalités des versions précédentes du produit avant de mettre à niveau.
2. Migrer les utilisateurs	Lors de la mise à niveau à partir d'une version antérieure à 2021.10, les utilisateurs disposant d'autorisations Insights ne sont pas automatiquement migrés vers votre nouvelle installation. Ils peuvent éventuellement être migrés via l' outil de migration des utilisateurs (User Migration tool). Si vous avez déjà utilisé l'outil lors de la mise à niveau vers 2021.10, vous n'avez pas besoin de réexécuter l'outil de migration des utilisateurs.
3. (Migration du tableau de bord) Exécutez l'OutilPréinstallationLooker (LookerPreInstallationTool) et exportez les volumes Looker	Lors de la mise à niveau de votre Looker sur la machine Linux Insights, exécutez l'outil de préinstallation à partir de la machine Windows Insights pour générer un fichier ZIP. Utilisez la même procédure pour exécuter le script Looker-initialization.sh. Assurez-vous d'exporter vos données Looker (tableaux de bord, vues et paramètres d'application) à l'étape 6 de la section Outil de préinstallation Looker (Looker Preinstallation tool) pour migrer vos tableaux de bord vers la machine Insights Linux.
4. Installez la nouvelle version d'Insights sur une machine distincte de l'installation existante	Suivez les instructions d'installation d'Insights pour l'installer sur une machine distincte. Après avoir installé la dernière version d'Insights sur une nouvelle machine, l'ingestion des anciennes données s'arrêtera.
5. Désinstaller l'ancienne version d'Insights	Une fois que vous avez terminé la création des nouveaux tableaux de bord et formules personnalisés sur la version nouvellement installée d'Insights, vous pouvez désinstaller l'ancienne version en toute sécurité.

Mise à niveau depuis la version 2022.4, 2022.10 2023.4 ou 2023.10 vers 2024.10

Étapes de mise à niveau

Avant de mettre à niveau Insights vers une version supérieure, assurez-vous de :

• Vérifiez et mettez à niveau la version d'Orchestrator si nécessaire. Il est recommandé pour Orchestrator et Insights d'utiliser la même version (par exemple Orchestrator version 2024.10 et Insights version 2024.10). Ne pas avoir la même version a un impact sur les performances de l'application. Pour savoir comment installer Orchestrator, consultez À propos de l'installation et À propos de la mise à jour si vous souhaitez mettre à jour votre version actuelle.
• Assurez-vous que le package MSI et preinstallationtool.exe ont été téléchargés et assurez-vous qu’ils correspondent entre les versions. (par ex. Orchestrator version 2024.10 l’outil de préinstallation pour Insights version 2024.10). Consultez la page Portail client (Customer Portal) > Téléchargement de produit (Product download) pour télécharger les fichiers requis ou demander à l'équipe d'assistance.

Pour démarrer le processus de mise à niveau, suivez ces étapes :

1. Faites mettre à niveau la version majeure d'UiPath Orchestrator pour qu'elle corresponde à la version majeure d'Insights.
2. Faites télécharger le package MSI et preinstallationtool.exe. Consultez la page Customer Portal > Téléchargement de produit (Product download) pour télécharger les fichiers requis ou demander à l’équipe d’assistance.
3. Exécutez et fournissez les informations demandées dans l'outil de préparation à l'installation. (Nom d'hôte Linux, empreinte numérique, etc.)
4. Copiez le fichier généré par l'outil de préinstallation sur la machine virtuelle Linux.
5. Unzip the zip file from the preinstallationtool into the installation directory. a. Locate the parent directory: dirname $(sudo docker inspect looker-container | jq -r '.[0].HostConfig.Binds' | grep 'deploy' | awk -F':/app/.deploy:Z' '{print $1}' | awk -F'"' '{print $2}') b. Unzip to that directory: unzip <looker zip file> -d <parent dir>
6. Exécutez le script looker-initialization.sh. bash insights/looker-initialization.sh.
7. Copiez le fichier généré sur la machine virtuelle Windows.
8. Exécutez Insights MSI.

Articles associés

• Vérifiez les services Insights (Insights Services).
• Modification des configurations Insights