Abonnieren

UiPath Installation and Upgrade

Die UiPath-Installations- und Upgrade-Anleitung

Installation

🚧

Wichtig

Bitte beachten Sie, dass dies eine Änderung unserer HW/SW-Spezifikationen von Insights 2021.10 ist. Insights 2021.10 erfordert eine einzelne Windows-Maschine, wĂ€hrend Insights 2022.10 eine Windows-Maschine und eine Linux-Maschine mit RHEL 8.2–8.6 oder 9.0 erfordert.

Klicken Sie hier, um diesen Abschnitt zu erweitern

In 2021.10 fĂŒhrte die Insights Windows-Maschine Docker aus, das den Looker Linux-Container beherbergte. Ab Windows 2022 wird der Treiber fĂŒr die Einbettung von Linux-Containern in das Windows-Betriebssystem (lcow genannt) von Microsoft fĂŒr Unternehmensanwendungen nicht mehr unterstĂŒtzt. Infolgedessen mussten wir unsere Bereitstellungsarchitektur so Ă€ndern, dass zwei Maschinen benötigt werden – eine Windows-Maschine, auf der die UiPath Insights-Komponenten laufen, und eine Linux-Maschine, auf der der Looker-Container lĂ€uft. Durch diese Änderung ist die UnternehmensunterstĂŒtzung von Betriebssystemanbietern fĂŒr die Komponenten verfĂŒgbar, die zur AusfĂŒhrung von UiPath-Produkten benötigt werden. Die unterstĂŒtzten Versionen des Linux-Betriebssystems sind dieselben, die auch von der Automation Suite unterstĂŒtzt werden.

Überblick

📘

Bevor Sie beginnen

ÜberprĂŒfen Sie die Hardware- und Softwareanforderungen fĂŒr Insights.

Zum Installieren der eigenstĂ€ndigen Insights-Version 2022.10 mĂŒssen Sie diese Verfahren in der folgenden Reihenfolge ausfĂŒhren:

  1. Die Insights Windows- und Linux-Maschinen vorbereiten
  2. Looker auf der Insights Linux-Maschine initialisieren
  3. Insights installieren

Die Insights Windows- und die Insights Linux-Maschinen vorbereiten

  1. Bereiten Sie das/die Zertifikat(e) vor, um SSL fĂŒr beide Maschinen zu aktivieren. Weitere Informationen finden Sie hier.

📘

Hinweis

Stellen Sie sicher, dass Sie die Looker- und Insights-Zertifikate auf die Maschine importieren, auf der Sie auf Insights zugreifen möchten.

Das Zertifikat fĂŒr die Insights Linux-Maschine sollte auf der Insights Windows-Maschine installiert werden, da „LookerPreinstallationtool.exe“ das Zertifikat von der Insights Windows-Maschine auf die Insights Linux-Maschine exportiert.

  1. Konfigurieren Sie zwei Maschinen, die die Hardware- und Softwareanforderungen erfĂŒllen.
For details on preparing a Linux machine
Vorbereiten einer AWS EC2-Linux-Maschine

Schritt 1 Eine Linux-Instanz in AWS EC2 starten

  1. Starten Sie die Instanz.
  2. WĂ€hlen Sie das Red Hat Enterprise Linux 8 Image aus (Wir unterstĂŒtzen die Versionen 8.2–8.6 oder 9.0)
  3. WĂ€hlen Sie einen Instanztyp aus und konfigurieren Sie Instanzdetails.
  4. FĂŒgen Sie Ihrer Instanz Speicher hinzu und Ă€ndern Sie die GrĂ¶ĂŸe in 32.
  5. ÜberprĂŒfen und Starten der Instanz
    Weitere Informationen finden Sie unter Starten der Instanz in AWS.

Schritt 2 Eingehende Ports öffnen

Öffnen Sie die in der folgenden Tabelle aufgefĂŒhrten eingehenden Ports, indem Sie die Anweisungen hier befolgen:

TypePort rangeSourceDescription
Custom TCP9999Anywhere-IPv4This is the Looker port.
Custom TCP19999Anywhere-IPv4This is the Looker API port.
Custom TCP29999Anywhere-IPv4This is the LookML update port.
  1. Klicken Sie auf Regeln speichern.
Vorbereiten einer Microsoft Azure Linux-Umgebung

Schritt 1 Erstellen einer Maschine mit Linux

  1. Navigieren Sie zu Dienste > Virtuelle Maschinen > Erstellen.
  2. Go to See all images and select Red Hat Enterprise Linux 8.2 - 8.6, or 9.0 from the Plan. For the offline RHEL bundle, click here for RHEL 8 and here for RHEL 9.
1464
  1. WĂ€hlen Sie unter Administratorkonto zwischen Öffentlichem SSH-SchlĂŒssel oder Kennwort aus. Wenn Sie einen öffentlichen SSH-SchlĂŒssel verwenden, können Sie ihn generieren und dann Vorhandenen SchlĂŒssel verwenden, der in Azure gespeichert ist auswĂ€hlen.

Schritt 2 Eingehende Ports fĂŒr die erstellte Maschine öffnen

Öffnen Sie die in der folgenden Tabelle aufgefĂŒhrten eingehenden Ports, indem Sie die Anweisungen hier befolgen

Destination port rangesNamePrioritySource
9999Looker_Port310Any
19999LookerAPI_Port320Any
29999LookMLUpdate_Port330Any

Informationen zum Konfigurieren zusÀtzlicher Einstellungen finden Sie unter Erstellen einer eingehenden Sicherheitsregel.

Schritt 3 Die Speicherzuweisung fĂŒr Azure Linux-Maschinen erhöhen

Die Standard-Speicherzuweisung in einer Azure Linux-Maschine betrĂ€gt 8 GB und kann beim Abrufen von Bildern, beim Erstellen von Sicherungen oder bei der Verwendung mehrerer Dashboards zu Fehlern wegen unzureichendem Speicherplatz fĂŒhren.

Stellen Sie bei Air-Gap-Umgebungen sicher, dass die Volumes /home und /var ĂŒber genĂŒgend Speicherplatz verfĂŒgen (z. B. mindestens 4 GB fĂŒr /home bzw. 10 GB fĂŒr /var) (siehe Hardware-Anforderungen fĂŒr Insights Linux-Maschinen). Bevor Sie das Bereitstellungsskript ausfĂŒhren, befolgen Sie die folgenden Schritte, um die Speicherplatzzuweisung zu erhöhen und Fehler zu vermeiden, wenn der Speicherplatz nicht ausreicht:

  1. Open a SSH client in the Linux machine by running the command below:
ssh azureuser@<your-hostname>

Dabei muss <your-hostname> angepasst werden, um den Hostnamen Ihrer Maschine widerzuspiegeln.

  1. Change to root user by running the command below:
sudo -i
  1. ÜberprĂŒfen Sie die DatentrĂ€gergrĂ¶ĂŸe, indem Sie den folgenden Befehl ausfĂŒhren:
lsblk -f

Sie finden den /var-Mountpoint unter dem Namen sda2 > rootvg-varlv.

1084
  1. ÜberprĂŒfen Sie die GrĂ¶ĂŸe von /dev/sda2, indem Sie den folgenden Befehl ausfĂŒhren:
lsblk /dev/sda2

Dabei wird /dev/sda2 aus Schritt 3 abgerufen. Sie sehen nun die GrĂ¶ĂŸe fĂŒr /var, die 8 G betrĂ€gt.

829
  1. Next, check the available space by running the command below:
vgdisplay rootvg
940

Sie sehen, dass der Wert fĂŒr Freie PE/GrĂ¶ĂŸe etwa 40 GiB betrĂ€gt.

  1. VergrĂ¶ĂŸern Sie die GrĂ¶ĂŸe von rootvg-varlv, indem Sie den folgenden Befehl ausfĂŒhren:
    Sie können ihn auf +10G oder einen anderen Wert Ă€ndern, der kleiner als die verfĂŒgbaren 40GB ist (die GrĂ¶ĂŸe des freien Speichers, die Sie in Schritt 5 sehen).
lvresize -r -L +10G /dev/mapper/rootvg-varlv

Note: for air-gapped installations please run the same command on /home

1339
lsblk /dev/sda2

Jetzt haben Sie genĂŒgend Speicherplatz fĂŒr Docker (in /var/lib/docker).

746

📘

Hinweis

FĂŒr Air-Gap-Umgebungen fĂŒhren Sie bitte die Befehle aus den Schritten 1–6 aus, um die GrĂ¶ĂŸe von „/home“ zu erhöhen, damit genĂŒgend Platz fĂŒr das Offline-Image und das Paket-Bundle vorhanden ist.

Klicken Sie hier, um Einzelheiten zur Vorbereitung einer Windows-Maschine fĂŒr den Insights-Dienst zu erfahren.
  1. Konfigurieren Sie eine Windows-Maschine, die die Hardware- und Softwareanforderungen erfĂŒllt.

  2. Öffnen Sie den standardmĂ€ĂŸigen eingehenden Port 443. Anweisungen zum Öffnen eines eingehenden Ports in AWS finden Sie unter Autorisieren des Zugriffs auf eine Instanz. Anweisungen zum Öffnen eines eingehenden Ports in Azure finden Sie unter NSG-Schnellstartportal.

  3. FĂŒhren Sie das Skript Install-Prerequisites.ps1 aus, um IIS 10+ zu aktivieren, installieren Sie .NET 6.0.5+ und starten Sie dann den IIS-Dienst neu. Alternativ können Sie die in den Schritten 3.1 bis 3.4 hervorgehobenen Voraussetzungen manuell installieren:

   3.1 Öffnen Sie eine RDP-Sitzung auf der erstellten Maschine, um die Voraussetzungen zu installieren.

   3.2 Aktivieren Sie IIS 10+.

Klicken Sie hier fĂŒr weitere Informationen zum Aktivieren von IIS 10+.

Um IIS 10+ zu aktivieren, wechseln Sie zu Systemsteuerung > Programme > Windows-Funktionen aktivieren oder deaktivieren. Dadurch wird der Assistent zum HinzufĂŒgen von Rollen und Funktionen geöffnet. Folgen Sie den Anweisungen des Assistenten, um den Webserver (IIS) zu aktivieren.

1011

Dadurch wird der „Assistent zum HinzufĂŒgen von Rollen und Funktionen“ geöffnet. Folgen Sie den Anweisungen des Assistenten, um den Webserver (IIS) zu aktivieren.

236

Aktivieren Sie die folgenden „Web Server (IIS)“-Module:

  • Webserver
    • Allgemeine HTTP-Funktionen
      • Standarddokument
      • Durchsuchen von Verzeichnissen
      • HTTP-Fehler
      • Statischer Inhalt
    • Zustand und Diagnose
      • HTPP-Protokollierung
    • Leistung
      • Statischer Inhalt
    • Sicherheit
      • Filtern von Anfragen
  • Verwaltungstools
    • IIS-Verwaltungskonsole

 

   3.3 Laden Sie die .NET Hosting Bundle-Version 6.0.5+ herunter und installieren Sie sie.

   3.4 FĂŒhren Sie in PowerShell die folgenden Befehle aus:

net stop was /y ; net start w3svc
  1. Aktivieren Sie HTTPS auf Ihrer Maschine unter Verwendung eines SSL-Zertifikats. Bereiten Sie Ihr Zertifikat mit einem Ă€hnlichen Verfahren vor, wie es fĂŒr den Orchestrator vorgesehen ist. Siehe Verwendung eines Zertifikats fĂŒr das HTTPS-Protokoll.

  2. Stellen Sie beim Angeben eines Hostnamens fĂŒr Insights sicher, dass der gewĂŒnschte Hostname in Ihrem DNS aufgelöst werden kann.

  3. Stellen Sie sicher, dass Sie TLS 1.1 oder 1.2 verwenden.

🚧

Wichtig

‱ Stellen Sie sicher, dass Sie die Rolle „db_owner“ auswĂ€hlen, da dies erforderlich ist, wenn Sie die Rolle des Datenbankbesitzers wĂ€hrend der Konfiguration der Insights SQL-Maschine hinzufĂŒgen.

‱ Die Orchestrator- und die Insights-Version mĂŒssen ĂŒbereinstimmen. Wenn Sie z. B. die Orchestrator-Version 2022.10.0 verwenden, mĂŒssen Sie die gleiche Version von Insights ausfĂŒhren, um eine ordnungsgemĂ€ĂŸe Kommunikation zwischen den beiden UiPath-Produkten herzustellen.

‱ Die Insights-Datenbank muss auf dieselbe Datenbank verweisen, die erstellt wurde, als Sie Insights wĂ€hrend der Installation des Orchestrators aktiviert haben.

‱ Wenn Sie ĂŒber eine große Datenbank verfĂŒgen, sollten Sie Indizes mithilfe von SQL-Skripten manuell hinzufĂŒgen. Die Orchestrator-Installation kann wĂ€hrend der Migration der Insights-Datenbank fehlschlagen, wenn sie einen großen Datensatz indizieren muss (siehe Datenbankmigration schlĂ€gt wĂ€hrend der Installation fehl).

SQL-Server-Konfiguration

Bevor Sie Insights installieren, mĂŒssen Sie die Insights SQL Server-Instanz konfigurieren, die Sie verwenden möchten.

📘

Hinweis:

Bei der Insights SQL-Datenbank wird die Groß-/Kleinschreibung nicht berĂŒcksichtigt („InsightsDB“ = „insightsdb“). Wenn sie wĂ€hrend der Insights-Installation erstellt wird, gilt das fĂŒr sie automatisch. Wenn Sie Ihre eigene Insights-Datenbank erstellen, legen Sie die Sortierreihenfolge auf Latin1_General_CI_AS fest, um sie manuell ohne BerĂŒcksichtigung der Groß-/Kleinschreibung zu konfigurieren.

Stellen Sie sicher, dass Sie die folgenden Informationen zur Hand haben, da diese fĂŒr die AusfĂŒhrung des Insights-Installationsprogramms benötigt werden:

  • Den Namen der SQL Server-Maschine.
  • Den Namen der Instanz, wenn es nicht die Standardinstanz ist.

Stellen Sie außerdem Folgendes sicher:

  • Der SQL Server-Port ist in der Firewall der SQL Server-Maschine offen. Sie können „SKIP_FIREWALL_RULE_CREATION=true“ verwenden, um die Erstellung von Firewallregeln zu ĂŒberspringen.
  • Das TCP-Protokoll im SQL Server-Konfigurationsmanager muss aktiviert sein.
  • Der SQL Server-Dienst ĂŒberwacht einen festen Port, nicht einen dynamisch zugeordneten.

Konfigurieren Sie eine der folgenden Authentifizierungsmethoden, mit denen Insights eine Verbindung mit der SQL Server-Datenbank herstellen kann:

Integrierte Windows-Authentifizierung (zum Erweitern klicken)

FĂŒr diese Option ist eine neue Anmeldung fĂŒr den SQL Server als Dienstkonto erforderlich. Das Dienstkonto muss ein DomĂ€nenbenutzer sein, dessen Kennwort niemals ablĂ€uft. Looker, der zugrunde liegende Motor, der von Insights verwendet wird, lĂ€uft in einem Linux-Container.

🚧

Wichtig

Um die Windows-Authentifizierung zu aktivieren, muss SQL Server die Authentifizierung ĂŒber das Kerberos-Protokoll unterstĂŒtzen.

Weitere Informationen zum Aktivieren der Kerberos-Authentifizierung auf SQL Server finden Sie unter Manuelle SPN-Registrierung.

Hinweise zum Konfigurieren der integrierten Windows-Authentifizierung

  • Bevor Sie die Kerberos-Authentifizierung konfigurieren, stellen Sie sicher, dass der Insights Server auf Ihr Active Directory (AD) und SQL Server zugreifen kann. Sie können Ihren IT-Administrator dazu fragen.
  • SQL Server muss Ihrer AD-DomĂ€ne hinzugefĂŒgt werden.
  • Die Insights-Maschine muss sich im selben Netzwerk wie die AD-DomĂ€ne und SQL Server befinden.
  • Das DNS muss so konfiguriert werden, dass die Insights-Maschine die DomĂ€nennamen sowohl fĂŒr AD als auch fĂŒr SQL Server auflösen kann.
  • Der AD-Benutzer sollte vorhanden sein und Zugriff auf SQL Server- und DB-Berechtigungen haben, wie im Abschnitt Berechtigungen definiert. DomĂ€ne, Benutzername und Kennwort fĂŒr diesen Benutzer mĂŒssen wĂ€hrend der Insights-Installation angegeben werden. Beachten Sie, dass beim Benutzernamen die Groß-/Kleinschreibung beachtet wird und dass er auch als sAMAccountName des Benutzers dient.
    Öffnen Sie cmd als Administrator und fĂŒhren Sie set user aus, um USERDNSDOMAIN und USERNAME.
  • SQL Server muss SPN-EintrĂ€ge in AD haben. Weitere Informationen finden Sie unter Registrieren eines Dienstprinzipalnamens fĂŒr Kerberos-Verbindungen.

🚧

Wichtig

Es ist wichtig, dass die Insights-Maschine die DomĂ€nennamen sowohl von der AD-DomĂ€ne als auch von SQL Server auflösen kann. Sie können dies ĂŒberprĂŒfen, indem Sie nslookup <your_AD_domain_name> und nslookup <your_SQL_server_domain_name> auf der Hostmaschine ausfĂŒhren.

Erstellen einer neuen Anmeldung in SQL Server Management Studio

  1. Navigieren Sie im Objekt-Explorer zu Sicherheit > Anmeldungen.
  2. Klicken Sie mit der rechten Maustaste auf den Ordner Anmeldungen und wÀhlen Sie Neue Anmeldung aus.
  3. WĂ€hlen Sie die Option Windows-Authentifizierung aus. Das Fenster wird entsprechend aktualisiert.
704
  1. Geben Sie im Feld Anmeldename die BenutzerdomÀne ein, die Sie als Dienstkonto verwenden möchten.
  2. WĂ€hlen Sie in der Liste Standardsprache die Option Deutsch aus.

🚧

Wichtig!

Stellen Sie sicher, dass die Standardsprache auf English festgelegt ist. Ist dies nicht der Fall, kann die Website nicht gestartet werden und die Ereignisanzeige auf der Maschine, auf dem Insights installiert ist, zeigt die folgende Fehlermeldung an: The conversion of a varchar data type to a datetime data type resulted in an out-of range value.

  1. Klicken Sie auf OK, um die Konfiguration zu speichern.
    Wenn das Dienstkonto bereits erstellt und dem Abschnitt Sicherheit > Anmeldungen von SQL Server hinzugefĂŒgt wurde, ĂŒberprĂŒfen Sie, ob die Standardsprache dieses SQL-Kontos auf Englisch festgelegt ist. Ist dies nicht der Fall, nehmen Sie die erforderlichen Anpassungen vor.
SQL Server-Authentifizierung (zum Erweitern klicken)

FĂŒr diese Authentifizierungsmethode benötigen Sie einen SQL Server-Benutzer.
ErwĂ€gen Sie aus SicherheitsgrĂŒnden die Verwendung eines Nicht-SA-Kontos (d. h. kein Systemadministrator).

Erstellen eines neuen SQL-Benutzers in SQL Server Management Studio

  1. Navigieren Sie im Objekt-Explorer zu Sicherheit > Anmeldungen.
  2. Machen Sie einen Rechtsklick auf den Ordner Anmeldungen (Logins) und wÀhlen Sie Neue Anmeldung (Neue Anmeldung) aus. Das Fenster Anmeldung - Neu (Login - New) wird angezeigt.
  3. WĂ€hlen Sie die Option SQL Server-Authentifizierung aus. Das Fenster wird entsprechend aktualisiert.
700
  1. FĂŒllen Sie die Felder Anmeldename, Kennwort und Kennwort bestĂ€tigen entsprechend aus.
  2. Stellen Sie sicher, dass die Optionen Kennwortablauf erzwingen und Der Benutzer muss das Kennwort bei der nÀchsten Anmeldung Àndern nicht ausgewÀhlt sind.

🚧

Wichtig!

Stellen Sie sicher, dass die Standardsprache auf English festgelegt ist. Wenn dies nicht der Fall ist, kann die Website nicht starten und die Ereignisanzeige auf der Maschine, auf dem Insights installiert ist, zeigt die folgende Fehlermeldung an: „The conversion of a varchar data type to a datetime data type resulted in an out of range value“ („Die Konvertierung eines varchar-Datentyps in einen datetime-Datentyp fĂŒhrte zu einem Wert, der außerhalb des zulĂ€ssigen Bereichs liegt“).

Wenn das SQL-Server-Konto bereits erstellt und dem Abschnitt Sicherheit > Anmeldungen hinzugefĂŒgt wurde, ĂŒberprĂŒfen Sie bitte, ob die Standardsprache auf Englisch eingestellt ist. Wenn das nicht der Fall ist, nehmen Sie bitte die erforderlichen Anpassungen vor.

Berechtigungen

Regardless of the type of user (domain or SQL) you want to connect to SQL Server, please note that you need to assign it the dbcreator Server Role BEFORE installing Insights, as the database is created during this installation process.

If security restrictions do not allow the use of the dbcreator Server Role in the service account, create the empty database in SQL Server.

Der Windows-Installer verbindet sich mit dem SQL-Server, um die Existenz der Datenbank zu ĂŒberprĂŒfen.

Nach der Erstellung der Datenbank mĂŒssen Sie den Benutzer angeben, der sich mit der Orchestrator SQL-Datenbank mit der Benutzerzuordnungsrolle db_owner verbindet, wie im folgenden Screenshot gezeigt:

704

Falls SicherheitsbeschrĂ€nkungen Ihnen die Verwendung der Rolle fĂŒr die Benutzerzuordnung db_owner mit der UiPath-Anmeldung nicht erlauben, gewĂ€hren Sie Folgendes:

  • db_datareader
  • db_datawriter
  • db_ddladmin
  • EXECUTE-Berechtigung fĂŒr dbo-Schema
705

Die Berechtigung EXECUTE muss wie folgt mithilfe des SQL-Befehls GRANT EXECUTE gewÀhrt werden .

  • falls die integrierte Windows-Authentifizierung verwendet wird:
USE UiPath Insights
GO
GRANT EXECUTE ON SCHEMA::dbo TO [domain\user]
GO
  • Wenn die SQL-Server-Authentifizierung verwendet wird:
USE UiPath Insights
GO
GRANT EXECUTE ON SCHEMA::dbo TO [sql_user]
GO

📘

Empfehlungen

Informationen zum Konfigurieren des Standard-MAXDOP Ihrer Datenbank finden Sie unter Konfigurieren des maximalen Grads der ParallelitÀtsoption der Serverkonfiguration.

 

Installieren Sie den Orchestrator und aktivieren Sie die Insights-Funktion.

Dieser Abschnitt ist erforderlich, um die Insights-Datenbank vorzubereiten. Bevor Sie mit der Installation von Insights fortfahren können, mĂŒssen Sie die Insights-Funktion im Orchestrator basierend auf Ihrem Szenario aktivieren.

For versions above 2021.10 Orchestrator and Insights fresh installation or Add Insights to existing Orchestrator installation: See Step 3 in Orchestrator Single-Node Installation).

For versions before 2021.10, when you Upgrade Insights: Disable the Insights feature in Orchestrator, then re-enable it.

Orchestrator installed as app service in Azure: If you run Orchestrator as an app service in Azure, you can run a script to publish to Orchestrator and enable Insights through the -insightsFeatureEnabled parameter.

📘

Informationen

‱ Die Orchestrator- und die Insights-Version mĂŒssen ĂŒbereinstimmen. Wenn Sie z. B. die Orchestrator-Version 2022.10.0 verwenden, mĂŒssen Sie die gleiche Version von Insights ausfĂŒhren, um eine ordnungsgemĂ€ĂŸe Kommunikation zwischen den beiden UiPath-Produkten herzustellen.

‱ Die Insights-Datenbank muss auf dieselbe Datenbank verweisen, die erstellt wurde, als Sie Insights wĂ€hrend der Installation des Orchestrators aktiviert haben.

‱ Wenn Sie ĂŒber eine große Datenbank verfĂŒgen, sollten Sie Indizes mithilfe von SQL-Skripten manuell hinzufĂŒgen. Die Orchestrator-Installation kann wĂ€hrend der Migration der Insights-Datenbank fehlschlagen, wenn sie einen großen Datensatz indizieren muss.

Looker auf der Insights Linux-Maschine initialisieren

Folgen Sie dem Verfahren, um Looker auf der Insights Linux-Maschine zu initialisieren.

Alternatively, you can use the deployment script (click to expand section)
  1. FĂŒhren Sie das Tool LookerPreinstallationTool.exe aus, um eine ZIP-Datei fĂŒr Looker zu generieren. Dadurch werden Looker-Dateien auf der Insights Windows-Maschine generiert.
  2. Kopieren Sie die Looker-Dateien auf die Insights Linux-Maschine, um Looker bereitzustellen, oder verwenden Sie das Skript Deploy-Looker.ps1, um extrahierte Dateien auf die Insights Linux-Maschine zu kopieren und dann Looker zu initialisieren.

🚧

Wichtig

Das Skript Deploy-Looker.ps1 ist kompatibel mit Version 2022.10.0 von LookerPreinstallationTool.exe.


Weitere Informationen finden Sie unter Skript fĂŒr die automatisierte Bereitstellung.

Generieren Sie Looker-Dateien auf der Insights Windows-Maschine.

The SMTP settings are configured automatically starting with the 2022.10 version

  1. Laden Sie LookerPreinstallationTool.exe herunter und fĂŒhren Sie das Tool auf der Insights Windows-Maschine aus.
  2. FĂŒhren Sie die ersten Schritte aus, um die ZIP-Datei zu generieren.
  3. WĂ€hlen Sie die Sprache aus.

🚧

Wenn Sie Chinesisch/Koreanisch/Japanisch auswÀhlen

Wenn die Konsole Chinesisch/Koreanisch/Japanisch nicht korrekt anzeigen kann, Àndern Sie bitte die Schriftart Ihrer Konsole. Bei Powershell können Sie mit der rechten Maustaste auf die Titelleiste klicken, Eigenschaften auswÀhlen und eine TrueType-Schriftart auswÀhlen (z. B. MS Gothic, MS Mincho oder NSimSun).

  1. Validieren und exportieren Sie das generierte Zertifikat. Stellen Sie sicher, dass der Hostname vollstÀndig qualifiziert ist und vom Zertifikat abgedeckt wird.

📘

Hinweis:

The certificate needs to be placed in both Personal and Trusted Root Certification Authorities folders.

823
  1. (Optional) Konfigurieren Sie die Windows-Authentifizierung, wenn Sie sie verwenden.

📘

Hinweis

Bei einem Upgrade von 21.10 ĂŒbertrĂ€gt das Installationsprogramm aufgrund der ArchitekturĂ€nderung auf zwei VMs in 22.10 nicht automatisch alle Dashboards, Alarme und ZeitplĂ€ne von 21.10 auf 22.10. Um den Verlust von Dashboards, Warnungen und ZeitplĂ€nen zu vermeiden, folgen Sie bitte Schritt 6, um diese Inhalte auf die neue Linux Maschine zu migrieren. Dies gilt nicht fĂŒr Upgrades von 22.4. Bitte beachten Sie: Wenn dieser Schritt wĂ€hrend des Upgrades nicht ausgefĂŒhrt wird, werden alle Dashboards, ZeitplĂ€ne und Warnungen gelöscht und stehen nicht mehr fĂŒr den Export auf die neue Looker Maschine zur VerfĂŒgung, sobald die Installation ĂŒber InsightsInstaller.msi erfolgreich abgeschlossen wurde.

  1. (Optional) Exportieren Sie Daten, um Ihre vorherigen Dashboards, Warnungen und ZeitplĂ€ne in der neuen Version weiter zu verwenden. Das Tool kann erkennen, ob ein looker_container auf der Maschine ausgefĂŒhrt wird. Wenn Sie Ihre Daten verschieben, wird das aktuelle Looker-Kennwort, das in $Env:ProgramData\UiPath Insights gespeichert ist, exportiert und auf der neuen Insights Linux-Maschine verwendet.
  2. (Optional) VerschlĂŒsseln Sie die ZIP-Datei, um das Looker-Geheimnis zu schĂŒtzen. Wenn Sie Schritt 4 abgeschlossen haben, sollten Sie die ZIP-Datei mit einem Kennwort schĂŒtzen.
823
  1. Geben Sie den Pfad ein, in dem Sie die ZIP-Datei erstellen möchten. Andernfalls wird sie unter dem Standardpfad erstellt, der in der Konsole angezeigt wird.

Kopieren Sie die Looker-Dateien auf die Insights Linux-Maschine.

Kopieren Sie die ZIP-Datei auf die Insights Linux-Maschine.

  1. Authentifizieren Sie sich bei Ihrer Insights Linux-Maschine.
  2. Öffnen Sie eine SCP-Sitzung und geben Sie einen Befehl ein, der den ZIP-Dateipfad sowie den Benutzernamen und das Kennwort enthĂ€lt, die als Ihre Insights Linux-Maschinen-Anmeldeinformationen verwendet werden. FĂŒhren Sie dazu den folgenden Befehl aus:
scp <path-to-Insights_Lookerfile>.zip <user@linuxhostname>:~/

📘

Hinweis

ErwĂ€gen Sie die Verwendung von Powershell 7 oder höher oder Putty, da bei frĂŒheren Versionen (Powershell 5.1) Probleme beim Rendern oder ein leerer Bildschirm auftreten können.

Looker initialisieren

  1. Öffnen Sie Powershell und fĂŒhren Sie den folgenden Befehl zur Authentifizierung aus:
ssh <username@hostname>

📘

Hinweis

Nachdem Sie sich bei der Insights Linux-Maschine angemeldet haben, stellen Sie sicher, dass die lokale Systemzeit korrekt ist. Andernfalls könnte Looker in eine unendliche Aktualisierungsschleife geraten.

  1. Generieren Sie den GPG-SchlĂŒssel mit dem folgenden Befehl:
gpg --generate-key

Geben Sie den Benutzernamen und die E-Mail-Adresse ein, wenn Sie dazu aufgefordert werden, und legen Sie ein Kennwort fest. Ein öffentlicher SchlĂŒssel wird generiert. Stellen Sie sicher, dass Sie den öffentlichen SchlĂŒssel speichern, da Sie ihn spĂ€ter verwenden werden.

Der öffentliche SchlĂŒssel wird verwendet, um das Looker-Kennwort und -Zertifikat zu speichern, die wĂ€hrend der Looker-Initialisierung generiert wurden. Sie können diesen öffentlichen SchlĂŒssel mit dem Parameter -k ĂŒbergeben, wenn Sie looker-initialization.sh ausfĂŒhren.

1531
  1. Entpacken Sie die Looker-Dateien, indem Sie den folgenden Befehl ausfĂŒhren:
unzip <Insights_Lookerfiles_timestamp.zip>
  1. FĂŒhren Sie das Looker-Initialisierungsskript aus, indem Sie den folgenden Befehl ausfĂŒhren:
bash insights/looker-initialization.sh -k <Public Key>

Dabei wird <Public Key> ĂŒber den Befehl gpg --generate-key generiert.
:information-source: Möglicherweise werden Sie aufgefordert, Ihr Kennwort einzugeben, um das Looker-Kennwort zu speichern.

📘

Hinweis

WĂ€hrend der Installation wird möglicherweise der folgende Fehler Module yaml error: Unexpected key in data: static_context [line 9 col 3] angezeigt. Weitere Informationen zu diesem Fehler finden Sie unter Deaktivieren der strikten Validierung von „modulemd“-Dokumenten (RhBug:2004853).

Dies hat keine Auswirkungen auf die Insights-Installation.

  1. Beenden Sie Powershell und laden Sie looker.json herunter, indem Sie den folgenden Befehl ausfĂŒhren
scp <username@hostname>:~/insights/looker.json <path-to-save-json>

Ersetzen Sie <username@hostname> durch Ihren Benutzernamen und Linux-Hostnamen.

Sie können cat /home/user/insights/looker.json verwenden, um den Inhalt zu kopieren und eine Datei auf der Insights Windows-Maschine mit dem Namen looker.json unter $HOME/_insights zu erstellen und dann den kopierten Inhalt einfĂŒgen.

After initialization, a file called 'looker.key' will be created in the $HOME/_insights folder. Please do not delete this file, it will be needed for future upgrades.

Insights-Installation

📘

Hinweis:

  • Wenn Sie von einer Version vor 2021.10 aktualisieren, werden Benutzer mit Insights-Berechtigungen nicht automatisch zu Ihrer neuen Installation migriert. Sie können optional ĂŒber das Benutzermigrationstool migriert werden. Wenn Sie das Tool bereits beim Upgrade auf 2021.10 verwendet haben, mĂŒssen Sie das Benutzermigrationstool nicht erneut ausfĂŒhren.

  • Das Installationsprogramm verwendet die Windows-Anzeigesprache, wenn Windows in einer der folgenden Sprachen ist: en-US, fr-FR, de-DE, es-ES, es-MX, ja-JP, ko-KR, pt-BR, pt-PT, ru-RU, tr-TR, zh-CN. Wenn die Windows-Anzeigesprache nicht eine dieser Sprachen ist, erscheint das Installationsprogramm in Englisch.
  1. FĂŒhren Sie das InsightsInstaller.msi-Installationsprogramm als Administrator mithilfe der Eingabeaufforderung oder der PowerShell-Konsole aus.

  2. Navigieren Sie zu dem Verzeichnis, in dem sich Ihr .msi-Installationsprogramm befindet.

  3. FĂŒhren Sie das Insights-Installationsprogramm mit dem folgenden Befehl aus:

msiexec /i InsightsInstaller.msi

Alternativ können Sie den folgenden Befehl ausfĂŒhren:

.\InsightsInstaller.msi
  1. Das Insights-Installationsprogramm sollte nun die Voraussetzungen ĂŒberprĂŒfen. Wenn alle Voraussetzungen erfĂŒllt sind, wird der Einrichtungsassistent fĂŒr UiPath Insights angezeigt, der Sie durch die Insights-Installation und -Konfiguration fĂŒhrt.
612

📘

Hinweis:

Wenn die Installation fehlgeschlagen ist oder Sie das Installationsprotokoll ĂŒberprĂŒfen möchten, können Sie zum Ordner %temp% oder %temp%/<sessionID> gehen und das neueste MSI{random chars}.LOG ĂŒberprĂŒfen. Die Dateien in diesem Verzeichnis sind nicht permanent und können zwischen Sitzungen verloren gehen. Sie können den folgenden Befehl eingeben, um die Installation mit dem vordefinierten Protokollspeicherort auszufĂŒhren.

msiexec -I "InsightsInstaller.msi" -L*V  c:\logs\interactive.log
  1. Akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf Weiter.
494
  1. Das Looker-Initialisierungsskript auf Ihrem Linux-Host gibt eine JSON-Datei mit der Konfiguration der Instanz aus. Geben Sie den vollstÀndigen Dateipfad des Speicherorts ein, an dem Sie diese Datei auf diesem Windows-Host gespeichert haben.
495
  1. Geben Sie die Insights Window-Maschineneinstellungen wie folgt ein:
  • Insights Server-URL – Der Hostname oder die URL der Insights Windows-Maschine.
  • Port - the port you want to use to enable the communication with the Insights Windows machine. The default port number is set to 443.
  • Zertifikat – der Antragsteller oder der Fingerabdruck des SSL-Zertifikats zum Sichern von Verbindungen mit dem Orchestrator.
495
  1. Konfigurieren Sie die Orchestrator-Einstellungen wie folgt:
  • Orchestrator-URL – die URL des Orchestrators.
  • Installation Token - enter the Installation Access Token you generated on Identity Server's Installation Access Token page by logging in as the host tenant. For more details, see Host administration portals.
  • Separater Identity Server – Wenn Sie ĂŒber einen separaten IdentitĂ€tsserver verfĂŒgen, aktivieren Sie diese Option.

📘

Hinweis:

Sie benötigen fĂŒr jede Installation ein neues Zugriffstoken. Das Token ist 2 Stunden gĂŒltig und lĂ€uft danach ab. Generieren Sie ein neues, wenn ein Installationsfehler auftritt.

495
  1. Konfigurieren Sie die Insights-Datenbankeinstellungen wie folgt:
  • Servername – Der Name der SQL Server-Maschine, auf der sich die Insights-Datenbank befindet, einschließlich des standardmĂ€ĂŸigen Listener-Ports fĂŒr den SQL Server (1433). Beispiel: SQLServer,1433.
  • Database Name - the name of the Insights database.
  • Authentifizierungstyp – WĂ€hlen Sie eine der folgenden Authentifizierungsmethoden aus:
    You must use the fully qualified domain name for the database (e.g., mysever.my.domain instead of myserver). Preferably the SQL Server must join the AD domain directly.
    • Windows Authentication - if selected, Insights connects to the database, creates tables, and runs the IIS Application Pool using the specified credentials. The installer validates the connection using the Windows credentials you are currently logged in with. If you select this option, you must specify the domain, username, and password.
    • SQL Authentication - if selected, the connection is made using SQL authentication. If using this option, the Username and Password fields become editable, and you must provide the SQL username and password used to connect to the database.
495

🚧

Wichtig

Aus SicherheitsgrĂŒnden unterstĂŒtzen wir keine Authentifizierung fĂŒr SMTP. Sie mĂŒssen die Authentifizierungsdetails in Schritt 10 angeben.

  1. Konfigurieren Sie die E-Mail-Einstellungen wie folgt:
  • E-Mail-Dienst konfigurieren (SMTP) – setzen Sie hier einen Haken, wenn der E-Mail-Dienst konfiguriert werden soll.
    • Server – Der SMTP-Hostname.
    • Von – die E-Mail-Adresse, von der E-Mail-Nachrichten gesendet werden sollen.
    • Benutzername – Der Benutzername des SMTP-Servers, wenn er eine Authentifizierung erfordert. Wenn Sie z. B. Gmail verwenden, fĂŒllen Sie dieses Feld mit der E-Mail-Adresse aus, die zum Senden von Nachrichten verwendet werden soll.
      ErwĂ€gen Sie die Verwendung von SMTP mit Authentifizierung, da SMTP ohne Authentifizierung in Zukunft möglicherweise nicht mehr unterstĂŒtzt wird.
    • Kennwort – Das Kennwort des E-Mail-Kontos.
    • Port – der SMTP-Port.
    • TLS/SSL – zum (De-)aktivieren von TLS/SSL.
      * TLS/SSL-Version – Nur sichtbar, wenn TLS/SSL aktiviert ist. WĂ€hlen Sie zwischen TLSv1_1 und TLSv1_2 aus.
495

📘

Hinweis:

Nachdem dieser Schritt abgeschlossen ist, wird eine E-Mail mit den Angaben des SMTP-Servers gesendet. So stellen Sie sicher, dass die SMTP-Details korrekt sind. Wenn wĂ€hrend dieses Schritts ein Fehler auftritt, ĂŒberprĂŒfen Sie bitte die Protokolldatei und navigieren Sie zur Seite Fehlerbehebung.

  1. Klicken Sie auf Weiter, um die Installation zu starten. Nachdem der Installationsvorgang abgeschlossen wurde, klicken Sie auf Schließen, um das Installationsprogramm zu beenden.
495

 

Schritte nach der Installation

Tabellen migrieren

FĂŒhren Sie die folgenden Schritte aus, um Auftragstabellen zu migrieren.

📘

Hinweis:

This step is required when upgrading to 2022.10. For more information on this, see Supporting Long Running Workflows.

  1. FĂŒllen Sie JobOrganizationUnitId aus.
with CTE as (
select qie.[JobOrgUnitFullyQualifiedName] as qOrgName, qie.[JobOrganizationUnitId] as qOrgId, j.[OrganizationUnitId] as jOrgId, j.[OrgUnitFullyQualifiedName] as jOrgName
from [dbo].[QueueItemEvents] qie 
inner join [dbo].[QueueItems] qi on qie.[QueueItemId] = qi.[Id]
inner join [dbo].[Jobs] j on qi.[ExecutorJobId] = j.[Id]
where j.[OrganizationUnitId] != qie.[JobOrganizationUnitId] or (qie.[JobOrganizationUnitId] is null and j.[OrganizationUnitId] is not null))
update CTE
set qOrgName = jOrgName, qOrgId = jOrgId;
  1. Erstellen Sie einen Workflowindex mit langer AusfĂŒhrungszeit, wenn er nicht vorhanden ist.
    Hinweis: Wenn dieses Skript zuvor verwendet wurde, muss es kein zweites Mal ausgefĂŒhrt werden.
IF NOT EXISTS(SELECT * FROM sys.indexes WHERE Name = 'IX_JobEvents_JobId_TenantId' and OBJECT_NAME(object_id) = 'JobEvents')
CREATE NONCLUSTERED INDEX [IX_JobEvents_JobId_TenantId] ON [dbo].[JobEvents]
(
    [JobId] ASC,
    [TenantId] ASC
)
  1. KĂŒrzen Sie gelesene Tabellen, um neue Felder abzugleichen.
truncate table [read].[QueueItemEvents];
truncate table [read].[QueueItems];
truncate table [read].[Jobs];
truncate table [read].[JobEvents];
delete [dbo].[IngestionMarkers] where [IngestionEventType] in (9002, 9001);

Stellen Sie die ordnungsgemĂ€ĂŸe Lizenzierung sicher

You need to have at least one license code, which will include Orchestrator, Insights, and one Robot, all of them at the Host level, attached in Orchestrator (see Manage Host Licensing).

Aktivierung von Mandanten

After installing Insights, you must then enable Insights for your desired tenant(s) from the Orchestrator host portal. For more details, see Enabling or disabling features.

ÜberprĂŒfen der Insights-Dienste

  1. Öffnen Sie einen unterstĂŒtzten Webbrowser
  2. Navigieren Sie zu https://hostname:443/Insights, um zu bestÀtigen, dass Insights erfolgreich installiert wurde.

Modifizieren von Insights

Behalten Sie die ursprĂŒngliche Installationsdatei bei, falls Sie Änderungen oder Deinstallationen ausfĂŒhren möchten.

For more information, see Modifying Insights configurations.

Ähnliche Artikel

Vor etwa einem Monat aktualisiert


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.