Insights
2021.10
False
  • Versionshinweise
  • Erste Schritte
  • Installation und Upgrade
  • Zugriff und Berechtigungen
  • Interaktion mit Insights
  • Fehlersuche und ‑behebung
Bannerhintergrundbild
Insights
Letzte Aktualisierung 23. Apr. 2024

Installation

Voraussetzungen für die Installation

  1. Stellen Sie sicher, dass Sie die Hardware- und Softwareanforderungen für Insights erfüllen.
  2. 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
    • Verwaltungstools
      • IIS-Verwaltungskonsole
  3. Laden Sie .NET Hosting Bundle Version 3.1.17+ herunter und installieren Sie es.
    1. Laden Sie das .NET-Hosting Bundle herunter.
    2. Führen Sie in der Eingabeaufforderung net stop was /y und dann net start w3svc aus.
  4. 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.



  5. 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.
    1. Rufen Sie das selbstsignierte Zertifikat mit Ihrem DNS ab und importieren Sie es in certlm.msc.


    2. 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 $pwd
      Hinweis: 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
    3. 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.

  6. Stellen Sie beim Angeben eines Hostnamens für Insights sicher, dass der gewünschte Hostname in Ihrem DNS aufgelöst werden kann.


  7. Stellen Sie sicher, dass der Server, auf dem Insights installiert wird, mit den Servern kommunizieren kann, auf denen der Orchestrator installiert ist, und umgekehrt.
  8. Wenn Sie eine lokale oder in der Cloud gehostete VM verwenden, muss sie die geschachtelte Virtualisierung auf Windows-Betriebssystemen unterstützen.
  9. Stellen Sie sicher, dass Sie TLS 1.1 oder 1.2 verwenden.
  10. Stellen Sie sicher, dass die folgenden Ports geöffnet und zugänglich sind: 543 (Standard), 9999 und 19999.
    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


  11. Installieren Sie Docker basierend auf Ihrer Umgebung.
    Installieren Sie Docker für Windows Server 2019:
    1. Erstellen Sie mit PowerShell die folgende Variable:
      $TMP_WORKDIR="c:\docker"$TMP_WORKDIR="c:\docker"
    2. Erstellen Sie mit PowerShell das folgende Verzeichnis:
      New-Item $TMP_WORKDIR -ItemType Directory -forceNew-Item $TMP_WORKDIR -ItemType Directory -force
    3. Aktivieren Sie die folgenden Windows-Features: Hyper-V und Container. Führen Sie dazu die folgenden Schritte aus:
      1. Rufen Sie die Systemsteuerung auf und darin Programme.
      2. Klicken Sie auf Windows-Features aktivieren oder deaktivieren.
      3. Aktivieren Sie die Kontrollkästchen neben Hyper-V auf dem Reiter Serverrollen sowie Container auf dem Reiter Funktionen.
      4. Starten Sie den Server bei Bedarf neu.




    4. 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"
      
    5. 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"
    6. 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\." -ForceExpand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force
      Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force
    7. 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")
      
    8. 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
    9. Registrieren Sie den Dienst, indem Sie den folgenden Befehl in PowerShell ausführen:
      cd $Env:ProgramFiles\docker
      .\dockerd.exe --register-servicecd $Env:ProgramFiles\docker
      .\dockerd.exe --register-service
    10. Starten Sie abschließend Ihren Computer neu, indem Sie den folgenden Befehl in PowerShell ausführen:
      Restart-Computer -ForceRestart-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

    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 containers

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

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 nicht, müssen Sie sie manuell so konfigurieren, dass die Groß-/Kleinschreibung nicht berücksichtigt wird.
Wenn Sie Ihre eigene Insights-Datenbank erstellen, müssen Sie die Sortiersequenz auf 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 Sie set user aus, um USERDNSDOMAIN und USERNAME.
  • SQL Server muss SPN-Einträge in AD haben. Weitere Informationen finden Sie unter Registrieren eines Dienstprinzipalnamens für Kerberos-Verbindungen.
    Wichtig: Es ist wichtig, dass 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> 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 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.
  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 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

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

Insights-Installation

Hinweis:
  • 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.
  1. Führen Sie das InsightsInstaller.msi-Installationsprogramm als Administrator mithilfe der Eingabeaufforderung oder der PowerShell-Konsole aus.
  2. Geben Sie cmd oder powershell ein, klicken Sie dann mit der rechten Maustaste auf die Anwendung sowie Als Administrator ausführen.
  3. 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>.
  4. Führen Sie das Insights-Installationsprogramm mit dem folgenden Befehl aus:
    msiexec /i InsightsInstaller.msimsiexec /i InsightsInstaller.msi

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

    .\InsightsInstaller.msi.\InsightsInstaller.msi
  5. Das Insights-Installationsprogramm sollte nun die Voraussetzungen überprüfen. Wenn alle Voraussetzungen erfüllt sind, wird der Einrichtungsassistent für UiPath Insights angezeigt, der Sie durch die Insights-Installation und -Konfiguration führt.


    Hinweis:
    Wenn die Installation fehlgeschlagen ist oder Sie das Installationsprotokoll überprüfen möchten, können Sie zum Ordner %temp% oder %temp%/<sessionID> gehen und das neueste MSI{random chars}.LOG überprüfen.
    Wenn Sie ein anderes Verzeichnis angeben möchten, verwenden Sie den Befehl msiexec.exe /i InsightsInstaller.msi /L*V logfilepath. Weitere Informationen finden Sie auf der Seite Support.
  6. Akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf Weiter.


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


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


  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.



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

Offline-Installation

Bei der Offlineinstallation müssen Sie Folgendes beachten:

  • Installieren Sie Docker für Windows Server 2019.
  • Sowohl der Orchestrator als auch die Insights-Datenbank sind zugänglich.
  • Stellen Sie sicher, dass der SMTP-E-Mail-Server zugänglich ist, falls konfiguriert.

Schritte nach der Installation

Überprüfen der Insights-Dienste

Hinweis: Entfernen Sie nicht den Ordner C:\Users\yourUsername\_insights .

Zugreifen auf Looker

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.

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.

Mandanteneinrichtung

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.

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.

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
UiPath Logo weiß
Vertrauen und Sicherheit
© 2005-2024 UiPath. All rights reserved.