Souscrire

UiPath Installation and Upgrade

Guide d'installation et de mise Ă  niveau d'UiPath

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

  1. 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 :

TypePort rangeSourceDescription
Custom TCP9999Anywhere-IPv4This is the Looker port.
Custom TCP19999Anywhere-IPv4This is the Looker API port.
Custom TCP29999Anywhere-IPv4This is the LookML update port.
  1. 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.
1464
  1. 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 rangesNamePrioritySource
9999Looker_Port310Any
19999LookerAPI_Port320Any
29999LookMLUpdate_Port330Any

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:
ssh azureuser@<your-hostname>

OĂč <your-hostname> doit ĂȘtre ajustĂ© pour reflĂ©ter le nom d'hĂŽte de votre machine.

  1. Change to root user by running the command below:
sudo -i
  1. 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.

1084
  1. 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.

829
  1. Next, check the available space by running the command below:
vgdisplay rootvg
940

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

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

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

1339
lsblk /dev/sda2

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

746

📘

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

1011

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

236

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 :

net stop was /y ; net start w3svc
  1. 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.

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

  3. 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.
704
  1. Dans le champ Nom de connexion (Login name), tapez le domaine d'utilisateur que vous souhaitez utiliser comme compte de service.
  2. 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.

  1. 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.
700
  1. 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.
  2. 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 :

704

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
705

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.

Alternatively, you can use the deployment script (click to expand section)
  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 2022.10.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

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

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

823
  1. (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.

  1. (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.
  2. (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.
823
  1. 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.

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

1531
  1. Décompressez les fichiers Looker en exécutant la commande ci-dessous :
unzip <Insights_Lookerfiles_timestamp.zip>
  1. 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.
:information-source: 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.

  1. 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
  1. 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.
612

📘

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
  1. Acceptez le contrat de licence et cliquez sur Suivant (Next).
494
  1. 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.
495
  1. 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.
495
  1. 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.

495
  1. 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.
495

🚧

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.

  1. 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
495

📘

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)

  1. 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.
495

 

É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;
  1. 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
)
  1. 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

Mise Ă  jour il y a environ un mois


Installation


Les modifications suggérées sont limitées sur les pages de référence de l'API

Vous pouvez uniquement suggérer des modifications au contenu du corps de Markdown, mais pas aux spécifications de l'API.