Schritt 6: Migrieren des eigenständigen Orchestrators

Um den eigenständigen Orchestrator zur Automation Suite zu migrieren, müssen Sie Einstellungen und verschiedene Dateien aus der eigenständigen Installation sammeln und auf die Automation Suite-Installation anwenden.

Migrieren der maximalen Anforderungsgröße

Informationen zum Angeben einer benutzerdefinierten maximalen Anforderungsgröße finden Sie unter Konfigurieren der maximalen Anforderungsgröße.

Migrieren von appSettings

Um benutzerdefinierte Änderungen zu migrieren, die beim Abschnitt appSettings oder secureAppSettings der UiPath.Orchestrator.dll.config-Datei vorgenommen wurden, müssen Sie Ihre benutzerdefinierte Konfiguration zur orchestrator-customconfig-Konfigurationsübersicht hinzufügen.

Sie können oder dürfen nicht alle benutzerdefinierten Einstellungen migrieren. Weitere Informationen dazu, welche appSettings Sie migrieren müssen und welche nicht, finden Sie unter Orchestrator appSettings.

Informationen zum Anwenden von benutzerdefinierten appSettings auf Orchestrator finden Sie unter Konfigurieren von appSettings.

Migrieren des Speichers

Standardmäßig verwendet der Orchestrator in der Automation Suite die Speicherkonfiguration auf Cluster-Ebene. Die empfohlene Konfiguration ist der externe Speicher, bei dem alle Mandanten in einem Bucket eines Speicheranbieters gespeichert werden. Die unterstützten Speicheranbieter sind Azure, S3 und MinIO.

Informationen zum Migrieren von FileSystem-Speicher zu Cluster-Speicher in der Automation Suite finden Sie unter Hochladen von Dateien in den Speicher.

Informationen zum Verbinden vorhandener Speicher vom Typ Azure, AWS S3 oder S3-kompatibel (MinIO) mit dem Orchestrator in der Automation Suite finden Sie unter Konfigurieren von Azure-/Amazon S3-Speicher-Buckets. In dieser Konfiguration verwendet der Orchestrator nicht den gleichen Speicher wie die anderen Dienste im Cluster. Stellen Sie sicher, dass Sie Ihren vorherigen Orchestrator vom Speicherkonto trennen, bevor Sie ihn mit der Automation Suite konfigurieren, da dies potenzielle Datenverluste verhindert.

Migrieren von NLog

Sie müssen den NLog-Abschnitt der Konfigurationsdatei überprüfen und die benutzerdefinierte NLog-Konfiguration erstellen.

Informationen zum Aktivieren der Speicherung von Roboterprotokollen in Elasticsearch finden Sie unter Speichern von Roboterprotokollen in Elasticsearch.

Informationen zum Hinzufügen von Plugins und zur Durchführung der erweiterten NLog-Konfiguration finden Sie unter Konfigurieren von NLog.

Migrieren von Anmeldeinformationsspeichern

Um benutzerdefinierte Plugins für Anmeldeinformationsspeicher zur Automation Suite zu migrieren, aktualisieren Sie die Konfiguration in der Konfigurationsübersicht und kopieren Sie die Plugins-Assemblys in den entsprechenden Objektspeicher-Bucket.

Die folgenden Anmeldeinformationsspeicher-Plugins werden für den Orchestrator in der Automation Suite bereitgestellt:

UiPath.Orchestrator.AzureKeyVault.SecureStore.dll
UiPath.Orchestrator.SecureStore.CyberArkCCP.dll

Hinweis:

Die Automation Suite unterstützt CyberArk AIM nicht, sie können es also nicht migrieren. Wir empfehlen, stattdessen zum CyberArkCCP-Anmeldeinformationsspeicher zu migrieren.

Weitere Informationen zur Konfiguration des Anmeldeinformationsspeichers im Orchestrator finden Sie unter Konfigurieren von Anmeldeinformationsspeichern.

Migrieren des Verschlüsselungsschlüssels

Standardmäßig generiert der Orchestrator zum Zeitpunkt der Installation einen Verschlüsselungsschlüssel, der für vertrauliche Informationen in der Datenbank verwendet werden soll. Sie müssen diesen Schlüssel migrieren, wenn Sie eine Datenbank in einer neuen Orchestrator-Bereitstellung wiederverwenden möchten.

Führen Sie die folgenden Schritte aus, um den Verschlüsselungsschlüssel zu migrieren und zu aktualisieren:

Verschlüsseln Sie bei Bedarf den Abschnitt secureAppSettings der Datei UiPath.Orchestrator.dll.config. Weitere Informationen finden Sie unter Verschlüsseln von UiPath.Orchestrator.dll.config-Abschnitten.
Rufen Sie den Verschlüsselungsschlüssel von UiPath.Orchestrator.dll.config ab. Weitere Informationen finden Sie unter Verschlüsselungsschlüssel.
Ersetzen Sie den Verschlüsselungsschlüssel im Kubernetes-Geheimnis orchestrator-generated-secrets, indem Sie den Wert von APPSETTINGS__EncryptionKey überschreiben. Führen Sie dazu den folgenden Befehl aus:
```
ENCRYPT_KEY=$(echo <key>|base64 -w 0)
kubectl -n uipath patch secret orchestrator-generated-secrets --type='json' \
-p="[{'op': 'replace', 'path': '/data/APPSETTINGS__EncryptionKey', 'value':'$ENCRYPT_KEY'}]"ENCRYPT_KEY=$(echo <key>|base64 -w 0)
kubectl -n uipath patch secret orchestrator-generated-secrets --type='json' \
-p="[{'op': 'replace', 'path': '/data/APPSETTINGS__EncryptionKey', 'value':'$ENCRYPT_KEY'}]"
```
Hinweis: Stellen Sie sicher, dass Sie <key> durch den Wert des Schlüssels ersetzen, der von UiPath.Orchestrator.dll.config abgerufen wurde.

Migrieren des Verschlüsselungsschlüssels pro Mandant

Das Verschlüsselungsschlüsselzertifikat wird im Windows-Zertifikatspeicher installiert. Sie müssen das Zertifikat für die Automation Suite-Umgebung bereitstellen, damit es für die Orchestrator-Pods verfügbar wird.

Die Einstellungen CertificatesStoreLocation und Azure.KeyVault.CertificateThumbprint werden in der Automation Suite nicht mehr benötigt, Sie können jedoch bei Bedarf CertificatePassword verwenden.

Rufen Sie die Verbindungseinstellungen für den Azure Key Vault in den appSettings ab: