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 :

• Please note that this is a change from our HW/SW specs from Insights 2021.10. Insights 2021.10 requires a single Windows machine, while Insights 2023.4 requires a Windows machine and a Linux machine with RHEL.
• Si le client utilise la clé GPG pour une version antérieure à la version d'avril (23.10.3, 23.4.6, etc.), il doit effectuer une mise à niveau en utilisant le même compte/utilisateur qui a effectué l'installation initiale, ou il devra faire une nouvelle installation.

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 :

Review hardware and software requirements.

If you have a large database, consider manually indexing the Robot Logs using a script. Consider doing the same for the ProcessingExceptionDetails and HostMachineName columns. The installation might fail during the Insights Database migration if it has to index a large set of data.

Scénarios de mise à niveau

Mise à niveau de la version 2021.4 ou antérieure vers la version 2023.4

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. Install the new Insights version on a separate machine from the existing installation	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 la version 2021.10 à 2023.4

Remarque :

If you upgrade from 2021.10.0, export the Looker volumes using the LookerPreInstallationTool and import them during the Looker initialization, to migrate your dashboards from the old Insights Machine to the new one. When upgrading from 2021.10, you also need to truncate the Raw Message column in your database table.

The default nlog rule has changed. To find out more details check Default Log Rules for Versions 2022.4 and higher page.

Tâche	Description
1. Examiner la comparaison des fonctionnalités	Review the 2023.4 cheat sheet for functionality and feature comparisons from previous product versions before upgrading to 2022.10.
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	When upgrading your Looker on the Insights Linux Machine, run the preinstallation tool from the Insights Windows Machine to generate a ZIP file. Use the same procedure to run the Looker-initialization.sh script. Make sure to export your Looker data (dashboards, views, and app settings), in Step 6 of the Looker Preinstallation tool section, to migrate your dashboards to the Insights Linux Machine.
4. Install the new Insights version on a separate machine from the existing installation	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 de la version 2022.4 ou 2022.10 vers la version 2023.4

É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 2022.10 et Insights version 2022.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 2022.10 l'outil de préinstallation pour Insights version 2022.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. Décompressez le fichier et exécutez la commande suivante : bash Insights_looker_’unzipfile’. Vous pouvez docker ps pour vérifier si le conteneur est en cours d'exécution. Après avoir exécuté la commande bash, un fichier est généré.
6. Copiez le fichier généré sur la machine virtuelle Windows.
7. Exécutez Insights MSI.

Articles associés

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