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

Überblick

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

Stellen Sie sicher, dass ip_forward aktiviert ist.

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

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 2022.4.X aktualisiert haben, müssen Sie eine 2022.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 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 (Wir unterstützen die Versionen 8.2–8.6)
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 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 über mindestens 10 GB freien Speicherplatz verfügen. 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

   
   

   

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

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 das für Ihre Version erforderliche.NET 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 .
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, die von Insights verwendete Analyseplattform, wird in einem Linux-Container ausgeführt.

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.

  <details>

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

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

1. Navigieren Sie zum Orchestrator, um das Installationszugriffstoken abzurufen. Weitere Informationen finden Sie unter Installationsschlüssel.
   
   

   

   
   
   Hinweis:

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

Generieren Sie Looker-Dateien auf der Insights-Windows-Maschine, und führen Sie dann das Skript Deploy-Looker.ps1 aus, um Looker-Dateien auf die Insights-Linux-Maschine zu kopieren, und initialisieren Sie dann Looker. Alternativ können Sie die Befehle manuell ausführen.

Wichtig: Das Skript Deploy-Looker.ps1 ist kompatibel mit Version 2022.4.2 von LookerPreinstallationTool.exe.

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

Führen Sie das Tool LookerPreinstallationTool.exe aus, um eine ZIP-Datei für Looker zu generieren.

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 und validieren Sie die SMTP-Einstellungen.
6. (Optional) Konfigurieren Sie die Windows-Authentifizierung, wenn Sie sie verwenden.
   Hinweis: Wenn Sie von 21.10 aktualisieren, können Sie Ihre aktuellen Dashboards, Ansichten und Einstellungen in Schritt 7 exportieren und diese Informationen auf die neue Linux-Maschine migrieren.
7. (Optional) Exportieren Sie Daten, um Ihre vorherigen Dashboards, Ansichten und App-Einstellungen in dieser neuen Umgebung weiterhin 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 _insights/LookerSecret gespeichert ist, exportiert und auf der neuen Insights Linux-Maschine verwendet.
8. (Optional) Verschlüsseln Sie die ZIP-Datei, um das Looker-Geheimnis zu schützen. Wenn Sie Schritt 7 abgeschlossen haben, sollten Sie die ZIP-Datei mit einem Kennwort schützen.
   
   

   

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

   Hinweis: Der GPG-Schlüssel wird ab dem Release von April 2023 (23.10.3, 23.4.6 usw.) nicht mehr in allen Installationsversionen benötigt.

   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 InightsInstaller.msi aus dem Kundenportal 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. Führen Sie das Insights-Installationsprogramm mit dem folgenden Befehl aus:

4. 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. Dieses Verzeichnis ist nicht persistent. 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.
    • Datenbankname – der Name der Datenbank.
    • Authentifizierungstyp – Wählen Sie eine der folgenden Authentifizierungsmethoden aus:
      Wichtig: 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.
        Wichtig: 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

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

Mandanteneinrichtung

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.

Hinweis: Es gibt Szenarien, in denen die Orchestrator-Tabelle „dbo.tenants“ die Spalten „Schlüssel“ und „kontoID“ in Großbuchstaben enthält. Dies ist in der Regel nur bei älteren Versionen von Orchestrator (Orchestrator 18.X oder niedriger) der Fall.

1. Überprüfen Sie die Protokolle unter %programdata%/UiPath Insights/Provisioning
2. Es sollte ein Fehler auftreten, wenn der OrchestratorTenantJob fehlschlägt.
3. Melden Sie sich mit einem SQL-Client bei der Orchestrator-DB an.
4. Überprüfen Sie die Tabelle dbo.Tenants.
5. Überprüfen Sie, ob die Spalten „Schlüssel“ und „KontoID“ alle großgeschrieben werden.
6. Wenn ja, wird das Problem behoben, wenn Sie sie in Kleinbuchstaben schreiben.
7. Wenn es einen Mandanten mit Kleinbuchstaben gibt, versuchen Sie, diesen Mandanten einfach zu aktivieren, und überprüfen Sie, ob der Fehler weiterhin auftritt.
8. Um das Problem zu beheben, ändern Sie die Groß-/Kleinschreibung der Felder (achten Sie darauf, die DB zuvor zu sichern). Beachten Sie auch die TASTEN, die bereits in Kleinbuchstaben geschrieben sind).
   • UPDATE [UiPath].[dbo].[Tenants]
   • set [key] = LOWER([key]), [AccountId] = LOWER([AccountId])
9. Führen Sie Folgendes aus, um die Änderung rückgängig zu machen:
   • UPDATE [UiPath].[dbo].[Tenants]
   • set [key] = UPPER([key]), [AccountId] = UPPER([AccountId])
   • WHERE [key] NOT IN ('xx-xx-xx-xx', 'xx-xx-xx-xx');
10. Möglicherweise ist ein IIS-Reset erforderlich (oder nur der Anwendungspool wird bereitgestellt). Der Bereitstellungsdienst versucht, die Instanz alle 10 Minuten bereitzustellen. Wenn dies nicht der Fall ist, warten Sie einfach höchstens 10 Minuten.
11. Wenn das Problem weiterhin auftritt, erstellen Sie ein Ticket bei UiPath und fügen Sie Folgendes bei
    • Screenshot der Tabelle „dbo.tenants“.
    • Die oben genannten Bereitstellungsprotokolle.

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

Bereitstellung der Automation Suite

Informationen zum Überprüfen der Netzwerkanforderungen für Insights finden Sie unter Netzwerkanforderungen.

Ähnliche Artikel

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