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

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

Erste Schritte

Per Kabel verbunden

Stellen Sie sicher, dass die Mindbreeze InSpire Appliance Netzwerk-Interfaces (NICs) per Kabel verbunden sind. Es wird mindestens die Verbindung des iDRAC Interfaces sowie eine der Host-NICs benötigt. Standardmäßig sind die Mindbreeze InSpire NICs auf DHCP konfiguriert. Sehen Sie unten, wie Sie iDRAC verwenden können, um die Host MAC-Adresse für die Reservierung eines DHCP-Lease zu erhalten.

Konfiguration der IP Adresse am iDRAC Interface (physischer Zugang notwendig)

Nach erfolgreicher Verbindung können Sie die IP Adresse des iDRAC Interfaces lokal am LCD Panel sehen, indem Sie folgendes Menü aufrufen:

• Home > View > iDRAC IP > IPv4 | IPv6 und wählen IPv4 (wenn dies der Fall ist).

Eine ausführlichere Anleitung zur Überprüfung der iDRAC-IP-Adresse am LCD Panel finden Sie auch hier.

Mit dieser Information können Sie vom DHCP Server abrufen, welche IP Adresse für die Netzwerk Interfaces geleast wurden.

Wenn DHCP für das iDRAC Netzwerk Interface nicht verfügbar ist, kann die IP Adresse manuell durch das Front LCD Panel gesetzt werden:

• Navigieren Sie vom Homescreen zum Setup-Screen und wählen Sie den Static IP Tab:
  Home -> Setup -> iDRAC -> DHCP | Static IP -> IP: 192.168.2.12
• Nach der IPv4 Konfiguration kann im gleichen Menü die Subnetz-Maske und der Gateway konfiguriert werden:
  Home -> Setup -> IDRAC -> Static IP ->Sub: 255.255.255.0
  Home -> Setup > IDRAC -> Static IP ->Gtw: 192.168.2.1

Eine ausführlichere Anleitung zur manuellen Konfigurierung der iDRAC-IP-Adresse am LCD Panel finden Sie auch hier.

Am Front LCD Panel des Servers können die MAC Adressen der Host Interfaces aufgelistet werden. Zur Anzeige der MAC Adressen führen Sie folgende Schritte aus:

• Home -> View -> MAC ->iDRAC| iSCSI1 | iSCSI2 | iSCSIn | NET1 | NET2 …NETn.
  Hier sind die NET1..N Interfaces Host Netzwerk-Interfaces.

Option 1) Konfiguration der IP Adresse des Host Interfaces via DHCP

Wenn DHCP verfügbar ist, können die MAC Adressen (entweder aus vorigem Schritt erhalten, oder durch das iDRAC Admin Portal https://<iDRAC_IP>:443) verwendet werden, um die jeweiligen DHCP-Leases zu identifizieren oder reservieren und dadurch die IP Adressen zu erhalten.

Login für iDRAC Admin Portal:

• Username: root
• Passwort: Appliance123

Option 2) Konfiguration der IP Adresse des Host Interfaces via iDRAC

Falls DHCP nicht verfügbar ist, um die Netzwerkeinstellungen automatisch an die Host Network Interfaces zu übermitteln, können die Netzwerkeinstellungen für die Interfaces mittels Verbinden mit der Virtuellen Konsole durch das iDRAC Web Interface (https://<iDRAC_IP>:443) durchgeführt werden.

Login in der Virtuellen Konsole:

• Username: config
• Passwort: Appliance123

Nach erfolgreichem Login erscheint das Network Configuration Interface. Hier können der DNS Server und die statischen Adresse des Netzwerk-Interfaces (bond0) konfiguriert werden. Es wird empfohlen, den DNS Server via „DNS configuration“ zu konfigurieren da ansonsten der DNS Server 8.8.8.8 verwendet werden könnte. Tragen Sie außerdem unter „Search Domains“ Ihre Domäne ein.

Abschließend müssen Sie noch einen Hostname (ohne Domäne) mit der Option „Set system hostname“ (im Hauptmenü des NetworkManager TUI) setzen.

Option 3) Konfiguration der IP Adresse des Host Interfaces durch physischen Zugriff

Wenn auf iDRAC nicht zugegriffen werden kann, können Sie sich mit dem config user auch physisch einloggen. Sehen Sie oben, wie Sie Device und DNS Konfiguration durchführen.

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.

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

Die Eingabe eines Passworts ist nur im Fehlerfall erforderlich.

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 Managementcenter 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 Größe” 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 eigener Insight Apps

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

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