- Versionshinweise
- Erste Schritte
- Installation und Upgrade
- Zugriff und Berechtigungen
- Interaktion mit Insights
- Fehlersuche und ‑behebung
Insights
Installation
- Stellen Sie sicher, dass Sie die Hardware- und Softwareanforderungen für Insights erfüllen.
- Aktivieren Sie IIS 10+.
Um IIS 10+ zu aktivieren, wechseln Sie zur Systemsteuerung > Programme > Windows-Features aktivieren oder deaktivieren > IIS.
Aktivieren Sie die folgenden „Web Server (IIS)“-Module:- Webserver
- Allgemeine HTTP-Funktionen
- Standarddokument
- Durchsuchen von Verzeichnissen
- HTTP-Fehler
- Standarddokument
- Statischer Inhalt
- Zustand und Diagnose
- HTTP-Protokollierung
- Leistung
- Statischer Inhalt
- Sicherheit
- Filtern von Anfragen
- Allgemeine HTTP-Funktionen
- Verwaltungstools
- IIS-Verwaltungskonsole
- Webserver
- Laden Sie .NET Hosting Bundle Version 3.1.17+ herunter und installieren Sie es.
- Laden Sie das .NET-Hosting Bundle herunter.
- Führen Sie in der Eingabeaufforderung
net stop was /y
und dannnet start w3svc
aus.
- Installieren Sie den Orchestrator und aktivieren Sie die Insights-Funktion. Sie müssen ein Zugriffstoken für die Installation des Orchestrators abrufen.
Wichtig:Stellen Sie sicher, dass Sie die
db_owner
Rolle auswählen, da dies erforderlich ist, wenn Sie die Datenbankbesitzer-Rolle während der Insights SQL Server-Konfiguration hinzufügen.• Die Orchestrator- und die Insights-Version müssen übereinstimmen. Wenn Sie z. B. die Orchestrator-Version 2021.10.1 ausführen, muss auch die ausgeführte Insights-Version 2021.10.1 sein, um eine ordnungsgemäße Kommunikation zwischen den beiden UiPath-Produkten sicher zu stellen.
- Aktivieren Sie HTTPS auf Ihrem Server unter Verwendung eines SSL-Zertifikats. Das Verfahren ähnelt dem für den Orchestrator. Siehe Verwendung eines Zertifikats für das HTTPS-Protokoll.
- Rufen Sie das selbstsignierte Zertifikat mit Ihrem DNS ab und importieren Sie es in
certlm.msc
.
- Führen Sie den folgenden Befehl aus:
$cert = New-SelfSignedCertificate -certstorelocation cert:\localmachine\my -dnsname <your-dns-name> -KeySpec KeyExchange $pwd = ConvertTo-SecureString -String '<your-password>' -Force -AsPlainText $path = 'cert:\localMachine\my\' + $cert.thumbprint Export-PfxCertificate -cert $path -FilePath <path-to-save>\cert.pfx -Password $pwd
$cert = New-SelfSignedCertificate -certstorelocation cert:\localmachine\my -dnsname <your-dns-name> -KeySpec KeyExchange $pwd = ConvertTo-SecureString -String '<your-password>' -Force -AsPlainText $path = 'cert:\localMachine\my\' + $cert.thumbprint Export-PfxCertificate -cert $path -FilePath <path-to-save>\cert.pfx -Password $pwdHinweis: Ersetzen Sie Folgendes:<your-dns-name>
mit dem DNS-Namen Ihres Servers oder der virtuellen Maschine<your-password>
mit dem Kennwort, mit dem Sie das Zertifikat verschlüsseln möchten<path-to-save>
mit dem Speicherort, an dem Sie das exportierte Zertifikat im Format.pfx
speichern möchten
- Installieren Sie mithilfe des Zertifikatsmanagers das Zertifikat manuell (sowohl unter Persönlich als auch unter Vertrauenswürdig).
Wichtig: Ein SAN-SSL-Zertifikat, das an eine Zertifizierungsstelle übermittelt wird, ist einem selbstsignierten Zertifikat vorzuziehen.
- Selbstsignierte Zertifikate (und welche von Ihrer eigenen Zertifizierungsstelle) müssen sowohl im Speicher für vertrauenswürdige Stammzertifikate als auch im persönlichen Zertifikatspeicher auf der Insights-Maschine installiert sein. Das Zertifikat muss auch als Exportfähig gekennzeichnet sein.
- Zertifikate, die an eine Zertifizierungsstelle übermittelt werden, müssen nur im vertrauenswürdigen Stammverzeichnis installiert werden.
Beachten Sie, dass bei der Verwendung eines selbstsignierten Zertifikats Probleme auftreten können, wenn Sie über Firefox oder Edge auf Insights zugreifen. Internet Explorer wird ab Insights 2021.4 nicht mehr unterstützt.
- Rufen Sie das selbstsignierte Zertifikat mit Ihrem DNS ab und importieren Sie es in
- 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 der Server, auf dem Insights installiert wird, mit den Servern kommunizieren kann, auf denen der Orchestrator installiert ist, und umgekehrt.
- Wenn Sie eine lokale oder in der Cloud gehostete VM verwenden, muss sie die geschachtelte Virtualisierung auf Windows-Betriebssystemen unterstützen.
- Azure - Weitere Informationen
- AWS - Weitere Informationen
- Stellen Sie sicher, dass Sie TLS 1.1 oder 1.2 verwenden.
- Stellen Sie sicher, dass die folgenden Ports geöffnet und zugänglich sind:
543
(Standard),9999
und19999
.Erstellen Sie für jeden Port eine Regel für den Eingangsport, um ihn zu öffnen:543
,9999
,19999
.
- Port
543
- Port
9999
- Port
19999
- Port
- Installieren Sie Docker basierend auf Ihrer Umgebung.
Installieren Sie Docker für Windows Server 2019:
- Erstellen Sie mit PowerShell die
folgende
Variable:
$TMP_WORKDIR="c:\docker"
$TMP_WORKDIR="c:\docker" - Erstellen Sie mit PowerShell das
folgende
Verzeichnis:
New-Item $TMP_WORKDIR -ItemType Directory -force
New-Item $TMP_WORKDIR -ItemType Directory -force - Aktivieren Sie die folgenden Windows-Features: Hyper-V und Container. Führen Sie dazu die folgenden Schritte aus:
- Rufen Sie die Systemsteuerung auf und darin Programme.
- Klicken Sie auf Windows-Features aktivieren oder deaktivieren.
- Aktivieren Sie die Kontrollkästchen neben Hyper-V auf dem Reiter Serverrollen sowie Container auf dem Reiter Funktionen.
- Starten Sie den Server bei Bedarf neu.
- Sie können mit PowerShell Docker herunterladen und die Linux-Container im Ordner
$TMP_WORKDIR entpacken, indem Sie den folgenden
Befehl ausführen:
Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip"
Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip" - Sie können mit PowerShell lcow kernel herunterladen und die Linux-Container
im Ordner $TMP_WORKDIR entpacken, indem Sie den folgenden
Befehl ausführen:
Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip"
Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip" - Als Nächstes installieren Sie Docker und
lcow:
Expand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force
Expand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force - Richten Sie mit PowerShell die
Umgebungsvariable ein, indem Sie den folgenden
Befehl ausführen:
[Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine) [Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine") [Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine")
[Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine) [Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine") [Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine") - Aktivieren Sie mit PowerShell die experimentellen Funktionen in
daemon.json
, indem Sie den folgenden Befehl ausführen:$configfile = @" { "experimental": true } "@ $configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force
$configfile = @" { "experimental": true } "@ $configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force - Registrieren Sie den Dienst, indem Sie den
folgenden Befehl in
PowerShell ausführen:
cd $Env:ProgramFiles\docker .\dockerd.exe --register-service
cd $Env:ProgramFiles\docker .\dockerd.exe --register-service - Starten Sie abschließend Ihren Computer neu, indem
Sie den folgenden Befehl in
PowerShell ausführen:
Restart-Computer -Force
Restart-Computer -Force
Installieren Sie Docker auf VMs mit Air-Gap:
Um Docker in Air-Gap-Umgebungen zu installieren, müssen Sie zwei Schritte ausführen. Laden Sie zuerst die Installationsdateien auf eine Online-VM herunter und kopieren Sie dann die Dateien auf Ihre Offline-VM, wo Sie sie installieren möchten.
Anforderungen- Stellen Sie sicher, dass die Offline-VM die Anforderungen für den Insights-Server erfüllt.
- Die Online-VM muss Windows Server 2019+ ausführen und über Internetzugriff verfügen.
Herunterladen der Docker-Installationsdateien auf der Online-VM
Öffnen Sie als Administrator PowerShell auf Ihrer Online-VM und führen Sie die folgenden Befehle aus, um einen neuen Docker-Ordner zu erstellen.
# variables $TMP_WORKDIR="c:\docker" # Create tmp_workdir New-Item $TMP_WORKDIR -ItemType Directory -force # Install Hyper-V and Containers Install-WindowsFeature Hyper-V Install-WindowsFeature containers
# variables $TMP_WORKDIR="c:\docker" # Create tmp_workdir New-Item $TMP_WORKDIR -ItemType Directory -force # Install Hyper-V and Containers Install-WindowsFeature Hyper-V Install-WindowsFeature containersLaden Sie lcow kernel herunter und entpacken Sie die Linux-Container im Ordner $TMP_WORKDIR.
# Get docker Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip" # Get lcow Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip"
# Get docker Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip" # Get lcow Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip"Installieren von Docker auf der Offline-VM
Öffnen Sie als Administrator PowerShell auf Ihrer Offline-VM und führen Sie die folgenden Befehle aus, um Docker zu installieren, den Dienst zu registrieren und die Maschine neu zu starten.
# Install Expand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force # Add Environment Variables [Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine) [Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine") [Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine") # Enable Experimental Features in Docker daemon.conf $configfile = @" { "experimental": true } "@ $configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force # Register service cd $Env:ProgramFiles\docker .\dockerd.exe --register-service # Restart Computer Restart-Computer -Force
# Install Expand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force # Add Environment Variables [Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine) [Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine") [Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine") # Enable Experimental Features in Docker daemon.conf $configfile = @" { "experimental": true } "@ $configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force # Register service cd $Env:ProgramFiles\docker .\dockerd.exe --register-service # Restart Computer Restart-Computer -Force - Erstellen Sie mit PowerShell die
folgende
Variable:
- Wenn Sie VMWare verwenden, stellen Sie sicher, dass Sie VMwareToolboxCmd 11.0.6+ verwenden. Bei früheren Versionen kann es passieren, dass der Docker-Container unerwartet neu gestartet wird.
Bevor Sie Insights installieren, müssen Sie die Insights SQL Server-Instanz konfigurieren, die Sie verwenden möchten.
Latin1_General_CI_AS
festlegen.
Voraussetzungen
Zu Beginn der Konfigurierung muss Folgendes bekannt/gegeben sein:
- Den Namen der SQL Server-Maschine.
- Den Namen der Instanz, wenn es nicht die Standardinstanz ist.
- Den SQL Server-Port ist offen in der Firewall der SQL-Server-Maschine.
- Das TCP-Protokoll im SQL Server-Konfigurationsmanager muss aktiviert sein.
- Der SQL Server-Dienst überwacht einen festen Port, nicht einen dynamisch zugeordneten.
Empfehlungen
Informationen zum Konfigurieren des Standard-MAXDOP Ihrer Datenbank finden Sie unter Konfigurieren des maximalen Grads der Parallelitätsoption der Serverkonfiguration.
SQL Server-Authentifizierungsmethoden
Konfigurieren Sie eine der folgenden Authentifizierungsmethoden, mit denen Insights eine Verbindung mit der SQL Server-Datenbank herstellen kann:
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. Um die Windows-Authentifizierung zu aktivieren, muss SQL Server die Authentifizierung über das Kerberos-Protokoll unterstützen.
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.
- Insights Server muss sich im selben Netzwerk wie die AD-Domäne und SQL Server befinden.
- Das DNS muss so konfiguriert werden, dass Insights Server 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 der Insights-Server 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 dem Computer, 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 dem Computer, 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 Varchar Datentyps in einen DatenZeit-Datentyp führte zu einem Wert außerhalb des Bereichs“).
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.
db_owner
mit der UiPath-Anmeldung nicht erlauben, gewähren Sie Folgendes:
db_datareader
db_datawriter
db_ddladmin
EXECUTE
-Berechtigung fürdbo
-Schema
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] GO
- Beim Upgrade auf 2021.10 werden Benutzer mit Insights-Berechtigungen derzeit nicht zur neuen Version migriert. Bald wird ein Skript dafür bereitgestellt.
- 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.
- Führen Sie das
InsightsInstaller.msi
-Installationsprogramm als Administrator mithilfe der Eingabeaufforderung oder der PowerShell-Konsole aus. - Geben Sie
cmd
oderpowershell
ein, klicken Sie dann mit der rechten Maustaste auf die Anwendung sowie Als Administrator ausführen. - Geben Sie den Befehl
cd <path-to-msi>
ein, wobei<path-to-msi>
den Ort angibt, an dem sich Ihr.msi
-Installationsprogramm befindet. Beispiel:C:\Users\yourUsername\Downloads>
. - 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.Wenn Sie ein anderes Verzeichnis angeben möchten, verwenden Sie den Befehlmsiexec.exe /i InsightsInstaller.msi /L*V logfilepath
. Weitere Informationen finden Sie auf der Seite Support. - Akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf Weiter.
- Ändern Sie die Insights-Servereinstellungen wie folgt:
- Insights Server-URL – der Hostname oder die URL des Insights-Servers.
- Port – der Port für die Kommunikation zwischen dem Computer und dem Orchestrator.
- 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.
- Separater Identity Server – Wenn Sie über einen separaten Identitätsserver verfügen, aktivieren Sie diese Option.
- 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 Zugriffstoken für die Installation.
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.
- 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
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.
- 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-Host.
- Von – die E-Mail-Adresse, von der E-Mail-Nachrichten gesendet werden sollen. Sie muss mit der für den Benutzernamen angegebenen übereinstimmen.
- 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
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.
- TLS/SSL-Version – Nur sichtbar, wenn TLS/SSL aktiviert ist. Wählen Sie zwischen TLSv1_1 und TLSv1_2
- Klicken Sie auf Weiter, um die Installation zu starten. Nachdem der Installationsvorgang abgeschlossen wurde, klicken Sie auf Schließen, um das Installationsprogramm zu beenden.
Wichtig: Starten Sie nach der Installation von Insights Docker neu.
C:\Users\yourUsername\_insights
.
Um zu überprüfen, ob Looker ausgeführt wird, stellen Sie sicher, dass der Docker-Container aktiv ist.
Nachdem die Insights-Installation abgeschlossen ist, gehen Sie zum Browser, um eine erfolgreiche Installation zu bestätigen.
Beheben der Schwachstelle durch log4j
Um die Log4j-Sicherheitslücke zu beheben, stellen Sie sicher, dass Sie den Hotfix ausführen, um Abhängigkeiten auf die neueste, nicht anfällige Version von Apache Log4j zu aktualisieren.
Weitere Informationen finden Sie im Abschnitt UiPath Insights (Version 2021.10+)/Automation Suite Advisory in UiPath Security Advisory CVE-2021-44228, CVE-2021-45046 und CVE-2021-45105.
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.
Nach der Installation von Insights müssen Sie es im Orchestrator-Hostportal für die gewünschten Mandanten aktivieren. Weitere Informationen finden Sie unter Aktivieren oder Deaktivieren von Funktionen.
- Überprüfen Sie die Protokolle unter %programdata%/UiPath Insights/Provisioning
- Es sollte ein Fehler auftreten, wenn der OrchestratorTenantJob fehlschlägt.
- Melden Sie sich mit einem SQL-Client bei der Orchestrator-DB an.
- Überprüfen Sie die Tabelle dbo.Tenants.
- Überprüfen Sie, ob die Spalten „Schlüssel“ und „KontoID“ alle großgeschrieben werden.
- Wenn ja, wird das Problem behoben, wenn Sie sie in Kleinbuchstaben schreiben.
- Wenn es einen Mandanten mit Kleinbuchstaben gibt, versuchen Sie, diesen Mandanten einfach zu aktivieren, und überprüfen Sie, ob der Fehler weiterhin auftritt.
- 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])
- 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');
- 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.
- 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.