🚧

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 2022.10 nécessite une machine Windows et une machine Linux avec RHEL 8.2-8.6, ou 9.0.

Cliquez pour développer cette section

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.

Vue d'ensemble (Overview)

📘

Avant de commencer

Vérifiez les prérequis logiciels et matériels (Hardware and Software Requirements) pour Insights.

Pour installer une version autonome d'Insights v2022.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

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.

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

For details on preparing a Linux machine

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 (nous prenons en charge les versions 8.2 - 8.6 ou 9.0)
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
   Pour plus d'informations, consultez Initialiser le lancement de l'instance dans AWS (Initiate instance launch in AWS).

Étape 2 : Ouvrir les ports entrants

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

Type	Port range	Source	Description
Custom TCP	9999	Anywhere-IPv4	This is the Looker port.
Custom TCP	19999	Anywhere-IPv4	This is the Looker API port.
Custom TCP	29999	Anywhere-IPv4	This is the LookML update port.

3. Cliquez sur Enregistrer les règles (Save rules).

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) > Créer (Create).
2. Go to See all images and select Red Hat Enterprise Linux 8.2 - 8.6, or 9.0 from the Plan. For the offline RHEL bundle, click here for RHEL 8 and here for RHEL 9.

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

Destination port ranges	Name	Priority	Source
9999	Looker_Port	310	Any
19999	LookerAPI_Port	320	Any
29999	LookMLUpdate_Port	330	Any

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.

Pour les environnements physiquement isolés, assurez-vous que les volumes /home et /var disposent de suffisamment d'espace disponible (par exemple, au moins 4 Go pour les volumes /home et 10 Go pour les volumes /var, respectivement) (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:

Shell

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:

Shell

sudo -i

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

Shell

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 :

Shell

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:

Shell

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).

Shell

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

Note: for air-gapped installations please run the same command on /home

Shell

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.

Pour plus de détails sur la préparation d'une machine Windows pour l'hébergement du 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. 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 aux étapes 3.1 à 3.4 ci-dessous :

   3.1 Ouvrez une session RDP dans la machine créée pour installer les prérequis.

   3.2 Activez IIS 10+.

Cliquez pour plus de détails sur l'activation d'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
• Performance
• Contenu statique
• Sécurité
• Filtrage des demandes
• Outils de gestion
• Console de gestion d'IIS

 

   3.3 Téléchargez et installez le bundle d'hébergement .NET version 6.0.5+.

   3.4 Dans PowerShell, exécutez les commandes suivantes :

PowerShell

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.

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.

🚧

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 Orchestrator et Insights doivent correspondre. Par exemple, si vous exécutez Orchestrator version 2021.10.1, 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 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)).

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 Windows (cliquez pour développer)

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).

É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 la machine Insights ait besoin de résoudre les noms de domaine du domaine AD (AD Domain) et du serveur SQL (SQL Server). Vous pouvez vérifier cela 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 (Default Language) est définie sur Français (French). 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 SQL Server (cliquez pour développer)

Pour cette méthode d'authentification, vous avez besoin d'un utilisateur SQL Server.
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 (Default Language) est définie sur Français (French). 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

Regardless of the type of user (domain or SQL) you want to connect to SQL Server, please note that you need to assign it the dbcreator Server Role BEFORE installing Insights, as the database is created during this installation process.

If security restrictions do not allow the use of the dbcreator Server Role in the service account, create the empty database in 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 :

Si les restrictions de sécurité ne vous autorisent pas à utiliser le rôle de mappage utilisateur db_owner avec la connexion UiPath, accordez les suivants :

• db_datareader
• db_datawriter
• db_ddladmin
• Autorisation EXECUTE sur le schéma dbo

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

📘

Recommandations

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.

For versions above 2021.10 Orchestrator and Insights fresh installation or Add Insights to existing Orchestrator installation: See Step 3 in Orchestrator Single-Node Installation).

For versions before 2021.10, when you Upgrade Insights: Disable the Insights feature in Orchestrator, then re-enable it.

Orchestrator installed as app service in Azure: If you run Orchestrator as an app service in Azure, you can run a script to publish to Orchestrator and enable Insights through the -insightsFeatureEnabled parameter.

📘

Information

• Les versions Orchestrator et Insights doivent correspondre. Par exemple, si vous exécutez Orchestrator version 2021.10.1, 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.

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

The SMTP settings are configured automatically starting with the 2022.10 version

1. Téléchargez LookerPreinstallationTool.exe et exécutez l'outil sur la machine Insights Windows.
2. Suivez les étapes initiales pour générer le fichier ZIP.
3. Sélectionnez la langue.

🚧

Lorsque vous sélectionnez chinois/coréen/japonais

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 :

The certificate needs to be placed in both Personal and Trusted Root Certification Authorities folders.

5. (Facultatif) Configurez l'authentification Windows (Windows Auth), si vous l'utilisez.

📘

Remarque

En cas de mise à niveau à partir de 21.10, en raison du changement d'architecture vers 2 machines virtuelles dans 22.10, le programme d'installation ne transfère pas automatiquement les tableaux de bord, les alertes et les horaires de 21.10 à 22.10. Pour éviter de perdre des tableaux de bord. alertes et horaires, veuillez suivre l'étape 6 pour migrer ce contenu vers la nouvelle machine Linux. Ceci ne s'applique pas aux mises à niveau à partir de 22.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 entraîner 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

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>

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

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

Où <Public Key> est généré via la commande gpg --generate-key.
Vous serez peut-être invité à saisir votre mot de passe pour enregistrer le mot de passe Looker.

📘

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é looker.json sous $HOME/_insights, puis coller le contenu copié.

After initialization, a file called 'looker.key' will be created in the $HOME/_insights folder. Please do not delete this file, it will be needed for future upgrades.

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. Exécutez le programme d'installation InsightsInstaller.msi en tant qu'administrateur à l'aide de l'invite de commande ou de la console PowerShell.

2. Accédez au répertoire où se trouve votre programme d'installation .msi.

3. 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

4. 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%/<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 saisir 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

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

6. 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.

7. 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 - the port you want to use to enable the communication with the Insights Windows machine. The default port number is set to 443.
• Certificat (Certificate) - le sujet ou l'empreinte du certificat SSL à utiliser pour sécuriser les connexions avec Insights.

8. Configurez les paramètres d'Orchestrator comme suit :

• URL d'Orchestrator (Orchestrator URL) - l'URL d'Orchestrator
• Installation Token - enter the Installation Access Token you generated on Identity Server's Installation Access Token page by logging in as the host tenant. For more details, see 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 d’installation pour chaque installation. Le jeton est valide pendant 2 heures, après quoi il expire. Générez-en un autre si l'installation vient à échouer.

9. 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.
• Database Name - the name of the Insights database.
• Type d'authentification (Authentication Type) - choisissez l'une des méthodes d'authentification suivantes :
  You must use the fully qualified domain name for the database (e.g., mysever.my.domain instead of myserver). Preferably the SQL Server must join the AD domain directly.
  • Windows Authentication - if selected, Insights connects to the database, creates tables, and runs the IIS Application Pool using the specified credentials. The installer validates the connection using the Windows credentials you are currently logged in with. If you select this option, you must specify the domain, username, and password.
  • SQL Authentication - if selected, the connection is made using SQL authentication. If using this option, the Username and Password fields become editable, and you must provide the SQL username and password used to connect to the database.

🚧

Important

Pour des raisons de sécurité, nous ne prenons pas en charge l'authentification pour SMTP. Vous devez fournir les détails d'authentification à l'étape 10.

10. 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 dépannage (troubleshooting page)

11. 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

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

📘

Remarque :

This step is required when upgrading to 2022.10. For more information on this, see Supporting Long Running Workflows.

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

You need to have at least one license code, which will include Orchestrator, Insights, and one Robot, all of them at the Host level, attached in Orchestrator (see Manage Host Licensing).

Activation de tenants

After installing Insights, you must then enable Insights for your desired tenant(s) from the Orchestrator host portal. For more details, see 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.

For more information, see Modifying Insights configurations.

Articles associés

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