Insights

2021.10

False

Notes de publication
Démarrage
- À propos des éclairages
- Modèle de données Insights
Installation et mise à niveau
Accès et autorisations
- Octroi d'autorisations
- Ajout d'utilisateurs concepteurs dans Insights
Interaction avec Insights
Résolution des problèmes
- Résolution des problèmes

Insights

Dernière mise à jour 23 avr. 2024

Installation

Prérequis à l'installation

Assurez-vous de remplir les conditions matérielles et logicielles requises pour Insights.
Activez IIS 10+.
Pour activer IIS 10+, accédez à Panneau de configuration > Programmes > Activer ou désactiver des fonctionnalités Windows > 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
    - Document par défaut
    - Contenu statique
  - Intégrité et diagnostic
    - Journalisation HTTP
  - Performances
    - Contenu statique
  - Sécurité
    - Filtrage des demandes
- Outils de gestion
  - Console de gestion d'IIS
Téléchargez et installez le bundle d'hébergement .NET version 3.1.17+.
1. Téléchargez le bundle d'hébergement .NET.
2. Dans l'invite de commande, exécutez net stop was /y puis net start w3svc.
Installez Orchestrator et activez la fonctionnalité Insights. Vous devez obtenir un jeton d'accès à l'installation auprès d'Orchestrator.
Important :
• Assurez-vous de sélectionner le rôle 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 d'Insights SQL Server.

• 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.
Activez HTTPS sur votre serveur à l'aide d'un certificat SSL. La procédure est similaire à celle fournie pour Orchestrator. Consultez Utilisation d'un certificat pour le protocole HTTPS.
1. Obtenez un certificat auto-signé avec votre DNS et importez-le dans certlm.msc
2. Exécutez la commande suivante :
```
$cert = New-SelfSignedCertificate -certstorelocation cert:\localmachine\my -dnsname <your-dns-name> -KeySpec KeyExchange
$pwd = ConvertTo-SecureString -String '<your-password>' -Force -AsPlainText
$path = 'cert:\localMachine\my\' + $cert.thumbprint
Export-PfxCertificate -cert $path -FilePath <path-to-save>\cert.pfx -Password $pwd$cert = New-SelfSignedCertificate -certstorelocation cert:\localmachine\my -dnsname <your-dns-name> -KeySpec KeyExchange
$pwd = ConvertTo-SecureString -String '<your-password>' -Force -AsPlainText
$path = 'cert:\localMachine\my\' + $cert.thumbprint
Export-PfxCertificate -cert $path -FilePath <path-to-save>\cert.pfx -Password $pwd
```
  Remarque : Assurez-vous de remplacer les éléments suivants :
  - <your-dns-name> avec le nom DNS de votre serveur ou machine virtuelle
  - <your-password> avec le mot de passe avec lequel vous souhaitez chiffrer le certificat
  - <path-to-save> par l'emplacement où vous souhaitez enregistrer le certificat au format .pfx exporté
3. Installez manuellement le certificat dans Personnel (Personal) et Approuvé (Trusted) à l'aide du gestionnaire de certificats.
  Important: Il est préférable d’utiliser un certificat SAN SSL soumis à une autorité de certificat plutôt qu’un certificat autosigné.
  - Les certificats auto-signés (et ceux de votre propre autorité de certification) doivent être installés à la fois dans les banques de certificats Racine approuvée (Trusted Root) et Personnel (Personal) de la machine Insights, et ils doivent également être marqués comme Exportable.
  - Les certificats soumis à une autorité de certification doivent uniquement être installés dans Racine approuvée (Trusted Root).
  Notez que lorsque vous utilisez un certificat auto-signé, vous pouvez rencontrer des problèmes au moment d'accéder à Insights via Firefox ou Edge. Le support Internet Explorer n’est plus disponible pour Insights v2021.4 ou version plus récente.
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.
Vérifiez que le serveur où Insights sera installé peut communiquer avec le(s) serveur(s) où Orchestrator est installé et vice versa.
Si vous utilisez une machine locale ou une machine virtuelle hébergée dans le cloud, elle doit prendre en charge la virtualisation imbriquée sur les systèmes d'exploitation Windows.
- Azure - En savoir plus
- AWS - En savoir plus
Assurez-vous d'utiliser TLS 1.1 ou 1.2.
Assurez-vous que les ports suivants sont ouverts et accessibles : 543 (par défaut), 9999 et 19999.
Créez une règle de port entrant pour chaque port afin de l'ouvrir : 543, 9999, 19999.
- Port 543 :
- Port 9999 :
- Port 19999 :

Installez Docker en fonction de votre environnement.

Installer Docker pour Windows Server 2019 :

À l'aide de PowerShell, créez la variable suivante :
```
$TMP_WORKDIR="c:\docker"$TMP_WORKDIR="c:\docker"
```

À l'aide de PowerShell, créez le répertoire suivant :

New-Item $TMP_WORKDIR -ItemType Directory -forceNew-Item $TMP_WORKDIR -ItemType Directory -force

Activez les fonctionnalités Windows suivantes : Hyper-V et Container. Pour ce faire, procédez comme suit :
1. Accédez au Panneau de configuration, puis accédez à Programmes.
2. Cliquez sur Activer ou désactiver des fonctionnalités Windows.
3. Cochez les cases à côté de Hyper-V dans l'onglet Rôles de serveur (Server Roles) et Conteneur (Container) dans l'onglet Fonctionnalités (Features).
4. Redémarrez le serveur si nécessaire.

Vous pouvez utiliser PowerShell pour télécharger Docker et décompresser les conteneurs Linux dans le dossier $TMP_WORKDIR, en exécutant la commande suivante :

Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip"Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip"

Vous pouvez utiliser PowerShell pour télécharger le noyau lcow et décompresser les conteneurs Linux dans le dossier $TMP_WORKDIR, en exécutant la commande suivante :

Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip"Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip"

Ensuite, installez Docker et lcow :

Expand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force
Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -ForceExpand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force
Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force

Ensuite, à l'aide de PowerShell, définissez les variables d'environnement en exécutant la commande suivante :

[Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine)
[Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine")
[Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine")[Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine)
[Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine")
[Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine")

À l'aide de PowerShell, activez les fonctionnalités expérimentales dans daemon.json en exécutant la commande suivante :

$configfile = @"
{
    "experimental": true
}
"@
$configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force$configfile = @"
{
    "experimental": true
}
"@
$configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force

Enregistrez le service en exécutant la commande suivante dans PowerShell :

cd $Env:ProgramFiles\docker
.\dockerd.exe --register-servicecd $Env:ProgramFiles\docker
.\dockerd.exe --register-service

Enfin, redémarrez votre ordinateur en exécutant la commande suivante dans PowerShell :
```
Restart-Computer -ForceRestart-Computer -Force
```

Installez Docker sur des machines virtuelles isolées :

Pour installer Docker dans des environnements isolés, vous devez effectuer deux étapes. Tout d'abord, téléchargez les fichiers d'installation sur une machine virtuelle en ligne, puis copiez les fichiers sur votre machine virtuelle hors ligne, où vous souhaitez l'installer.

Prérequis

Assurez-vous que la machine virtuelle hors ligne répond aux exigences du serveur Insights.
La machine virtuelle en ligne doit exécuter Windows Server 2019+ et avoir accès à Internet.

Télécharger les fichiers d'installation de Docker sur la machine virtuelle en ligne

Dans votre machine virtuelle en ligne, ouvrez PowerShell en tant qu'administrateur et exécutez les commandes suivantes pour créer un nouveau dossier Docker.

# variables
$TMP_WORKDIR="c:\docker"

# Create tmp_workdir
New-Item $TMP_WORKDIR -ItemType Directory -force

# Install Hyper-V and Containers
Install-WindowsFeature Hyper-V
Install-WindowsFeature containers# variables
$TMP_WORKDIR="c:\docker"

# Create tmp_workdir
New-Item $TMP_WORKDIR -ItemType Directory -force

# Install Hyper-V and Containers
Install-WindowsFeature Hyper-V
Install-WindowsFeature containers

Téléchargez le noyau lcow et décompressez les conteneurs Linux dans le dossier $TMP_WORKDIR.

# Get docker
Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip"

# Get lcow
Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip"# Get docker
Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip"

# Get lcow
Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip"

Installer Docker sur la machine virtuelle hors ligne

Dans votre machine virtuelle hors ligne, ouvrez PowerShell en tant qu'administrateur et exécutez les commandes suivantes pour installer Docker, enregistrer le service et redémarrer la machine.

# Install
Expand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force
Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force

# Add Environment Variables
[Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine)
[Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine")
[Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine")

# Enable Experimental Features in Docker daemon.conf
$configfile = @"
{
    "experimental": true
}
"@
$configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force

# Register service
cd $Env:ProgramFiles\docker
.\dockerd.exe --register-service

# Restart Computer
Restart-Computer -Force# Install
Expand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force
Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force

# Add Environment Variables
[Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine)
[Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine")
[Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine")

# Enable Experimental Features in Docker daemon.conf
$configfile = @"
{
    "experimental": true
}
"@
$configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force

# Register service
cd $Env:ProgramFiles\docker
.\dockerd.exe --register-service

# Restart Computer
Restart-Computer -Force

Si vous utilisez VMWare, assurez-vous d'utiliser VMwareToolboxCmd 11.0.6+. Les versions antérieures peuvent entraîner le redémarrage inattendu du conteneur Docker.

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. Sinon, vous devez la configurer manuellement afin de la rendre insensible à la casse.

Si vous créez votre propre base de données Insights, vous devez définir la séquence de classement sur Latin1_General_CI_AS.

Prérequis

Assurez-vous que vous avez les éléments suivants à portée de main ou que vous les avez travaillés lors des étapes de configuration initiales :

Le nom de la machine exécutant SQL Server.
Le nom de l'instance, si ce n'est pas celle par défaut.
Le port SQL Server est ouvert dans le pare-feu de la machine exécutant SQL Server.
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.

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

Méthodes d'authentification SQL Server

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

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 activer l'authentification Windows, SQL Server doit prendre en charge l'authentification via le protocole Kerberos.

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

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

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 peut pas démarrer et l'Observateur d'événements sur l'ordinateur sur lequel Insights est installé affiche 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.

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

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

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 sur l'ordinateur sur lequel 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 utilisateur db_owner, comme dans la capture d'écran suivante.

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]
GOUSE 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]
GOUSE UiPath Insights
GO
GRANT EXECUTE ON SCHEMA::dbo TO [sql_user]
GO

Installation d'Insights

Remarque :

Lors de la mise à niveau vers 2021.10, les utilisateurs disposant des autorisations Insights ne sont actuellement pas migrés vers la nouvelle version. Un script pour le faire sera bientôt disponible.
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.

Exécutez le programme d'installation InsightsInstaller.msi en tant qu'administrateur à l'aide de l'invite de commande ou de la console PowerShell.
Tapez cmd ou powershell, puis cliquez avec le bouton droit sur l'application et sélectionnez Exécuter en tant qu'administrateur.
Tapez la commande cd <path-to-msi>, où <path-to-msi> correspond à l'emplacement de votre programme d'installation .msi. Par exemple, C:\Users\yourUsername\Downloads>.
Exécutez le programme d'installation d'Insights à l'aide de la commande suivante :
```
msiexec /i InsightsInstaller.msimsiexec /i InsightsInstaller.msi
```
Vous 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 dernier MSI{random chars}.LOG.

Si vous souhaitez spécifier un répertoire différent, utilisez la commande msiexec.exe /i InsightsInstaller.msi /L*V logfilepath. Pour plus de détails, consultez la page Assistance.
Acceptez le contrat de licence et cliquez sur Suivant (Next).
Modifiez les paramètres du serveur Insights comme suit :
- URL du serveur Insights (Insights Server URL) - le nom d'hôte ou l'URL du serveur Insights.
- Port - le port que vous souhaitez utiliser pour activer la communication entre l’ordinateur et Insights.
- 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
- Serveur d'identité séparé (Separate Identity Server) : Si vous disposez d'un serveur d'identité distinct, activez cette option.
- 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 Jeton d’accès de l’installation.
  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 de myserver). De préférence, le serveur SQL doit rejoindre directement le domaine AD.
  - Authentification Windows (Windows Authentication) - si cette option est sélectionnée, Insights se connecte à la base de données, crée des tables et exécute le pool d'applications IIS à l'aide des informations d'identification spécifiées. Le programme d'installation valide la connexion à l'aide des informations d'identification Windows avec lesquelles vous êtes actuellement connecté. Si vous sélectionnez cette option, vous devez spécifier le domaine, le nom d'utilisateur et le mot de passe.
  - Authentification SQL – si elle est sélectionnée, la connexion est effectuée à l’aide de l’authentification SQL. Si vous utilisez cette option, les champs Nom d’utilisateur (Username) et Mot de passe (Password) peuvent alors être modifiés et vous devez fournir le nom d’utilisateur et le mot de passe SQL utilisés pour vous connecter à la base de données.
- 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 - l'hôte SMTP
  - De (From) – l'adresse électronique à partir de laquelle envoyer des e-mails. Il doit correspondre à celui fourni pour le Nom d'utilisateur (Username).
  - 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
    
    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.
- 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.
  
  Important: Une fois l'installation d'Insights terminée, assurez-vous de redémarrer Docker.

Installation hors ligne

Pour une installation hors ligne, vous devez tenir compte des éléments suivants :

Installez Docker pour Windows Server 2019.
Orchestrator et la base de données Insights sont accessibles.
Assurez-vous que le serveur de messagerie SMTP est accessible, s'il est configuré.

Étapes post-installation

Vérification des services Insights

Remarque : ne supprimez pas le dossier C:\Users\yourUsername\_insights .

Accéder à Looker

Pour vérifier que Looker est en cours d'exécution, assurez-vous que le conteneur Docker est actif.

Une fois l'installation d'Insights terminée, accédez au navigateur pour confirmer la réussite de l'installation.

Résolution de la vulnérabilité log4j

Pour résoudre la vulnérabilité log4j, assurez-vous d'exécuter le correctif pour mettre à jour les dépendances vers la dernière version non vulnérable d'Apache Log4j.

Pour plus d'informations, consultez la section UiPath Insights (version 2021.10+)/Automation Suite Advisory dans UiPath Security Advisory CVE-2021-44228, CVE-2021-45046 & CVE-2021-45105j.

Modification d'Insights

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

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

Configuration du locataire

Après avoir installé Insights, vous devez l'activer pour le ou les locataires souhaités à partir du portail hôte Orchestrator. Pour plus de détails, voir Activer ou désactiver des fonctionnalités.

Remarque : Il existe des scénarios où la table Orchestrator dbo.tenants a les colonnes clé et accountId en majuscules. Cela ne se produit généralement qu'avec les anciennes versions d'Orchestrator (Orchestrator 18.X ou versions antérieures).

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.