UiPath Documentation
insights
2021.10
false
Insights
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde. Es kann 1–2 Wochen dauern, bis die Lokalisierung neu veröffentlichter Inhalte verfügbar ist.

Installation

Voraussetzungen für die Installation

  1. Ensure that you meet the Hardware and Software Requirements for Insights.

  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. Download .NET Hosting Bundle.
    2. Führen Sie in der Eingabeaufforderung net stop was /y und dann net start w3svc aus.
  4. Install Orchestrator and enable the Insights feature. You need to get an installation access token from Orchestrator.

    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. Enable HTTPS on your server using an SSL certificate. The procedure is similar to the one provided for Orchestrator. See Using a Certificate for the HTTPS Protocol.

    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 -force
      New-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. Navigate to the Control Panel, then go to Programs.

      2. Click Turning the Windows features on or off.

      3. Select the checkboxes next to Hyper-V in the Server Roles tab and Container in the Features tab.

      4. Starten Sie den Server bei Bedarf neu.

    4. You can use PowerShell to download Docker and unzip the Linux Containers to the $TMP_WORKDIR folder, by running the following command:

      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. You can use PowerShell to download lcow kernel and unzip the Linux Containers to the $TMP_WORKDIR folder, by running the following command:

      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\." -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
      
    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-service
      cd $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 -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

    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
    

    Download lcow kernel and unzip the Linux Containers to the $TMP_WORKDIR folder.

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

  • AD user should exist with access to SQL server and DB permissions as defined in the Permissions section. Domain, username, and password for this user must be provided during the Insights install process. Keep in mind that the username is case sensitive and that this also serves as the sAMAccountName of the user.

    Ö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 (d. h. kein 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

Ungeachtet des Benutzertyps (Domäne oder SQL), den Sie mit SQL Server verbinden möchten, beachten Sie bitte, dass Sie ihm dieServerrolledbcreator zuweisen müssen, BEVOR Sie Insights installieren, da die Datenbank während dieses Installationsprozesses erstellt wird.

If security restrictions do not allow the use of thedbcreator 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]
    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
    

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.msi
    msiexec /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.

    If you would like to specify a different directory, use the command msiexec.exe /i InsightsInstaller.msi /L*V logfilepath. For more details, see the Support page.

  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.

    • Installation Token - enter the Installation Access Token you generated on Identity Server's Installation Access Token page by logging in as the host tenant. For more details, see Installation Access Token.

      Hinweis:

      Sie benötigen für jede Installation ein neues Zugriffstoken. Das Token ist 2 Stunden 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:

      You must use the fully-qualified domain name for the database (e.g., mysever.my.domain instead of myserver). Preferably the SQL Server must join the AD domain directly.

      • 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 anhand der Angaben zum SMTP-Server 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 den Ordner C:\Users\yourUsername\_insights nicht.

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.

For more information, see the UiPath Insights (version 2021.10+) / Automation Suite Advisory section in UiPath Security Advisory CVE-2021-44228, CVE-2021-45046 & CVE-2021-45105.

Modifizieren von Insights

Behalten Sie die ursprüngliche Installationsdatei bei, falls Sie Änderungen oder Deinstallationen ausführen möchten.

For more information, see Modifying Insights configurations.

Mandanteneinrichtung

After installing Insights, you must then enable it for your desired tenant(s) from the Orchestrator host portal. For more details, see Enabling or disabling features.

Hinweis:

There are scenarios where the Orchestrator table dbo.tenants has the key and accountId columns in uppercase values. This typically only happens with older versions of Orchestrator (Orchestrat 18.X or lower).

  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?

Verbinden

Benötigen Sie Hilfe? Support

Möchten Sie lernen? UiPath Academy

Haben Sie Fragen? UiPath-Forum

Auf dem neuesten Stand bleiben