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
Systemanforderungen überprüfen	Stellen Sie sicher, dass Sie die Voraussetzungen, Hardware- und Softwareanforderungen für die Version erfüllen, die Sie installieren möchten. Hardwareanforderungen Softwareanforderungen Voraussetzungen
Mehr über die durch die neue Bereitstellung eingeführten Änderungen erfahren	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
Plattform-Konfigurationstool ausführen	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. Plattform-Konfigurationstool: Dokumentation und Download.
Orchestrator stoppen	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

Während eines Orchestrator-Updates kann das Installationsprogramm einen verschlüsselten SecureAppSettings-Abschnitt in web.config nicht lesen. Um EncryptionKey aus der Datei web.config von Orchestrator zu lesen und dann in appsettings.Production.jsonvon Identity Server zu migrieren, muss der Schlüssel in Klartext sein. Sie müssen den Abschnitt manuell entschlüsseln , bevor Sie den Orchestrator aktualisieren. Nachdem der Orchestrator-Aktualisierungsprozess abgeschlossen wurde, denken Sie daran, den Abschnitt SecureAppSettings in web.configerneut zu verschlüsseln.

Zertifikat

Beachten Sie die neuen Zertifikatsanforderungen. Wenn Ihr vorhandenes Zertifikat diese Anforderungen nicht erfüllt, erfahren Sie hier, wie Sie ein gültiges Zertifikat erhalten und wie Sie es in der vorhandenen Orchestrator-Instanz ersetzen können, bevor Sie ein Upgrade durchführen.

Stellen Sie aus Sicherheitsgründen sicher, dass Sie für das Zertifikat, das zum Signieren der von Identity Server generierten Zugriffstoken verwendet wird, einen öffentlichen Schlüssel für 2048 Bit verwenden. Der Speicherort des Zertifikats muss im Abschnitt Signaturanmeldeinformationen von appsettings.Production.json festgelegt werden.

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 verwendet haben und die Konvertierung von importierten Active Directory-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 beim Orchestrator anmelden, um den Vorgang abzuschließen die Konvertierung. Durch die Anmeldung beim Identity Management-Portal oder die Anmeldung über UiPath Studio oder UiPath Assistant 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

Wenn Sie von einer anderen Cloud als der öffentlichen aus auf einen Azure Key Vault zugreifen, müssen Sie die Umgebungsvariable AZURE_AUTHORITY_HOST auf den entsprechenden Wert festlegen (d. h "AZURE_AUTHORITY_HOST": "https://login.microsoftonline.us/"). Weitere Informationen zu den Werten finden Sie in der Dokumentation zu Microsoft Entra-Authentifizierung und nationale Clouds – Microsoft Identity Platform .

Bekannte Probleme (Known Issues)

Datenbank-Timeout-Fehler beim Upgrade auf 2023.10+

Bei mehr als 100.000 Gruppen im Orchestrator kann es beim Upgrade auf 2023.10+ zu einem Timeout-Fehler kommen.

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.10ist, Sie müssen Ihre Lizenzinformationen aktualisieren, andernfalls profitieren Sie nicht vom Kulanzzeitraum nach Ablauf der Lizenz, was zu Dienstunterbrechungen führen kann.

Paketmigration

In v2020.10+ Legacy ist kein unterstützter NuGet-Repository-Typ mehr. Pakete, die sich zuvor in einem Legacy -Repository befinden, werden in ein Composite -Repository migriert. Für zusammengesetzte Repositorys wird der Speicherort des Pakets mithilfe der Parameter Storage.Type und Storage.Location in UiPath.Orchestrator.dll.configkonfiguriert. Nach dem Upgrade sind alle Legacy-bezogenen App-Einstellungen veraltet und nicht mehr wirksam:

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