- Démarrage
- Prérequis
- Meilleures pratiques
- Installation
- Mise à jour en cours
- Serveur d'identité
- Résolution des erreurs de démarrage
Guide d'installation d'Orchestrator
À propos de la mise à jour et de la migration
Vous pouvez mettre directement à jour votre Orchestrator vers la version v2022.4 si vous utilisez actuellement l’une des versions suivantes :
- 2021.x
- 2020.x
-
2019.x
Important :Si vous utilisez la version 2018.4, vous devez effectuer une mise à niveau vers les versions 2019.x ou 2020.x ou 2021.x, puis passer à la version 2022.4.
Si vous utilisez une version inférieure à 2018.4, vous devez mettre à niveau vers v2018.4 ou v2019.x ou 2020.x, puis passer à la version 2022.4.
Nous vous recommandons d'utiliser la version 2019.10 comme version intermédiaire.
Pour voir les dernières versions disponibles, consultez la page des notes de mise à jour.
Avant de procéder à une mise à niveau/installation d'Orchestrator, examinez attentivement la liste des tâches suivante :
|
Description |
Détails (Details) |
|---|---|
|
|
Assurez-vous de satisfaire aux prérequis, aux exigences matérielles et logicielles de la version que vous souhaitez installer. |
|
|
Un nouveau déploiement Orchestrator apporte des changements dont vous devez avoir connaissance. Certains des éléments doivent être pris en charge avant une mise à niveau / installation. Certains sont des remarques sur les plus gros changements et recommandations sur la façon de tirer le meilleur de la nouvelle version. |
|
|
L’outil de configuration de la plate-forme est un script PowerShell utilisé pour vous aider durant l’installation et la mise à niveau d’Orchestrator. Il vous aide à vérifier le bon état et la disponibilité de votre environnement avant une mise à niveau, et vous aide à effectuer plusieurs opérations après l’installation. |
|
|
Les mises à niveau d'Orchestrator doivent être effectuées avec l'application arrêtée. L'exécution de mises à jour pendant l'exécution de l'application peut entraîner des erreurs et n'est pas prise en charge. |
Les artefacts d'installation sont fournis lors du premier achat d'Orchestrator. Votre responsable succès clients ou notre équipe d'assistance peut également les fournir. Quelques méthodes permettent d'effectuer la mise à jour directement :
UiPathOrchestrator.msi réalise une mise à jour sur place qui copie tous vos paramètres et qui crée un dossier de sauvegarde pour l'ancienne version. Elle est applicable à l’architecture à un ou plusieurs nœuds. Certains paramètres web.config ne sont pas copiés si la version à partir de laquelle vous effectuez la mise à niveau a été installée à l'aide de scripts obsolètes.La fonctionnalité de réparation de Windows Installer n'est pas prise en charge.
UiPathPlatformInstaller.exe, aujourd'hui obsolète, utilisez l’installateur Windows pour mettre à jour cette version.
Une mise à jour complexe d'Orchestrator et de ses composants sur un ou plusieurs nœuds, dans le portail Azure.
web.config . Pour lire la EncryptionKey du fichier web.config d’Orchestrator, puis la migrer dans le fichier appsettings.Production.jsondu serveur d’identité, la clé doit être en texte brut. Vous devez déchiffrer manuellement la section avant de mettre à jour Orchestrator. Une fois le processus de mise à jour Orchestrator finalisé, n’oubliez pas de rechiffrer la section SecureAppSettings dans web.config.
Notez les nouvelles exigences en matière de certificats. Si votre certificat n'y satisfait pas, voici comment obtenir un certificat valide et le remplacer dans l'instance Orchestrator existante avant de le mettre à niveau.
appsettings.Production.json.
Quelle que soit l'option de mise à jour que vous choisissez, si la base de données vers laquelle vous pointez n’existe pas, elle est automatiquement créée lors de l’exécution de la mise à jour. Si vous pointez vers une base de données existante, elle est mise à jour au cours du même processus. La base de données Orchestrator SQL est automatiquement définie comme insensible à la casse (« OrchDB » = « orchdb ») lors de l’installation.
web.config, vous êtes invité à réaliser les modifications manuelles requises dans l’emplacement existant des fournisseurs externes.
Lors de la mise à niveau vers la dernière version d'Orchestrator, tous vos comptes locaux sont automatiquement migrés d'Orchestrator vers Identity Server et convertis au format requis.
Ce changement n'a pas d'impact sur vos robots.
Une fois la conversion terminée, vous ne pouvez plus utiliser les informations d’authentification de base pour vous connecter avec les utilisateurs respectifs.
Lors de la mise à niveau vers la dernière version d'Orchestrator, nous vous recommandons vivement d'utiliser le même type d'identité de pool d'applications pour Identity Server et Webhooks que celui utilisé pour Orchestrator lors de l'installation d'origine.
Par exemple, si vous définissez le type d'identité du pool d'applications en tant que compte personnalisé lors de l'installation d'Orchestrator v2020.10, lors de la mise à niveau vers v2021.10, sélectionnez le même type d'identité de pool d'applications (c'est-à-dire un compte personnalisé) pour les applications Identity Server et Webhooks. Sinon, l'accès au serveur SQL peut être bloqué.
Erreurs de délai d'expiration de la base de données lors de la mise à niveau vers la version 2023.10 et plus
Le fait d'avoir plus de 100 000 groupes dans Orchestrator peut provoquer une erreur de délai d'expiration lors de la mise à niveau vers la version 2023.10 et plus.
Pour résoudre ce problème, exécutez le script suivant directement dans votre base de données, puis réessayez la mise à niveau :
-- 1. Delete group subscriptions
DECLARE @rowCount BIGINT = 1
DECLARE @batchSize BIGINT = 4000
DECLARE @pivotDate DATETIME = GETUTCDATE()
WHILE (@rowCount > 0)
BEGIN
DECLARE @subscriptionsToDeleteIds TABLE(
[Id] UNIQUEIDENTIFIER NOT NULL
)
INSERT INTO @subscriptionsToDeleteIds
SELECT TOP(@batchSize) [ns].[Id]
FROM [dbo].[NotificationSubscriptions] [ns]
JOIN [dbo].[Users] [u] ON [u].[Id] = [ns].[UserId]
WHERE [u].[Type] = 3 AND -- Group
[u].[CreationTime] <= @pivotDate AND
[u].[IsDeleted] = 0
DELETE FROM [dbo].[NotificationSubscriptions]
WHERE [Id] IN (
SELECT [Id] FROM @subscriptionsToDeleteIds
)
OPTION (MAXDOP 1)
SET @rowCount = @@ROWCOUNT
WAITFOR DELAY '00:00:00.1'
END
-- 2. Create index on UserNotifications
IF NOT EXISTS(SELECT * FROM sys.indexes WHERE OBJECT_ID = OBJECT_ID(N'[dbo].[UserNotifications]') AND NAME = N'IX_UserId_CreationTime')
CREATE NONCLUSTERED INDEX [IX_UserId_CreationTime] ON [dbo].[UserNotifications]
(
[UserId] ASC,
[CreationTime] ASC
) INCLUDE ([TenantNotificationId]) WITH (ONLINE = ON);-- 1. Delete group subscriptions
DECLARE @rowCount BIGINT = 1
DECLARE @batchSize BIGINT = 4000
DECLARE @pivotDate DATETIME = GETUTCDATE()
WHILE (@rowCount > 0)
BEGIN
DECLARE @subscriptionsToDeleteIds TABLE(
[Id] UNIQUEIDENTIFIER NOT NULL
)
INSERT INTO @subscriptionsToDeleteIds
SELECT TOP(@batchSize) [ns].[Id]
FROM [dbo].[NotificationSubscriptions] [ns]
JOIN [dbo].[Users] [u] ON [u].[Id] = [ns].[UserId]
WHERE [u].[Type] = 3 AND -- Group
[u].[CreationTime] <= @pivotDate AND
[u].[IsDeleted] = 0
DELETE FROM [dbo].[NotificationSubscriptions]
WHERE [Id] IN (
SELECT [Id] FROM @subscriptionsToDeleteIds
)
OPTION (MAXDOP 1)
SET @rowCount = @@ROWCOUNT
WAITFOR DELAY '00:00:00.1'
END
-- 2. Create index on UserNotifications
IF NOT EXISTS(SELECT * FROM sys.indexes WHERE OBJECT_ID = OBJECT_ID(N'[dbo].[UserNotifications]') AND NAME = N'IX_UserId_CreationTime')
CREATE NONCLUSTERED INDEX [IX_UserId_CreationTime] ON [dbo].[UserNotifications]
(
[UserId] ASC,
[CreationTime] ASC
) INCLUDE ([TenantNotificationId]) WITH (ONLINE = ON);
Problèmes avec les logiciels antivirus
Certains logiciels anti-virus peuvent empêcher les scripts de migration des données de fonctionner correctement pendant une mise à jour.
Problèmes lors des tentatives de connexion
Une fois la mise à jour de votre Orchestrator vers la version v2019.10 ou une version précédente réalisée, la page Profil n'affichera pas les tentatives de connexion antérieures.
Après avoir mis à niveau ou migré Orchestrator, nous vous recommandons de mettre à jour vos informations de licence à partir de la page Licences en utilisant l’activation en ligne ou hors ligne. Pour consulter les instructions, voir Activation de votre licence. Pour obtenir des instructions, consultez Activation de votre licence.
Legacy n'est plus un type de référentiel NuGet pris en charge. Les packages résidant auparavant dans un référentiel Legacy sont migrés vers un référentiel Composite . Pour les référentiels composites, l'emplacement du package est configuré à l'aide des paramètres Storage.Type et Storage.Location dans UiPath.Orchestrator.dll.config. Après la mise à niveau, tous les paramètres d'application liés à Legacydeviennent dépréciés et n'ont plus d'effet :
NuGet.Packages.PathNuGet.Activities.PathNuget.EnableRedisNodeCoordinationNuget.EnableNugetServerLoggingNuGet.EnableFileSystemMonitoringNuGet.Repository.Type
NuGet.Packages.Path et NuGet.Activities.Path dans web.config pour la version Orchestrator précédente.
~/NuGetPackages et ~/NuGetPackages/Activities), le nouvel emplacement du paquet devient RootPath=.\Storage.
|
Pré 2020.10 Défauts clés - web.config |
2020.10+ Paramètres par défaut des clés - UiPath.Orchestrator.dll.config |
|---|---|
|
|
|
STORAGE_TYPE et STORAGE_LOCATION deviennent obligatoires, sauf si vous les ajoutez spécifiquement dans web.config (Storage.Type et Storage.Location) avant la mise à niveau.
STORAGE_TYPE et STORAGE_LOCATION sont demandés ou ignorés lors d'une mise à niveau. La matrice prend en compte la version à partir de laquelle vous mettez à niveau, ainsi que la personnalisation de l'emplacement du package dans la version précédente et dans les versions 2020.10 et ultérieures.
Par exemple, sur la base de cette combinaison de fonctionnalités, la matrice indique que les deux paramètres sont demandés (signalés par une coche) en mode silencieux pour une mise à niveau à partir de la version 2019.4+ si le package était stocké dans un emplacement personnalisé, mais que son nouvel emplacement de stockage est celui par défaut.
|
Mise à niveau depuis |
Emplacement Héritage précédent |
Nouvel emplacement composite |
Paramètres demandés dans la fenêtre de stockage |
Paramètres demandés en mode silencieux |
Paramètres ignorés du CMD |
|---|---|---|---|---|---|
|
2019.4+ |
Default |
Default |
| ||
|
2019.4+ |
Default |
Personnalisé |
| ||
|
2019.4+ |
Personnalisé |
Default |
|
| |
|
2019.4+ |
Personnalisé |
Personnalisé |
|
Si, pour une raison quelconque, la migration des paquets échoue, les options suivantes vous sont présentées :
- Réessayer - La migration des paquets est redémarrée. Les paquets qui ont déjà été migrés sont ignorés.
- Abandonner - L’installation est redémarrée. Pendant l’étape de migration, les paquets qui ont déjà été migrés ne sont pas ignorés et sont à nouveau migrés. Pour cette raison, vous pouvez trouver des fichiers en double dans différents conteneurs. Cela ne se produit que lorsque vous migrez depuis des versions antérieures à 2019.4.
- Continuer - La migration se poursuit.
Mises à niveau à partir de 2019.10
La migration dans le cadre d'une mise à niveau à partir de 2019.10 peut parfois entraîner la modification des noms de packages, devenant ainsi indisponibles dans Orchestrator. Si cela se produit, nous vous recommandons de télécharger manuellement tout package concerné.
- Vue d'ensemble (Overview)
- Liste de contrôles avant l'installation
- Mise à jour directe d'Orchestrator
- Utilisation de Windows Installer
- Utilisation du script Azure
- Mettre à jour les considérations
- Encryption
- Certificats
- Base de donnés
- Fournisseurs externes
- Utilisateurs
- Identités du pool d'applications
- Problèmes connus
- Mettre à jour votre licence après l'installation
- Migration des paquets
- Emplacement par défaut
- Emplacement personnalisé
- Matrice de migration des paquets
- Erreurs de migration
