Installation

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.

Les installations sur des versions non prises en charge de RHEL sont bloquées et vous devez effectuer une mise à jour vers une version prise en charge. Vérifiez le système d'exploitation pour connaître les versions prises en charge.

Important : Insights ne doit pas être installé dans un dossier /tmp car cela peut créer des problèmes après un redémarrage. L'installation doit être effectuée dans un répertoire persistant.

Remarque :

Les versions majeures d'Orchestrator et d'Insights doivent correspondre. Par exemple, si vous avez mis Orchestrator à niveau vers la version 2024.10.X, vous devez exécuter une version 2024.10.X d'Insights pour assurer une communication correcte entre les deux produits UiPath.

Remarque : Une installation multi-nœuds n'est pas prise en charge, mais après l'installation, Insights peut être activé sur une installation existante d'Orchestrator multi-nœuds.

Vue d'ensemble (Overview)

Pour installer une version autonome d'Insights v2024.10, vous devez suivre ces procédures dans l'ordre indiqué ci-dessous :

1. Préparez les machines Windows et Linux Insights
2. Initialisez Looker sur la machine Linux Insights
3. Installez Insights.

Préparez la machine Windows Insights et la machine Linux Insights

Étape 1

Préparez le ou les certificats (Certificate) pour activer SSL pour les deux machines. Pour plus d'informations, cliquez ici.

Remarque : Assurez-vous d'importer les certificats Looker et Insights sur la machine sur laquelle vous souhaitez accéder à Insights.

Le certificat de la machine Insights Linux doit être installé sur la machine Insights Windows, car OutilPréinstallationLooker.exe (LookerPreinstallationtool.exe) exportera le certificat de la machine Insights Windows vers la machine Insights Linux.

La machine Windows et la machine Linux traiteront la requête HTTPS. À ce titre, les deux utiliseront un certificat pour les connexions HTTPS. Assurez-vous comme prérequis d'avoir un certificat valide pour le serveur Linux et un certificat valide pour la machine Windows.

Étape 2

Configurez deux machines qui répondent aux prérequis logiciels et matériels.

Important :

• Assurez-vous de sélectionner le rôle bd_propriétaire (db_owner), car il est requis lorsque vous ajoutez le rôle de propriétaire de la base de données lors de la configuration machine d'Insights SQL.
• Les versions majeures d'Orchestrator et d'Insights doivent correspondre. Par exemple, si vous avez mis Orchestrator à niveau vers la version 2023.4.X, vous devez exécuter une version 2023.4.X d'Insights pour assurer une communication correcte entre les deux produits UiPath.
• La base de données Insights doit pointer vers la même base de données qui a été créée lorsque vous avez activé Insights lors de l'installation d'Orchestrator.
• Si vous disposez d'une grande base de données, envisagez d'ajouter manuellement des index à l'aide de scripts SQL. L'installation d'Orchestrator peut échouer lors de la migration de la base de données Insights si elle doit indexer un grand nombre de données (voir Échec de la migration de la base de données lors de l'installation (Database migration fails during installation)).

Préparer une machine Linux

Préparation d'une machine Linux AWS EC2

Étape 1 : Lancez une instance Linux dans AWS EC2

1. Initialisez le lancement de l'instance.
2. Sélectionnez l ' image Red Hat Enterprise Linux 8
   Remarque : Nous prenons en charge les versions 8.2, 8.4 et 8.6. La prise en charge de 8.8, 9.1 et 9.2 est disponible depuis le correctif d'août et devrait être disponible pour toutes les versions après (23.4.2+, 22.10.5+, Etc.
3. Choisissez un type d'instance (Instance Type) et configurez les détails de l'instance (Instance Details).
4. Ajoutez du stockage à votre instance et modifiez la Taille (Size) en 32.
5. Examiner et lancer l'instance

   our plus d'informations, consultez Initialiser le lancement de l'instance dans AWS (Initiate instance launch in AWS).

Remarque :

Le script utilise Sudo pour effectuer l'initialisation et si l'hôte Linux utilise dzdo au lieu de Sudo, le script utilisera également dzdo.

Étape 2 : Ouvrir les ports entrants

Ouvrez les ports entrants listés dans le tableau ci-dessous en suivant les instructions ici :

Saisie de texte	Plage de ports	Source	Description
TCP personnalisé	9999	N'importe où-IPv4 (Anywhere-IPv4)	C'est le port Looker.
TCP personnalisé	19999	N'importe où-IPv4 (Anywhere-IPv4)	Il s'agit du port de l'API Looker.
TCP personnalisé	29999	N'importe où-IPv4 (Anywhere-IPv4)	Il s'agit du port de mise à jour LookML.

Préparation d'un environnement Microsoft Azure Linux

Étape 1 : Créer une machine exécutant Linux

1. Accédez à Services > Machines virtuelles (Virtual machines)
2. Accédez à Voir toutes les images (See all images) et sélectionnez Red Hat Enterprise Linux 8.2 - 8.6, ou 9.0 dans le Plan. Pour le bundle RHEL hors ligne, cliquez ici.
   
   

   

   
   
3. Sous Compte administrateur (Administrator account) choisissez entre Clé publique SSH (SSH public key) ou Mot de passe (Password). Si vous utilisez une clé publique SSH, vous pouvez la générer, puis choisir Utiliser la clé existante enregistrée dans Azure (Use existing key stored in Azure).

Étape 2 : Ouvrez les ports entrants (Inbound ports) vers la machine créée

Pour ouvrir les ports entrants répertoriés dans le tableau ci-dessous, suivez les instructions ici

Plages de ports de destination	Nom	Priorité (Priority)	Source
9999	Port_Looker (Looker_Port)	310	Tout
19999	Port_APILooker (LookerAPI_Port)	320	Tout
29999	Port_LookMLMiseÀJour (LookMLUpdate_Port)	330	Tout

Pour configurer des paramètres supplémentaires, consultez Créer une règle de sécurité entrante.

Étape 3 Augmenter l'allocation de stockage pour les machines Linux Azure

L'allocation de stockage par défaut dans une machine Azure Linux est de 8 Go, et cela peut entraîner des erreurs d'espace insuffisant lors de l'extraction d'images, de la création de sauvegardes ou de l'utilisation de plusieurs tableaux de bord.

Important : pour les environnements physiquement isolés, une vérification de l'espace libre suffisant est effectuée, mais assurez-vous que les volumes /var disposent d'au moins 10 Go d'espace libre (voir Exigences matérielles de la machine Insights Linux). Avant d'exécuter le script de déploiement, suivez les étapes ci-dessous pour augmenter l'allocation de stockage et éviter les erreurs d'espace insuffisant :

1. Open a SSH client in the Linux machine by running the command below:

   ssh azureuser@<your-hostname>

   Où <your-hostname> doit être ajusté pour refléter le nom d'hôte de votre machine.
2. Change to root user by running the command below:

   sudo -i

3. Vérifiez la taille du disque en exécutant la commande ci-dessous :

   lsblk -f

   Vous trouverez le PointDeMontage (Mountpoint) /var sous le nom sda2 > rootvg-varlv.

   
4. Vérifiez la taille de /dev/sda2 en exécutant la commande ci-dessous :

   lsblk /dev/sda2

   Où /dev/sda2 est récupéré à l'étape 3. Vous verrez maintenant la taille de /var, qui est 8 Go.

   
5. Next, check the available space by running the command below:

   vgdisplay rootvg

   
   

   

   
   

   Vous verrez que l'EP / Taille libre (Free PE / Size) sera d'environ 40 Go.

6. Augmentez la taille de rootvg-varlv en exécutant la commande ci-dessous :
   Vous pouvez le changer en +10G ou une valeur différente qui est plus petite que les 40GB disponibles (la taille de mémoire libre que vous avez à l'étape 5).

   lvresize -r -L +10G /dev/mapper/rootvg-varlv

   Remarque : pour les installations physiquement isolées, exécutez la même commande sur /home.
   
   

   

   
   
7. Vérifiez si le redimensionnement a réussi en exécutant la commande ci-dessous :

   lsblk /dev/sda2

Vous aurez maintenant assez d'espace pour Docker (situé dans /var/lib/docker).

Remarque : Pour les environnements physiquement isolés, exécutez les commandes des étapes 1 à 6 pour augmenter la taille de /home afin de garantir suffisamment d'espace pour l'image hors ligne et le bundle de package.

Préparer une machine Windows pour héberger le service Insights

1. Configurez une machine Windows qui répond aux prérequis logiciels et matériels.
2. Ouvrez le port entrant par défaut 443. Pour obtenir des instructions sur l'ouverture d'un port entrant dans AWS, consultez Autoriser l'accès à une instance (Authorizing access to an instance). Pour obtenir des instructions sur l'ouverture d'un port entrant dans Azure, consultez Portail de démarrage rapide NSG (NSG Quickstart Portal).
3. Exécutez le script Installer-Prérequis.ps1 pour activer IIS 10+, installez .NET 6.0.5+, puis redémarrez le service IIS. Vous pouvez également installer manuellement les prérequis mis en évidence dans les sous-étapes ci-dessous :
   1. Ouvrez une session RDP sur la machine créée pour installer les prérequis.
   2. Activez IIS 10+.
      Pour activer IIS 10+, accédez au Panneau de configuration (Control Panel) > Programmes (Programs) > Activer ou désactiver des fonctionnalités Windows. Cela ouvrira l'assistant d'ajout de rôles et fonctionnalités (Add Roles and Features wizard). Suivez l'assistant pour activer le serveur Web (IIS).

      
      

      

      
      
      Cela ouvrira l'assistant d'ajout de rôles et fonctionnalités (Add Roles and Features wizard). Suivez l'assistant pour activer le serveur Web (IIS).

      
      

      

      
      

      Activez les modules de serveur Web (IIS) suivants :

      • Serveur Web
        • Fonctionnalités HTTP courantes
          • Document par défaut
          • Navigation dans le répertoire
          • Erreurs HTTP
          • Contenu statique
        • Intégrité et diagnostic
          • Journalisation HTTP
        • Performances
          • Contenu statique
        • Sécurité
          • Filtrage des demandes
      • Outils de gestion
        • Console de gestion d'IIS
   3. Téléchargez et installez la version 6.0.7+ du bundle d'hébergement .NET.
   4. Dans PowerShell, exécutez les commandes suivantes  :

      net stop was /y ; net start w3svc

4. Activez HTTPS sur votre machine à l'aide d'un certificat SSL. Préparez votre certificat en utilisant une procédure similaire à celle fournie pour Orchestrator. Consultez Utilisation d'un certificat pour le protocole HTTPS (Using a Certificate for the HTTPS Protocol).
5. Lorsque vous spécifiez un nom d’hôte pour Insights, assurez-vous que le nom d’hôte désiré est résolvable dans votre DNS.
6. Assurez-vous d'utiliser TLS 1.1 ou 1.2.

Configuration de SQL Server

Avant d'installer Insights, vous devez configurer l'instance Insights SQL Server que vous souhaitez utiliser.

Remarque : La base de données Insights SQL doit être insensible à la casse (« InsightsDB » = « insightsdb »). Si elle est créée lors du processus d'installation d'Insights, elle est automatiquement définie comme telle. Si vous créez votre propre base de données Insights, définissez la séquence de classement sur Latin1_General_CI_AS pour la configurer manuellement comme insensible à la casse.

Assurez-vous que vous disposez des informations suivantes à portée de main, car elles sont nécessaires pour exécuter le programme d'installation d'Insights :

• Le nom de la machine exécutant SQL Server.
• Le nom de l'instance, si ce n'est pas celle par défaut.

Assurez-vous également de :

• Le port SQL Server est ouvert dans le pare-feu de la machine exécutant le serveur SQL (SQL Server). Vous pouvez utiliser SKIP_FIREWALL_RULE_CREATION=true` pour ignorer la création de règles de pare-feu.
• Le protocole TCP dans le Gestionnaire de configuration SQL Server est activé.
• Le service SQL Server est défini de façon à écouter sur un port fixe, pas sur un port alloué de manière dynamique.

Configurez l'une des méthodes d'authentification suivantes par lesquelles Insights peut se connecter à la base de données SQL Server :

• Authentification intégrée de Windows
• Authentification de SQL Server

Authentification intégrée de Windows

Pour cette option, une nouvelle connexion est requise pour SQL Server en tant que compte de service. Le compte de service doit être un utilisateur de domaine dont le mot de passe n'expire jamais. Looker, le moteur sous-jacent utilisé par Insights, s'exécute dans un conteneur Linux.

Important: Pour activer l'authentification Windows, SQL Server doit prendre en charge l'authentification via le protocole Kerberos.

Pour plus de détails sur l'activation de l'authentification Kerberos sur SQL Server, consultez Enregistrement SPN manuel (Manual SPN Registration).

Exécutez la commande suivante pour vérifier le SPN sur votre machine Windows :

setspn -Q MSSQLsvc/<server name>:port

Exécutez la commande suivante pour définir le SPN :

setspn -S MSSQLsvc/<FQDN server name>:port [domain\<SQL service account>

Remarque : En option, vous pouvez utiliser un compte de service comme SPN. Il doit s'agir du compte sous lequel le service SQL Server s'exécute.

Éléments à prendre en compte lors de la configuration de l'authentification intégrée Windows

• Avant de configurer l'authentification Kerberos, assurez-vous que Insights Server peut accéder à votre Active Directory (AD) et SQL Server. Vous pouvez revoir cela avec votre administrateur informatique.
• SQL Server doit être ajouté à votre domaine AD.
• La machine Insights doit se trouver sur le même réseau que le domaine AD (AD Domain) et le serveur SQL (SQL Server).
• Le DNS devrait être configuré pour que la machine Insights puisse résoudre les noms de domaine pour le domaine AD (AD Domain) et le serveur SQL (SQL Server).
• L'utilisateur AD doit exister et avoir accès au serveur SQL et des autorisations de base de données comme défini dans la section Autorisations. Le domaine, le nom d'utilisateur et le mot de passe de cet utilisateur doivent être fournis lors du processus d'installation d'Insights. Gardez à l'esprit que le nom d'utilisateur est sensible à la casse et qu'il sert également de sAMAccountName de l'utilisateur.
  Ouvrez cmd en tant qu'administrateur et exécutez set user pour obtenir les USERDNSDOMAIN et USERNAME.
• Le serveur SQL doit avoir des entrées SPN dans AD. Pour plus d'informations, consultez Enregistrer un nom de service principal pour les connexions Kerberos.
  Important: Il est essentiel que le machine Insights ait besoin de résoudre les noms de domaine du domaine AD et de SQL Server. Vous pouvez le vérifier en exécutant nslookup <your_AD_domain_name> et nslookup <your_SQL_server_domain_name> sur la machine hôte.

Créez une nouvelle connexion dans SQL Server Management Studio :

1. Dans le volet Explorateur d'objets (Object Explorer), accédez à Sécurité > Connexions (Security > Logins).
2. Cliquez avec le bouton droit sur le dossier Connexions (Logins) et sélectionnez Nouvelle connexion (Login name).
3. Sélectionnez l'option Authentification Windows (Windows Authentication). La fenêtre est mise à jour en conséquence.
   
   

   

   
   
4. Dans le champ Nom de connexion (Login name), tapez le domaine d'utilisateur que vous souhaitez utiliser comme compte de service.
5. Dans la liste des langues par défaut (Default Language), sélectionnez Français (French).
   Important : assurez-vous que la langue par défaut est définie sur Anglais. Si ce n'est pas le cas, le site Web ne pourra pas démarrer et l'Observateur d'événements (Event Viewer) sur la machine sur laquelle Insights est installé affichera le message d'erreur suivant : The conversion of a varchar data type to a datetime data type resulted in an out-of range value.
6. Cliquez sur OK pour enregistrer la configuration.

   Si le compte de service a déjà été créé et ajouté à la section Sécurité > Connexions de SQL Server, vérifiez que l'option Langue par défaut de ce compte SQL est configurée sur Anglais. Si ce n'est pas le cas, vous devez effectuer les ajustements nécessaires.

Authentification de SQL Server

Pour cette méthode d'authentification, vous avez besoin d'un utilisateur SQL Server.

Important : Envisagez d'utiliser un compte non-SA (administrateur système) pour des raisons de sécurité.

Créer un nouvel utilisateur SQL dans SQL Server Management Studio

1. Dans le volet Explorateur d'objets (Object Explorer), accédez à Sécurité > Connexions (Security > Logins).
2. Cliquez avec le bouton droit sur le dossier Connexions et sélectionnez Nouvelle connexion. La fenêtre Nouvelle connexion s'affiche.
3. Sélectionnez l'option Authentification SQL Server (SQL Server authentication). La fenêtre est mise à jour en conséquence.
   
   

   

   
   
4. Remplissez les champs Nom de connexion (Login Name), Mot de passe (Password) et Confirmer le mot de passe (Confirm Password) de manière appropriée.
5. Veillez à ce que les options Appliquer l'expiration de mot de passe (Enforce password expiration) et L'utilisateur doit changer de mot de passe à la prochaine connexion (User must change password at next login) ne soient pas sélectionnées.
   Important : assurez-vous que la langue par défaut est définie sur Anglais. Si ce n'est pas le cas, le site Web ne peut pas démarrer et l'Observateur d'événements (Event Viewer) sur la machine sur laquelle Insights est installé affiche le message d'erreur suivant : « La conversion d'un type de données varchar en type de données datetime a généré un dépassement des limites de valeur. » (« The conversion of a varchar data type to a datetime data type resulted in an out of range value »).

Si le compte SQL Server a déjà été créé et ajouté à la section Sécurité > Connexions de SQL Server, vérifiez que l'option Langue par défaut est configurée sur Anglais. Si ce n'est pas le cas, effectuez les ajustements nécessaires.

Autorisations

Quel que soit le type d'utilisateur (domaine ou SQL) à connecter à SQL Server, notez que vous devez lui affecter le rôle de serveur dbcreator AVANT d'installer Insights, car la base de données est créée lors de l'installation.

Si les restrictions de sécurité n'autorisent pas l'utilisation du rôle de serveur dbcreator dans le compte de service, créez la base de données vide dans SQL Server.

Windows Installer se connecte à SQL Server pour vérifier l'existence de la base de données.

Après avoir créé la base de données, vous devez fournir à l'utilisateur qui se connecte à la base de données SQL d'Orchestrator le rôle de mappage d'utilisateur db_owner, comme présenté dans la capture d'écran ci-dessous :

L'autorisation EXECUTE doit être accordée en utilisant la commande SQL GRANT EXECUTE, comme suit.

• Si l'option Authentification intégrée de Windows est utilisée :

  USE UiPath Insights
  GO
  GRANT EXECUTE ON SCHEMA::dbo TO [domain\user]
  GO

• Si l'authentification de SQL Server est utilisée :

  USE UiPath Insights
  GO
  GRANT EXECUTE ON SCHEMA::dbo TO [sql_user]
  GO

  Remarque : Pour configurer le MAXDOP par défaut de votre base de données, voir Configurer le degré maximal de parallélisme pour l'option de configuration du serveur (Configure the max degree of parallelism Server Configuration Option).

Installez Orchestrator et activez (Enable) la fonctionnalité Insights (Insights Feature).

Cette section est nécessaire pour préparer la base de données d'Insights. Avant de pouvoir continuer à installer Insights, vous devez activer la fonctionnalité Insights dans Orchestrator, en fonction de votre scénario.

Pour les versions supérieures à 2021.10 Nouvelle installation d' Orchestrator et d'Insights (Orchestrator and Insights fresh installation) ou Ajouter Insights à l'installation d'Orchestrator existante (Add Insights to existing Orchestrator installation) : voir l' étape 3 dans Installation d'Orchestrator à nœud unique.

Remarque : Une installation multi-nœuds n'est pas prise en charge, mais après l'installation, Insights peut être activé sur une installation existante d'Orchestrator multi-nœuds.

Orchestrator installé en tant que service d'application dans Azure : si vous exécutez Orchestrator en tant que service d'application dans Azure, vous pouvez exécuter un script pour publier Orchestrator et activer Insights via le paramètre -insightsFeatureEnabled.

Remarque :

• Les versions Orchestrator et Insights doivent correspondre. Par exemple, si vous exécutez Orchestrator version 2023.4.0, vous devez exécuter la même version d'Insights pour assurer une communication correcte entre les deux produits UiPath.
• La base de données Insights doit pointer vers la même base de données qui a été créée lorsque vous avez activé Insights lors de l'installation d'Orchestrator.
• Si vous disposez d'une grande base de données, envisagez d'ajouter manuellement des index à l'aide de scripts SQL . L'installation peut échouer lors de la migration de la base de données Insights (Insights Database) si elle doit indexer un grand nombre de données.

Initialisez Looker sur la machine Linux Insights

Suivez la procédure pour initialiser Looker sur la machine Insights Linux.

Vous pouvez également utiliser le script de déploiement :

1. Exécutez l'outil LookerPreinstallationTool.exe pour générer un fichier ZIP pour Looker. Cela générera des fichiers Looker sur la machine Windows Insights.
2. Copiez les fichiers Looker sur la machine Linux Insights pour déployer Looker, ou utilisez le script Deployer-Looker.ps1 pour copier les fichiers extraits sur la machine Linux Insights, puis initialisez Looker.
   Important :

   Le script Deploy-Looker.ps1 est compatible avec LookerPreinstallationTool.exe version 2023.4.0.

   Pour plus d'informations, consultez le script de déploiement automatisé (Automated Deployment Script).

Générer des fichiers Looker sur la machine Windows Insights

Remarque : les paramètres SMTP sont configurés automatiquement à partir de la version 2023.4

1. Téléchargez LookerPreinstallationTool.exe et exécutez-le sur la machine Insights Windows.
   Remarque :

   La version de l'outil doit correspondre exactement à la même version d'Orchestrator et d'Insights. Pour télécharger la version nécessaire de l'OutilPréinstallationLooker (LookerPreinstallationTool), consultez la page Portail client (Customer Portal) > Téléchargement du produit (Product download) ou demandez à l'équipe d'assistance.

2. Suivez les étapes initiales pour générer le fichier ZIP.
3. Sélectionnez la langue.
   Important : Si la console ne peut pas afficher correctement le chinois/coréen/japonais, veuillez changer la police de votre console. Pour Powershell, vous pouvez cliquer avec le bouton droit sur la barre de titre et sélectionner Propriétés (Properties) et sélectionner une police TrueType (par exemple, MS Gothic, MS Mincho ou NSimSun).
4. Validez et exportez le certificat généré. Assurez-vous que le nom d'hôte est complet et couvert par le certificat.
   Remarque : le certificat doit être placé dans les dossiers Autorités de certification racine personnelle et Autorité de confiance.
   
   

   

   
   
5. (Facultatif) Configurez l'authentification Windows (Windows Auth), si vous l'utilisez.
   Remarque : en cas de mise à niveau à partir de 2021.10, en raison du changement d'architecture à 2 machines virtuelles dans la version 2023.4, le programme d'installation ne transfère pas automatiquement les tableaux de bord, les alertes et les planifications de la version 2021.10 vers la version 2023.4. Pour éviter de perdre des tableaux de bord, des alertes et des horaires, veuillez suivre l'étape 6 pour migrer ce contenu vers la nouvelle machine Linux. Cela ne s'applique pas aux mises à niveau à partir de la version 2022.4. Veuillez noter que si cette étape n'est pas effectuée lors de la mise à niveau, tous les tableaux de bord, calendriers et alertes seront supprimés et ne pourront plus être exportés vers la nouvelle machine Looker une fois l'installation via InsightsInstaller.msi terminée avec succès.
6. (Facultatif) Exportez les données pour continuer à utiliser vos anciens tableaux de bord, alertes et planifications dans la nouvelle version. L'outil peut détecter si un looker_container est en cours d'exécution sur la machine. Si vous déplacez vos données, le mot de passe Looker actuel conservé dans $Env:ProgramData\UiPath Insights sera exporté et utilisé dans la nouvelle machine Insights Linux.
7. (Facultatif) Chiffrez le fichier ZIP pour protéger le Secret Looker (Looker Secret). Si vous avez terminé l'étape 4 pensez à utiliser un mot de passe pour protéger le fichier ZIP.
   
   

   

   
   
8. Indiquez le chemin d'accès où vous souhaitez créer le fichier ZIP. Sinon, il sera créé dans le chemin d'accès par défaut qui sera affiché dans la console.

Copiez les fichiers Looker sur la machine Insights Linux

Copiez le fichier ZIP sur la machine Insights Linux.

1. Authentifiez-vous sur votre machine Insights Linux.
2. Ouvrez une session SCP et saisissez une commande incluant le chemin d'accès au fichier ZIP ainsi que le nom d'utilisateur et le mot de passe utilisés comme informations d'identification de votre machine Linux Insights en exécutant la commande ci-dessous :

   scp <path-to-Insights_Lookerfile>.zip <user@linuxhostname>:~/

   Remarque : Envisagez d'utiliser Powershell 7 ou supérieur, ou Putty, car les versions précédentes (Powershell 5.1) peuvent rencontrer des problèmes de rendu ou un écran noir.

Initialiser Looker

1. Ouvrez Powershell et exécutez la commande ci-dessous pour vous authentifier :

   ssh <username@hostname>

   Remarque : Après vous être connecté à la machine Insights Linux, assurez-vous que l'heure locale du système est correcte. Sinon, Looker pourrait entrer dans une boucle infinie de rafraîchissement.
2. Générez la clé GPG à l'aide de la commande ci-dessous :

   gpg --generate-key

   Remarque : la clé GPG n'est plus nécessaire dans toutes les versions d'installation à partir de la version d'avril 2023 (23.10.3, 23.4.6, etc.)

   Lorsque vous y êtes invité, saisissez le nom d'utilisateur, l'e-mail et définissez un mot de passe. Une clé publique est générée. Assurez-vous de sauvegarder la clé publique, car vous l'utiliserez plus tard.

   La clé publique (Public Key) est utilisée pour stocker le mot de passe et le certificat Looker générés lors de l'initialisation de Looker. Vous pouvez transmettre cette clé publique à l'aide du paramètre -k lorsque vous exécutez looker-initialization.sh.

   
   

   

   
   
3. Décompressez les fichiers Looker en exécutant la commande ci-dessous :

   unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directory

   Le répertoire d'installation d'Insights est le répertoire à partir duquel le script est exécuté. Évitez donc de décompresser le fichier dans votre répertoire personnel. Le répertoire standard Linux serait /opt, mais il peut être installé à un emplacement de votre choix.

4. Exécutez le script d'initialisation de Looker en exécutant la commande ci-dessous :

   cd <installation directory>
   bash insights/looker-initialization.sh -k <Public Key>

   Remarque : -k <public key> n'est plus nécessaire dans toutes les versions d'installation à partir de la version d'avril 2023 (23.10.3, 23.4.6, etc.)
   Où <Public Key> est généré via la commande gpg --generate-key.
   Remarque : Vous serez peut-être invité à saisir votre mot de passe pour enregistrer le mot de passe Looker.
   Remarque : le script utilise Sudo pour effectuer l'initialisation et si l'hôte Linux utilise dzdo au lieu de Sudo, le script utilisera également dzdo.
   Remarque : Vous pourriez rencontrer l'erreur suivante Module yaml error: Unexpected key in data: static_context [line 9 col 3] lors de l'installation. Pour plus d'informations sur ce bogue, consultez Désactiver la validation stricte des documents modulemd (RhBug:2004853) (Turn off strict validation of modulemd documents).

   Cela n'a aucun impact sur l'installation d'Insights.

5. Quittez Powershell et téléchargez looker.json en exécutant la commande suivante

   scp <username@hostname>:~/insights/looker.json <path-to-save-json>

   Remplacez <username@hostname> par votre nom d'utilisateur et votre nom d'hôte Linux.
   Vous pouvez utiliser cat /home/user/insights/looker.json pour copier le contenu et créer un fichier sur la machine Windows Insights nommée looker.json dans le référentiel de déploiement, puis coller le contenu copié.

Important:Après l'initialisation, un fichier appelé « looker.key » sera créé dans le dossier $HOME/_insights. Veuillez ne pas supprimer ce fichier, il sera nécessaire pour les futures mises à jour.

Remarque :

Vous pouvez créer un utilisateur Looker et modifier la propriété du dossier de déploiement au nouvel utilisateur Looker et définir l'autorisation du dossier de déploiement sur 755. Tous les fichiers du dossier auront l'attribut 644.

Remarque :

Looker a la capacité de forcer l'arrêt d'une requête SQL après la fermeture d'un tableau de bord, si la requête n'est pas terminée. Cela peut atténuer les problèmes de performances dans certains scénarios. S'il souhaite que cette fonctionnalité soit activée, ajoutez l'autorisation SQL ci-dessous. Ceci est facultatif.

use master
go
GRANT ALTER ANY CONNECTION TO sqladmin

Installation d'Insights

Remarque :

• 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.
• Le programme d'installation utilisera la langue d'affichage de Windows s'il s'agit de l'une des langues suivantes : en-US, fr-FR, de-DE, es-ES, es-MX, ja-JP, ko-KR, pt-BR, pt-PT, ru-RU, tr-TR, zh-CN. Si la langue d'affichage de Windows n'est pas l'une de ces langues, le programme d'installation utilisera l'anglais.

1. Téléchargez le InsightsInstaller.msi depuis le Customer Portal en sélectionnant votre version.
2. Exécutez le programme d'installation en tant qu'administrateur à l'aide de l'invite de commande ou de la console PowerShell.
3. Accédez au répertoire où se trouve votre programme d'installation .msi.
4. Exécutez le programme d'installation d'Insights à l'aide de la commande suivante :

   msiexec /i InsightsInstaller.msi

   Vous pouvez également utiliser la commande suivante :

   .\InsightsInstaller.msi

5. Le programme d'installation d'Insights doit maintenant vérifier les prérequis. Si toutes les conditions préalables sont remplies, l'assistant de configuration d'UiPath Insights s'affiche et vous guide tout au long de l'installation et de la configuration d'Insights.
   
   

   

   
   
   Remarque : Si l'installation a échoué ou si vous souhaitez vérifier le journal d'installation, vous pouvez accéder au dossier %temp% ou %temp%%temp%/<sessionID>et vérifier le dernier MSI{random chars}.LOG. Les fichiers de ce répertoire ne sont pas permanents et peuvent être perdus entre les sessions. Vous pouvez entrer la commande ci-dessous pour exécuter l'installation avec l'emplacement de journal prédéfini.

   msiexec -I "InsightsInstaller.msi" -L*V  c:\logs\interactive.log

6. Acceptez le contrat de licence et cliquez sur Suivant (Next).
   
   

   

   
   
7. Le script d'initialisation Looker sur votre hôte Linux génère un fichier JSON avec la configuration de l'instance. Veuillez saisir le cheminfichier (filepath) complet de l'emplacement où vous avez stocké ce fichier sur cet hôte Windows.
   
   

   

   
   
8. Saisissez les paramètres de la machine Insights Window comme suit :
   • URL du serveur Insights (Insights Server URL) : le nom d'hôte ou l'URL de la machine Insights Windows.
   • Port : le port que vous souhaitez utiliser pour activer la communication avec la machine Windows Insights. Le numéro de port par défaut est défini sur 443.
   • Certificat (Certificate) - le sujet ou l'empreinte du certificat SSL à utiliser pour sécuriser les connexions avec Insights.
     
     

     

     
     
9. Configurez les paramètres d'Orchestrator comme suit :
   • URL d'Orchestrator (Orchestrator URL) - l'URL d'Orchestrator
   • Jeton d’installation (Installation Token) : entrez le jeton d’accès d’installation que vous avez généré sur la page Jeton d’accès de l’installation (Installation Access Token) de l'Identity Server en vous connectant en tant que locataire hôte. Pour plus de détails, voir Portails d'administration de l'hôte (Host administration portals).
   • Serveur d'identité séparé (Separate Identity Server) : Si vous disposez d'un serveur d'identité distinct, activez cette option.
     Remarque : Vous avez besoin d'un nouveau jeton d'accès à l'installation pour chaque installation. Le jeton est valide pendant 2 heure, après quoi il expire. Générez-en un autre en cas d'échec de l'installation.
     
     

     

     
     
10. Configurez les paramètres de la base de données Insights comme suit :
    • Nom du serveur (Server Name) : le nom de la machine SQL Server sur laquelle se trouve la base de données Insights, y compris le port d'écoute par défaut pour le serveur SQL (1433). Par exemple, SQLServer,1433.
    • Nom de la base de données (Database Name) - le nom de la base de données Insights
    • Type d'authentification (Authentication Type) - choisissez l'une des méthodes d'authentification suivantes :
      Vous devez utiliser le nom de domaine complet de la base de données (par exemple, mysever.my.domain au lieu de myserver). De préférence, le serveur SQL doit rejoindre directement le domaine AD.
      • Authentification Windows (Windows Authentication) - si cette option est sélectionnée, Insights se connecte à la base de données, crée des tables et exécute le pool d'applications IIS à l'aide des informations d'identification spécifiées. Le programme d'installation valide la connexion à l'aide des informations d'identification Windows avec lesquelles vous êtes actuellement connecté. Si vous sélectionnez cette option, vous devez spécifier le domaine, le nom d'utilisateur et le mot de passe.
      • Authentification SQL – si elle est sélectionnée, la connexion est effectuée à l’aide de l’authentification SQL. Si vous utilisez cette option, les champs Nom d’utilisateur (Username) et Mot de passe (Password) peuvent alors être modifiés et vous devez fournir le nom d’utilisateur et le mot de passe SQL utilisés pour vous connecter à la base de données.
        
        

        

        
        
        Important : Aucune authentification pour SMTP n'est prise en charge dans Insights 2022.4, 2022.10 et 2023.4.
11. Configurez les paramètres de messagerie comme suit :
    • Configurer le service de messagerie (SMTP) (Configure Email Service (SMTP)) - cochez pour configurer le service de messagerie
      • Serveur (Server)r : le nom de l'hôte SMTP.
      • De (From) – l'adresse électronique à partir de laquelle envoyer des e-mails.
      • Nom d'utilisateur (Username) - Le nom d'utilisateur du serveur SMTP, s'il nécessite une authentification. Par exemple, si vous utilisez Gmail, remplissez ce champ avec l'adresse e-mail utilisée pour envoyer des messages.

        Envisagez d'utiliser SMTP avec authentification, car SMTP sans authentification risque de ne plus être pris en charge à l'avenir.

      • Mot de passe (Password) : le mot de passe du compte de messagerie
      • Port - le port SMTP.
      • TLS/SSL - cochez pour activer TLS/SSL.

        Version TLS/SSL - seul le TLS/SSL visible est vérifié. Choisissez entre TLSv1_1 et TLSv1_2

        Remarque : une fois cette étape terminée, un e-mail est envoyé en utilisant les détails du serveur SMTP. Cela permet de s'assurer que les détails SMTP sont corrects. S'il y a une erreur au cours de cette étape, veuillez vérifier le fichier journal et accéder à la page de résolution des problèmes
12. Cliquez sur Suivant (Next) pour démarrer l'installation. Une fois le processus d'installation terminé, cliquez sur Fermer (Close) pour quitter le programme d'installation.
    
    

    

    
    

Étapes post-installation

Migrer des tables

Remarque : cette étape n'est nécessaire que si vous avez de grandes tables et que vous rencontrez des délais d'attente lors de la mise à niveau.

Pour migrer les tables de tâches, suivez les étapes ci-dessous.

1. Remplissez JobOrganizationUnitId.

   with CTE as (
   select qie.[JobOrgUnitFullyQualifiedName] as qOrgName, qie.[JobOrganizationUnitId] as qOrgId, j.[OrganizationUnitId] as jOrgId, j.[OrgUnitFullyQualifiedName] as jOrgName
   from [dbo].[QueueItemEvents] qie 
   inner join [dbo].[QueueItems] qi on qie.[QueueItemId] = qi.[Id]
   inner join [dbo].[Jobs] j on qi.[ExecutorJobId] = j.[Id]
   where j.[OrganizationUnitId] != qie.[JobOrganizationUnitId] or (qie.[JobOrganizationUnitId] is null and j.[OrganizationUnitId] is not null))
   update CTE
   set qOrgName = jOrgName, qOrgId = jOrgId;

2. Créez un index de workflow de longue durée s'il n'existe pas.
   Remarque : Si ce script a été utilisé précédemment, il n'est pas nécessaire de l'exécuter une seconde fois.

   IF NOT EXISTS(SELECT * FROM sys.indexes WHERE Name = 'IX_JobEvents_JobId_TenantId' and OBJECT_NAME(object_id) = 'JobEvents')
   CREATE NONCLUSTERED INDEX [IX_JobEvents_JobId_TenantId] ON [dbo].[JobEvents]
   (
       [JobId] ASC,
       [TenantId] ASC
   )

3. Tronquez les tables de lecture pour renvoyer de nouveaux champs.

   truncate table [read].[QueueItemEvents];
   truncate table [read].[QueueItems];
   truncate table [read].[Jobs];
   truncate table [read].[JobEvents];
   delete [dbo].[IngestionMarkers] where [IngestionEventType] in (9002, 9001);

Assurez-vous que les licences sont appropriées

Vous devez disposer d'au moins un code de licence, qui inclura Orchestrator, Insights et un Robot, tous de niveau hôte, attachés à Orchestrator (voir Gérer les licences d'hôte (Manage Host Licensing).

Activation de tenants

Après avoir installé Insights, vous devez activer Insights pour le ou les locataires souhaités à partir du portail hôte Orchestrator (Orchestrator host portal). Pour plus de détails, voir Activer ou désactiver des fonctionnalités (Enabling or disabling features).

Vérification des services Insights

1. Ouvrir un navigateur Web pris en charge
2. Accédez au https://hostname:443/Insights pour confirmer qu'Insights a été correctement installé.

Modification d'Insights

Conservez le fichier d'installation d'origine au cas où vous voudriez le modifier ou le désinstaller.

Pour plus d'informations, consultez la section Modification des configurations Insights.

Activer Insights à nœud unique sur Orchestrator multi-nœuds existant

Pour activer Insights à nœud unique sur UiPath Orchestrator multi-nœuds UiPath , suivez les étapes ci-dessous :

1. Activez UiPath Orchestrator sur un nœud principal et générez un fichier de paramètres. Reportez-vous à la section Ajout de nœuds à l'Orchestrator multi-nœuds pour plus de détails.
2. Exécutez le programme d'installation d'Orchestrator (UiPathOrchestrator.msi) sur les nœuds secondaires à l'aide de la commande suivante :

   UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json
         /Q

3. Assurez-vous la cohérence entre tous les nœuds en remplaçant UiPath.Orchestrator.dll. sur les nœuds secondaires avec la version du nœud principal. Ce fichier se trouve à C:\Program Files (x86)\UiPath\Orchestrator. Il est recommandé de créer une sauvegarde avant le remplacement.
4. Vérifiez que les fichiers UiPath.Orchestrator.dll. est identique sur tous les nœuds après le remplacement.

Articles associés

• Installation dans un environnement physiquement isolé
• Mise à niveau d'Insights
• Résolution des problèmes