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.

Es ist möglich, Ihren Orchestrator in den folgenden Fällen direkt auf v2020 zu aktualisieren:

• Sie haben eine beliebige Version 2018.4
• Sie haben eine beliebige Version 2019.x
• Sie haben eine beliebige 2020.x- Version.

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. Platform Configuration Tool documentation and 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.

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.

Verwenden des UiPathPlatform-Installationsprogramms

Eine ausführbare Datei, mit der Sie Orchestrator, Robot und Studio aktualisieren können. Sie eignet sich für Architekturen mit einem Knoten. Die Prozesse sind die gleichen wie die, die Sie mit den Windows-Installationsprogrammen, UiPathStudio.msi und UiPathOrchestrator.msi durchlaufen würden.

Im Gegensatz zu UiPathStudio.msi und UiPathOrchestrator.msi akzeptiert UiPathPlatformInstaller.exe keine Befehlszeilenargumente.

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.

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

After you upgrade or migrate Orchestrator, we recommend that you update your license information from the Licenses page using either online or offline activation.

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.Packages.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 in den folgenden Fällen im Silent-Modus angefordert (mit einem Häkchen versehen) werden:

• Für ein Upgrade von Version 2018.4, wenn das Paket an einem benutzerdefinierten Speicherort gespeichert wurde

• Bei einem Upgrade von Version 2019.4+ wenn das Paket an einem benutzerdefinierten Speicherort gespeichert wurde, der neue Speicherort jedoch ein Standardspeicherort ist

  Upgrade von	Vorheriger Legacy-Speicherort	Neuer Verbundsspeicherort	Im Speicherfenster angeforderte Parameter	Im unbeaufsichtigten Modus angeforderte Parameter	Von CMD ignorierte Parameter
  2018.4	Standard
  2018.4	Benutzerdefiniert
  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.