Azure App Service-Installation

Überblick

Das Azure-Installationsskript ermöglicht Ihnen die Installation von Orchestrator auf einem oder mehreren Knoten.

Wichtig:

1. Alle Schritte sind bei den unten aufgeführten Installationsverfahren obligatorisch. Ohne die Installation von Identity Server funktioniert Orchestrator nicht.

2. Bevor Sie die Installation des Orchestrators starten, stellen Sie sicher, dass Ihre Zertifikate von einer von Azure vertrauenswürdigen Zertifizierungsstelle wie DigiCert ausgestellt wurden.

3. Azure Stack wird nicht unterstützt, da API-Inkompatibilitäten auftreten können. Bitte verwenden Sie Azure Cloud für Ihre Bereitstellung.

Einzelknoten-Installation

Zum Installieren von Orchestrator auf einem Azure-App-Dienst führen Sie die folgenden Schritte aus:

Orchestrator-Schritte

1. Erstellen Sie im Azure-Portal unter App Services einen neuen App-Dienst mit einem benutzerdefinierten Namen, z. B. UiPathOrchestrator. Achten Sie beim Erstellen der Web-App darauf, Stack .NET Core 3.1auszuwählen. Weitere Informationen finden Sie in der offiziellen Dokumentation von Microsoft.

2. Öffnen Sie die neu erstellte Web-App im Azure-Portal, und wählen Sie auf der Registerkarte Konfiguration Allgemeine Einstellungen aus, und nehmen Sie dann die folgenden Konfigurationsänderungen vor:

   • Setzen Sie Plattform auf 64-Bit.
   • Legen Sie Websockets auf Ein fest.

3. Legen Sie die Datenbankverbindungszeichenfolge über Konfiguration > Verbindungszeichenfolgen der Web-App mit dem Namen Default fest. Zum Beispiel: Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

   Wichtig:

   • Der Azure SQL-Benutzer muss Zugriff auf die Serverebene haben, der Zugriff auf Datenbankebene reicht für eine erfolgreiche Installation nicht aus.
   • Stellen Sie sicher, dass das TrustServerCertificate-Attribut in der Datenbankverbindungszeichenfolge auf True festgelegt ist.
   • Um eine Datenbankverbindungszeichenfolge für das Testautomatisierungsmodul festzulegen, führen Sie die Schritte aus, die für den Parameter -testAutomationFeatureEnabled in Parametern von Publish-Orchestrator.ps1 beschrieben sind.

4. Create an Azure AD application and service principal that can access your Orchestrator App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

Schritte für Identity Server

1. Erstellen Sie im Azure-Portal unter App Services einen neuen App-Dienst mit einem benutzerdefinierten Namen, z. B. UiPathIdentity. Achten Sie beim Erstellen der Web-App darauf, Stack .NET Core 3.1auszuwählen. Weitere Informationen finden Sie in der offiziellen Dokumentation von Microsoft.

2. Legen Sie die Datenbankverbindungszeichenfolge über Konfiguration > Verbindungszeichenfolgen der Web-App mit dem Namen DefaultConnection fest. Zum Beispiel: Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

   Wichtig:

   Stellen Sie sicher, dass das TrustServerCertificate-Attribut in der Datenbankverbindungszeichenfolge auf True festgelegt ist.

3. Navigieren Sie zu Einstellungen > Konfiguration > Registerkarte Allgemeine Einstellungen, und wählen Sie 64-Bit als Plattform aus.

4. Create an Azure AD application and service principal that can access your Identity App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

Allgemeine Schritte

1. Download the UiPathOrchestrator.zip archive to your local machine. This contains all the scripts necessary to install Orchestrator, Identity Server, and Webhooks Service. UiPath provides the UiPathOrchestrator.zip archive on request. Contact us for details.

2. Extrahieren Sie den Inhalt der ZIP-Datei in einen Ordner auf Ihrer Maschine.

   Hinweis:

   Die folgenden Schritte erfordern die Ausführung der PowerShell-Skripte. Um alle Eingabeaufforderungen zu deaktivieren, die diese Aufgaben unterbrechen, führen Sie den Befehl Get-ChildItem *.ps1 -Recurse | Unblock-File in dem in Schritt 10 ausgewählten Verzeichnis aus.

3. Run the Publish-Orchestrator.ps1 script, in PowerShell, using the parameters described here.

   Wichtig:

   • Stellen Sie vor dem Ausführen des Publish-Orchestrator.ps1-Skripts sicher, dass Sie das AzureRM PowerShell-Modul deinstalliert haben. Wir empfehlen als Alternative das Az PowerShell-Modul. Die gleichzeitige Installation von AzureRM- und Az-Modulen wird nicht unterstützt.
   • Wenn die gewünschte Az-Version nicht erkannt wird und AzureRM beim Ausführen des Skripts vorhanden ist, müssen Sie das Entfernen von AzureRM auch bei unbeaufsichtigten Installationen bestätigen.
   • Beim Aktualisieren auf Az v6.0.0, wenn eine frühere Version des Moduls verwendet wird, die folgende Meldung erscheint: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications (Version „x.x.x“ des Moduls „Az.“ wird momentan bereist verwendet. Schließen Sie die Anwendungen und versuchen Sie es erneut). Um dieses Problem zu lösen, stellen Sie sicher, dass Sie Publish-Orchestrator.ps1 in einer neuen PowerShell-Sitzung ausführen.
   • Wenn Sie von Microsoft gehostete Agenten verwenden, verhindert das Problem Publish-Orchestrator.ps1, dass Sie die richtige Az-Version ausführen. Anstatt Version 5.4.0 oder 6.0.0 zu verwenden, bleibt es bei 4.7.0. Als Workaround können Sie den Ordner C:\Modules\az_4.7.0 löschen.

4. Run the Publish-IdentityServer.ps1 script, in PowerShell, using the parameters described here.

   Wichtig:

   Make sure to complete the process by performing the steps described on the Publish to Identity Server page.

5. Run the MigrateTo-IdentityServer.ps1 script, in PowerShell, using the parameters described here.

6. Install the Webhooks Service.

7. Starten Sie die Orchestrator- und Identity-App-Dienste. Nutzen Sie Orchestrator in Ihrem Azure-Portal.

Mehrfach-Knoten-Installation

Hinweis:

Multi-node installations require the setup of the High Availability Add-on.

Um Orchestrator auf mehreren Knoten auf einem Azure-App-Dienst zu installieren, führen Sie die folgenden Schritte durch:

Orchestrator-Schritte

1. Erstellen Sie im Azure-Portal unter App Services einen neuen App-Dienst mit einem benutzerdefinierten Namen, z. B. UiPathOrchestrator. Achten Sie beim Erstellen der Web-App darauf, Stack .NET Core 3.1auszuwählen. Weitere Informationen finden Sie in der offiziellen Dokumentation von Microsoft.

2. Öffnen Sie die neu erstellte Web-App im Azure-Portal, und wählen Sie auf der Registerkarte Konfiguration Allgemeine Einstellungen aus, und nehmen Sie dann die folgenden Konfigurationsänderungen vor:

   • Setzen Sie Plattform auf 64-Bit.
   • Legen Sie Websockets auf Ein fest.

3. Legen Sie die Datenbankverbindungszeichenfolge über Konfiguration > Verbindungszeichenfolgen der Web-App mit dem Namen „Standard“ fest. Zum Beispiel: Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

   Wichtig:

   • Der Azure SQL-Benutzer muss Zugriff auf die Serverebene haben, der Zugriff auf Datenbankebene reicht für eine erfolgreiche Installation nicht aus.
   • Stellen Sie sicher, dass das TrustServerCertificate-Attribut in der Datenbankverbindungszeichenfolge auf True festgelegt ist.

4. Create an Azure AD application and service principal that can access your Orchestrator App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

5. In der Registerkarte Skalierung (App-Serviceplan) wählen Sie die Option Skalieren auf eine bestimmte Instanzenzahl und geben Sie die gewünschte Anzahl von Instanzen ein.

Schritte für Identity Server

1. Erstellen Sie im Azure-Portal unter App Services einen neuen App-Dienst mit einem benutzerdefinierten Namen, z. B. UiPathIdentity. Achten Sie beim Erstellen der Web-App darauf, Stack .NET Core 3.1auszuwählen. Weitere Informationen finden Sie in der offiziellen Dokumentation von Microsoft.

2. Legen Sie die Datenbankverbindungszeichenfolge über Konfiguration > Verbindungszeichenfolgen der Web-App mit dem Namen DefaultConnection fest. Zum Beispiel: Server=13.13.13.13;Initial Catalog=UiPath;Persist Security Info=False;User ID=dbUser;Password=pass123; MultipleActiveResultSets=False;Encrypt=True; Connection Timeout=30;TrustServerCertificate=True.

   Wichtig:

   Stellen Sie sicher, dass das TrustServerCertificate-Attribut in der Datenbankverbindungszeichenfolge auf True festgelegt ist.

3. Navigieren Sie zu Einstellungen > Konfiguration > Registerkarte Allgemeine Einstellungen, und wählen Sie 64-Bit als Plattform aus.

4. Create an Azure AD application and service principal that can access your Identity App Service and Resource Group. Optionally, ask your friendly DevOps team to provide you with an Azure Service Principal ID and Password that can access the App Service and associated Resource Group.

Allgemeine Schritte

1. Download the UiPathOrchestrator.zip archive to your local machine. This contains all the scripts necessary to install Orchestrator, Identity Server, and Webhooks Service. UiPath provides the UiPathOrchestrator.zip archive on request. Contact us for details.

2. Extrahieren Sie den Inhalt der ZIP-Datei in einen Ordner auf Ihrer Maschine.

   Hinweis:

   Die folgenden Schritte erfordern die Ausführung der PowerShell-Skripte. Um alle Eingabeaufforderungen zu deaktivieren, die diese Aufgaben unterbrechen, führen Sie den Befehl Get-ChildItem *.ps1 -Recurse | Unblock-File in dem in Schritt 11 ausgewählten Verzeichnis aus.

3. Run the Publish-Orchestrator.ps1 script, in PowerShell, using the parameters described here.

   Wichtig:

   • Stellen Sie vor dem Ausführen des Publish-Orchestrator.ps1-Skripts sicher, dass Sie das AzureRM PowerShell-Modul deinstalliert haben. Wir empfehlen als Alternative das Az PowerShell-Modul. Die gleichzeitige Installation von AzureRM- und Az-Modulen wird nicht unterstützt.
   • Wenn die gewünschte Az-Version nicht erkannt wird und AzureRM beim Ausführen des Skripts vorhanden ist, müssen Sie das Entfernen von AzureRM auch bei unbeaufsichtigten Installationen bestätigen.
   • Beim Aktualisieren auf Az v6.0.0, wenn eine frühere Version des Moduls verwendet wird, die folgende Meldung erscheint: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications (Version „x.x.x“ des Moduls „Az.“ wird momentan bereist verwendet. Schließen Sie die Anwendungen und versuchen Sie es erneut). Um dieses Problem zu lösen, stellen Sie sicher, dass Sie Publish-Orchestrator.ps1 in einer neuen PowerShell-Sitzung ausführen.
   • Wenn Sie von Microsoft gehostete Agenten verwenden, verhindert das Problem Publish-Orchestrator.ps1, dass Sie die richtige Az-Version ausführen. Anstatt Version 5.4.0 oder 6.0.0 zu verwenden, bleibt es bei 4.7.0. Als Workaround können Sie den Ordner C:\Modules\az_4.7.0 löschen.

4. Run the Publish-IdentityServer.ps1 script, in PowerShell, using the parameters described here.

   Wichtig:

   Make sure to complete the process by performing the steps described on the Publish to Identity Server page.

5. Run the MigrateTo-IdentityServer.ps1 script, in PowerShell, using the parameters described here.

6. Install the Webhooks Service.

7. Starten Sie die Orchestrator- und Identity-App-Dienste. Nutzen Sie Orchestrator in Ihrem Azure-Portal.