À propos de la mise à jour et de la migration

Vue d'ensemble (Overview)

Avertissement : Veuillez garder à l’esprit que ces informations concernent la version vers laquelle vous effectuez la mise à niveau, et non la version à partir de laquelle vous effectuez la mise à niveau. Veillez donc à prendre connaissance des informations adéquates avant de continuer.

Pour voir si votre ancienne version d'Orchestrator peut être mise à niveau vers une version plus récente, consultez la matrice des chemins de mise à niveau d'Orchestrator dans notre guide de Présentation.

Pour voir les dernières versions disponibles, consultez la page des notes de mise à jour.

Liste de contrôles avant l'installation

Avant de procéder à une mise à niveau/installation d'Orchestrator, examinez attentivement la liste des tâches suivante :

Description	Détails (Details)
Examiner les exigences du système	Assurez-vous de satisfaire aux prérequis, aux exigences matérielles et logicielles de la version que vous souhaitez installer. Prérequis matériels Prérequis logiciels Prérequis
En savoir plus sur les changements introduits par le nouveau déploiement	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. A changé le runtime de .NET Framework en .NET Core A apporté plusieurs modifications aux fichiers de configuration. A mis à jour le protocole SignalR. A réorganisé l’infrastructure NuGet. A mis à jour la bibliothèque Swagger. Changements d’API.
Exécuter l’outil de configuration de la plate-forme	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. Documentation et téléchargement de l’outil de configuration de plate-forme.
Arrêter Orchestrator	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.

Mise à jour directe d'Orchestrator

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 :

Utilisation de Windows Installer

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.

Si l’Orchestrator que vous souhaitez mettre à jour a été installé à l’aide de UiPathPlatformInstaller.exe, aujourd'hui obsolète, utilisez l’installateur Windows pour mettre à jour cette version.

Découvrez comment installer à l'aide du Windows Installer.

Utilisation du script Azure

Une mise à jour complexe d'Orchestrator et de ses composants sur un ou plusieurs nœuds, dans le portail Azure.

Découvrez comment installer à l’aide du script Azure.

Mettre à jour les considérations

Encryption

Pendant la mise à jour d’Orchestrator, l’installateur ne peut pas lire une section SecureAppSettings chiffrée dans 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.

Certificats

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.

Pour des raisons de sécurité, assurez-vous d’utiliser une clé publique 2048 bits pour le certificat utilisé pour signer les jetons d’accès générés par le serveur d’identité. L’emplacement du certificat doit être défini dans la section Signature des informations d’identification de appsettings.Production.json.

Base de donnés

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.

Fournisseurs externes

Quand vous réalisez la mise à jour, si des fournisseurs externes sont activés dans web.config, vous êtes invité à réaliser les modifications manuelles requises dans l’emplacement existant des fournisseurs externes.

Utilisateurs

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.

Remarque : si vous avez déjà utilisé la version 2018.4 et que vous n'avez pas terminé la conversion des comptes d'utilisateurs importés Active Directory en comptes de répertoire (ou si vous n'avez pas converti tous les utilisateurs importés), les comptes de répertoire qui n'ont pas été convertis doivent se connecter de manière interactive à Orchestrator au moins une fois pour finaliser la conversion. La connexion au portail de gestion des identités, ou la connexion depuis UiPath Studio ou UiPath Assistant ne termine pas la conversion du compte.

Une fois la conversion terminée, vous ne pouvez plus utiliser les informations d’authentification de base pour vous connecter avec les utilisateurs respectifs.

Identités du pool d'applications

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

Azure Key Vault

Lorsque vous accédez à Azure Key Vault à partir d'un cloud différent du cloud public, vous devez définir la variable d'environnement AZURE_AUTHORITY_HOST sur la valeur correspondante (c'est-à-dire "AZURE_AUTHORITY_HOST": "https://login.microsoftonline.us/"). Pour plus de détails sur les valeurs, consultez la documentation Authentification Microsoft Entra et cloud nationaux - Plate-forme d'identité Microsoft (Microsoft Entra authentication & nationaux clouds) .

Problèmes connus

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

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.

Mettre à jour votre licence après l'installation

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.

Important : si vous mettez à niveau ou migrez à partir d'une version antérieure à 2019.10, vous devez mettre à jour vos informations de licence, sinon vous ne bénéficiez pas du délai de grâce à l'expiration de la licence, ce qui peut entraîner une interruption du service.

Migration des paquets

Dans la version v2020.10+, 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.Path
• NuGet.Activities.Path
• Nuget.EnableRedisNodeCoordination
• Nuget.EnableNugetServerLogging
• NuGet.EnableFileSystemMonitoring
• NuGet.Repository.Type

Le nouvel emplacement du paquet dépend de la façon dont vous avez configuré les paramètres NuGet.Packages.Path et NuGet.Activities.Path dans web.config pour la version Orchestrator précédente.

Emplacement par défaut

Si vous avez stocké les paquets dans les emplacements par défaut (~/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
<add key="NuGet.Packages.Path" value="~/NuGetPackages" /> <add key="NuGet.Activities.Path" value="~/NuGetPackages/Activities" />	<add key="Storage.Type" value="FileSystem" /> <add key="Storage.Location" value="RootPath=.\Storage" />

Emplacement personnalisé

Si vous avez stocké les paquets dans un emplacement personnalisé, pendant l’installation, on vous demande un nouvel emplacement de stockage. Pour les installations silencieuses, les paramètres 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.

Matrice de migration des paquets

La matrice ci-dessous décrit quand les paramètres 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é

Erreurs de migration

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