Migrationsvoraussetzungen

Stellen Sie vor dem Start der Migration sicher, dass die folgenden Voraussetzungen erfüllt sind:

.NET Runtime 6.0

.NET Runtime 6.0 oder höher ist erforderlich, um das Tool UiPath.OrganizationMigrationApp auszuführen. Sie müssen es herunterladen und installieren, bevor Sie UiPath.OrganizationMigrationApp ausführen.

Linux

Wenn .NET Runtime 6.0 oder höher nicht vorhanden ist, laden Sie .NET Runtime für Linux herunter und installieren Sie es, bevor Sie UiPath.OrganizationMigrationApp verwenden.

Um .NET Runtime 6.0 unter RHEL zu installieren, führen Sie den folgenden Befehl aus:

sudo yum install dotnet-sdk-6.0 -y

Windows

Das UiPath.OrganizationMigrationApp-Tool erfordert mindestens .NET Runtime 6.0. Wenn .NET Runtime 6.0 und höher nicht vorhanden ist, laden Sie .NET Runtime 6.0 für Windows herunter und installieren Sie es, bevor Sie UiPath.OrganizationMigrationApp verwenden.

Docker/Podman

Um den Migrationsprozess abzuschließen, müssen Sie einen Docker- oder Podman-Client verwenden, der mit der privaten Registrierung authentifiziert wurde. Dadurch können die Migratoren auf den MSI-Datenbanken ausgeführt werden, wodurch sie mit den Automation Suite-Datenbanken kompatibel sind.

Docker

• Informationen zum Herunterladen der Docker-Binärdateien finden Sie in der offiziellen Dokumentation zu Install Docker Engine.
• Informationen zum Authentifizieren der Docker-Registrierung finden Sie in der offiziellen Dokumentation zur Docker-Anmeldung. Alternativ können Sie den folgenden Befehl verwenden, indem Sie die Beispielanmeldeinformationen durch Ihre tatsächlichen Registrierungsanmeldeinformationen ersetzen:

  docker login my.registry.io:443 --username "admin" --password "secret"

Podman

• Informationen zum Herunterladen der Podman-Binärdateien finden Sie in den offiziellen Podman-Installationsanweisungen.
• Informationen zur Authentifizierung bei der Podman-Registrierung finden Sie in der offiziellen Dokumentation zur Podman-Anmeldung. Alternativ können Sie den folgenden Befehl verwenden, indem Sie die Beispielanmeldeinformationen durch Ihre tatsächlichen Registrierungsanmeldeinformationen ersetzen:

  podman login my.registry.io:443 --username "admin" --password "secret"

Einstellung zur Erstellung von Orchestrator-Buckets

Um sicherzustellen, dass Orchestrator-Buckets automatisch mit der richtigen CORS-Richtlinie erstellt werden, müssen Sie den folgenden Befehl ausführen. Der Befehl erfordert, dass das Dienstprogramm jq auf Ihrer Maschine installiert ist.

cd <AS install directory>
rm -f values.json && rm -f appsettings.json
kubectl -n <uipath> get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq '.' > values.json
jq '.AppSettings' values.json > appsettings.json
jq '.["Storage.CreateBucket.OnTenantCreation.Enabled"] = "true"' appsettings.json > temp.json && mv -f temp.json appsettings.json
uipathctl config orchestrator update-config --app-settings appsettings.json

Um jq zu installieren, verwenden Sie eine der folgenden Optionen:

• Option 1: Führen Sie den folgenden Befehl aus:

  yum install -y epel-release yum install -y jq

• Option 2: Führen Sie die folgenden Befehle aus:

  shell
  curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
  yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm

Warnung: Wenn die Orchestrator-Einstellung, die sicherstellt, dass Buckets automatisch mit der richtigen CORS-Richtlinie erstellt werden, nicht aktiviert wird, verursacht dies Probleme beim Herunterladen aus Speicher-Buckets, die Sie durch manuelle Aktualisierung der CORS-Richtlinie beheben müssen.

Um zu bestätigen, dass die Einstellung aktiviert wurde, führen Sie den folgenden Befehl aus:

kubectl -n <uipath> get cm orchestrator-customconfig -o jsonpath='{.data.values\.json}' | jq

Wenn die Einstellung aktiviert wurde, sollte der Befehl die folgende Antwort zurückgeben:

{
  "AppSettings": {
    "Storage.CreateBucket.OnTenantCreation.Enabled": "true"
  }
}

UiPath.OrganizationMigrationApp

Mit dem Tool UiPath.OrganizationMigrationApp können Sie Vorgänge ausführen, z. B. die Identitätsdaten aller Mandanten von eigenständigen in die Automation Suite verschieben und Organisationen zusammenführen.

Informationen zum Herunterladen von UiPath.OrganizationMigrationApp finden Sie unter Herunterladen der Installationspakete.

Eine Übersicht, welche UiPath.OrganizationMigrationApp-Version mit Ihrer Umgebung kompatibel ist, finden Sie in der Kompatibilitätsmatrix.

Tool zur Verwaltung von Microsoft SQL Server

Sie müssen SQL Server Management Studio (SSMS) oder ein ähnliches Tool zur Verwaltung von Microsoft SQL Server herunterladen und installieren. Mit diesem Tool können Sie die Orchestrator-Datenbank in der Automation Suite SQL Server-Instanz oder einer anderen SQL Server-Instanz wiederherstellen.

1. Laden Sie SQL Server Management Studioherunter und installieren Sie es.

2. Melden Sie sich beim eigenständigen SQL-Server mithilfe der eigenständigen SQL-Verbindungszeichenfolge an.

3. Öffnen Sie Port 1433 für die Quell- und Zieldatenbank.

Escape-Regeln für Sonderzeichen bei Kennwörtern von Verbindungszeichenfolgen

In den meisten Fällen werden Verbindungskennwörter in einzelne Anführungszeichen (') eingeschlossen. Wenn das Kennwort jedoch Sonderzeichen wie ` oder $ enthält, ist ein anderer Ansatz erforderlich.

In diesen Fällen muss das Kennwort wie \`"<password>\`" formatiert werden, wobei <password> durch das tatsächliche Kennwort ersetzt wird. Zudem müssen Sie die Escape-Regeln der folgenden Tabelle einhalten:

Originalformat in ADUC	Escape-Format in PowerShell-Zeichenfolge
cn=James $ Smith	"cn=James `$ Smith"
cn=Sally Wilson + Jones	"cn=Sally Wilson \+ Jones"
cn=William O'Brian	"cn=William O'Brian"
cn=William O`Brian	"cn=William O``Brian"
cn=Richard #West	"cn=Richard #West"
cn=Roy Johnson$	"cn=Roy Johnson$"

Beispiel

Angenommen, das ursprüngliche Kennwort ist 7'8:<=XMe$y[@vC?_4ZeY8c-~y'W!1dU4gnczuf'/p>j<I. Gemäß Escape-Regeln für Sonderzeichen wird daraus: Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`".

Das ist der vollständige Befehl mit dem in der Zielverbindungszeichenfolge konfigurierten Kennwort:

./UiPath.OrganizationMigrationApp.exe migrate -a -m -s "Server=tcp:abc.com,1433;Initial Catalog=UiPath_20230531;Persist Security Info=False;User ID=username;Password=asiodhyf;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=True;Connection Timeout=30;" -d "Server=tcp:cde.net,1433;Initial Catalog=AutomationSuite_Platform;Persist Security Info=False;User Id=[e-mail];Password=\`"7'8:<=XMe`$y[@vC?_4ZeY8c-~y'W!1dU4```gnczuf'/p>```j<I\`""

Hinweis: Stellen Sie sicher, dass der Befehl nur auf einer Maschine ausgeführt wird, die über autorisierten Zugriff auf die RDS-Datenbank verfügt.