Windows Installer

Le UiPathOrchestrator.msi programme d'installation vous permet d’installer Orchestrator sur un ou plusieurs nœuds, en fonction de vos besoins. Les sections suivantes vous fournissent les détails sur la façon d’effectuer une installation réussie dans les environnements mono-et multi-nœuds.

Services inclus

Les services inclus dans l'installation d'Orchestrator sont les suivants :

Orchestrator
Serveur d'identité
Webhooks
Service de catalogue de ressources

Installation sur un nœud unique

Dans des installations à nœud unique, la session est gardée en mémoire, car il n'est pas nécessaire de la partager.

Exécutez Windows Installer (UiPathOrchestrator.msi). L'assistant Installation d'UiPath Orchestrator (UiPath Orchestrator Setup) s'affiche.
Cochez la case J'accepte les conditions du contrat de licence pour accepter les conditions du contrat, puis cliquez sur Installer. La fenêtre de sélection Fonctionnalités du produit s'affiche :
Important :
- Lorsque vous activez la fonctionnalité Automatisation de test, une base de données portant le nom par défaut UiPathTestAutomation est créée. Vous pouvez choisir un autre nom en passant par la ligne de commande TA_DATABASE_NAME=<MyCustomDB>.
- La base de données Automatisation de test (Test Automation) peut être séparée de la base de données Orchestrator ou y être intégrée.
Indiquez si les fonctionnalités suivantes sont installées avec Orchestrator : UiPath Insights et/ou Test Automation. Cliquez sur Suivant(Next) pour afficher l'étape Paramètres IIS d'Orchestrator .
Modifiez les paramètres d'IIS comme vous le souhaitez :
- Nom du site Web - le nom du site Web. Il est défini sur UiPath Orchestrator par défaut et ne peut pas être modifié.
- Port du site Web - le port que vous souhaitez utiliser pour activer la communication entre l’ordinateur et Orchestrator. Par défaut, il est défini sur 443, pour vous permettre d'utiliser HTTPS. Si un autre port est utilisé, assurez-vous de l'ajouter au paramètre PUBLIC_URL du Identity Server comme indiqué ci-dessous.
- Ajouter des règles de pare-feu pour ce port (Add firewall rules for this port) : lorsque cette option est sélectionnée, des règles de pare-feu sont automatiquement ajoutées pour ce port afin de garantir la sécurité de la machine.
- Certificat SSL (SSL certificate) : le sujet ou l'empreinte du certificat SSL à utiliser pour sécuriser les connexions avec Orchestrator. Par défaut, il est renseigné avec le nom d'ordinateur complet.
- Vérifier la disponibilité du port (Verify port availability) : si cette option est sélectionnée, vérifie si le port de site Web spécifié est disponible.
Cliquez sur Suivant (Next). L'étape Paramètres du pool d'applications (Application Pool Settings) s'affiche.
Configurez les options modifiables comme vous le souhaitez :
- Nom (Name) - nom du pool d'applications. Il est défini sur UiPath Orchestrator par défaut et ne peut pas être modifié.
- Identité (Identity) : permet de choisir l'identité sous laquelle le site UiPath Orchestrator s'exécute. Les options suivantes sont disponibles :
  - Identité du pool d'applications (Application Pool Identity) : exécute le site Web Orchestrator sous l'identité par défaut du pool d'applications.
  - Compte personnalisé (Custom account) : exécute le site Web Orchestrator sous une identité Windows ou de domaine existante. La sélection de cette option affiche deux champs, Nom d'utilisateur (Username) et Mot de passe (Password), qui permettent de spécifier l'identité sous laquelle réaliser l'exécution.
    
    Pour plus d’informations sur les identités de pool d’applications, reportez-vous à la documentation officielle de Microsoft.
- Cliquez sur Suivant (Next). L'étape Paramètres de la base de données Orchestrator (Orchestrator Database Settings) s'affiche.
Remplissez les champs avec les informations relatives à votre SQL Server, comme suit :
- Hôte SQL Server (SQL Server host) - le nom de la machine exécutant SQL Server. Par défaut, il est configuré sur localhost (.). Si ce n'est pas l'instance par défaut, veuillez également la mentionner au format MyMachine\MyInstance. Vous pouvez également spécifier un numéro de port personnalisé ici en utilisant une virgule (MyMachine\MyInstance,800).
- Nom de la base de données - le nom de la base de données. Par défaut, elle est définie sur UiPath. Veuillez noter que les caractères spéciaux suivants ne sont pas pris en charge : un espace vide, \, /, *, :, ;, ?, ", <, >, | et la longueur maximale est de 123 caractères.
- Mode d'authentification (Authentication mode) : permet de choisir le mode d'authentification pour le site Web UiPath Orchestrator. Les options suivantes sont disponibles :
  - Authentification intégrée de Windows (Windows Integrated Authentication) : il s'agit de l'option par défaut. Si vous la sélectionnez, Orchestrator se connecte à la base de données en utilisant le compte Windows du pool de l'application IIS détecté et crée la base de données à l'aide des identifiants Windows avec lesquels vous êtes actuellement connecté.
  - Authentification de SQL Server (SQL Server Authentication) - si vous sélectionnez cette option, les champs Nom d'utilisateur SQL (SQL Username) et Mot de passe (Password) s'affichent. Ils doivent être remplis avec le nom d'utilisateur et le mot de passe SQL Server. Pour en savoir plus, voir le chapitre sur les conditions préalables.
    
    Remarque : Le mot de passe ne prend pas en charge l'utilisation des points virgules (;).
- Cliquez sur Suivant (Next). Le programme d'installation vérifie la connexion SQL. Si celle-ci n'est pas valide, une boîte de dialogue est affichée. Si la connexion SQL est valide, l'étape Paramètres d'Identity Server (Identity Server Settings) est affichée.
  
  Remarque : Le serveur d'identité est livré avec Orchestrator, ce qui permet de réaliser l'authentification et le contrôle d'accès centralisés des produits UiPath.
  
  Attention : Pour les déploiements importants, nous vous recommandons d’utiliser une base de données distincte pour l'Identity Server.
Remplissez les champs avec les informations relatives à votre Identity Server, comme suit :
- Nom de la base de données (Database Name) - nom de la base de données. Par défaut, c'est le nom de la base de données, mais il est possible de le modifier. Notez que les caractères spéciaux suivants ne sont pas pris en charge : un espace vide, \, /, *, :, ?, ", <, >, |. La longueur maximale est de 123 caractères.
- URL publique d'Orchestrator - l'URL d'Orchestrator auquel le Identity Server se connecte. Dans un scénario multi-nœuds, il s'agit de l'URL du système d'équilibrage de la charge, par le biais de laquelle l'utilisateur appelle l'installation d'Orchestrator (par exemple, https://orchestrator.mydomain.local).
  
  Par défaut, l’URL publique Orchestrator est réglée sur https://<host name>. À noter que cela ne s'applique que si vous utilisez le port par défaut du site web suivant : 443. Si vous optez pour un port personnalisé, l’URL publique Orchestrator est https://<host name>:<custom port>. Par exemple, si le port du site web est réglé sur 444, l’URL publique Orchestrator est la suivante : https://<host name>:444.
- Certificat de signature : objet ou empreinte numérique du certificat utilisé pour signer les jetons d'accès utilisés pour réaliser l'authentification entre Orchestrator et le serveur d'identité.
Cliquez sur Suivant (Next). L'étape Paramètres de la base de données du serveur de mise à jour (Update Server Database Settings) s'affiche.
Remplissez les champs avec les informations relatives à votre base de données du serveur de mise à jour, comme suit :
- Hôte SQL Server (SQL Server host) : le nom de la machine exécutant SQL Server. Par défaut, il est configuré sur localhost (.). Si ce n'est pas l'instance par défaut, veuillez également la mentionner au format MyMachine\MyInstance. Vous pouvez également spécifier un numéro de port personnalisé ici en utilisant une virgule (MyMachine\MyInstance,800).
- Nom de la base de données (Database name) - le nom de la base de données utilisée par Update Server. Par défaut, c'est le nom de la base de données Orchestrator, mais vous pouvez le modifier. Notez que les caractères spéciaux suivants ne sont pas pris en charge : un espace vide, \, /, *, :, ?, ", <, >, |. La longueur maximale est de 123 caractères.
- Mode d'authentification (Authentication mode) : permet de choisir le mode d'authentification pour serveur de mise à jour. Les options suivantes sont disponibles :
  - Authentification intégrée de Windows (Windows Integrated Authentication) : il s'agit de l'option par défaut. Si vous la sélectionnez, Orchestrator se connecte à la base de données en utilisant le compte Windows du pool de l'application IIS détecté et crée la base de données à l'aide des identifiants Windows avec lesquels vous êtes actuellement connecté.
  - Authentification de SQL Server (SQL Server Authentication ) : si vous sélectionnez cette option, les champs Nom d'utilisateur SQL (SQL Username) et Mot de passe (Password) s'affichent. Ils doivent être remplis avec le nom d'utilisateur et le mot de passe SQL Server. Pour plus d'informations, consultez le chapitre sur les conditions préalables.
    Remarque : Le mot de passe ne prend pas en charge l'utilisation des points virgules (;).
- Cliquez sur Suivant (Next). L'étape Paramètres du journal Elasticsearch (Elasticsearch Log Settings) s'affiche.
(En option) Remplissez les champs avec les informations relatives à votre instance Elasticsearch, comme suit :
- URL (URL) : l'URL d'Elasticsearch dans laquelle consigner les informations.
- Requiert l'authentification (Requires authentication) : permet d'indiquer si votre instance d'Elasticsearch requiert l'authentification. Si cette option est sélectionnée, les champs Nom d'utilisateur (Username) et Mot de passe (Password) sont affichés.
  - Nom d'utilisateur : le nom d'utilisateur d'Elasticsearch.
  - Mot de passe (Password) : le mot de passe d'Elasticsearch.
    
    Remarque : Si vous ne voulez pas utiliser Elasticsearch pour la journalisation, laissez le champ URL (URL) vide.
- Cliquez sur Suivant (Next). L'étape Paramètres d'authentification d'Orchestrator (Orchestrator Authentication Settings) s'affiche.
Remplissez les champs comme suit :
- Mot de passe de l'hôte (Host password) : définissez un mot de passe personnalisé pour l'administrateur hôte. Notez que les mots de passe doivent contenir entre 8 et 33 caractères, et doivent contenir au minimum une minuscule et un chiffre.
- Confirmer le mot de passe (Confirm password) : confirmez le mot de passe de l'administrateur hôte.
- Réinitialiser à la première connexion (Reset at first login) : permet d'appliquer une réinitialisation du mot de passe à la première connexion de l'administrateur hôte. On l'appelle également mot de passe à usage unique.
- Mot de passe du locataire par défaut (Default tenant password) : définissez un mot de passe personnalisé pour l'administrateur locataire par défaut. Notez que les mots de passe doivent contenir entre 8 et 33 caractères, et doivent contenir au minimum une minuscule et un chiffre.
- Confirmer le mot de passe (Confirm password) : confirmez le mot de passe de l'administrateur locataire.
- Réinitialiser à la première connexion (Reset at first login) : permet d'appliquer une réinitialisation du mot de passe à la première connexion de l'administrateur locataire par défaut. On l'appelle également mot de passe à usage unique.
Cliquez sur Suivant. Si la fonctionnalité Insights a été sélectionnée, l'étape Insights s'affiche.

Remarque : lors de la configuration d’Insights SQL Server, 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.
Remplissez les champs avec les informations relatives à votre instance Insights, comme suit :
- Hôte SQL Server (SQL Server Host) - le nom de la machine exécutant Insights SQL Server. Par défaut, il est configuré sur localhost (.). Si ce n'est pas l'instance par défaut, veuillez également la mentionner au format MyMachine\MyInstance. Vous pouvez également spécifier un numéro de port personnalisé ici en utilisant une virgule (MyMachine\MyInstance,800).
- Nom de la base de données - le nom de la base de données. Par défaut, elle est définie sur UiPath. Veuillez noter que les caractères spéciaux suivants ne sont pas pris en charge : un espace vide, \, /, *, :, ;, ?, ", <, >, | et la longueur maximale est de 123 caractères.
- Mode d'authentification (Authentication mode) : permet de choisir le mode d'authentification pour le site Web UiPath Orchestrator. Les options suivantes sont disponibles :
  - Authentification intégrée de Windows (Windows Integrated Authentication) : il s'agit de l'option par défaut. Si vous la sélectionnez, Orchestrator se connecte à la base de données en utilisant le compte Windows du pool de l'application IIS détecté et crée la base de données à l'aide des identifiants Windows avec lesquels vous êtes actuellement connecté.
  - Authentification de SQL Server (SQL Server Authentication) : si vous sélectionnez cette option, les champs Nom d'utilisateur SQL (SQL Username) et Mot de passe (Password) s'affichent. Ils doivent être remplis avec le nom d'utilisateur et le mot de passe SQL Server.
- Cliquez sur Suivant. Si la fonctionnalité Automatisation de test a été sélectionnée, l’étape Automatisation de test s’affiche.
Remplissez les champs avec les informations relatives à votre instance Automatisation de test, comme suit :
- Hôte SQL Server (SQL Server host) - le nom de la machine exécutant Insights SQL Server. Par défaut, il est configuré sur localhost (.). Si ce n'est pas l'instance par défaut, veuillez également la mentionner au format MyMachine\MyInstance. Vous pouvez également spécifier un numéro de port personnalisé ici en utilisant une virgule (MyMachine\MyInstance,800).
- Nom de la base de données - le nom de la base de données. Notez que les caractères spéciaux suivants ne sont pas pris en charge : un espace vide, \, /, *, :, ;, ?, ", <, >, |. La longueur maximale est de 123 caractères.
- Mode d'authentification (Authentication mode) : permet de choisir le mode d'authentification pour le site Web UiPath Orchestrator. Les options suivantes sont disponibles :
  - Authentification intégrée de Windows (Windows Integrated Authentication) : il s'agit de l'option par défaut. Si vous la sélectionnez, Orchestrator se connecte à la base de données en utilisant le compte Windows du pool de l'application IIS détecté et crée la base de données à l'aide des identifiants Windows avec lesquels vous êtes actuellement connecté.
  - Authentification de SQL Server (SQL Server Authentication) : si vous sélectionnez cette option, les champs Nom d'utilisateur SQL (SQL Username) et Mot de passe (Password) s'affichent. Ils doivent être remplis avec le nom d'utilisateur et le mot de passe SQL Server.
    
    Remarque : Le mot de passe ne prend pas en charge l'utilisation des points virgules (;).
- Cliquez sur Suivant (Next). L'étape Paramètres de la base de données Orchestrator (Orchestrator Database Settings) s'affiche.
Saisissez le Type de stockage ( Storage Type) et l' Emplacement de stockage (Storage Location)souhaités. Voir ici pour plus de détails.
Cliquez sur Suivant (Next). L'étape Prêt à installer UiPath (Ready to install UiPath) s'affiche.
Cliquez sur Installer (Install). Le processus d'installation démarre. Notez qu'Orchestrator est installé à l'emplacement suivant : C:\Program Files (x86)\UiPath\Orchestrator.

Attention : Vérifiez à nouveau le chemin d’installation sélectionné. Le déplacement d’une installation vers un autre emplacement après l’installation n’est pas pris en charge.
Accédez au Gestionnaire des services Internet (IIS).
Sélectionnez le serveur Orchestrator. La Vue Fonctionnalités (Features View) est mise à jour en conséquence.
Double-cliquez sur Délégation des fonctionnalités (Feature Delegation). L'affichage Délégation des fonctionnalités (Feature Delegation) apparaît.
Cliquez avec le bouton droit sur Authentification (Authentication) - Windows et cliquez sur Lecture/Écriture (Read/Write).
Démarrez le site Web. Vous pouvez à présent utiliser Orchestrator.

Remarque : Pour vous connecter en tant qu’administrateur hôte, utilisez les identifiants fournis par nos équipes lors de l’achat d’une licence et écrivez host dans le champ Nom du locataire. Vous trouverez plus de détails ici.

Installation à plusieurs nœuds

Important :

Les déploiements d'Orchestrator multinœud utilisent le protocole RESP (REdis Serialization Protocol) pour la communication et peuvent donc être configurés à l'aide de n'importe quelle solution mettant en œuvre ce protocole.

Les déploiements haute disponibilité avec Orchestrator multi-nœuds ne sont pris en charge par UiPath que si est utilisé.

Attention : Pour les installations multi-nœuds, les paramètres CERTIFICATE_SUBJECT et IS_CERTIFICATE_SUBJECT sont obligatoires. L'intégration Orchestrator - Identity Server ne fonctionne pas si différentes certifications sont utilisées pour Identity. Sa valeur dans le fichier de paramètres utilisé doit être commune à tous les nœuds. C'est possible en utilisant :

Un certificat de caractères génériques (subject=*.domain.local) ; ou
Un certificat Nom alternatif de sujet (Subject Alternative Name, SAN) contenant les noms DNS de l'équilibreur de charge, et de manière facultative, les noms DNS de tous les nœuds, soit lors de la création des certificats, soit en modifiant la valeur dans le fichier de paramètres avant de procéder à l'installation du ou des nœuds secondaires.

Les certificats peuvent être saisis par sujet ou par empreinte.

Sur le nœud principal : installez Orchestrator à partir d'une invite de commandes élevée à l'aide de la ligne de commande suivante :

UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=install.json REDIS_HOST=redis.corp.local REDIS_PASSWORD=secretPass STORAGE_TYPE=FileSystem
                        STORAGE_LOCATION="RootPath=\\fileserver\Share" PUBLIC_URL=<Orchestrator_LoadBalancer_URL> CERTIFICATE_SUBJECT=*.domain.local
                        IS_CERTIFICATE_SUBJECT=*.domain.local

Pour plus d'informations sur les paramètres disponibles, reportez-vous ici.

Remarque : Vous pouvez également spécifier un port pour la solution RESP installée (REdis Serialization Protocol) en utilisant le paramètre REDIS_PORT si vous ne souhaitez pas utiliser le port par défaut (6379).

Le High Availability Add-on utilise le port 10000.

Important : Pour les déploiements incluant Insights, complétez l'installation d'Insights avant de procéder à l'installation du nœud secondaire d'Orchestrator.

Sur tous les nœuds secondaires, installez Orchestrator à l’aide de UiPathOrchestrator.msi avec des arguments de ligne de commande, en vous assurant de définir le paramètre SECONDARY_NODE sur Vrai et en fournissant le fichier de paramètres généré lors de l’installation du nœud principal. Nous vous recommandons également d'utiliser le paramètre /passive , car une installation passive affiche la barre de progression et des fenêtres contextuelles d'erreur. Optez pour le mode silencieux, en spécifiant le paramètre /Q, uniquement pour les installations Unattended.

Par exemple : UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json /Q.

Le pool d'applications est démarré et vous pouvez utiliser votre instance Orchestrator.

La base de données est initialisée lorsque vous installez le nœud principal. Lorsque vous configurez les nœuds secondaires, l'étape d’initialisation de la base de données n'est plus nécessaire.

Ajout de nœuds à l'Orchestrator multi-nœuds

Lorsque les méthodes ci-dessus supposent l'installation et la configuration des nœuds primaires et secondaires au cours du déploiement initial, il est également possible de générer un fichier de paramètres à partir de tout nœud existant destiné à être utilisé dans l'installation de tout nœud supplémentaire.

Cela se fait à l'aide du script Generate-ParametersFile.ps1, qui se trouve dans le sous-dossier Tools du répertoire d'installation d'Orchestrator :

Ouvrez le sous-dossier Tools de votre répertoire d'installation Orchestrator et exécutez Generate-ParametersFile.ps1.

Remarque: le mot de passe utilisateur appPool personnalisé doit être adopté à moins que appPoolIdentity ne soit utilisé pour l’authentification.
Un fichier JSON est généré sur la base des fichiers de configuration et de l'environnement d'Orchestrator.
À l’aide de ce fichier, terminez l’installation du nœud secondaire (étape 2 de l’installation multi-nœuds ci-dessus).

Considérations de stockage des paquets

Les métadonnées (définition) de tous les paquets (activités, workflows, bibliothèques) sont conservées dans la base de données SQL pour accélérer la recherche et le filtrage.

En outre, il est possible de conserver les fichiers réels et les supports d'exécution dans FileSystem ou un stockage blob de votre choix : Azure, Amazon S3 ou Minio. Cette fonctionnalité permet une synchronisation plus performante des fichiers, en particulier dans des environnements Orchestrator complexes à plusieurs nœuds.

Prenez en compte que, quel que soit le stockage que vous utilisez pour conserver vos paquets, la taille maximale du fichier par téléchargement est de 28,6 Mo - une limitation donnée par IIS. Pour voir comment modifier cela pour Amazon, Minio et FileSystem, veuillez visiter cette page.

À cette page