- Versionshinweise
- Erste Schritte
- Zugriff und Berechtigungen
- Installation und Upgrade
- Interaktion mit Insights
- Export historischer Daten
- Protokolle
- Leistung und Skalierbarkeit
Installation
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 2024.10 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.
/tmp
-Ordner installiert werden, da dies nach einem Neustart zu Problemen führen kann. Die Installation muss in einem persistenten Verzeichnis erfolgen.
Die Hauptversionen von Orchestrator und Insights müssen übereinstimmen. Wenn Sie z. B. den Orchestrator auf 2024.10.X aktualisiert haben, müssen Sie eine 2024.10.X-Version von Insights ausführen, um eine ordnungsgemäße Kommunikation zwischen den beiden UiPath-Produkten herzustellen.
Zum Installieren der eigenständigen Insights-Version 2024.10 müssen Sie diese Verfahren in der folgenden Reihenfolge ausführen:
Bereiten Sie das/die Zertifikat(e) vor, um SSL für beide Maschinen zu aktivieren. Weitere Informationen finden Sie hier.
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.
Konfigurieren Sie zwei Maschinen, die die Hardware- und Softwareanforderungen erfüllen.
- 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
- Starten Sie die Instanz.
- Wählen Sie das Red Hat Enterprise Linux 8 Image ausHinweis: 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.
- Wählen Sie einen Instanztyp aus und konfigurieren Sie Instanzdetails.
- Fügen Sie Ihrer Instanz Speicher hinzu und ändern Sie die Größe in
32
. - Überprüfen und Starten der Instanz
Weitere Informationen finden Sie unter Starten der Instanz in AWS.
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
- Navigieren Sie zu Virtuelle Maschinen > Erstellen. >
- 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.
- 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.
/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:
- 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. - Change to root user by running the command below:
sudo -i
sudo -i - Überprüfen Sie die Datenträgergröße, indem Sie den folgenden Befehl ausführen:
lsblk -f
lsblk -fSie finden den/var
-Mountpoint unter dem Namensda2
>rootvg-varlv
. - Überprüfen Sie die Größe von
/dev/sda2
, indem Sie den folgenden Befehl ausführen:lsblk /dev/sda2
lsblk /dev/sda2Dabei wird/dev/sda2
aus Schritt 3 abgerufen. Sie sehen nun die Größe für/var
, die 8 G beträgt. - Next, check the available space by running the command below:
vgdisplay rootvg
vgdisplay rootvgSie sehen, dass der Wert für Freie PE/Größe etwa 40 GiB beträgt.
- 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ügbaren40GB
ist (die Größe des freien Speichers, die Sie in Schritt 5 sehen).lvresize -r -L +10G /dev/mapper/rootvg-varlv
lvresize -r -L +10G /dev/mapper/rootvg-varlvHinweis: Führen Sie für Air-Gap-Installationen denselben Befehl für/home
aus. - Prüfen Sie, ob die Größenänderung erfolgreich war, indem Sie den folgenden Befehl ausführen:
lsblk /dev/sda2
lsblk /dev/sda2
/var/lib/docker
).
/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
- Konfigurieren Sie eine Windows-Maschine, die die Hardware- und Softwareanforderungen erfüllt.
- Ö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. - 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:
- Öffnen Sie eine RDP-Sitzung auf der erstellten Maschine, um die Voraussetzungen zu installieren.
- 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
- Allgemeine HTTP-Funktionen
- Verwaltungstools
- IIS-Verwaltungskonsole
- Webserver
- Laden Sie .NET Hosting Bundle Version 6.0.7+ herunter und installieren Sie es.
- Führen Sie in PowerShell die folgenden Befehle aus:
net stop was /y ; net start w3svc
net stop was /y ; net start w3svc
- 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.
- Stellen Sie beim Angeben eines Hostnamens für Insights sicher, dass der gewünschte Hostname in Ihrem DNS aufgelöst werden kann.
- Stellen Sie sicher, dass Sie TLS 1.1 oder 1.2 verwenden.
Bevor Sie Insights installieren, müssen Sie die Insights SQL Server-Instanz konfigurieren, die Sie verwenden möchten.
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.
- 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.
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 Sieset user
aus, umUSERDNSDOMAIN
undUSERNAME
. - 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>
undnslookup <your_SQL_server_domain_name>
auf der Hostmaschine ausführen.
Erstellen einer neuen Anmeldung in SQL Server Management Studio
- Navigieren Sie im Objekt-Explorer zu Sicherheit > Anmeldungen.
- Klicken Sie mit der rechten Maustaste auf den Ordner Anmeldungen und wählen Sie Neue Anmeldung aus.
- Wählen Sie die Option Windows-Authentifizierung aus. Das Fenster wird entsprechend aktualisiert.
- Geben Sie im Feld Anmeldename die Benutzerdomäne ein, die Sie als Dienstkonto verwenden möchten.
- 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
. - 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.
Erstellen eines neuen SQL-Benutzers in SQL Server Management Studio
- Navigieren Sie im Objekt-Explorer zu Sicherheit > Anmeldungen.
- 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.
- Wählen Sie die Option SQL Server-Authentifizierung aus. Das Fenster wird entsprechend aktualisiert.
- Füllen Sie die Felder Anmeldename, Kennwort und Kennwort bestätigen entsprechend aus.
- 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.
db_owner
verbindet, wie im folgenden Screenshot gezeigt:
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
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
USE UiPath Insights GO GRANT EXECUTE ON SCHEMA::dbo TO [sql_user] GOHinweis: Informationen zum Konfigurieren des Standard-MAXDOP Ihrer Datenbank finden Sie unter Konfigurieren des maximalen Grads der Parallelitätsoption der Serverkonfiguration.
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.
-insightsFeatureEnabled
zu aktivieren.
- 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.
Folgen Sie dem Verfahren, um Looker auf der Insights Linux-Maschine zu initialisieren.
Alternativ können Sie das Bereitstellungsskript verwenden:
- 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.
- 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 vonLookerPreinstallationTool.exe
.Weitere Informationen finden Sie unter Skript für die automatisierte Bereitstellung.
- 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.
- Führen Sie die ersten Schritte aus, um die ZIP-Datei zu generieren.
- 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).
- 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.
- (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.
- (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. - (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.
- 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 ZIP-Datei auf die Insights Linux-Maschine.
- Authentifizieren Sie sich bei Ihrer Insights Linux-Maschine.
- Ö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>:~/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.
- Ö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. - Generieren Sie den GPG-Schlüssel mit dem folgenden Befehl:
gpg --generate-key
gpg --generate-keyHinweis: 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 Sielooker-initialization.sh
ausführen.
- Entpacken Sie die Looker-Dateien, indem Sie den folgenden Befehl ausführen:
unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directory
unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directoryDas 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.
- 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>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 Befehlgpg --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 FehlerModule 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.
- 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önnencat /home/user/insights/looker.json
verwenden, um den Inhalt zu kopieren und eine Datei auf der Insights Windows-Maschine mit dem Namenlooker.json
unter dem Bereitstellungsverzeichnis zu erstellen und dann den kopierten Inhalt einfügen.
$HOME/_insights
erstellt. Löschen Sie diese Datei nicht, da sie für zukünftige Upgrades benötigt wird.
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.
use master
go
GRANT ALTER ANY CONNECTION TO sqladmin
use master
go
GRANT ALTER ANY CONNECTION TO sqladmin
- 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.
-
Laden Sie
InsightsInstaller.msi
aus dem Customer Portal herunter und wählen Sie Ihre Version aus. - Führen Sie das Installationsprogramm als Administrator mithilfe der Eingabeaufforderung oder der PowerShell-Konsole aus.
- Navigieren Sie zu dem Verzeichnis, in dem sich Ihr
.msi
-Installationsprogramm befindet. - Führen Sie das Insights-Installationsprogramm mit dem folgenden Befehl aus:
msiexec /i InsightsInstaller.msi
msiexec /i InsightsInstaller.msiAlternativ können Sie den folgenden Befehl ausführen:
.\InsightsInstaller.msi
.\InsightsInstaller.msi - 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 neuesteMSI{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
msiexec -I "InsightsInstaller.msi" -L*V c:\logs\interactive.log - Akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf Weiter.
- 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.
- 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
443
festgelegt. - Zertifikat – der Antragsteller oder der Fingerabdruck des SSL-Zertifikats zum Sichern von Verbindungen mit dem Orchestrator.
- 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.
- 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 BeispielSQLServer,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
stattmyserver
). 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.
- 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 (
- 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.
- E-Mail-Dienst konfigurieren (SMTP) – setzen Sie hier einen Haken, wenn der E-Mail-Dienst konfiguriert werden soll.
- Klicken Sie auf Weiter, um die Installation zu starten. Nachdem der Installationsvorgang abgeschlossen wurde, klicken Sie auf Schließen, um das Installationsprogramm zu beenden.
Führen Sie die folgenden Schritte aus, um Auftragstabellen zu migrieren.
- 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;
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; - 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 )
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 ) - 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);
truncate table [read].[QueueItemEvents]; truncate table [read].[QueueItems]; truncate table [read].[Jobs]; truncate table [read].[JobEvents]; delete [dbo].[IngestionMarkers] where [IngestionEventType] in (9002, 9001);
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).
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.
- Öffnen Sie einen unterstützten Webbrowser
- Navigieren Sie zu
https://hostname:443/Insights
, um zu bestätigen, dass Insights erfolgreich installiert wurde.
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.
Aktivieren Sie Insights mit einem einzelnen Knoten in einem vorhandenen Orchestrator mit mehreren Knoten
- Aktivieren Sie UiPath Orchestrator auf einem primären Knoten und generieren Sie eine Parameterdatei. Weitere Informationen finden Sie unter Hinzufügen von Knoten zu einem Orchestrator mit mehreren Knoten .
- Führen Sie das Orchestrator-Installationsprogramm (UiPathOrchestrator.msi) mit dem folgenden Befehl auf den sekundären Knoten aus:
UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json /Q
UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json /Q - Stellen Sie die Konsistenz über alle Knoten hinweg sicher, indem Sie die UiPath.Orchestrator.dll-Datei ersetzen. Konfigurationsdatei auf sekundären Knoten mit der Version vom primären Knoten. Diese Datei befindet sich unter
C:\Program Files (x86)\UiPath\Orchestrator
. Es wird empfohlen, vor dem Ersetzen eine Sicherung zu erstellen. - Vergewissern Sie sich, dass die Datei UiPath.Orchestrator.dll. Konfigurationsdatei ist nach dem Ersetzen auf allen Knoten identisch.
- Überblick
- Die Insights Windows- und die Insights Linux-Maschinen vorbereiten
- Schritt 1
- Schritt 2
- SQL-Server-Konfiguration
- Installieren Sie den Orchestrator und aktivieren Sie die Insights-Funktion.
- Looker auf der Insights Linux-Maschine initialisieren
- Generieren Sie Looker-Dateien auf der Insights Windows-Maschine.
- Kopieren Sie die Looker-Dateien auf die Insights Linux-Maschine.
- Looker initialisieren
- Insights-Installation
- Schritte nach der Installation
- Tabellen migrieren
- Stellen Sie die ordnungsgemäße Lizenzierung sicher
- Aktivierung von Mandanten
- Überprüfen der Insights-Dienste
- Modifizieren von Insights
- Aktivieren Sie Insights mit einem einzelnen Knoten in einem vorhandenen Orchestrator mit mehreren Knoten
- Ähnliche Artikel