Insights
2022.4
False
Bannerhintergrundbild
Insights
Letzte Aktualisierung 19. April 2024

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

Prepare the Certificate(s) to enable SSL for both machines. For more information, please click here.

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

    For more information, see Initiate instance launch 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

Open the inbound ports listed in the table below by following the instructions here:

TypPortbereichQuelleBeschreibung
Benutzerdefiniertes TCP9999Überall-IPv4Dies ist der Looker-Port.
Benutzerdefiniertes TCP19999Überall-IPv4Dies ist der Looker API-Port.
Benutzerdefiniertes TCP29999Überall-IPv4Dies 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. Go to See all images and select Red Hat Enterprise Linux 8.2 - 8.6 from the Plan. For the offline RHEL bundle, click here.


  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

To open the Inbound ports listed in the table below, follow the instructions here

ZielportbereicheNamePrioritätQuelle
9999Looker_Port310Alle
19999LookerAPI_Port320Alle
29999LookMLUpdate_Port330Alle

To configure additional settings, see Create an inbound security rule.

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>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 -isudo -i
  3. Überprüfen Sie die Datenträgergröße, indem Sie den folgenden Befehl ausführen:
    lsblk -flsblk -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/sda2lsblk /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 rootvgvgdisplay 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-varlvlvresize -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/sda2lsblk /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. Open the default inbound port 443. For instructions on how to open an inbound port in AWS, see Authorizing access to an instance. For instructions on how to open an inbound port in Azure, see NSG Quickstart Portal.
  3. Run the Install-Prerequisites.ps1 script to Enable IIS 10+, install .NET required for your version, and then restart the IIS service. Alternatively, you can manually install the prerequisites highlighted in the sub-steps below:
    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. Download and install .NET Hosting Bundle version 6.0.7+.
    4. Führen Sie in PowerShell die folgenden Befehle aus:
      net stop was /y ; net start w3svcnet 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.

For more details on how to enable Kerberos authentication on SQL Server, see Manual SPN Registration.

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 needs to have SPN entries in AD. For more information, see Register a Service Principal Name for Kerberos Connections.
    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

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:


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]
GOUSE 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]
GOUSE UiPath Insights
GO
GRANT EXECUTE ON SCHEMA::dbo TO [sql_user]
GO
    Note: To configure the default MAXDOP of your database, see Configure the max degree of parallelism Server Configuration Option.

    <details>

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

Install Orchestrator and enable the Insights feature.

  1. Navigate to Orchestrator to obtain the installation access token. For more details, see Installation key.


    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

Generate Looker files on the Insights Windows Machine then run the Deploy-Looker.ps1 script to copy Looker files to the Insights Linux Machine and then initialize Looker. Alternatively, you can manually run the commands.

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. Download LookerPreinstallationTool.exe and run the tool on the Insights Windows machine.
  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>:~/scp <path-to-Insights_Lookerfile>.zip <user@linuxhostname>:~/
    Note: Consider using Powershell 7 or higher, or Putty, as previous versions (Powershell 5.1) might experience rendering issues or a blank screen.

Looker initialisieren

  1. Öffnen Sie Powershell und führen Sie den folgenden Befehl zur Authentifizierung aus:
    ssh <username@hostname>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-keygpg --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 directoryunzip <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>cd <installation directory>
bash insights/looker-initialization.sh -k <Public Key>
    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.
    Note: You might get the following error Module yaml error: Unexpected key in data: static_context [line 9 col 3] during the installation. For more information about this bug, see Turn off strict validation of modulemd documents (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>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 has the ability to kill a SQL query after a dashboard is closed, if the query hasn't completed. This can mitigate performance issues in some scenarios. If its desired for this feature to be enabled, add the below sql permission. This is optional.
use master
go
GRANT ALTER ANY CONNECTION TO sqladminuse 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. Run the InsightsInstaller.msi installer as administrator using the command prompt or PowerShell console.
  2. Navigieren Sie zu dem Verzeichnis, in dem sich Ihr .msi-Installationsprogramm befindet. Führen Sie das Insights-Installationsprogramm mit dem folgenden Befehl aus: 
  3. msiexec /i InsightsInstaller.msimsiexec /i InsightsInstaller.msi

    Alternativ können Sie den folgenden Befehl ausführen:

    .\InsightsInstaller.msi.\InsightsInstaller.msi
  4. 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.logmsiexec -I "InsightsInstaller.msi" -L*V  c:\logs\interactive.log
  5. Akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf Weiter.


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


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


  8. 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 lang gültig und läuft danach ab. Generieren Sie ein neues, wenn ein Installationsfehler auftritt.


  9. 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.
  10. 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 - only visible TLS/SSL is checked. Choose between TLSv1_1 and TLSv1_2

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

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.

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

To check network requirements for Insights, see Network requirements.

War diese Seite hilfreich?

Support und Services
Hilfe erhalten
UiPath Academy
RPA lernen – Automatisierungskurse
UiPath-Forum
UiPath Community-Forum
UiPath Logo weiß
Vertrauen und Sicherheit
Nutzungsbedingungen
Datenschutzerklärung
Cookie-Richtlinie
© 2005-2024 UiPath. All rights reserved.