- Notes de publication
- Démarrage
- Installation et mise à niveau
- Accès et autorisations
- Interaction avec Insights
- Journaux (Logs)
Insights
Installation
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.4 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 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 2 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.
/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.
ip_forward
est activé.
Pour installer une version autonome d'Insights v2022.4, vous devez suivre ces procédures dans l'ordre indiqué ci-dessous :
Préparez le ou les certificats (Certificate) pour activer SSL pour les deux machines. Pour plus d'informations, cliquez ici.
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.
Configurez deux machines qui répondent aux prérequis logiciels et matériels.
- 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 2022.4.X, vous devez exécuter une version 2022.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 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
- Initialisez le lancement de l'instance.
- Sélectionnez l'image Red Hat Enterprise Linux 8 (Red Hat Enterprise Linux 8 Image) (nous prenons en charge les versions 8.2 à 8.6)
- Choisissez un type d'instance (Instance Type) et configurez les détails de l'instance (Instance Details).
- Ajoutez du stockage à votre instance et modifiez la Taille (Size) en
32
. - Examiner et lancer l'instance
Pour plus d'informations, consultez Initiate instance launch in AWS.
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
- Accédez à Services > Machines virtuelles (Virtual machines) > Créer (Create).
- Accédez à Voir toutes les images (See all images) et sélectionnez Red Hat Enterprise Linux 8.2 à 8.6 dans le Plan. Pour le bundle RHEL hors ligne, cliquez ici.
- 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.
/var
disposent d'au moins 10 Go d'espace libre. 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 :
- Open a SSH client in the Linux machine by running the command below:
ssh azureuser@<your-hostname>
ssh azureuser@<your-hostname>Où<your-hostname>
doit être ajusté pour refléter le nom d'hôte de votre machine. - Change to root user by running the command below:
sudo -i
sudo -i - Vérifiez la taille du disque en exécutant la commande ci-dessous :
lsblk -f
lsblk -fVous trouverez le PointDeMontage (Mountpoint)/var
sous le nomsda2
>rootvg-varlv
. - Vérifiez la taille de
/dev/sda2
en exécutant la commande ci-dessous :lsblk /dev/sda2
lsblk /dev/sda2Où/dev/sda2
est récupéré à l'étape 3. Vous verrez maintenant la taille de/var
, qui est 8 Go. - Next, check the available space by running the command below:
vgdisplay rootvg
vgdisplay rootvgVous verrez que l'EP / Taille libre (Free PE / Size) sera d'environ 40 Go.
- 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 les40GB
disponibles (la taille de mémoire libre que vous avez à l'étape 5).lvresize -r -L +10G /dev/mapper/rootvg-varlv
lvresize -r -L +10G /dev/mapper/rootvg-varlv - Vérifiez si le redimensionnement a réussi en exécutant la commande ci-dessous :
lsblk /dev/sda2
lsblk /dev/sda2
/var/lib/docker
).
Préparer une machine Windows pour héberger le service Insights
- Configurez une machine Windows qui répond aux prérequis logiciels et matériels.
- 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). - Exécutez le script Installer-Prérequis.ps1 (Install-Prerequisites.ps1 ) pour activer IIS 10+, installez le fichier .NET requis pour votre version, puis redémarrez le service IIS. Vous pouvez également installer manuellement les prérequis mis en évidence dans les sous-étapes ci-dessous :
- Ouvrez une session RDP sur la machine créée pour installer les prérequis.
- 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
- Fonctionnalités HTTP courantes
- Outils de gestion
- Console de gestion d'IIS
- Serveur Web
- Téléchargez et installez la version 6.0.7+ du bundle d'hébergement .NET.
- Dans PowerShell, exécutez
les commandes suivantes
:
net stop was /y ; net start w3svc
net stop was /y ; net start w3svc
- 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. Voir .
- 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.
- Assurez-vous d'utiliser TLS 1.1 ou 1.2.
Avant d'installer Insights, vous devez configurer l'instance Insights SQL Server que vous souhaitez utiliser.
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, la plate-forme d'analyse utilisée par Insights, s'exécute dans un conteneur Linux.
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écutezset user
pour obtenir lesUSERDNSDOMAIN
etUSERNAME
. - 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>
etnslookup <your_SQL_server_domain_name>
sur la machine hôte.
Créez une nouvelle connexion dans SQL Server Management Studio :
- Dans le volet Explorateur d'objets (Object Explorer), accédez à Sécurité > Connexions (Security > Logins).
- Cliquez avec le bouton droit sur le dossier Connexions (Logins) et sélectionnez Nouvelle connexion (Login name).
- Sélectionnez l'option Authentification Windows (Windows Authentication). La fenêtre est mise à jour en conséquence.
- Dans le champ Nom de connexion (Login name), tapez le domaine d'utilisateur que vous souhaitez utiliser comme compte de service.
- 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
. - 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.
Créer un nouvel utilisateur SQL dans SQL Server Management Studio
- Dans le volet Explorateur d'objets (Object Explorer), accédez à Sécurité > Connexions (Security > Logins).
- Cliquez avec le bouton droit sur le dossier Connexions et sélectionnez Nouvelle connexion. La fenêtre Nouvelle connexion s'affiche.
- Sélectionnez l'option Authentification SQL Server (SQL Server authentication). La fenêtre est mise à jour en conséquence.
- 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.
- 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
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.
db_owner
, comme présenté dans la capture d'écran ci-dessous :
db_owner
avec la connexion UiPath, accordez les suivants :
db_datareader
db_datawriter
db_ddladmin
-
Autorisation
EXECUTE
sur le schémadbo
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
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
USE UiPath Insights GO GRANT EXECUTE ON SCHEMA::dbo TO [sql_user] GORemarque : 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).<details>
Installez Orchestrator et activez la fonctionnalité Insights.
- Accédez à Orchestrator pour obtenir le jeton d'accès à l'installation. Pour plus de détails, voir Clé d'installation (Installation key).
Remarque :
- Les versions Orchestrator et Insights doivent correspondre. Par exemple, si vous exécutez Orchestrator version 2022.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 ensemble de données.
Générez des fichiers Looker sur la machine Windows Insights, puis exécutez le script Deploy-Looker.ps1 pour copier les fichiers Looker sur la machine Linux Insights, puis initialisez Looker. Vous pouvez également exécuter manuellement les commandes.
Deploy-Looker.ps1
est compatible avec LookerPreinstallationTool.exe
version 2022.4.2.
LookerPreinstallationTool.exe
pour générer un fichier ZIP pour Looker.
- 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.
- Suivez les étapes initiales pour générer le fichier ZIP.
- 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).
- 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.
- (Facultatif) Configurez et validez les paramètres SMTP.
- (Facultatif) Configurez l'authentification Windows (Windows Auth), si vous l'utilisez.
Remarque : Si vous mettez à niveau depuis la version 21.10, vous pouvez exporter vos tableaux de bord, vues et paramètres actuels à l'étape 7 et migrer ces informations vers la nouvelle machine Linux.
- (Facultatif) Exportez les données pour continuer à utiliser vos tableaux de bord, vues et paramètres d'application précédents dans ce nouvel environnement. 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_insights/LookerSecret
sera exporté et utilisé dans la nouvelle machine Insights Linux. - (Facultatif) Chiffrez le fichier ZIP pour protéger le Secret Looker (Looker Secret). Si vous avez terminé l'étape 7, pensez à utiliser un mot de passe pour protéger le fichier ZIP.
- 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 le fichier ZIP sur la machine Insights Linux.
- Authentifiez-vous sur votre machine Insights Linux.
- 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>:~/
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.
- Ouvrez Powershell et exécutez la commande ci-dessous pour vous authentifier :
ssh <username@hostname>
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. - Générez la clé GPG à l'aide de la commande ci-dessous :
gpg --generate-key
gpg --generate-keyRemarque : 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écutezlooker-initialization.sh
.
- Décompressez les fichiers Looker en exécutant la commande ci-dessous :
unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directory
unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directoryLe 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.
- 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>
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 commandegpg --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 suivanteModule 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.
- Quittez Powershell et téléchargez
looker.json
en exécutant la commande suivantescp <username@hostname>:~/insights/looker.json <path-to-save-json>
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 utilisercat /home/user/insights/looker.json
pour copier le contenu et créer un fichier sur la machine Windows Insights nomméelooker.json
dans le référentiel de déploiement, puis coller le contenu copié.
$HOME/_insights
. Veuillez ne pas supprimer ce fichier, il sera nécessaire pour les futures mises à jour.
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.
use master
go
GRANT ALTER ANY CONNECTION TO sqladmin
use master
go
GRANT ALTER ANY CONNECTION TO sqladmin
- 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.
-
Téléchargez
InightsInstaller.msi
depuis le Portail client ( Customer Portal), en sélectionnant votre version. -
Exécutez le programme d'installation en tant qu'administrateur à l'aide de l'invite de commande ou de la console PowerShell.
- Accédez au répertoire où se trouve votre programme d'installation
.msi
. Exécutez le programme d'installation d'Insights à l'aide de la commande suivante : msiexec /i InsightsInstaller.msi
msiexec /i InsightsInstaller.msiVous pouvez également utiliser la commande suivante :
.\InsightsInstaller.msi
.\InsightsInstaller.msi- 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 dernierMSI{random chars}.LOG
. Ce répertoire est non persistant. 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
msiexec -I "InsightsInstaller.msi" -L*V c:\logs\interactive.log - Acceptez le contrat de licence et cliquez sur Suivant (Next).
- 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.
- 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.
- 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.
- Configurez les paramètres de la base de données Insights comme suit :
- Nom du serveur (Server Name) - nom de la machine SQL Server sur laquelle se trouve la base de données Insights
- 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 :
Important: Vous devez utiliser le nom de domaine complet de la base de données (par exemple,
mysever.my.domain
au lieu demyserver
). 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.
- 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.
Important: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
Important : Aucune authentification pour SMTP n'est prise en charge dans Insights 2022.4, 2022.10 et 2023.4.
- Configurer le service de messagerie (SMTP) (Configure Email Service (SMTP)) - cochez pour configurer le service de messagerie
- 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.
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érifiez les journaux sous %programdata%/UiPath Insights/Provisioning
- Une erreur doit survenir concernant l'échec d'OrchestratorTenantJob.
- Connectez-vous à la base de données Orchestrator à l'aide d'un client SQL.
- Vérifiez la table dbo.Tenants.
- Vérifiez que les colonnes « Clé » et « IDCompte » sont en majuscules.
- Si c'est le cas, les mettre en minuscules résoudra le problème.
- Si un locataire est en minuscules, essayez simplement d'activer ce locataire et voyez si l'erreur se produit à nouveau.
- Pour résoudre le problème, modifiez la casse des champs (assurez-vous de sauvegarder la base de données au préalable). Notez également les clés qui sont déjà en minuscules).
- UPDATE [UiPath].[dbo].[Tenants]
- set [key] = LOWER([key]), [AccountId] = LOWER([AccountId])
- Pour annuler la modification, exécutez
- UPDATE [UiPath].[dbo].[Tenants]
- set [key] = UPPER([key]), [AccountId] = UPPER([AccountId])
- WHERE [key] NOT IN ('xx-xx-xx-xx', 'xx-xx-xx-xx');
- Faire une réinitialisation d'IIS (ou simplement recycler le pool d'applications d'enregistrement) peut être nécessaire. Le service d’enregistrement essaie d’enregistrer l’instance toutes les 10 minutes. Si ce n’est pas le cas, attendez 10 minutes au maximum.
- Si le problème persiste, créez un ticket avec UiPath et incluez les éléments suivants
- Capture d'écran de la table dbo.tenants.
- Les journaux d'enregistrement mentionnés ci-dessus.
- Ouvrir un navigateur Web pris en charge
- Accédez au
https://hostname:443/Insights
pour confirmer qu'Insights a été correctement installé.
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.
Pour vérifier la configuration réseau requise pour Insights, consultez Configuration réseau requise (Network requirements).
- Vue d'ensemble (Overview)
- Préparez la machine Windows Insights et la machine Linux Insights
- Étape 1
- Étape 2
- Configuration de SQL Server
- Installez Orchestrator et activez (Enable) la fonctionnalité Insights (Insights Feature).
- Initialisez Looker sur la machine Linux Insights
- Générer des fichiers Looker sur la machine Windows Insights
- Copiez les fichiers Looker sur la machine Insights Linux
- Initialiser Looker
- Installation d'Insights
- Étapes post-installation
- Configuration du locataire
- Vérification des services Insights
- Modification d'Insights
- Déploiement d'Automation Suite
- Articles associés