Installation

Voraussetzungen für die Installation

1. Stellen Sie sicher, dass Sie die Hardware- und Softwareanforderungen für Insights erfüllen.
2. Installieren Sie Orchestrator oder ändern Sie eine vorhandene Installation, indem Sie die Insights-Funktion aktivieren.
3. Stellen Sie sicher, dass Sie die Orchestrator-Anweisungen befolgt haben. Dieses Zertifikat muss sowohl öffentliche als auch private Schlüssel enthalten und im vertrauenswürdigen Stamm der Insights-Maschine installiert sein.
4. Stellen Sie sicher, dass das Insights-Zertifikat im vertrauenswürdigen Stamm der Orchestrator-Maschine platziert ist.
5. Stellen Sie beim Angeben eines Hostnamens für Insights sicher, dass der gewünschte Hostname in Ihrem DNS aufgelöst werden kann.
6. Stellen Sie sicher, dass der Server, auf dem Insights installiert wird, mit den Servern kommunizieren kann, auf denen Orchestrator installiert ist, und umgekehrt,
   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.

   Beachten Sie, dass bei der Verwendung eines selbstsignierten Zertifikats Probleme auftreten können, wenn Sie über Firefox, Internet Explorer oder Edge auf Insights zugreifen.

Ändern einer Orchestrator-Installation für Insights

1. Wählen Sie in der Windows-Systemsteuerung Programme hinzufügen oder entfernen aus.
2. Wählen Sie Orchestrator in der Liste aus, und klicken Sie auf Ändern.
3. Folgen Sie dem Installationsprogramm auf dem Bildschirm, und wählen Sie die Funktion Insights-Integration aus:
   
   

   

   
   
   Hinweis: Nach Abschluss der Installation müssen Sie auch Ihre Hostlizenz aktualisieren, um sicherzustellen, dass die Insights-Funktion aktiviert ist.

Insights-Installation

1. Führen Sie das UiPathInsightsInstaller.exe-Installationsprogramm als Administrator aus. Der Assistent des UiPath Insights-Installationsprogramms wird angezeigt.
2. Aktivieren Sie das Kontrollkästchen Hier aktivieren, um die Lizenzvereinbarung zu akzeptieren, um den Bedingungen in der Vereinbarung zuzustimmen, und klicken Sie dann auf Weiter. Die Insights-Server-Konfiguration wird angezeigt.
   
   

   

   
   
3. Ändern Sie die Serverkonfiguration wie gewünscht:
   • Website-Hostname – wird verwendet, um das Gerät zu identifizieren, auf dem Insights installiert ist. Standardmäßig ist dies auf den Maschinenhostnamen festgelegt, kann aber bearbeitet werden. Dieser Name muss von einem externen Server aufgelöst werden können.
   • Websiteport - der Port, der für Insights-Kommunikation verwendet werden soll. Standardmäßig ist er auf 443 festgelegt, um die Verwendung von HTTPS zu ermöglichen.
   • Firewallregeln für diesen Port hinzufügen – falls ausgewählt, fügt dies automatisch Firewallregeln für diesen Port hinzu, um die Sicherheit der Maschine zu gewährleisten.
     Wichtig: Insights verwendet die Loopback-IP-Adresse für die Kommunikation zwischen verschiedenen Diensten. Diese Ports verwenden kein HTTPS. Um zu verhindern, dass die Ports von anderen Maschinen aus erreichbar sind, stellen Sie sicher, dass nur der Port 443 Verbindungen von externen Quellen (d. h. andere IP-Adressen als 127.0.0.1) empfangen kann.
   • Insights-Buildverzeichnis - Wenn definiert, legt es das Verzeichnis fest, in dem die Insights-Daten gespeichert werden, nachdem sie importiert und in das System integriert wurden.
     Wichtig: Dieses Feld ist nicht erforderlich, wenn es leer bleibt, verwendet das Installationsprogramm das Standardverzeichnis. Der Ordner darf kein Stammverzeichnis des Laufwerks D:\ sein und keinen nachgestellten Schrägstrich haben.

     Überprüfen Sie den ausgewählten Installationspfad. Das Verschieben einer Installation von einem Speicherort an einen anderen wird nicht unterstützt.

   • SSL-Zertifikatantragsteller – der Antragstellername des SSL-Zertifikats, das Sie zum Sichern von Verbindungen mit Insights verwenden möchten. Standardmäßig wird dieses mit dem vollständigen Computernamen ausgefüllt, kann aber bearbeitet werden.

Hinweis: Der SSL-Zertifikatantragsteller muss mit dem oben angegebenen Website-Hostnamen übereinstimmen. Wenn Sie ein vorhandenes Zertifikat verwenden, muss es als exportierbar markiert und im persönlichen Zertifikatspeicher der lokalen Maschine installiert sein.

• Selbstsigniertes Zertifikat erstellen – Wenn diese Option ausgewählt ist, wird automatisch ein selbstsigniertes Zertifikat mit dem oben angegebenen Antragstellernamen erstellt. Informationen zur Verwendung von Edge oder Internet Explorer mit selbstsignierten Zertifikaten finden Sie hier.
  Wichtig: Es wird nicht empfohlen, die Option Selbstsigniertes Zertifikat erstellen zu aktivieren, da es vorzuziehen ist, ein SAN-SSL-Zertifikat zu verwenden, das an eine Zertifizierungsstelle übermittelt wurde.

  Wenn auch ein selbstsigniertes Zertifikat auf Ihrer Orchestrator-Maschine verwendet wird, müssen die Orchestrator- und Insights-Zertifikate dem vertrauenswürdigen Stamm auf beiden Maschinen hinzugefügt werden.

• E-Mail - die E-Mail-Adresse des lokalen Insights-Administratorbenutzers.

Hinweis: Diese darf nicht mit der E-Mail-Adresse eines im Orchestrator definierten Benutzers übereinstimmen.

• Kennwort - das Kennwort für den lokalen Insights-Administratorbenutzer. Es muss 8-20 Zeichen lang sein und mindestens 1 Großbuchstaben, 1 Kleinbuchstaben, 1 Zahl und 1 Sonderzeichen (!, @, #, $, %, ^, &, *) enthalten.
  1. Klicken Sie auf Weiter. Die Insights-Datenbankkonfiguration wird angezeigt.
     
     

     

     
     
  2. Füllen Sie die Datenbankdetails wie folgt aus:
• Hostservername - der Name der SQL Server-Maschine, auf der sich die Insights-Datenbank befindet. Sie können hier auch eine benutzerdefinierte Portnummer mithilfe eines Doppelpunkts angeben, z. B. sql.uipath.com:1733.
• Datenbankname - der Name der Insights-Datenbank die bei der Installation von Orchestrator angegeben wurde.
• Windows-Authentifizierung: Wenn diese Option ausgewählt ist, wird die Verbindung mit Insights über ein Domänenkonto hergestellt. Weitere Konfigurationsschritte finden Sie weiter unten.
• SQL-Authentifizierung: Wenn diese Option ausgewählt ist, wird die Verbindung zu Insights mithilfe der SQL-Authentifizierung hergestellt. Wenn Sie diese Option verwenden, können die Felder Benutzername und Kennwort bearbeitet werden, und Sie müssen den SQL-Benutzernamen und das Kennwort angeben, die zum Herstellen einer Verbindung mit der Datenbank verwendet werden.
  1. Klicken Sie auf Weiter. Die Orchestrator-Konfiguration wird angezeigt.
     
     

     

     
     
  2. Geben Sie die Verbindungsdetails für Ihre Orchestrator-Instanz wie folgt an:
• Orchestrator-Endpunkt - die URL Ihres Orchestrator.
• Benutzername - der Benutzername des Host-Mandanten. Standardmäßig ist dies admin und kann nicht bearbeitet werden.
• Kennwort - das Kennwort für das Host-Administratorkonto
  1. Klicken Sie auf Weiter. Die Orchestrator-Datenbankkonfiguration wird angezeigt.
     
     

     

     
     
  2. Füllen Sie die Orchestrator-Datenbankdetails wie folgt aus:
• Hostservername - der Name der SQL Server-Maschine, auf der sich die Orchestrator-Datenbank befindet. Sie können hier auch eine benutzerdefinierte Portnummer mithilfe eines Doppelpunkts angeben, z. B. sql.uipath.com:1733.
• Datenbankname - der Name der Orchestrator-Datenbank, die bei der Installation von Orchestrator angegeben wurde.
• Windows-Authentifizierung: Wenn diese Option ausgewählt ist, wird die Verbindung über ein Domänenkonto hergestellt.
• 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 Benutzername und Kennwort bearbeitet werden, und Sie müssen den SQL-Benutzernamen und das Kennwort angeben, die zum Herstellen einer Verbindung mit der Datenbank verwendet werden.
  1. Klicken Sie auf Weiter. Die E-Mail-Serverkonfiguration wird angezeigt.
     
     

     

     
     
     Hinweis: Wenn Sie keinen E-Mail-Server konfigurieren, werden keine Insights-E-Mail-Benachrichtigungen und Benachrichtigungen gesendet. Sie können jedoch nach der Installation eine E-Mail-Serverkonfiguration hinzufügen, indem Sie die Funktion Ändern der Windows-Funktion „Programme hinzufügen oder entfernen“ verwenden.
  2. Konfigurieren Sie bei Bedarf Ihren E-Mail-Server wie folgt für Insights-Benachrichtigungen:
• SMTP-Host - Geben Sie Ihren SMTP-Host ein.
• SMTP-Port - Geben Sie Ihren SMTP-Port ein. Standardmäßig ist dies auf 25 eingestellt, kann aber bearbeitet werden.
• TLS-Konfiguration – wird verwendet, um die Sicherheitseinstellungen des E-Mail-Servers festzulegen. Es gibt die folgenden Optionen:
  • Sicher - Wenn diese Option aktiviert ist, verwendet die Verbindung TLS.
  • TLS ignorieren - Wenn diese Option ausgewählt ist (und Sicher nicht), wird TLS nicht verwendet. Wählen Sie diese Option, wenn Sie eine Verbindung mit einem nicht sicheren SMTP-Server herstellen.
  • TLS anfordern - wenn diese Option ausgewählt ist (und **„Sicher“ nicht), muss die Verbindung unabhängig vom E-Mail-Server-Support auf TLS aktualisiert werden.
• SMTP-Benutzername - die E-Mail-Adresse, von der E-Mail-Nachrichten gesendet werden sollen.
• SMTP-Kennwort - das Kennwort für die oben verwendete E-Mail-Adresse.
• Von-Adresse - die E-Mail-Adresse, von der E-Mail-Nachrichten gesendet werden sollen. Sie muss mit der als SMTP-Benutzername angegebenen Adresse übereinstimmen.
• Von-Anzeigename – ein Anzeigename für die E-Mail-Adresse.

• Erweiterte E-Mail-Server-Konfiguration - es gibt die folgenden Optionen:

  • Debuggen - Wenn diese Option ausgewählt ist, protokolliert Insight den gesamten SMTP-Datenverkehr. Sollte nur zur Problembehandlung verwendet werden.
  • Protokollierung - Wenn diese Option ausgewählt ist, protokolliert Insights alle Ereignisse (z. B. Serververbindung).
  • Verbindungs-Timeout - Zeit in Millisekunden, die gewartet werden muss, bis eine Verbindung hergestellt ist.
  • Begrüßungs-Timeout - Zeit in Millisekunden, die nach dem Aufbau einer Verbindung auf die Begrüßung gewartet werden muss.

  • Socket-Timeout - Zulässige Dauer von Inaktivität in Millisekunden.

    1. Klicken Sie auf Installieren. Der Installationsvorgang wird gestartet. Klicken Sie nach dem Abschluss auf Schließen, um das Installationsprogramm zu beenden.
       Wichtig:

       Nach Abschluss der Insights-Installation:

       • Stellen Sie sicher, dass die .NET-Vertrauensebene der Sisense-App auf Full festgelegt ist.
       • Öffnen Sie die consts.js Datei im Verzeichnis C:\Program Files\Sisense\app\query-proxy-service\src\common, und legen Sie den Parameter HEALTH_CHECK_TIMEOUT auf 100000 fest.

Windows-Authentifizierungskonfiguration

Wenn Sie die Windows-Authentifizierung zum Herstellen einer Verbindung mit der Insights-Datenbank verwenden (Schritt 4, oben), müssen Sie die Anmelde-Eigenschaften der Dienste Sisense.CLRConnectorsContainer und Sisense.JVMConnectorsContainer wie folgt ändern:

Hinweis: Wenn das Konto, das diesen Prozess ausführt, nicht das Konto war, das beim Ausführen des Insights-Installationsprogramms verwendet wurde, stellen Sie sicher, dass es Teil der lokalen Administratorgruppe ist.

1. Öffnen Sie den Windows-Dienst-Manager.
2. Klicken Sie mit der rechten Maustaste auf Sisense.CLRConnectorsContainer, und wählen Sie Eigenschaften aus.
3. Wählen Sie auf der Registerkarte Anmelden das Optionsfeld Dieses Konto aus.
4. Geben Sie den Benutzernamen und das Kennwort des Kontos ein, das zum Herstellen einer Verbindung mit der Insights SQL-Datenbank verwendet wird, und klicken Sie auf OK.
5. Wiederholen Sie diesen Vorgang für den Sisense.JVMConnectorsContainer-Dienst.
6. Starten Sie beide Dienste neu.

Mandanteneinrichtung

Nachdem Insights installiert wurde, müssen Sie es mit dem Dienstprogramm UiPath.InsightsAdminTool.exe für die gewünschten Mandanten aktivieren.

Wichtig:

Jeder aktivierte Mandant löst einen „Warmstart“-Prozess aus, der Daten für die konfigurierte Anzahl von Abgleichtagen in die Insights-Datenbank abruft.

Je nach Datenvolumen und Hardwarefunktionen kann es mehrere Stunden dauern, bis alle Mandantendaten in Insights verarbeitet und angezeigt werden können.

1. Navigieren Sie auf der Maschine, auf der Insights installiert ist, zum Verzeichnis \Orchestrator\Tools. Beispiel: cd C:\Program Files (x86)\UiPath\Orchestrator\Tools.
2. Führen Sie das Dienstprogramm UiPath.InsightsAdminTool.exe aus:
   
   

   

   
   
3. Geben Sie im Feld Benutzer den Administratorbenutzer des host-Mandanten von Orchestrator ein. Dies ist standardmäßig Admin und kann nicht geändert werden.
4. Geben Sie das Kennwort für den host-Mandanten von Orchestrator ein, und klicken Sie auf Anmelden. Das Fenster Testfälle auswählen wird angezeigt.
   Wichtig: Insights 20.10.0 hat ein kleines bekanntes Problem im ROI-Dashboard. In den verlinkten Versionshinweisen finden Sie Anweisungen, wie Sie dieses Problem mithilfe des Mandantensetups beheben können.
   
   

   

   
   
5. Wählen Sie Insights für Mandanten aktivieren aus. Eine Liste aller Mandanten wird angezeigt.
   
   

   

   
   
6. Wählen Sie für jeden Mandanten die folgenden Optionen aus:
   • Insights aktivierte: Aktivieren Sie dieses Kontrollkästchen, um Insights für den ausgewählten Mandanten zu aktivieren.
   • Dashboard-Sprache: Die gewünschte Sprache für Ihr Dashboard.
   • Ressourcen ersetzen - Wählen Sie Cube aus, um den Insights-Datencube zu löschen und neu zu erstellen, und Dashboards, wenn Sie alle mit enthaltenen OOTB-Dashboards durch neue OOTB-Dashboards ersetzen möchten.
   • Dashboardzugriff - Wählen Sie die Benutzerrollen/-gruppen aus, denen Zugriff auf Insights gewährt wird.

     Standarddashboards der folgenden Optionen:

Alle - die Standard-Dashboards werden für alle Insights-Benutzer freigegeben.

Verbraucher ‑ Die Standard-Dashboards werden nur für Benutzer freigegeben, die über Ansichtsberechtigungen für Insights verfügen.

Editoren ‑ Die Standard-Dashboards werden nur für Benutzer freigegeben, die über Bearbeitungsberechtigungen für Insights verfügen.

Insights-Administrator – Die Standard-Dashboards werden nicht automatisch für Insights-Benutzer freigegeben, sondern der Insights-Administratorbenutzer gibt sie manuell über das Insights-Portal frei.

• Abgleich: Aktivieren Sie diese Option, um einen Abgleich historischer Daten zu aktivieren, und geben Sie die gewünschte Anzahl von Tagen in das Eingabefeld ein.
  1. Klicken Sie auf Weiter. Ein Warnfenster wird angezeigt, klicken Sie auf OK, um fortzufahren.
  2. Die Mandanten sind aktiviert, und Ihre Installation ist abgeschlossen.
     Wichtig:

     Standardmäßig werden ab dieser Version keine benutzerdefinierten Tabellen erstellt. Sie müssen über die Option „Benutzerdefinierte Tabellen verwalten“ im Admin-Tool Prozesse und Warteschlangen auf eine Zulassungsliste setzen. Auf der Seite „Benutzerdefinierte Tabellen verwalten“ können Sie auswählen, welche Prozesse und Warteschlangentabellen Sie dem Insights-Cube hinzufügen möchten.

     Bei Bereitstellungen, bei denen die gewünschte Anzahl von Prozess- und Warteschlangentabellen die maximale Anzahl von 75 pro Mandant überschreitet, ermöglicht das Aktivieren der Tabellengruppierung die Kombination mehrerer Prozesse oder Warteschlangen in einer einzigen Gruppentabelle.

Protokollaufnahme für nicht-englische Bereitstellungen

Bei Bereitstellungen, die nicht-englische Daten verwenden (einschließlich der Ausführung von Robot oder Studio in einer anderen Sprache als Englisch), müssen einige Änderungen vorgenommen werden, um sicherzustellen, dass alle Protokolle ordnungsgemäß aufgenommen werden:

Für historische Protokolle zum Abgleich während des Warmstarts:

1. Öffnen Sie die Datei UiPath.InsightsAdminTool.exe.config im Verzeichnis C:\Program Files (x86)\UiPath\Orchestrator\Tools.
2. Suchen Sie den Schlüssel "Insights.RobotLogsWarmStartupQueryCondition", und ersetzen Sie "Execution ended" im Wert durch die entsprechende Übersetzung in der Sprache, die von Ihrer Bereitstellung verwendet wird.

Für die laufende Protokollaufnahme:

1. Öffnen Sie die Datei UiPath.Orchestrator.dll.config unter C:\Program Files (x86)\UiPath\Orchestrator.
2. Suchen Sie die when condition namens level, und ersetzen Sie execution ended durch die entsprechenden Zeichenfolge, die in die von Ihrer Bereitstellung verwendete Sprache übersetzt wurde:

• de > Ausführung beendet
• fr > Exécution terminée
• es-ES > Ejecución finalizada
• es-MX > Ejecución terminada
• ja > の実行が終了しました。
• ko > 실행이 종료되었습니다.
• zh-CN > 执行结束
• pt-pt > Execução terminada
• pt-BR > A execução terminou
• tr > Yürütme işlemi bitti
• ru > Выполнение завершено

Beispiele

• Englisch

  <logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="false" minlevel="Info" writeTo="insightsRobotLogs"><filters defaultAction="Ignore"><when condition="level >= LogLevel.Error or ends-with('${message}',' execution ended')" action="Log" /></filters></logger>

• Portugiesisch (BR)

  <logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="false" minlevel="Info" writeTo="insightsRobotLogs"><filters defaultAction="Ignore"><when condition="level >= LogLevel.Error or ends-with('${message}',' A execução terminou')" action="Log" /></filters></logger>

Bitte beachten Sie, dass alle anderen Zeichenfolgenänderungen an dieser when condition nicht unterstützt werden und bei Implementierung möglicherweise eine vollständige Produktneuinstallation erfordern.

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 Advisory (vor Version 2021.10) in UiPath Security Advisory CVE-2021-44228, CVE-2021-45046 und CVE-2021-45105j.