Aktualisierung und Migration

Überblick

Warnung:

Bitte beachten Sie, dass sich diese Informationen auf die Version beziehen, auf die Sie aktualisieren, NICHT auf die Version, von der Sie aktualisieren. Stellen Sie daher sicher, dass Sie die richtigen Details lesen, bevor Sie fortfahren.

Um herauszufinden, ob Ihre ältere Version des Orchestrators auf eine neue Version aktualisiert werden kann, prüfen Sie die Matrix der Upgrade-Pfade für den Orchestrator in unserem Übersichtsleitfaden.

Die aktuellen verfügbaren Versionen finden Sie auf der Seite Versionshinweise.

Checkliste vor der Installation

Bevor Sie mit einem/r Orchestrator-Upgrade/-Installation fortfahren, lesen Sie die folgende Aufgabenliste sorgfältig durch:

Beschreibung	Details
✅ Überprüfen Sie die Systemanforderungen	Stellen Sie sicher, dass Sie die Voraussetzungen, Hardware- und Softwareanforderungen für die Version erfüllen, die Sie installieren möchten. Hardwareanforderungen Softwareanforderungen Voraussetzungen
✅ Erfahren Sie mehr über die durch die neue Bereitstellung eingeführten Änderungen	Eine neue Orchestrator-Bereitstellung führt zu Änderungen, die Sie kennen sollten. Einige der Elemente müssen vor einem Upgrade/einer Installation behandelt werden. Einige sind Hinweise zu den größten Änderungen und Empfehlungen, wie man die neue Version optimal nutzen kann. Die Runtime wurde von .NET Framework in .NET Core geändert Es wurden einige Änderungen an den Konfigurationsdateien vorgenommen Das SignalR-Protokoll wurde aktualisiert. Die NuGet-Infrastruktur wurde überarbeitet. Die Swagger-Bibliothek wurde aktualisiert. API-Änderungen
✅ Führen Sie das Plattformkonfigurationstool aus	Das Plattformkonfigurationstool ist ein PowerShell-Skript, das Sie bei der erfolgreichen Installation/Aktualisierung von Orchestrator unterstützt. Es hilft Ihnen, die Integrität und Bereitschaft Ihrer Umgebung vor einem Upgrade zu überprüfen, und unterstützt Sie bei der Durchführung mehrerer Vorgänge nach der Installation. Platform Configuration Tool documentation and download.
✅ Beenden Sie den Orchestrator	Upgrades Ihres Orchestrators müssen bei beendeter Anwendung durchgeführt werden. Die Durchführung von Aktualisierungen bei laufender Anwendung kann zu Fehlern führen und wird nicht unterstützt.

Direktes Aktualisieren von Orchestrator

Wenn Sie Orchestrator erstmals kaufen, sind die Installationsartifakte vorhanden oder können von Ihrem Kundenerfolgsmanager oder Ihrem Support-Team eingerichtet werden. Es gibt mehrere Möglichkeiten für eine direkte Aktualisierung:

Verwendung von Windows Installer

UiPathOrchestrator.msi führt ein In-Place-Update durch, das alle Ihre Einstellungen kopiert und einen Sicherungsordner für die alte Version erstellt. Es ist sowohl für eine Ein-Knoten-Architektur als auch für eine Architektur mit mehreren Knoten geeignet. Einige web.config-Einstellungen werden nicht kopiert, wenn die Version, von der Sie aktualisieren, mit den veralteten Skripts installiert wurde. Die Reparaturfunktionalität des Windows-Installationsprogramms wird nicht unterstützt.

Wenn der Orchestrator, den Sie aktualisieren möchten, mit dem jetzt veralteten Installationsprogramm UiPathPlatformInstaller.exe installiert wurde, verwenden Sie das Windows-Installationsprogramm, um diese Version zu aktualisieren.

Erfahren Sie, wie Sie mit dem Windows-Installationsprogramm aktualisieren.

Verwenden des Azure-Skripts

Eine komplexe Aktualisierung von Orchestrator und seinen Komponenten auf einem oder mehreren Knoten im Azure-Portal.

Erfahren Sie, wie Sie mit dem Azure-Skript aktualisieren.

Aktualisierungsüberlegungen

Verschlüsselung

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.

Zertifikat

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.

Datenbank

Ungeachtet dessen, welche Aktualisierung Sie wählen, wird die Datenbank, auf die Sie verweisen, automatisch während der Ausführung der Aktualisierung erstellt, wenn sie nicht existiert. Wenn Sie auf eine bestehende Datenbank verweisen, wird die während desselben Prozesses aktualisiert. Für die Orchestrator-SQL-Datenbank wird bei der Installation automatisch festgelegt, dass Groß-/Kleinschreibung nicht berücksichtigt wird (“OrchDB” = “orchdb”).

Externe Anbieter

Wenn Sie beim Durchführen des Updates externe Anbieter in web.config aktiviert haben, werden Sie zu den manuellen Änderungen aufgefordert, die Sie für Ihre bereits vorhandenen externen Anbieter vornehmen müssen.

Benutzer

Beim Upgrade auf die neueste Orchestrator-Version werden alle Ihre lokalen Konten automatisch vom Orchestrator zum Identity Server migriert und in das erforderliche Format konvertiert.

Diese Änderung wirkt sich nicht auf Ihre Roboter aus.

Hinweis:

Wenn Sie jemals Version 2018.4 hatten und die Konvertierung von aus Active Directory importierten Benutzerkonten in Verzeichniskonten nicht abgeschlossen haben (oder nicht alle importierten Benutzer konvertiert haben), müssen sich die Verzeichniskonten, die nicht konvertiert wurden, mindestens einmal interaktiv im Orchestrator anmelden, um die Konvertierung abzuschließen . Wenn Sie sich beim Identity Management-Portal oder über UiPath Studio oder UiPath Assistant anmelden, wird die Konvertierung des Kontos nicht abgeschlossen.

Sobald die Konvertierung abgeschlossen ist, können Sie die einfache Authentifizierung nicht mehr verwenden, um sich mit den jeweiligen Benutzern anzumelden.

Anwendungspool-Identitäten

Beim Upgrade auf die neueste Orchestrator-Version empfehlen wir dringend, denselben Anwendungspoolidentitätstyp für Identity Server und dieselben Webhooks zu verwenden wie bei der ursprünglichen Orchestrator-Installation.

Wenn Sie beispielsweise bei der Installation der Orchestrator-Version 2020.10 den Anwendungspoolidentitätstyp als benutzerdefiniertes Konto festgelegt haben, wählen Sie beim Upgrade auf 2021.10 denselben Anwendungspoolidentitätstyp aus (d. h. das benutzerdefinierte Konto), sowohl für Identity Server- als auch für Webhooks-Anwendungen. Andernfalls könnte der Zugriff auf den SQL-Server blockiert sein.

Azure Key Vault

When you access an Azure Key Vault from a different cloud than the public one, you must set the environment variable AZURE_AUTHORITY_HOST to the corresponding value (i.e. "AZURE_AUTHORITY_HOST": "https://login.microsoftonline.us/"). For more details on the values, check the Microsoft Entra authentication & national clouds - Microsoft identity platform documentation.

Bekannte Probleme (Known Issues)

Datenbank-Timeout-Fehler beim Upgrade auf 2023.10 oder höher

Mehr als 100.000 Gruppen in Orchestrator können einen Timeout-Fehler beim Upgrade von einer Version älter als 2023.10 auf 2023.10 oder höher verursachen.

Um dies zu umgehen, führen Sie das folgende Skript direkt in Ihrer Datenbank aus und wiederholen Sie dann das Upgrade:

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

Probleme mit Antivirensoftware

Antivirensoftware kann verhindern, dass die Datenmigrationsskripts während des Upgrades ordnungsgemäß funktionieren.

Probleme mit Anmeldeversuchen

Nachdem Sie Ihren Orchestrator von 2019.10 oder älter aktualisiert haben, werden auf der Profilseite keine Anmeldeversuche vor dieser Aktualisierung angezeigt.

Aktualisieren Ihrer Lizenz nach der Installation

Nachdem Sie den Orchestrator aktualisiert oder migriert haben, empfehlen wir Ihnen, Ihre Lizenzinformationen auf der Seite Lizenzen mithilfe der Online- oder Offlineaktivierung zu aktualisieren. Anweisungen finden Sie unter Aktivieren Ihrer Lizenz.

Wichtig:

Wenn Sie ein Upgrade oder eine Migration von einer Version durchführen, die älter als 2019.10 ist, müssen Sie Ihre Lizenzinformationen aktualisieren, andernfalls profitieren Sie nicht von dem Übergangszeitraum beim Ablauf der Lizenz, was zu Dienstunterbrechungen führen kann.

Paketmigration

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

Der neue Paketspeicherort hängt davon ab, wie Sie die Parameter NuGet.Packages.Path und NuGet.Activities.Path in web.config für die vorherige Orchestrator-Version konfiguriert haben.

Standardspeicherort

Wenn Sie die Pakete an den Standardspeicherorten (~/NuGetPackages und ~/NuGetPackages/Activities) gespeichert haben, wird RootPath=.\Storage der neue Paketspeicherort.

Wichtige Standardeinstellungen vor 2020.10 – web.config	Wichtige Standardeinstellungen in 2020.10+ – 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" />

Benutzerdefinierter Standort

Wenn Sie die Pakete an einem benutzerdefinierten Speicherort gespeichert haben, werden Sie während der Installation nach einem neuen Speicherort gefragt. Bei unbeaufsichtigten Installationen werden die Parameter STORAGE_TYPE und STORAGE_LOCATION obligatorisch, es sei denn, Sie fügen sie vor dem Upgrade ausdrücklich in web.config (Storage.Type und Storage.Location) hinzu.

Migrationsmatrix für Pakete

Die folgende Matrix beschreibt, wann die Parameter STORAGE_TYPE und STORAGE_LOCATION während eines Upgrades angefordert oder ignoriert werden. Die Matrix berücksichtigt die Version, von der Sie aktualisieren, sowie die Anpassung des Paketspeicherorts sowohl in der vorherigen Version als auch in 2020.10 und höher.

Auf der Grundlage dieser Funktionskombination zeigt die Matrix beispielsweise, dass die beiden Parameter im Silent-Modus für ein Upgrade von Version 2019.4+ angefordert (mit einem Häkchen versehen) werden, wenn das Paket an einem benutzerdefinierten Speicherort gespeichert wurde, der neue Speicherort aber ein Standardspeicherort ist.

Upgrade von	Vorheriger Legacy-Speicherort	Neuer Verbundsspeicherort	Im Speicherfenster angeforderte Parameter	Im unbeaufsichtigten Modus angeforderte Parameter	Von CMD ignorierte Parameter
2019.4+	Standard	Standard			✅
2019.4+	Standard	Benutzerdefiniert			✅
2019.4+	Benutzerdefiniert	Standard	✅	✅
2019.4+	Benutzerdefiniert	Benutzerdefiniert			✅

Migrationsfehler

Wenn die Paketmigration aus irgendeinem Grund fehlschlägt, werden Ihnen die folgenden Optionen angezeigt:

• Wiederholen - Die Paketmigration wird neu gestartet. Pakete, die bereits migriert wurden, werden übersprungen.
• Abbrechen - Die Installation wird neu gestartet. Während des Migrationsschritts werden Pakete, die bereits migriert wurden, nicht übersprungen und erneut migriert. Aus diesem Grund finden Sie möglicherweise doppelte Dateien in verschiedenen Containern. Dies geschieht nur, wenn von älteren Versionen als 2019.4 migriert wird.
• Fortsetzen - Die Migration wird fortgesetzt.

Upgrades von 2019.10

Die Migration als Teil eines Upgrades von 2019.10 kann manchmal dazu führen, dass sich Paketnamen ändern und somit im Orchestrator nicht mehr verfügbar sind. In diesem Fall empfehlen wir Ihnen, alle betroffenen Pakete manuell hochzuladen.