Abonnieren

UiPath Installation and Upgrade

Die UiPath-Installations- und Upgrade-Anleitung

Azure App Service-Installation

├ťberblick


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

­čÜž

Wichtig!

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


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

 

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, den Stack .NET Core 3.1 auszuw├Ą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 f├╝r den Parameter -testAutomationFeatureEnabled in Publish-Orchestrator.ps1 Parameters beschriebenen Schritte aus.
  • Um eine Datenbankverbindungszeichenfolge f├╝r das Modul zur Aktualisierung des Servers festzulegen, f├╝hren Sie die f├╝r den Parameter -updateServerFeatureEnabled in den Publish-Orchestrator.ps1-Parametern beschriebenen Schritte aus.
  1. Der von unseren Skripten unterst├╝tzte Azure PowerShell-Authentifizierungsmechanismus kann einer der beiden folgenden sein:
  • Through your own user identity - use the -noAzureAuthentication parameter when signing in with Azure PowerShell.
  • Through a service principal - 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, den Stack .NET Core 3.1 auszuw├Ą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.

  1. Navigieren Sie zu Einstellungen > Konfiguration > Registerkarte Allgemeine Einstellungen, und w├Ąhlen Sie 64-Bit als Plattform aus.

  2. Der von unseren Skripten unterst├╝tzte Azure PowerShell-Authentifizierungsmechanismus kann einer der beiden folgenden sein:

  • Through your own user identity - use the -noAzureAuthentication parameter when signing in with Azure PowerShell.
  • Through a service principal - 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.

Webhooks-Schritte

  1. Erstellen Sie in Ihrem Azure Portal eine neue Webanwendung mit einem benutzerdefinierten Namen, z. B.: UiPathWebhookService.

  2. W├Ąhlen Sie im Feld Ver├Âffentlichen die Option Code aus.

  3. W├Ąhlen Sie bei Laufzeitstapel die Option .NET Core 3.1 aus.

  4. ├ľffnen Sie Ihre neue Web-App, und navigieren Sie zu Einstellungen > Konfiguration.

  5. W├Ąhlen Sie auf der Registerkarte Allgemeine Einstellungen die Option 64-Bit als Plattform aus.

  6. W├Ąhlen Sie Speichern.

­čÜž

Wichtig!

Wenn Sie zuvor noch keine Azure AD-Anwendung und keinen Dienstprinzipal ├╝ber die Orchestrator-Installation in Azure erstellt haben, erstellen Sie sie jetzt. Sie m├╝ssen diese konfigurieren, um auf UiPathWebhookService und die Ressourcengruppe zugreifen zu k├Ânnen.

Schritte zum Ressourcenkatalog

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

  2. Navigieren Sie zu Einstellungen > Konfiguration > Registerkarte Allgemeine Einstellungen, und w├Ąhlen Sie 64-Bit als Plattform aus.

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

  4. Der von unseren Skripten unterst├╝tzte Azure PowerShell-Authentifizierungsmechanismus kann einer der beiden folgenden sein:

  • Through your own user identity - use the -noAzureAuthentication parameter when signing in with Azure PowerShell.
  • Through a service principal - create an Azure AD application and service principal that can access your Resource Catalog 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. Laden Sie das UiPathOrchestrator.zip-Archiv auf Ihre lokalen Maschine herunter. Es enth├Ąlt alle Skripte, die zum Installieren des Orchestrators, des Identity Servers, des Ressourcenkatalogs und des Webhooks-Diensts erforderlich sind. UiPath stellt das UiPathOrchestrator.zip-Archiv auf Anfrage bereit. Kontaktieren Sie uns f├╝r weitere Informationen.

  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 im vorherigen Schritt ausgew├Ąhlten Verzeichnis aus.

  1. F├╝hren Sie das Skript Publish-Orchestrator.ps1 in PowerShell unter Verwendung der hier beschriebenen Parameter aus. Sehen Sie sich dieses Beispiel an.

­čÜž

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.

  • Bei einem Upgrade auf Az v6.0.0 wenn bei Verwendung einer fr├╝heren Version des Moduls folgende Meldung eingeblendet: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. (ÔÇ×WARNUNG: Die Version ÔÇ×x.x.xÔÇť des Moduls ÔÇ×AzÔÇť wird aktuell 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.

  1. F├╝hren Sie das Publish-IdentityServer.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

­čÜž

Wichtig!

Stellen Sie sicher, dass Sie den Prozess abschlie├čen, indem Sie die auf der Seite Ver├Âffentlichen auf Identity Server beschriebenen Schritte ausf├╝hren.

  1. F├╝hren Sie das MigrateTo-IdentityServer.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

  2. F├╝hren Sie das Publish-ResourceCatalog.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

  3. F├╝hren Sie das MigrateTo-ResourceCatalog.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

  4. F├╝hren Sie das Publish-Webhooks.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

  5. F├╝hren Sie das MigrateTo-Webhooks.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

  6. 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, den Stack .NET Core 3.1 auszuw├Ą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.
  1. Der von unseren Skripten unterst├╝tzte Azure PowerShell-Authentifizierungsmechanismus kann einer der beiden folgenden sein:
  • Through your own user identity - use the -noAzureAuthentication parameter when signing in with Azure PowerShell.
  • Through a service principal - 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.
  1. 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, den Stack .NET Core 3.1 auszuw├Ą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.

  1. Navigieren Sie zu Einstellungen > Konfiguration > Registerkarte Allgemeine Einstellungen, und w├Ąhlen Sie 64-Bit als Plattform aus.

  2. Der von unseren Skripten unterst├╝tzte Azure PowerShell-Authentifizierungsmechanismus kann einer der beiden folgenden sein:

  • Through your own user identity - use the -noAzureAuthentication parameter when signing in with Azure PowerShell.
  • Through a service principal - 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.

Webhooks-Schritte

  1. Erstellen Sie in Ihrem Azure Portal eine neue Webanwendung mit einem benutzerdefinierten Namen, z. B.: UiPathWebhookService.

  2. W├Ąhlen Sie im Feld Ver├Âffentlichen die Option Code aus.

  3. W├Ąhlen Sie bei Laufzeitstapel die Option .NET Core 3.1 aus.

  4. ├ľffnen Sie Ihre neue Web-App, und navigieren Sie zu Einstellungen > Konfiguration.

  5. W├Ąhlen Sie auf der Registerkarte Allgemeine Einstellungen die Option 64-Bit als Plattform aus.

  6. W├Ąhlen Sie Speichern.

­čÜž

Wichtig!

Wenn Sie zuvor noch keine Azure AD-Anwendung und keinen Dienstprinzipal ├╝ber die Orchestrator-Installation in Azure erstellt haben, erstellen Sie sie jetzt. Sie m├╝ssen diese konfigurieren, um auf UiPathWebhookService und die Ressourcengruppe zugreifen zu k├Ânnen.

Schritte zum Ressourcenkatalog

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

  2. Navigieren Sie zu Einstellungen > Konfiguration > Registerkarte Allgemeine Einstellungen, und w├Ąhlen Sie 64-Bit als Plattform aus.

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

  4. Der von unseren Skripten unterst├╝tzte Azure PowerShell-Authentifizierungsmechanismus kann einer der beiden folgenden sein:

  • Through your own user identity - use the -noAzureAuthentication parameter when signing in with Azure PowerShell.
  • Through a service principal - create an Azure AD application and service principal that can access your Resource Catalog 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. Laden Sie das UiPathOrchestrator.zip-Archiv auf Ihre lokalen Maschine herunter. Es enth├Ąlt alle Skripte, die zum Installieren des Orchestrators, des Identity Servers, des Ressourcenkatalogs und des Webhooks-Diensts erforderlich sind. UiPath stellt das UiPathOrchestrator.zip-Archiv auf Anfrage bereit. Kontaktieren Sie uns f├╝r weitere Informationen.

  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 im vorherigen Schritt ausgew├Ąhlten Verzeichnis aus.

  1. F├╝hren Sie das Skript Publish-Orchestrator.ps1 in PowerShell unter Verwendung der hier beschriebenen Parameter aus. Sehen Sie sich dieses Beispiel an.

­čÜž

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.

  • Bei einem Upgrade auf Az v6.0.0 wenn bei Verwendung einer fr├╝heren Version des Moduls folgende Meldung eingeblendet: WARNING: The version 'x.x.x' of module 'Az.<Name>' is currently in use. Retry the operation after closing the applications. (ÔÇ×WARNUNG: Die Version ÔÇ×x.x.xÔÇť des Moduls ÔÇ×AzÔÇť wird aktuell 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.

  1. F├╝hren Sie das Publish-IdentityServer.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

­čÜž

Wichtig!

Stellen Sie sicher, dass Sie den Prozess abschlie├čen, indem Sie die auf der Seite Ver├Âffentlichen auf Identity Server beschriebenen Schritte ausf├╝hren.

  1. F├╝hren Sie das MigrateTo-IdentityServer.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

  2. F├╝hren Sie das Publish-ResourceCatalog.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

  3. F├╝hren Sie das MigrateTo-ResourceCatalog.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

  4. F├╝hren Sie das Publish-Webhooks.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

  5. F├╝hren Sie das MigrateTo-Webhooks.ps1-Skript in PowerShell unter Verwendung der hier beschriebenen Parameter aus.

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

Aktualisiert vor 8 Monaten



Azure App Service-Installation


Auf API-Referenzseiten sind ├änderungsvorschl├Ąge beschr├Ąnkt

Sie k├Ânnen nur ├änderungen an dem Textk├Ârperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.