UiPath Documentation
orchestrator
2021.10
false
Guide d'installation d'Orchestrator
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique. La localisation du contenu nouvellement publié peut prendre 1 à 2 semaines avant d’être disponible.

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

Vous pouvez directement mettre à jour votre Orchestrator vers la version v2021.10 si vous utilisez actuellement l’une des versions suivantes :

  • 2021.x

  • 2020.x

  • 2019.x

  • 2018.4

    Important :

    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 2021.10

    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.

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.

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

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

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

Utilisation du script Azure​

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

Utilisation de l’installateur UiPathPlatform​

Un exécutable qui vous permet de mettre à jour Orchestrator, Robot et Studio. Il convient aux architectures à nœud unique. Les processus sont les mêmes que ceux que vous suivriez en utilisant les installateurs Windows, UiPathStudio.msi et UiPathOrchestrator.msi.

Contrairement à UiPathStudio.msi et UiPathOrchestrator.msi, UiPathPlatformInstaller.exe n'accepte pas les arguments de la ligne de commande.

Mettre à jour les considérations​

Encryption​

During an Orchestrator update, the installer cannot read an encrypted SecureAppSettings section within web.config . In order to read the EncryptionKey from Orchestrator's web.config and then migrate it into Identity Server's appsettings.Production.json, the key must be plain text. You need to manually decrypt the section before updating Orchestrator. After the Orchestrator update process was finalized, remember to re-encrypt the SecureAppSettings section in web.config.

Certificats​

Note the new certificate requirements. If your existing certificate doesn't meet them, here is how to get a valid certificate and how to replace it in the existing Orchestrator instance, before upgrading.

For security reasons, for the certificate used to sign the access tokens generated by the Identity Server, make sure to use a public key on 2048 bits. The certificate's location has to be set within appsettings.Production.json's Signing Credential section.

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.

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);
-- 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 de la période de grâce à l'expiration de la licence, ce qui peut entraîner une interruption du service.

Migration des paquets​

In v2020.10+, Legacy is no longer a supported NuGet repository type. Packages previously residing in a Legacy repository are migrated to a Composite repository. For composite repositories, package location is configured using the Storage.Type and Storage.Location parameters in UiPath.Orchestrator.dll.config. After the upgrade, all Legacy-related app settings become deprecated and no longer have an effect:

  • 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.config2020.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 (Silent mode) dans les cas suivants :

  • Pour une mise à niveau depuis la version 2018.4, si le package a été stocké dans un emplacement personnalisé

  • Pour une mise à niveau depuis la version 2019.4+, si le package a été stocké dans un emplacement personnalisé, mais que son nouvel emplacement de stockage est celui par défaut

    Mise à niveau depuisEmplacement Héritage précédentNouvel emplacement compositeParamètres demandés dans la fenêtre de stockageParamètres demandés en mode silencieuxParamètres ignorés du CMD
    2018.4Default✅
    2018.4Personnalisé✅✅
    2019.4+DefaultDefault✅
    2019.4+DefaultPersonnalisé✅
    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é.

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance

Vous souhaitez apprendre ? UiPath Academy

Vous avez des questions ? UiPath Forum

Rester à jour