Initiale Inbetriebnahme
Mindbreeze InSpire G7

Tutorial Video „First Startup and Support“

In diesem Video erfahren Sie, wie Sie eine neue Mindbreeze InSpire Appliance in Betrieb nehmen. Es wird unter anderem gezeigt, wie Sie die Netzwerkkonfiguration vornehmen können und welche Mindbreeze Support Plattformen zur Verfügung stehen, sollten Sie weitere Hilfe benötigen.

https://www.youtube.com/watch?v=IiqqxPZeS_g

Vorbereitung

Im Anhang finden Sie eine kurze Anleitung, die Ihnen bei der Vorbereitung Ihrer Infrastruktur für Mindbreeze InSpire hilft.

Bitte übermitteln Sie den gewünschten vollqualifizierten Hostnamen für Mindbreeze InSpire (z.B. search.firmenname.com) und den technischen Ansprechpartner für die Inbetriebnahme, sowie passende Terminmöglichkeiten für die Vor-Ort Unterstützung über unser Mindbreeze InSpire Kontaktformular: https://www.mindbreeze.com/de/inspire-kontakt.html. Bitte teilen Sie uns auch alle Datenquellen mit, die Sie an die Suche anbinden möchten. Falls benötigt, übermitteln Sie uns auch den Authentifizierungsmechanismus, der für die Suche verwendet werden soll (z.B, Kerberos, SAML, ...).

Nötige Hardware Ressourcen

• Mindbreeze InSpire ist für den Einbau in ein 19“ Server-Rack vorgesehen.
  Es wird 2HE benötigt, bitte diesen Platz reservieren.
• Wir empfehlen zwei Stromanschlüsse für den Mindbreeze InSpire Server bereitzustellen, damit eine ausfallsichere Stromversorgung gewährleistet ist (je 750W Nennleistung).
• Bitte wenn möglich, 2 Ethernet LAN-Verbindungen vorbereiten, damit Netzwerk Bonding konfiguriert werden kann. Dafür müssen sich die beiden Verbindungen im selben Subnetz befinden. Eine Ethernet LAN-Verbindung ist zwingend erforderlich.
• Für den Anschluss des Remote Management Interface (iDRAC) benötigen Sie zusätzlich einen 3. Ethernet Anschluss. Stellen Sie bitte sicher, dass dieser eine korrekte IP-Adresse (DHCP/Manuell) zugewiesen bekommt. Die zugewiesene IP-Adresse kann anschließend am Display des Frontpanels oder im BIOS eingesehen werden. Diese IP ist für den Erstkontakt mit unserem Consulting-Team zwingend erforderlich.

Mindbreeze Service User

Für Kerberos-basierte Authentisierung mit Active Directory müssen Sie einen Service User im Active Directory anlegen, z.B mindbreeze.service. Bitte stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

• Ein NTP-Server, der zeitlich synchron mit Ihrem Active Directory Server ist und den die Mindbreeze InSpire Appliance erreichen kann, muss vorhanden sein
• Der Benutzer ist im Active Directory vorhanden
• Der Benutzer besitzt den Service Principal Namen
  HTTP/<vollqualifizierter Hostname für Mindbreeze InSpire>
  Sie können den Service Principal Namen als Active Directory Domain Administrator in einer Windows Eingabeaufforderung mit folgendem Befehl setzen:
  setspn –s HTTP/<vollqualifizierter Hostname für Mindbreeze InSpire><domain>\<mindbreeze.service>
  Beispiel:
  setspn –s HTTP/search.firmenname.com firmenname\mindbreeze.service
• Der vollqualifizierte Hostname muss einen DNS-Eintrag besitzen.
• Der Service Benutzer muss das “Trusted for Delegation (Kerberos only)” Attribut gesetzt haben. Sie können das Attribut „Trusted for Delegation (Kerberos only)“ für den Benutzer in der Microsoft Management Console unter „Active Directory Users and Computers“ Microsoft Management Console setzen.

Optionale Service User

Für das Crawling der Datenquellen sollten darüber hinaus auch Benutzer mit vollständiger Leseberechtigungen für alle zu indizierenden Daten erstellt werden. Diese werden nur von Mindbreeze verwendet um Daten zu indizieren.

Firewall Konfiguration

Bitte beachten Sie, dass folgende Netzwerkverbindungen für den Mindbreeze InSpire Server freigeschaltet sind:

• Mindestens Port 443 für das Standard Mindbreeze Client Service, muss von allen Benutzern erreichbar sein
• Port 8443 und 22 sind für Administratoren erreichbar
• Port 2222 ist für die Verbindung zwischen InSpire Appliances verfügbar
• Ports 88 und 389 bei allen Active Directory Servern müssen vom Mindbreeze InSpire Service erreichbar sein
• Zwischen Datenquellen, anderen Services und der Mindbreeze InSpire Appliance müssen darüber hinaus die entsprechenden Ports freigeschalten werden (z.B. NTP: Port 123)

Technische Voraussetzungen

Elektronische und andere technische Voraussetzungen für die Installation von Mindbreeze InSpire.

Vorbereitung

Ihre Mindbreeze InSpire Appliance muss an einem Ort installiert werden, der die in den folgenden Tabellen angegebenen Temperatur-, Elektro-, Kühl- und sonstigen Anforderungen erfüllt.

Voraussetzungen für Mindbreeze InSpire R760

Voraussetzungen für Mindbreeze InSpire R750

Voraussetzungen für Mindbreeze InSpire R740

Mindbreeze Management Center

Vorbereitung

Im Mindbreeze InSpire Management Center werden Administrations- und Managementaufgaben für die Mindbreeze InSpire Search Appliance durchgeführt.

Browser Support

Das Mindbreeze InSpire Management Center wird vollständig in folgenden Browsern unterstützt:
Google Chrome, Mozilla Firefox, Apple Safari.

Firewall Konfiguration

Um Zugriff auf das Mindbreeze InSpire Management Center zu bekommen stellen Sie sicher, dass folgende Netzwerk-Ports an die verbundenen Mindbreeze InSpire Server Netzwerk-Interfaces zugänglich sind:

Admin und Management Ports:

• Port 8443 (HTTPS) für den Zugang zum Mindbreeze Management Center
• Port 22 (SSH) für den Zugang zum Mindbreeze System Configuration Interface via eines unserer Consultants

Generelle Mindbreeze Ports:

• Port 443 (HTTPS) für den Zugang zum Mindbreeze Standard Client
• Port 2222 (SSH) für die Synchronisation zwischen Mindbreeze Appliances

Um das iDRAC Inferface des Mindbreeze InSpire Servers zu verwenden, müssen folgende Ports am iDRAC Network Interface des Mindbreeze InSpire Servers zugänglich sein:

• Port 443 (HTTPS) für den Zugang zum iDRAC Web Interface
• Port 5900 (TCP, UDP) für den Zugang zur iDRAC Virtual Console
• Port 8080 (TCP, UDP) für den Zugang zur iDRAC Virtual Console

Einrichtung der Mindbreeze InSpire Appliance

Grundsätzlich hängt die Einrichtung der Mindbreeze InSpire Appliance von der Netzwerkumgebung und den Anforderungen Ihres Unternehmens ab. In den meisten Fällen wird davon ausgegangen, dass der Netzwerkadministrator Ihres Unternehmens die genauen Details kennt, die für die Durchführung der Netzwerkkonfiguration erforderlich sind. Dazu gehören wichtige Informationen über die Netzwerkumgebung Ihres Unternehmens, die Anforderungen, die von der Appliance erfüllt werden müssen, als auch Kenntnisse, die von einem Netzwerkadministrator zu erwarten sind.

Bitte beachten Sie daher, dass in den folgenden Kapiteln lediglich die grundlegende Einrichtung der Appliance sowie weitere Einrichtungsoptionen beschrieben werden, die je nach Netzwerkumgebung und den Anforderungen Ihres Unternehmens erforderlich sein könnten.

Die Einrichtung der Mindbreeze InSpire Appliance kann auch über die Mindbreeze Consulting Services erfolgen: Carefree Renewal

Grundlegende Einrichtung

Schritt 1: Verbinden Sie die Appliance mit Kabeln

Die Mindbreeze InSpire Appliance verfügt über mehrere Netzwerkkarten (Network Interface Cards, NICs). Beispielsweise besitzt die Mindbreeze InSpire R760 Appliance die folgenden NICs:

Die folgende Tabelle beschreibt die erforderliche Mindestkonfiguration:

Standardmäßig sind die Mindbreeze InSpire NICs auf DHCP eingestellt. Wenn iDRAC verwendet werden soll, um die MAC-Adresse des Hosts für die Reservierung einer DHCP-Lease zu ermitteln, lesen Sie bitte das Kapitel Konfiguration über iDRAC.

Die Mindbreeze InSpire Appliance kann auch eine Bonding-Schnittstelle mit mehreren LAN-Kabeln automatisch verarbeiten. In diesem Fall reicht es aus, die Appliance mit den LAN-Kabeln zu verbinden und anschließend die grundlegende Einrichtung mit Schritt 2: Ermitteln/Konfigurieren Sie die IP-Adresse für die iDRAC-Schnittstelle fortzusetzen.

Die Appliance kann auch andere Verbindungstypen automatisch verarbeiten, wie beispielsweise eine Glasfaserverbindung. Im Falle einer Glasfaserverbindung müssen die NICs auf der Broadcom Extension Card gegen ein Glasfasermodul ausgetauscht werden. Danach kann die grundlegende Einrichtung, wie in diesem und dem nächsten Kapitel beschrieben, durchgeführt werden.

Schritt 2: Ermitteln/Konfigurieren Sie die IP-Adresse für die iDRAC-Schnittstelle

Nachdem die erforderlichen Kabel an die Appliance angeschlossen wurden, besteht der nächste Schritt darin, die IP-Adresse des iDRAC zu ermitteln oder zu konfigurieren, um die Fernadministration der Appliance zu ermöglichen.

Dazu ist der physische Zugriff auf die Mindbreeze InSpire Appliance erforderlich, da die IP-Adresse der iDRAC-Schnittstelle lokal auf dem LCD-Display an der Vorderseite der Appliance angezeigt und konfiguriert werden kann. Je nachdem, ob DHCP verfügbar ist oder eine statische IP-Adresse benötigt wird, muss der Netzwerkadministrator unterschiedlich durch die Menüpunkte navigieren. In den folgenden Kapiteln wird beschrieben, wie man durch die Menüpunkte navigieren muss, um die IP-Adresse von iDRAC zu ermitteln und zu konfigurieren.

DHCP ist verfügbar

Wenn DHCP verfügbar ist, kann die iDRAC IP über die folgenden Menüpunkte auf dem LCD-Display an der Vorderseite der Appliance abgerufen und konfiguriert werden:

1. Home
2. View
3. iDRAC IP
4. IPv4 | IPv6
5. Wählen Sie „IPv4“ aus. Die konfigurierbare iDRAC IP sieht dann zum Beispiel so aus:

Anhand dieser Informationen können Sie herausfinden, welche IP-Adresse vom DHCP-Server für die NICs gemietet wurde.

Ausführlichere Anweisungen zur Überprüfung der iDRAC IP-Adresse auf dem LCD-Display finden Sie außerdem hier.

DHCP ist nicht verfügbar und eine statische IP-Adresse wird benötigt

Wenn DHCP nicht verfügbar ist, kann eine statische IP-Adresse über die folgenden Menüpunkte auf dem LCD-Display an der Vorderseite der Appliance abgerufen und manuell konfiguriert werden:

1. Home
2. Setup
3. iDRAC
4. DHCP | Static IP
5. Wählen Sie die Option „Static IP“ aus. Die konfigurierbare statische IP-Adresse sieht zum Beispiel so aus:

Nach der Konfiguration der statischen IP-Adresse können Sie eine Subnetzmaske im nächsten Bildschirm oder über die folgenden Menüpunkte konfigurieren:

1. Home
2. Setup
3. iDRAC
4. Static IP
5. Bestätigen Sie die konfigurierte statische IP-Adresse, indem Sie zum Ende der IP-Adresse gehen und auf das Häkchen klicken.
6. Nun können Sie die Subnetzmaske konfigurieren, die zum Beispiel so aussehen kann:

Nach der Konfiguration der Subnetzmaske kann das Gateway auf dem nächsten Bildschirm oder über die folgenden Menüpunkte konfiguriert werden:

1. Home
2. Setup
3. iDRAC
4. Static IP
5. Bestätigen Sie die konfigurierte statische IP-Adresse und die Subnetzmaske, indem Sie zum Ende der IP-Adresse und anschließend zum Ende der Subnetzmaske gehen und auf das Häkchen klicken.
6. Nun können Sie das Gateway konfigurieren, das zum Beispiel so aussehen kann:

Ausführlichere Anweisungen zur manuellen Konfiguration der iDRAC IP-Adresse über das LCD-Display finden Sie außerdem hier.

Nachdem Sie nun die IP-Adresse ermittelt und die Fernadministration auf der Appliance hergestellt haben, ist die grundlegende Einrichtung abgeschlossen.

Weitere Einrichtungsoptionen

MAC-Adressen der Netzwerkkarten (NICs) finden

Die MAC-Adressen der Netzwerkkarten können entweder über das LCD-Display an der Vorderseite der Mindbreeze InSpire Appliance oder über das iDRAC Admin-Portal ermittelt werden.

LCD-Display an der Vorderseite der Mindbreeze InSpire Appliance

Um die MAC-Adressen zu finden, navigieren Sie durch die folgenden Menüpunkte:

1. Home
2. View
3. MAC
4. iDRAC| iSCSI1 | iSCSI2 | iSCSIn | NET1 | NET2 …NETn.
5. Wählen Sie eine der Optionen aus, wie „NET1“, „NET2“ oder andere, um die MAC-Adressen zu finden.

iDRAC Admin-Portal

Rufen Sie das iDRAC Admin-Portal über diesen Link auf:

https://<iDRAC_IP>:443

Hinweis: Wenn nach dem Aufrufen des iDRAC Admin-Portals über den Link ein Zertifikatsfehler angezeigt wird, stellen Sie sicher, dass das erforderliche SSL-Zertifikat für iDRAC installiert ist. Weitere Informationen finden Sie in der folgenden Dell-Dokumentation: https://www.dell.com/support/manuals/en-us/idrac9-lifecycle-controller-v6.x-series/idrac9_6.xx_ug/ssl-server-certificates?guid=guid-3154dbfc-906d-4444-9341-356e2d7dc54e&lang=en-us

Melden Sie sich anschließend mit den folgenden Anmeldedaten an:

• Benutzername: root
• Passwort: Appliance123

Im iDRAC Admin-Portal finden Sie die MAC-Adressen unter dem Menüpunkt „System“ im Abschnitt „Details“:

Manuelle Konfiguration einer IPv4-Adresse

Standardmäßig erfolgt die IPv4-Konfiguration automatisch und sollte nur geändert werden, wenn es notwendig ist.

Wenn beispielsweise eine bestimmte IPv4-Adresse benötigt wird oder verwendet werden soll, kann der Netzwerkadministrator die IPv4-Adresse manuell konfigurieren.

Um die IPv4-Adresse manuell zu konfigurieren, stehen zwei Optionen zur Verfügung:

• über iDRAC
• über physischen Zugriff mit Monitor und Tastatur

Beide Möglichkeiten werden in den folgenden Kapiteln beschrieben.

Konfiguration über iDRAC

Administratoren können die IPv4-Adresse manuell über die virtuelle Konsole im iDRAC Admin-Portal konfigurieren.

Rufen Sie das iDRAC Admin-Portal über den Link „https://<iDRAC_IP>:443“ auf und melden Sie sich mit dem folgenden Benutzernamen und Passwort an:

• Benutzername: root
• Passwort: Appliance123

Hinweis: Wenn nach dem Aufrufen des iDRAC Admin-Portals über den Link ein Zertifikatsfehler angezeigt wird, stellen Sie sicher, dass das erforderliche SSL-Zertifikat für iDRAC installiert ist. Weitere Informationen finden Sie in der folgenden Dell-Dokumentation: https://www.dell.com/support/manuals/en-us/idrac9-lifecycle-controller-v6.x-series/idrac9_6.xx_ug/ssl-server-certificates?guid=guid-3154dbfc-906d-4444-9341-356e2d7dc54e&lang=en-us

Rufen Sie anschließend die virtuelle Konsole auf.

Melden Sie sich mit den folgenden Anmeldedaten bei der virtuellen Konsole an:

• Benutzername: config
• Passwort: Appliance123

Hinweis: Bitte beachten Sie, dass ein Systemneustart durchgeführt wird, nachdem die Netzwerkeinstellungen konfiguriert sind und die Sitzung mit dem Benutzer „config“ beendet ist.

Nach der erfolgreichen Anmeldung sollte die NetworkManager TUI mit den folgenden verfügbaren Optionen angezeigt werden:

Ändern Sie das Feld „IPv4-Konfiguration“ von „<Automatic>“ auf „<Manual>“. Die folgenden Felder stehen nun für die Konfiguration der IPv4-Adresse zur Verfügung:

Danach ist die manuelle Konfiguration der IPv4-Adresse abgeschlossen und kann gespeichert werden. Bitte beachten Sie, dass das Schließen des NetworkManager-TUI-Fensters einen Neustart auslöst, unabhängig davon, ob Änderungen an der Konfiguration vorgenommen wurden oder nicht.

Konfiguration über physischen Zugriff mit Monitor und Tastatur

Falls kein Zugriff auf iDRAC möglich ist, kann die IPv4-Adresse auch manuell konfiguriert werden, indem die Mindbreeze InSpire Appliance an einen Monitor und eine Tastatur angeschlossen wird. Nachdem die physische Verbindung hergestellt wurde, kann die Konfiguration wie im vorherigen Kapitel beschrieben durchgeführt werden, indem man sich mit dem Konto „config“ anmeldet und in der NetworkManager TUI die Option „Edit a connection“ auswählt.

Weitere Informationen finden Sie im vorigen Kapitel Konfiguration über iDRAC.

Manuelle Konfiguration eines System-Hostnamens

Je nach Netzwerkumgebung des Unternehmens kann es erforderlich sein, einen System-Hostnamen manuell festzulegen. Dies ist beispielsweise der Fall, wenn der DHCP-Server keine Hostnamen vergibt.

Um einen Hostnamen manuell festzulegen, ist der Zugriff auf die NetworkManager TUI, entweder über iDRAC oder durch physischen Zugriff auf die Mindbreeze InSpire Appliance, erforderlich. Weitere Informationen finden Sie im Kapitel Konfiguration über iDRAC und im vorherigen Kapitel Konfiguration durch physischen Zugriff mit Monitor und Tastatur.

Wählen Sie in der NetworkManager TUI die Option „Set system hostname“ und definieren Sie anschließend einen Hostnamen ohne Domäne:

Speichern Sie den Hostnamen mit „OK“.

Mögliche Anpassung der Node-Einstellungen im Management Center

Nachdem die Einrichtung der Mindbreeze InSpire Appliance abgeschlossen ist und zum ersten Mal auf das Mindbreeze InSpire Management Center zugegriffen wird, könnten Administratoren eine Benachrichtigung über fehlende Einstellungen erhalten. Je nach Netzwerkkonfiguration Ihres Unternehmens ist dies ein Hinweis darauf, dass möglicherweise einige Anpassungen der Node-Einstellungen erforderlich sind.

Beispielsweise würden die folgenden Anwendungsfälle eine Anpassung der Node-Einstellungen erfordern:

• Die Domäne und der Hostname der Mindbreeze InSpire Appliance sind nicht kompatibel oder werden durch die Netzwerkkonfiguration Ihres Unternehmens beeinträchtigt.
• Benutzer:innen außerhalb des Unternehmensnetzwerks sollen einen anderen Hostnamen verwenden als die Benutzer:innen innerhalb des Unternehmensnetzwerks.
• Für die Kommunikation zwischen den Nodes ist ein anderer Hostname erforderlich.

Achtung: Bitte beachten Sie, dass es zu Betriebsproblemen kommen kann, wenn die Node-Einstellungen nicht ordnungsgemäß entsprechend der Netzwerkkonfiguration Ihres Unternehmens konfiguriert sind. Es ist zwar möglich, Mindbreeze InSpire mit fehlerhaften Node-Einstellungen zu nutzen, doch mit der zunehmenden Nutzung der Funktionen von Mindbreeze InSpire werden Probleme auftreten und die Fehlerbehebung wird zunehmend schwieriger und komplexer. So können beispielsweise in den folgenden Bereichen Probleme auftreten:

• Funktionen und Login des Management Centers
• Kommunikation zwischen Index Services und Client Services
• Upgrade der Mindbreeze InSpire Appliance
• Funktionen bezüglich der Nutzung von Large Language Models (LLMs) und Retrieval Augmented Generation (RAG)

Auf Grund dessen wird empfohlen, dass der Netzwerkadministrator des Unternehmens sicherstellt, dass nach Abschluss der Einrichtung der Mindbreeze InSpire Appliance die richtigen Node-Einstellungen konfiguriert sind.

Konfiguration und Anpassung der Node-Einstellungen

Um die Node-Einstellungen zu konfigurieren und anzupassen, rufen Sie das Management Center wie im folgenden Kapitel beschrieben auf und erweitern Sie anschließend den Menüpunkt „Setup“ in der Seitennavigation. Öffnen Sie den Untermenüpunkt „Nodes“, um eine Übersicht über alle Nodes zu sehen. Um die Node-Einstellungen zu bearbeiten, klicken Sie auf das „i“ in der Spalte „Aktionen“ des anzupassenden Nodes. Es erscheint ein neues Fenster, in dem die „Basic Node Information“ über die Schaltfläche „Bearbeiten“ bearbeitet werden können.

Beachten Sie beim Bearbeiten der „Basic Node Information“ folgende Punkte:

• Es sollte ein „Fully Qualified Domain Name” (FQDN) verwendet werden, der von einem mit dem System verknüpften DNS aufgelöst werden kann.
• Bei der Migration von Projekten, bei denen die Domäne noch vom ursprünglichen System verwendet wird, sollten Sie für das neue System eine temporäre Domäne verwenden, um Probleme während der Installation zu vermeiden.
• Domänen wie „.local“, „.localhost“ oder „.test“ werden nicht unterstützt.

Speichern Sie die Änderungen, um die Anpassung der Node-Einstellungen abzuschließen.

Weitere Informationen zu den „Basic Node Information“ finden Sie in der Dokumentation Handbuch – Verteilter Betrieb (G7) – Basic Node Information.

Management Center

Zugriff auf das Mindbreeze InSpire Management Center

Nach erfolgreicher Netzwerk-Konfiguration ist das Mindbreeze InSpire Management Center durch folgenden Secure-HTTP-Link zugänglich: https://<ip_address>:8443. Der <ip_address>-Platzhalter wird durch die IP Adresse von einem der verbundenen Netzwerk-Interfaces ersetzt.

Für den Zugriff auf das Mindbreeze InSpire Management Center benötigen Sie Anmeldedaten. Standardmäßig ist „admin“ der Username und „Appliance123“ das Passwort.

Weitere Informationen finden Sie in den Kapiteln Credentials, Passwort ändern, Benutzer anlegen und Rollen verwalten.

Bereiche

Hier werden die Haupt-Bereiche des Mindbreeze InSpire Management Center kurz erklärt.

Insight Apps

In diesem Bereich finden Sie das vorkonfigurierte Mindbreeze Client Service und den Insight App Editor.

Reporting

Hier können Sie Reports, Telemetry Daten und Statistiken zu den Mindbreeze Services abrufen.

Standardmäßig wird für die PostgreSQL-Datenbank von app.telemetry der Benutzer „telemetryuser“ mit dem Passwort „Appliance123“ verwendet.

Search Experience

In diesem Bereich werden verschiedene erweiterte Such-Parameter definiert. Folgende Untermenüpunkte stehen zur Verfügung.

Synonyms

Hier können Sie die CSV-Datei bearbeiten, die das Synonym Transformer Plugin verwendet, um Suchanfragen so zu transformieren, dass auch nach Synonymen gesucht wird.

Replacements

Hier können Sie die CSV-Datei bearbeiten, die das Replacement Transformer Plugin verwendet, um Suchbegriffe in Suchanfragen zu ersetzen.

Query Boostings

Hier können Sie die CSV-Datei bearbeiten, die das Term2DocumentBoost Transformer Plugin verwendet, um die Relevanz Dokumente mit bestimmten Metadaten abhängig vom Suchbegriff zu erhöhen.

Vocabulary

Hier können Sie die CSV-Dabei bearbeiten, die das Vocabulary Synonym Transformer Plugin verwendet, um die Suchanfrage so zu transformieren, dass auch nach Synonymen gesucht wird. Die Unterschiede zum Synonym Transformer Plugin werden hier beschrieben.

Relevance

Hier können Sie mithilfe eines einfachen User-Interface die JSON-Datei bearbeiten, welche vom Term2DocumentBoost Transformer Plugin verwendet, um das Relevanzmodell der Dokumente zu verändern.

Services

Hier können Sie verschiedene Aufgaben durchführen, die die Mindbreeze Services betreffen. Beispiele: Starten/Stoppen der Services oder Indices zurücksetzen (reindexing).

Configuration

Unter “Configuration” haben Sie Zugriff auf die detaillierte Konfiguration der Mindbreeze Services und Komponenten. Eine detaillierte Beschreibung der Einstellungen finden Sie unter:
http://help.mindbreeze.com/

Setup

In diesem Abschnitt können Sie Kerberos einrichten, Keytab-Dateien generieren, den Zugriff auf verschiedene Teile der Applkation konfigurieren, einen Mail-Server einrichten und Container neu starten.

Kerberos

Kerberos-Konfiguration und Generierung von Keytab-Dateien. Für Details siehe Konfiguration - Kerberos Authentifizierung.

Credentials

Hier können notwendige Credentials konfiguriert werden. Für mehr Informationen, siehe Konfiguration – Backend Credentials.

InSpire

Eine vollständige Erklärung des Menüpunktes „InSpire“ finden Sie im Kapitel Mindbreeze InSpire Management.

SSL-Zertifikat

Hier kann das notwendige SSL-Zertifikat hochgeladen werden. Für mehr Informationen siehe Konfiguration – Mindbreeze InSpire – Tutorial Video „Installieren eines SSL-Zertifikats“.

Achtung: Der Security Header "strict-transport-security" kann die Verbindung zum Mindbreeze Management Center verhindern, wenn sich derselbe Browser vorher mit einem gültigen SSL-Zertifikat verbunden hat und sich nun ohne gültigem SSL-Zertifikat verbindet. Ist dies der Fall, nutzen Sie einen “sauberen” Browser (zum Beispiel duch den Inkognitomodus) um sich mit dem Management Center zu verbinden und ein gültiges Zertifikat zu installieren.

Nodes

Hier können Nodes konfiguriert und bearbeitet werden. Für mehr Informationen, siehe Handbuch - Verteilter Betrieb (G7) - Verwaltung von Nodes.

Aufgaben

Hier können Aufgaben hinzugefügt und bearbeitet werden.

Snapshots

Mit Snapshots kann eine Mindbreeze InSpire Appliance gesichert und falls notwendig auf eine andere Appliance migriert werden. Für mehr Informationen, siehe Handbuch – Sichern und Wiederherstellen.

Update

Installiert Updates. Details finden Sie im Kapitel Mindbreeze InSpire Produktupdates.

Filemanager

Unter „File Manager“ haben Sie Zugriff auf das Filesystem. Eine detaillierte Beschreibung der Möglichkeiten finden Sie unter Mindbreeze – Filemanager.

Anmeldedaten

Mindbreeze InSpire verwendet zur Verwaltung der Anmeldedaten die Softwarekomponente Keycloak. In diesem Abschnitt werden die wichtigsten Anwendungsfälle (Passwort ändern, Benutzer anlegen und Rollen verwalten) beschrieben.

Darüber hinaus finden Sie hier weiterführende Dokumentation: Keycloak 21.0 Server Administration

Passwort ändern

Bei der ersten Anmeldung im Management Center werden Sie aufgefordert, Ihr Passwort zu ändern. Wenn Sie zu einem späteren Zeitpunkt das Passwort eines Benutzers ändern möchten, gehen Sie wie folgt vor: Navigieren Sie im Management Center zum Menüpunkt „Setup“, „Credentials“ und dann zu „Manage“, „Users“. Suchen Sie den betreffenden Benutzer mit der Suchfunktion oder suchen Sie nach „*“, um eine Liste der Benutzer anzuzeigen. Klicken Sie auf den gewünschten Benutzer. Um ein neues Passwort zu setzen, klicken Sie im Tab „Credentials“ auf „Reset Password“. Wählen Sie die Einstellung „Temporary“, wenn der Benutzer das Passwort bei der nächsten Anmeldung selbst ändern soll. Bestätigen Sie Ihre Eingaben mit „Save“.

Benutzer anlegen

Sie können mehrere Benutzer anlegen. Navigieren Sie im Management Center zum Menüpunkt „Setup“, „Credentials“ und dann unter „Manage“ zu „Users“. Klicken Sie auf „Add User“, dann vergeben Sie den Benutzernamen unter „Username“ und anschließend klicken Sie auf „Save“. Wechseln Sie anschließend in den Tab „Credentials“ und klicken Sie auf „Set Password“, um ein Passwort festzulegen. Dies ist im vorherigen Abschnitt „Passwort ändern“ beschrieben.

Nachdem Sie ein Passwort gesetzt haben, müssen Sie dem Benutzer noch Rollen zuweisen. Ansonsten ist der neue Benutzer nicht sinnvoll nutzbar.

Siehe dazu den folgenden Abschnitt: „Rollen verwalten“. Um die Funktion „Passwort vergessen/zurücksetzen“ nutzen zu können, wird empfohlen für jeden Benutzer eine gültige E-Mail-Adresse anzugeben.

Rollen verwalten

Der Zugriff auf die verschiedenen Bereiche des Management Centers (z.B. „Reporting“, „Configuration“) wird über Rollen geregelt. Um beispielsweise den Punkt „Configuration“ im Management Center nutzen zu können, muss ein Benutzer die Rolle „InSpire Config Administrator“ besitzen. Mehrere InSpire-Rollen sind bereits standardmäßig angelegt.

Hinweis: Für eine Auflistung aller Mindbreeze InSpire Rollen, siehe Konfiguration - Backend Credentials - Beschreibung der Mindbreeze InSpire Rollen.

Sie können die Liste aller verfügbaren Rollen wie folgt aufrufen: Navigieren Sie im Management Center zum Menüpunkt „Setup“, „Credentials“ und dann unter „Configure“, „Roles“. Standardmäßig verfügt der Benutzer „admin“ über alle Rollen.

Sie können Benutzern Rollen wie folgt zuweisen oder entfernen: Navigieren Sie im Management Center zum Menüpunkt „Setup“, „Credentials“ und dann unter „Manage“, „Users“. Suchen Sie den gewünschten Benutzer über die Suchfunktion oder klicken Sie auf „View all users*“, um eine Liste der Benutzer anzuzeigen. Klicken Sie auf „Edit“ für den betreffenden Benutzer. Wechseln Sie zum Tab „Role Mappings“. Hier können Sie die Rollen zuweisen.

Laufende Aktualisierung der Betriebssystem-Patches

Betriebssystem-Patches werden als Teil des Mindbreeze InSpire Update Pakets ausgeliefert. Nach dem Einspielen ist ein Neustart der Appliance erforderlich.

Mindbreeze InSpire Produktupdates

Video Tutorial „Update a Mindbreeze InSpire appliance“

In diesem Video zeigen wir Ihnen, wie Sie Ihre Mindbreeze InSpire Appliance auf die neueste Softwareversion aktualisieren können. Es enthält auch eine Anleitung zum Downgrade auf ältere Versionen und behandelt Patches und andere Verbesserungen.

Link zum Video: https://www.youtube.com/watch?v=pwyDkJ_gsyc

Einführung

Neue Versionen von Mindbreeze InSpire können über das Management Center installiert werden. Dazu wird die (G7-)Image-Datei und ein Webbrowser mit Zugang zum Management Center benötigt.

Sie können die Image-Datei über folgenden Link von der Mindbreeze Webseite herunterladen: Updates & PI

Installation

Öffnen Sie das Management Center und navigieren Sie zur Sektion „Update“ -> „Upload“.

Wählen Sie mit „Wähle eine Datei aus“ die Image-Datei aus und klicken Sie auf „Datei hochladen“. Ein Fortschrittsbalken zeigt den Verlauf des Hochladevorgangs an.

Als nächstes werden wichtige Informationen zum Update angezeigt.

Hier können sie auswählen, ob die Appliance falls nötig automatisch neu gestartet wird.
Normalerweise wird das Update bei Fehlern bei denen ein Rücksetzen möglich ist abgebrochen.
Mit der Option “Force Update on Recoverable Verification Errors” kann versucht werden das Update trotzdem fortzusetzen.

Ein Passwort ist nur erforderlich, wenn das Update nicht startet (wenden Sie sich in diesem Fall bitte an den Mindbreeze Support).

Wenn Sie mit den General Terms and Conditions einverstanden sind, klicken Sie auf „Perform Update“ um den Update-Vorgangs zu starten.

Hinweis: Die Dienste sind während des Vorgangs nicht verfügbar! Während des Vorgangs werden detaillierte Informationen unten in einer Konsole ausgegeben.

Ist das Update erfolgreich, erscheint die Mitteilung „Success“. Während des Updates werden Sie erneut zur Eingabe der Zugangsdaten für das Management Center aufgefordert.

Falls Sie das Update nach dem Uploadvorgang nicht sofort starten wollen, können Sie es später zum Menüpunkt “Update”->”Perform Update” zurückkehren.

Mindbreeze InSpire Management

Das Mindbreeze InSpire Management ermöglicht es, globale Einstellungen für die InSpire Appliance zu setzen und einzelne Container neu zu starten, falls dies notwendig sein sollte.

Öffnen Sie das Management Center und navigieren Sie zur Sektion „Setup“ -> „InSpire“.

Global Settings

SMTP-Einstellungen

Mindbreeze InSpire muss E-Mails für das Zurücksetzen des Administrator-Passworts und app.telemetry-Benachrichtigungen versenden. Bitte geben Sie Ihren Mailserver unter "SMTP Server" an. Um den gleichen Mailserver für den Versand von Benachrichtigungen zu verwenden, konfigurieren Sie "localhost" für die Client Service Alerts Einstellung "SMTP Server". Die Standardadresse des Absenders für E-Mails, die von InSpire Services gesendet werden, kann ebenfalls konfiguriert werden.

Zeiteinstellungen

Für die Kerberos-basierte Authentifizierung mit Active Directory muss in der Konfiguration Ihrer Mindbreeze InSpire Applikation ein NTP-Server angegeben werden, der mit Ihrem Active Directory Server zeitlich synchron ist.

Füllen Sie die beiden Felder "NTP-Servers" und "Timezone" aus. Der Zeitserver wird sofort übernommen. Ein Neustart ist erforderlich, damit die Zeitzone in allen Containern wirksam wird.

Shared-Memory-Einstellungen

Im InSpire container stehen 64MiB als Shared-Memory zur Verfügung. Diese Standardmenge ist für fast alle Anwendungsfälle ausreichend, kann aber, wenn notwendig, angepasst werden.

Die Größe von /dev/shm kann mit der Einstellung “SHM Size” konfiguriert werden. Der Wert wird als MiB interpretiert und sofort angewandt.

Container Management

Der Bereich „Container Management“ bietet die Möglichkeit, den InSpire Container neu zu starten. Wenn der InSpire Container gestoppt ist, sind die InSpire Services nicht verfügbar. Weiters gibt es auch die Möglichkeit, die Infrastruktur von InSpire neu zu starten.

Upload von Zertifikaten

Der Bereich „SSL-Zertifikat“ bietet die Möglichkeit das SSL Zertifikat für die das Management Center der Appliance auszutauschen. Es kann eine p12 oder pfx Zertifikatsdatei via Upload installiert werden. Das Passwort zum Entschlüsseln der Zertifikatsdatei muss bei verschlüsselten Zertifikaten angegeben werden.

Tutorial Video „Install SSL certificate“

Dieses Video zeigt, wie Sie die SSL-Zertifikate für den Web Client und für das Management Center installieren können: https://www.youtube.com/watch?v=oThC_VNcc5s

Backup-Strategie

Anschließend finden Sie eine Kurzanleitung zum Thema Backup von Konfigurationen und Indices für Linux.

Mindbreeze InSpire Backup Strategie

Dieses Dokument beschreibt die wichtigsten Aspekte des Backups von Mindbreeze InSpire Konfigurations- und Indexdaten.

Die Backup Strategie sollte folgende Arten von Daten enthalten und insbesonders auch vor der Installation von Produktupdates angewandt werden:

• Mindbreeze Konfigurationsdaten: nach größeren Änderungen in der Mindbreeze Konfiguration ist ein Backup ebenfalls sinnvoll.
• Eigene Insight Apps: sollten Sie eigene Insight Apps eingespielt haben, ist ein regelmäßiges Backup davon empfehlenswert.
• Mindbreeze Index Daten: Insbesondere vor Produktupdates oder bei extrem großen Datenquellen nach vollständiger Indizierung ist ein Backup des Index ratsam.
• app.telemetry Konfigurationsdaten: auch die app.telemetry Konfiguration sollte in der Backup Strategie enthalten sein (zumindest wenn geändert/erweitert durch Kunde).
• Anmeldedaten: Die Benutzerdatenbank beinhalten Benutzer-Credentials und Rollenzuordnungen für das Berechtigungssystem und sollte im Backup sein.
• Sonstige Anpassungen: Alle weiteren Anpassungen, die nicht dem Mindbreeze Standardprodukt entsprechen, müssen darüber hinaus abgesichert werden.

Backup Strategie

Backup der Konfigurationsdateien

Die letzten 10 Versionen der Mindbreeze Konfigurationsdateien werden von Mindbreeze selbst im Konfigurationsverzeichnis behalten. Trotzdem ist es ratsam Backups dieser Dateien auf einem Backup-Medium zu sichern:

• Konfigurationsdateien werden gespeichert unter: /etc/mindbreeze

Wichtige Konfigurationsdateien:

• mesconfig.xml
• license
• plugins
• mesmasteruri.conf

Des Weiteren führen Sie bitte export_managerconfig.sh mit einer Pfadangabe aus (z.B. export_managerconfig.sh /data/export) und sichern Sie anschließend den Ordner „export“.

Backup selbsterstellter Insight Apps

Haben Sie selbsterstellte Insight Apps eingespielt, sollte von diesen regelmäßig ein Backup angefertigt werden:

• Selbsterstellte Insight Apps
  (/data/apps/<yourApp>)

Backup der Index-Daten

Fabasoft Mindbreeze Enterprise erzeugt einen dateibasierten Index. Diese Indexdateien können in einem konsistenten Zustand vollständig gesichert werden.

Um die Indexdaten zu sichern, gehen Sie folgendermaßen vor:

1. Ändern Sie den Modus des Index Service auf „Mode: readonly” mit folgendem mescontrol Kommando (der Indexport muss ensprechend dem gewünschten Index angepasst werden):
2. mescontrol http://indexserver.yourcompany.com:23100 readonly
3. Prüfen Sie Konsistenz des Index mit folgendem mescontrol Kommando (der Indexport muss entsprechend dem gewünschten Index angepasst werden):
   mescontrol http://indexserver.yourcompany.com:23100 checkconsistency
4. Prüfen Sie den Exit-Code (ERRORLEVEL) des mescontrol Kommandos
   echo %ERRORLEVEL% (sollte den Wert 0 zurückgeben wenn der Index in Ordnung ist)
5. Zum Backup der Index Daten navigieren Sie zum Indexverzeichnis und sichern (nach erfolgreichem Konsistenzcheck) das gesamte Verzeichnis wie folgt:
   1. Entweder kopiert man das gesamte Verzeichnis (z. B. in einer Linux Konsole) in das Backup Zielverzeichnis (wo man es später auch komprimieren kann).
   2. Oder man erstellt mit einem Archivierungs-Werkzeug nach Wahl direkt ein Backup-Archiv. Allerdings sind dabei folgende Punkte zu beachten:
      1. Durch die Kompression dauert dies länger als das einfache Kopieren und der Index muss somit länger im readonly-Modus verweilen.
      2. Andererseits darf das Backup-Tool die Index-Daten nicht verändern und muss mit geteiltem Lesezugriff umgehen können, da Mindbreeze-Prozesse Index-Daten noch lesend geöffnet haben. Zum Beispiel muss bei Verwendung von 7-Zip die Option „Compress shared files“ (-ssw) aktiviert sein.

1. Ändern Sie den Modus des Index Service aufs “Mode: normal” mit folgendem mescontrol Kommando (der Indexport muss ensprechend dem gewünschten Index angepasst werden):
   mescontrol http://indexserver.yourcompany.com:23100 readwrite

Backup der app.telemetry Konfiguration

Die wichtigste Konfigurationsdatei von app.telemetry ist die Datei infra.xml welche in Ihrem Backup nicht fehlen sollte. Sie befindet sich in folgendem Verzeichnis:

/etc/app.telemetry

Backup der app.telemetry Datenbank

Per Cron-Job wird täglich ein Backup der Datenbank erstellt, welches im Dateimanager unter “/data/backups/telemetrydb-pgdump” verfügbar ist.

Backup der Anmeldedaten

Die Benutzerdatenbank wird im Container keycloak täglich in folgendes Verzeichnis exportiert:
/data/backup/curr

Dieses Verzeichnis ist im Host über folgenden Pfad zugänglich:
/var/data/keycloak/data/backup/curr

Fügen Sie dieses Verzeichnis dem Backup hinzu.

Auswirkungen von Fremdsoftware

Allgemeine Hinweise zu Mindbreeze InSpire als Appliance

Mindbreeze InSpire wird als vorkonfigurierte Appliance an Kunden ausgeliefert. Die dabei vorinstallierten Software-Komponenten wurden aufeinander abgestimmt und auf mögliche Nebenwirkungen getestet.

Es ist nicht vorgesehen, dass Kunden den Softwarestand selbstständig verändern.

Beispiele für unerwünschte Veränderungen am Softwarestand wären:

• Software-Updates von installierten Anwendungen (ausgenommen Mindbreeze Produktupdates)
• Entfernen (Deinstallation) von vorinstallierter Software
• Installation neuer Software (z.B. Antivirus-Software)

Auswirkung von Drittsoftware auf Mindbreeze InSpire

Je nach Art von Drittsoftware Komponenten kann es zu unterschiedlichen Auswirkungen auf Mindbreeze kommen.

Mögliche Auswirkungen von Drittsoftware wären:

• Negative Auswirkungen auf die Systemleistung …
  • aufgrund übermäßigem Festplattenzugriff (z.B. Antivirus-Software)
  • aufgrund übermäßigem Speicherkonsum der Drittanwendung
    
• Stabilitätsprobleme aufgrund unerwartetem Dateizugriff …
  • Dateisperren
  • Modifikation von Dateiinhalten

Die häufigsten Probleme sind durch den Einsatz von Antivirus-Software zu erwarten und wie im nächsten Kapitel beschrieben zu minimieren.

Auswirkungen von Antivirus-Software auf Mindbreeze minimieren

Um negative Auswirkungen auf Performance und Stabilität von Mindbreeze zu minimieren sollten folgende Verzeichnisse dediziert von Virus-Scan-Läufen ausgeschlossen werden:

• Mindbreeze Index- und Cache-Verzeichnisse (z.T. konfigurationsabhängig)
  • Automatischer Pfad: /data/servicedata
  • Konfigurierte Pfade, z.B.: /data/indices und /data/cache
• Mindbreeze Log-Verzeichnisse (Pfad konfigurationsabhängig)
  • Example: /data/logs
• Mindbreeze Konfigurations-Verzeichnisse
  • /etc/mindbreeze
  • /data/resources
• Mindbreeze Produkt-Verzeichnis:
  • /opt/mindbreeze
• Fabasoft app.telemetry Produktverzeichnis:
  • /opt/app.telemetry
• Fabasoft app.telemetry Datenverzeichnisse
  • /var/opt/app.telemetry/
• Verzeichnis der Fabasoft app.telemetry Telemetry-Datenbank
  • /data/postgres/
• Temp-Verzeichnisse die von den einzelnen Services verwendet werden:
  • /tmp
  • /var/opt/mindbreeze
  • /data/servicetempdata
• Insight Apps:
  • /data/apps
• Weitere Verzeichnisse, die ausgeschlossen werden sollten:
  • /var/lib/docker
  • /sysroot/ostree/deploy/centos-atomic-host
  • /usr/lib/modules
  • /usr/lib/ostree-boot
  • /usr/lib/firmware
  • /sysroot/ostree/repo

Auf der anderen Seite können sich jegliche Virus-Scan-Läufe negativ auf die Systemleistung und somit auch das Antwortzeitverhalten von Mindbreeze auswirken. Hier wird empfohlen, sofern regelmäßige System-Scans unumgänglich sind, diese am besten in Wartungsfenstern oder außerhalb der Kernzeit in der die Suche angeboten wird durchzuführen.

Mindbreeze InSpire Supportprozess

Vorgehensweise bei Problemen mit Mindbreeze InSpire

Um einen bestmöglichen Support gewährleisten zu können, bitten wir all unsere Kunden und Partner unseren Standardprozess einzuhalten.

1. Bei jeglichen Standardprodukt-Problemen (Software, Hardware) erstellt jeder Kunde und Partner ein Ticket in unserem Support Desk unter https://tickets.mindbreeze.com.
2. Die Mitarbeiter unseres Support-Teams kümmern sich als erste Ansprechpartner um das aufgetretene Problem und sorgen für eine rasche Behebung des Problems.