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 2023.4 eine Windows-Maschine und eine Linux-Maschine mit RHEL erfordert.

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.

Installationen auf nicht unterstützten Versionen von RHEL werden blockiert, und Sie müssen auf eine unterstützte Version aktualisieren. Unter Betriebssystem finden Sie die unterstützten Versionen.

Wichtig: Insights sollte nicht in einem /tmp -Ordner installiert werden, da dies nach einem Neustart zu Problemen führen kann. Die Installation muss in einem persistenten Verzeichnis erfolgen.

Hinweis:

Die Hauptversionen von Orchestrator und Insights müssen übereinstimmen. Wenn Sie z. B. den Orchestrator auf 2023.4.X aktualisiert haben, müssen Sie eine 2023.4.X-Version von Insights ausführen, um eine ordnungsgemäße Kommunikation zwischen den beiden UiPath-Produkten herzustellen.

Überblick

Hinweis: Überprüfen Sie die Hardware- und Softwareanforderungen für Insights.

Für HTTPS ist ein SSL-Zertifikat erforderlich.

Stellen Sie sicher, dass ip_forward aktiviert ist.

Zum Installieren der eigenständigen Insights-Version 2023.4 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

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

Sowohl die Windows-Maschine als auch die Linux-Maschine können HTTPS-Anforderungen verarbeiten. Daher verwenden beide ein Zertifikat für die HTTPS-Verbindungen. Stellen Sie sicher, dass Sie ein gültiges Zertifikat für den Linux-Server und ein gültiges Zertifikat für die Windows-Maschine haben.

Schritt 2

Konfigurieren Sie zwei Maschinen, die die Hardware- und Softwareanforderungen erfüllen.

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 Hauptversionen von Orchestrator und Insights müssen übereinstimmen. Wenn Sie z. B. den Orchestrator auf 2023.4.X aktualisiert haben, müssen Sie eine 2023.4.X-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).

Vorbereiten einer Linux-Maschine

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
   Hinweis: Wir unterstützen die Versionen 8.2, 8.4 und 8.6. Die Unterstützung für 8.8, 9.1 und 9.2 ist seit dem August-Patch verfügbar und sollte für alle Versionen nach (23.4.2+, 22.10.5+, usw.
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.

Hinweis:

Das Skript verwendet Sudo für die Initialisierung, und wenn der Linux-Host dzdo anstelle von Sudo verwendet, verwendet das Skript auch dzdo.

Schritt 2 Eingehende Ports öffnen

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

Typ	Portbereich	Quelle	Beschreibung
Benutzerdefiniertes TCP	9999	Überall-IPv4	Dies ist der Looker-Port.
Benutzerdefiniertes TCP	19999	Überall-IPv4	Dies ist der Looker API-Port.
Benutzerdefiniertes TCP	29999	Überall-IPv4	Dies ist der LookML-Aktualisierungsport.

Vorbereiten einer Microsoft Azure Linux-Umgebung

Schritt 1 Erstellen einer Maschine mit Linux

1. Navigieren Sie zu Dienste > Virtuelle Maschinen > Erstellen.
2. Gehen Sie zu Alle Bilder anzeigen und wählen Sie Red Hat Enterprise Linux 8.2–8.6 oder 9.0 aus dem Plan aus. Für das Offline-RHEL-Paket klicken Sie hier.
   
   

   

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

Zielportbereiche	Name	Priorität	Quelle
9999	Looker_Port	310	Alle
19999	LookerAPI_Port	320	Alle
29999	LookMLUpdate_Port	330	Alle

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.

Wichtig: Bei Air-Gap-Umgebungen wird geprüft, ob genügend freier Speicherplatz vorhanden ist. Stellen Sie jedoch sicher, dass /var -Volumes mindestens 10 GB freien Speicherplatz haben (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.
2. Change to root user by running the command below:

   sudo -i

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

   
4. Ü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.

   
5. Next, check the available space by running the command below:

   vgdisplay rootvg

   
   

   

   
   

   Sie sehen, dass der Wert für Freie PE/Größe etwa 40 GiB beträgt.

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

   Hinweis: Führen Sie für Air-Gap-Installationen denselben Befehl für /homeaus.
   
   

   

   
   
7. Prüfen Sie, ob die Größenänderung erfolgreich war, indem Sie den folgenden Befehl ausführen:

   lsblk /dev/sda2

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

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.

Vorbereiten einer Windows-Maschine für das Hosten des Insights-Diensts

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 folgenden Schritten hervorgehobenen Voraussetzungen manuell installieren:
   1. Öffnen Sie eine RDP-Sitzung auf der erstellten Maschine, um die Voraussetzungen zu installieren.
   2. Aktivieren Sie 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.

      
      

      

      
      
      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.

      
      

      

      
      

      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. Laden Sie .NET Hosting Bundle Version 6.0.7+ herunter und installieren Sie es.
   4. Führen Sie in PowerShell die folgenden Befehle aus:

      net stop was /y ; net start w3svc

4. 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.
5. Stellen Sie beim Angeben eines Hostnamens für Insights sicher, dass der gewünschte Hostname in Ihrem DNS aufgelöst werden kann.
6. Stellen Sie sicher, dass Sie TLS 1.1 oder 1.2 verwenden.

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
• SQL Server-Authentifizierung

Integrierte Windows-Authentifizierung

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

   

   
   
4. Geben Sie im Feld Anmeldename die Benutzerdomäne ein, die Sie als Dienstkonto verwenden möchten.
5. 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.
6. 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

Für diese Authentifizierungsmethode benötigen Sie einen SQL Server-Benutzer.

Wichtig: Erwägen Sie aus Sicherheitsgründen die Verwendung eines Nicht-SA-Kontos (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.
   
   

   

   
   
4. Füllen Sie die Felder Anmeldename, Kennwort und Kennwort bestätigen entsprechend aus.
5. 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

Ungeachtet des Benutzertyps (Domäne oder SQL), den Sie mit SQL Server verbinden möchten, beachten Sie bitte, dass Sie ihm die Serverrolle dbcreator zuweisen müssen, BEVOR Sie Insights installieren, da die Datenbank während dieses Installationsprozesses erstellt wird.

Wenn Sicherheitsbeschränkungen die Verwendung von der Serverrolle dbcreator im Dienstekonto nicht erlauben, erstellen Sie die leere Datenbank im 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:

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
  
  

  

  
  

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

  Hinweis: 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.

Für Versionen ab 2021.10 Orchestrator- und Insights-Neuinstallation oder Hinzufügen von Insights zu einer bestehenden Orchestrator-Installation: Siehe Schritt 3 in der Orchestrator-Installation auf einem einzelnen Knoten).

Orchestrator installiert als App-Dienst in Azure: Wenn Sie den Orchestrator als App-Dienst in Azure ausführen, können Sie ein Skript ausführen, um den Orchestrator zu veröffentlichen und Insights über den Parameter -insightsFeatureEnabled zu aktivieren.

Hinweis:

• Die Orchestrator- und die Insights-Versionen müssen übereinstimmen. Wenn Sie z. B. die Orchestrator-Version 2023.4.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.

Alternativ können Sie das Bereitstellungsskript verwenden:

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 2023.4.0 von LookerPreinstallationTool.exe.

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

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

Hinweis: Die SMTP-Einstellungen werden ab Version 2023.4 automatisch konfiguriert.

1. Laden Sie LookerPreinstallationTool.exe herunter und führen Sie das Tool auf der Insights Windows-Maschine aus.
   Hinweis:

   Die Toolversion muss mit der genauen gleichen Version von Orchestrator und Insights übereinstimmen. Um die erforderliche Version des LookerVorinstallationsTools herunterzuladen, überprüfen Sie die Customer Portal > Produktdownload-Seite oder fragen Sie das Support-Team.

2. Führen Sie die ersten Schritte aus, um die ZIP-Datei zu generieren.
3. Wählen Sie die Sprache aus.
   Wichting: 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).
4. Validieren und exportieren Sie das generierte Zertifikat. Stellen Sie sicher, dass der Hostname vollständig qualifiziert ist und vom Zertifikat abgedeckt wird.
   Hinweis: Das Zertifikat muss in den Ordnern „ Persönliche “ und „ Vertrauenswürdige Stammzertifizierungsstellen “ abgelegt werden.
   
   

   

   
   
5. (Optional) Konfigurieren Sie die Windows-Authentifizierung, wenn Sie sie verwenden.
   Hinweis: Bei einem Upgrade von 2021.10 überträgt das Installationsprogramm aufgrund überträgt das Installationsprogramm aufgrund der Architekturänderung auf zwei VMs in 2023.4 nicht automatisch alle Dashboards, Warnungen und Zeitpläne nicht automatisch von 2021.10 auf 2023.4. 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 2022.4. Beachten Sie, dass wenn dieser Schritt während des Upgrades nicht ausgeführt wird, alle Dashboards, Zeitpläne und Warnungen gelöscht werden und nicht mehr für den Export auf die neue Looker-Maschine zur Verfügung stehen, sobald die Installation über InsightsInstaller.msi erfolgreich abgeschlossen wurde.
6. (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.
7. (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.
   
   

   

   
   
8. 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.
2. 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.

   
   

   

   
   
3. Entpacken Sie die Looker-Dateien, indem Sie den folgenden Befehl ausführen:

   unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directory

   Das Installationsverzeichnis für Insights ist das Verzeichnis, von dem aus das Skript ausgeführt wird. Vermeiden Sie also das Entpacken der Datei in Ihrem Stammverzeichnis. Das Linux-Standardverzeichnis wäre /opt, es kann jedoch an einem von Ihnen gewählten Speicherort installiert werden.

4. Führen Sie das Looker-Initialisierungsskript aus, indem Sie den folgenden Befehl ausführen:

   cd <installation directory>
   bash insights/looker-initialization.sh -k <Public Key>

   Hinweis: -k <public key> wird ab dem Release von April 2023 (23.10.3, 23.4.6 usw.) nicht mehr in allen Installationsversionen benötigt.
   Dabei wird <Public Key> über den Befehl gpg --generate-key generiert.
   Hinweis: Möglicherweise werden Sie aufgefordert, Ihr Kennwort einzugeben, um das Looker-Kennwort zu speichern.
   Hinweis: Das Skript verwendet Sudo für die Initialisierung. Wenn der Linux-Host dzdo anstelle von Sudo verwendet, verwendet das Skript auch dzdo.
   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.

5. 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 dem Bereitstellungsverzeichnis zu erstellen und dann den kopierten Inhalt einfügen.

Wichtig: Nach der Initialisierung wird eine Datei mit dem Namen „looker.key“ im Ordner $HOME/_insights erstellt. Löschen Sie diese Datei nicht, da sie für zukünftige Upgrades benötigt wird.

Hinweis:

Sie können einen Looker-Benutzer erstellen, den Besitzer des Bereitstellungsordners in den neuen Looker-Benutzer ändern und die Berechtigung für den Bereitstellungsordner auf 755 festlegen. Alle Dateien im Ordner haben das Attribut 644.

Hinweis:

Looker kann eine SQL-Abfrage beenden, nachdem ein Dashboard geschlossen wurde, wenn die Abfrage nicht abgeschlossen wurde. Dies kann Leistungsprobleme in einigen Szenarien verringern. Wenn diese Funktion aktiviert werden soll, fügen Sie die folgende SQL-Berechtigung hinzu. Dies ist optional.

use master
go
GRANT ALTER ANY CONNECTION TO sqladmin

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. Laden Sie InsightsInstaller.msi aus dem Customer Portal herunter und wählen Sie Ihre Version aus.
2. Führen Sie das Installationsprogramm als Administrator mithilfe der Eingabeaufforderung oder der PowerShell-Konsole aus.
3. Navigieren Sie zu dem Verzeichnis, in dem sich Ihr .msi-Installationsprogramm befindet.
4. 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

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

   

   
   
   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

6. Akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf Weiter.
   
   

   

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

   

   
   
8. Geben Sie die Insights Window-Maschineneinstellungen wie folgt ein:
   • Insights Server-URL – Der Hostname oder die URL der Insights Windows-Maschine.
   • Port - Der Port, den Sie verwenden möchten, um die Kommunikation mit der Insights Windows-Maschine zu aktivieren. Die Standardportnummer ist auf 443festgelegt.
   • Zertifikat – der Antragsteller oder der Fingerabdruck des SSL-Zertifikats zum Sichern von Verbindungen mit dem Orchestrator.
     
     

     

     
     
9. Konfigurieren Sie die Orchestrator-Einstellungen wie folgt:
   • Orchestrator-URL – die URL des Orchestrators.
   • Installationstoken – Geben Sie das Zugriffstoken für die Installation ein, das Sie auf der Seite Zugriffstoken für die Installation von Identity Server generiert haben, indem Sie sich als Hostmandant anmelden. Weitere Informationen finden Sie unter Portal der Hostverwaltung.
   • 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 lang gültig und läuft danach ab. Generieren Sie ein neues, wenn ein Installationsfehler auftritt.
     
     

     

     
     
10. 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). Zum Beispiel SQLServer,1433.
    • Datenbankname - der Name der Datenbank.
    • Authentifizierungstyp – Wählen Sie eine der folgenden Authentifizierungsmethoden aus:
      Sie müssen den vollqualifizierten Domänennamen für die Datenbank verwenden (z. B. mysever.my.domain statt myserver). Vorzugsweise muss der SQL Server der AD-Domäne direkt beitreten.
      • Windows-Authentifizierung: Wenn diese Option ausgewählt ist, stellt Insights anhand der angegebenen Anmeldeinformationen eine Verbindung mit der Datenbank her, erstellt Tabellen und führt den IIS-Anwendungspool aus. Das Installationsprogramm überprüft die Verbindung mithilfe der Windows-Anmeldeinformationen, mit denen Sie in dem jeweiligen Moment sind. Wenn Sie diese Option auswählen, müssen Sie die Domäne, den Benutzernamen und das Kennwort angeben.
      • SQL-Authentifizierung : Wenn diese Option ausgewählt ist, wird die Verbindung mithilfe der SQL-Authentifizierung hergestellt. Wenn Sie diese Option verwenden, können die Felder für Benutzername und Kennwort bearbeitet werden. Hier müssen Sie den SQL-Benutzernamen und das Kennwort angeben, die zum Herstellen einer Verbindung mit der Datenbank verwendet werden.
        
        

        

        
        
        Wichtig: Es wird keine Authentifizierung für SMTP in Insights 2022.4, 2022.10 und 2023.4 unterstützt.
11. 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

        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 die Protokolldatei und wechseln Sie zur Seite Fehlerbehebung.
12. Klicken Sie auf Weiter, um die Installation zu starten. Nachdem der Installationsvorgang abgeschlossen wurde, klicken Sie auf Schließen, um das Installationsprogramm zu beenden.
    
    

    

    
    

Schritte nach der Installation

Tabellen migrieren

Hinweis: Dieser Schritt ist nur erforderlich, wenn Sie große Tabellen haben und während des Upgrades Timeouts auftreten.

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

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;

2. 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
   )

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

Sie benötigen mindestens einen Lizenzcode, der den Orchestrator, Insights und einen Roboter umfasst, die alle auf Host-Ebene im Orchestrator angeschlossen sind (siehe Verwalten der Hostlizenzierung).

Aktivierung von Mandanten

Nach der Installation von Insights müssen Sie es im Orchestrator-Hostportal für den/die gewünschten Mandanten aktivieren. Weitere Informationen finden Sie unter Aktivieren oder Deaktivieren von Funktionen.

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

Weitere Informationen finden Sie unter Ändern der Insights-Konfigurationen.

Ähnliche Artikel

• Installation in einer Airgapped-Umgebung
• Aktualisieren von Insights
• Fehlersuche und ‑behebung