Handbuch

Verteilter Betrieb (G7)

Einführung

ACHTUNG: Diese Dokumentation bezieht sich auf Mindbreeze InSpire Appliances der Generation G7. Wenn Sie eine älter Version betreiben, lesen Sie bitte das Handbuch – Synchronisierter Betrieb G6.

Mindbreeze InSpire kann mit dedizierten Producer und Consumer Nodes betrieben werden. Dabei wird außerdem zwischen Master- und synchronisierte Nodes unterschieden.

Genau ein Server ist Master, wobei dieser zumeist als Producer agiert. Mehrere Server handeln als synchronisierte Nodes, wobei diese Producer oder Consumer sein können. Dabei wird die Konfiguration ausschließlich am Master vorgenommen, wobei diese Konfiguration dann an alle synchronisierten Nodes verteilt wird.

Ein oder mehrere Server dienen als Producer. Auf diesen Nodes werden entsprechend der jeweils gültigen Konfiguration Erstindizierungen und Deltaindizierungen durchgeführt.

Weiters betreiben die Producer Server alle Mindbreeze Indizes sowie jeweils ein Mindbreeze Filter Service. Auf diesen Servern werden die Indizes produziert (indiziert) und sie führen auch die Delta-Indizierung durch. Die Producer Nodes sind also reine Produzenten von Indizes.

Die so erzeugten oder erneuerten Indizes werden automatisch durch Kopieren auf die Consumer Nodes verteilt.

Auf den Consumer Nodes laufen (auch verteilt auf mehrere Produzenten)

• alle Mindbreeze Indizes im Lesemodus,
• die dazugehörigen Sandbox-Prozesse für Kontextualisierung und Autorisierung,
• (Caching) Principal Resolution Services für Autorisierung, sowie
• Client Services.

Diese Consumer-Server sind für die Beantwortung der Suchanfragen sowie der Bereitstellung der Client Services verantwortlich.

Wesentliche Vorteile

• Indizierung inkl. Delta-Crawl Läufe beeinträchtigen die Suchperformance nicht negativ
• Keine Beeinflussung der Suchperformance durch
• Erstindizierung während dem laufenden Betrieb
• Deltaindizierung während dem laufenden Betrieb
• Hochfrequente Deltaindizierung (z. B. 15 Minuten Aktualität)
• kein Ausfall der Datenquellen während der Neuindizierung (Suchen auf den Consumern mit den bestehenden Indizes, Neu-Indizierung auf den Producern)
• Einfache Migration auf neue Produktversionen selbst wenn Neuindizierung empfohlen/nötig ist.
• Regelmäßige Neuindizierung ist durchführbar ohne Einfluss auf den Betrieb
• Flexibilität z. B. bei Änderungen von Konfigurationen
• Zentrale Verwaltung aller Nodes (inklusive app.telemetry)

Voraussetzung

• Zusätzliche Hardware für Producer und Consumer Nodes
• Für zusätzliche Ausfallsicherheit werden auch Lastverteiler benötigt/vorausgesetzt
• Die TCP Ports 8443 und 2222 müssen von allen Appliances untereinander erreicht werden können
• Jede Appliance muss einen eindeutigen Host-Namen haben, der vom DNS-Server aufgelöst werden kann

Lastverteiler (Load Balancer)

Wenn Sie in Ihrem Setup mehrere Client Services verteilt auf mehreren Nodes haben, können Sie mithilfe von Lastverteilern die Suchanfragen auf Ihre Client Services verteilen, um die Performance zu verbessern und die Ausfallsicherheit zu gewährleisten.

Wichtig dabei ist, dass der Lastverteiler so konfiguriert ist, dass ein User immer am selben Client Service sucht. Um dies zu realisieren, gibt es verschiedene Möglichkeiten, die abhängig vom konkreten Lastverteiler sind, wobei die folgende Liste ein paar Beispiele für die Realisierung nennt:

• der Lastverteiler unterstütz Session Affinity Out-of-the-box
• Requests, die von der gleichen IP-Adresse kommen, werden immer an denselben Client Service weitergeleitet
• Requests mit gleichem Cookie „JSESSIONID“ werden immer an denselben Client Service weitergeleitet

Konfiguration

Verwaltung von Nodes

Im Management Center unter „Setup“ -> „Nodes“ können Sie den Cluster Ihrer Mindbreeze Inspire Appliances (Nodes) verwalten. Beim Einrichten des Clusters öffnen Sie die gerade genannte Konfigurationsoberfläche bei der Mindbreeze InSpire Appliance, welche Sie später als Master verwenden möchten. Der Master Node steht in der Node Übersicht (siehe Screenshot unten) immer ganz oben und ist mit einem grauen Hintergrund gekennzeichnet, sodass er von synchronisierten Nodes unterschieden werden kann.

Die folgende Node Konfiguration wird für die nachfolgenden Beispiele verwendet:

• inspirenode2: Master; Producer für inspirenode1
• inspirenode1: Consumer von inspirenode2
• inspirenode3: Producer für inspirenode3
• inspirenode4: Consumer von inspirenode3
• inspirenode5: Agiert als eigenen Producer und Consumer

Anzahl der Dokumente Ihrer Lizenz

Unter „Total Licensed Documents“ können Sie die maximale Anzahl der Dokumente ansehen, die Sie im Rahmen Ihrer Lizenz indizieren können.
Die Anzahl der noch frei verfügbaren Dokumentenanzahl wird ebenfalls angezeigt.

Hinzufügen von Nodes

Mit dem Button „Add Node“ können Nodes zum Cluster hinzugefügt werden.

Konfigurieren Sie die in der nachstehenden Tabelle angeführten Optionen und klicken Sie anschließend auf den Button „Connect“. Mit einem Stern markierte Optionen sind Pflichtfelder.

Ändern von Nodes

Sie haben die Möglichkeit, die Quelle/Producer (Spalte „Source“) der Node zu ändern und weitere Optionen (Button „i“, Spalte „Action“) anzeigen zu lassen oder zu verändern.

Ändern der Quelle

In der Spalte „Source“ können Sie die Quelle ändern. Folgende Auswahlmöglichkeiten haben Sie bei synchronisierte Nodes:

Ändern weiterer Optionen

Wenn Sie auf den Button „i“ in der Spalte „Action“ eines Nodes klicken, können Sie weitere Informationen zu diesem Node betrachten. Außerdem finden Sie hier noch weitere Einstellungsmöglichkeiten.

Basic Node Informationen

In diesem Bereich werden Grundinformationen angezeigt. Wenn Sie auf den Button „Edit“ klicken, können sie diese Einstellungen verändern. Die folgende Tabelle beschreibt die Einstellungen, die verändert werden können:

Node Status

In diesem Bereich werden Statusinformationen des Nodes angezeigt. Die folgende Tabelle beschreibt die einzelnen Felder.

Product Version

In diesem Bereich werden Produktversionsinformationen des Nodes angezeigt. Die folgende Tabelle beschreibt die einzelnen Felder.

Change Master

Wenn Sie die Einstellungen für einen Nicht-Master Node geöffnet haben, wird Ihnen ein Button mit dem Namen „Propagate this node as master“ angezeigt, mit dem Sie einen Node zum Master machen können.

Spalte „Indexed Document“

In dieser Spalte wird die prozentuale Anzahl der aktuell indizierten Dokumente im Verhältnis zur maximalen Anzahl („Licensed Documents“) des jeweiligen Nodes angezeigt.

Spalte „Licensed Documents“

In dieser Spalte wird die maximale Anzahl von Dokumenten angezeigt, die im jeweiligen Node indiziert werden können.

Hinweise:

• Ein Producer Node darf die Anzahl von „Total Licensed Documents“ nicht überschreiten.
• Ein Consumer Node darf die Anzahl des zugehörigen Producers nicht überschreiten.

Entfernen von Nodes

Wenn Sie einen Node vom Cluster entfernen wollen, klicken Sie auf das Papierkorbsymbol des jeweiligen Nodes. Bitte beachten Sie, dass nur Nodes entfernt werden können, die nicht als Producer konfiguriert sind. Wenn Sie einen Producer entfernen möchten, müssen Sie zuerst alle zugehörigen Consumer vom Producer entfernen.

Verwaltung von Tasks

Im Management Center unter Setup -> Tasks können Sie Synchronisierungs-Tasks definieren, die Ihre im Nodes-Menü hinzugefügten Mindbreeze Inspire Appliances (Node) betreffen. Öffnen Sie das Tasks-Menü immer auf Ihrem Master Node, da alle Einstellungen immer an diesem Node durchgeführt werden.

Mindbreeze InSpire unterscheidet drei Arten von Tasks:

• Konfigurations- und Datensynchronisierung
• Indexsynchronisierung
• app.telemetry Dashboardaktualisierung

In den folgenden Abschnitten werden die verschiedenen Tasks im Einzelnen beschrieben.

Konfigurations- und Datensynchronisierung

In der Liste „Synchronize config and data“ werden alle Tasks für Konfigurations- und Datensynchronisierungen verwaltet. Ein Task sorgt immer dafür, dass Dateien vom Master auf alle synchronisierten Nodes übertragen werden, solange dies nicht anders konfiguriert ist (dazu noch später). Standardmäßig gibt es einen Task für Konfigurations- und Datensynchronisierung, der alle 15 Minuten ausgeführt wird. Dieser Task ist mit einer gelben Umrahmung gekennzeichnet und kann nicht gelöscht oder verändert werden (ausgenommen „Schedule“ und „Enable/Disable“).

Bei der Konfigurationssynchronisierung werden einerseits Konfigurationsdateien, aber auch Beispielsweise Zertifikate, Lizenzen und Plugins übertragen. Dies sorgt dafür, dass alle für die Konfiguration grundlegend notwendigen Dateien auch auf den synchronisierten Nodes vorhanden sind.

Bei der Datensynchronisierung werden alle Dateien aus /data/apps und /data/resources vom Master auf alle synchronisierten Nodes verteilt.

Mit dem Button „Add Task“ kann ein neuer Synchronisierungstask hinzugefügt werden. Die folgende Tabelle beschreibt die Optionen, die dabei eingestellt werden können.

Indexsynchronisierung

In der Liste „Synchronize indices“ werden alle Tasks für Indexsynchronisierungen verwaltet. Ein Task sorgt immer dafür, dass Indizes von allen Producern auf ihre Consumer übertragen werden. Standardmäßig gibt es einen Task für Indexsynchronisierung, der alle 2 Stunden ein Index-Sync-Delta ausführt. Dieser Task ist mit einer gelben Umrahmung gekennzeichnet und kann nicht gelöscht oder verändert werden (ausgenommen „Schedule“ und „Enable/Disable“).

Zusätzlich zu den Standard-Tasks wird empfohlen, einmal am Tag eine vollständige Index-Synchronisierung („Operation“: „Sync Full“) auf allen Producern durchzuführen, beispielsweise in der Nacht.

Mit dem Button „Add Task“ kann ein neuer Synchronisierungstask hinzugefügt werden. Die folgende Tabelle beschreibt die Optionen, die dabei eingestellt werden können.

app.telemetry Dashboardaktualisierung

Eine Beschreibung dieses Tasks finden Sie in einer separaten Dokumentation hier.

Aktuelle Tasks

In der Liste „Current Tasks“ finden Sie eine Übersicht der Tasks, die gerade laufen oder schon gelaufen sind. Es werden dabei immer nur die Tasks angezeigt, die aktuell laufen oder in den letzten 5 Minuten fertig geworden sind. Dabei werden jedoch maximal 15 Tasks angezeigt.

Wenn ein Task gerade läuft, kann er mit dem Button „Cancel“ abgebrochen werden.

Wenn ein Task nicht mehr läuft, kann er mit dem Button „Rerun“ neu gestartet werden.

Dabei kann ein Task verschiedene Status haben:

• In Progress: Der Task läuft gerade
• Completed: Der Task wurde erfolgreich abgeschlossen
• Failed: Der Task konnte nicht erfolgreich abgeschlossen werden. In den Details finden man die Fehlerbeschreibung.
• Canceled: Der Task wurde abgebrochen (Button „Cancel“)

Task History

Wenn man sich mehr als nur die letzten 15 Tasks aus den „Current Tasks“ anzeigen lassen möchte, kann man die „Task History“ verwenden. Dabei muss zuerst ein Zeitraum ausgewählt werden, indem die anzuzeigenden Tasks stattgefunden haben. Anschließend kann die Task History mit dem Button „Get Task History“ angezeigt werden. Folgende Zeiträume können ausgewählt werden:

Mit dem Button „Previous“ und „Next“ kann auf die vorherige oder nächste Seite Navigiert werden. Zwischen den zwei Buttons wird angezeigt, auf welcher Seite man sich gerade befindet und wie viele Seiten es insgesamt gibt. Ich rechten oberen Bereich (unter „Status“) kann mit der Dropdown-Box nach „Completed“, „Canceled“, „Failed“ und „In Progress“ Tasks gefiltert werden. Mit dem Button „Download Data“ können die Informationen der Tasks (über alle Seiten) als JSON Datei heruntergeladen werden. Mit dem Button „Close“ kann das Fenster wieder geschlossen werden.

Service-Konfiguration im Manager UI

Wie bereits erwähnt, wird die Konfiguration ausschließlich am Master vorgenommen. Um Änderungen vorzunehmen, gehen Sie im Mindbreeze Management Center am Master auf das Menü „Configuration“.

Bitte beachten Sie, dass die Änderungen erst nach einer Konfigurations-Synchronisierung auf den anderen Nodes wirksam werden. Wenn sie nicht auf den nächsten Synchronisierungs-Task warten wollen, können Sie eine Synchronisation manuell starten (siehe Konfigurations- und Datensynchronisierung).

In den folgenden Unterabschnitten wird erklärt, wie Sie die verschiedenen Mindbreeze Inspire Services auf unterschiedliche Nodes konfigurieren können.

Hinweis: Grundsätzlich jedoch sollen nur Master-, synchronisierte und Producer Nodes bei der Konfiguration eines Services ausgewählt werden. Alle Services, die auf den Consumer Nodes laufen sollen, werden beim Synchronisieren der Konfiguration automatisch auf den Consumer Nodes konfiguriert, sodass diese nicht mehr explizit konfiguriert werden müssen. Detaillierte Informationen dazu finden sie in den folgenden Unterabschnitten.

Die folgende Node Konfiguration wird für die nachfolgenden Beispiele verwendet:

• inspirenode2: Master; Producer für inspirenode1
• inspirenode1: Consumer von inspirenode2
• inspirenode3: Producer für inspirenode3
• inspirenode4: Consumer von inspirenode3
• inspirenode5: Agiert als eigenen Producer und Consumer

Index Service

Wenn Sie einen neuen Index im Tab „Indices“ anlegen möchten (mit dem Button „Add Index“), können Sie dort den gewünschten Node in der Dropdown-Box „Index Node“ auswählen. Der Index Service läuft dann auch auf allen Consumer, die der ausgewählte Node (Producer) hat, nachdem die Konfiguration synchronisiert worden ist. Die Datenquelle (Crawler) läuft jedoch dann sinnvollerweise nur am ausgewählten Node (Producer).

Wenn Sie die den Node eines bestehenden Index ändern möchten, können Sie dies beim Index im Abschnitt Setup mit der Dropdown-Box „Index Node“ tun.

Index Layout

Aktivieren sie die „Advanced Settings“, um das „Index Layout“ konfigurieren zu können.

Index Synchronization Settings

Aktivieren Sie die "Erweiterten Einstellungen", um die folgenden Optionen in "Index-Synchronisationseinstellungen" zu konfigurieren:

Service

Wenn Sie einen neuen Service im Tab „Indices“ anlegen möchten, können Sie den Button „Add Service“ klicken und im angelegten Service im Abschnitt „Nodes“ alle Nodes auswählen, auf die der Service laufen soll. Auch hier sollen keine Consumer Node explizit ausgewählt werden, da beim Synchronisieren der Konfiguration der Service auch automatisch beim Consumer startet, falls er für die Suche benötigt wird (z. B. bei Principal Resolution Services).

Filter Service

Wenn Sie einen neuen Filter im Tab „Filters“ anlegen möchten, können Sie den Button „Add Service“ klicken und im angelegten Service im Abschnitt „Nodes“ alle Nodes auswählen, auf die der Service laufen soll. Filter Services laufen nie auf Consumer, da sie nur für das Indizieren gebraucht werden.

Client Service

Wenn Sie einen neuen Client Service im Tab „Client Services“ anlegen möchten (mit dem Button „Add Client Service“), können Sie dort den gewünschten Node in der Dropdown-Box „Node“ auswählen. Der Client Service läuft dann auch auf allen Consumer, die der ausgewählte Node (Producer) hat, nachdem die Konfiguration synchronisiert worden ist.

Troubleshooting

app.telemetry

In der app.telemetry am Master sind alle anderen Nodes als Agents registriert. Dies hat den Vorteil, dass alle Logs von allen Nodes in der app.telemetry (vom Master) verfügbar sind.

Um in einem Log Pool nach einem Agent (= Node) filtern zu können, klicken Sie mit einem Rechtklick auf eine Zelle in der „Agent“-Spalte und wählen Sie „Add Filter“ aus.

Geben Sie den entsprechenden Node Namen ein, nach dem Sie filtern wollen und bestätigen Sie den Filter mit dem Button „Update“.

Indexsynchronisierung wird immer mit Status „Failed“ beendet

Wenn Ihre Indexsynchronisierungs-Tasks („Sync Delta“ oder „Sync Full“) auf einem oder mehreren Indizes immer fehlschlagen (Status „Failed“), kann ein Indexsynchronisierungstask mit der Operation „Sync Forced Full“ helfen. Legen Sie dazu einen neuen „Synchronize indizes“-Task an (Button „Add Task“) und führen Sie folgende Schritte durch:

• Erweiterte Optionen einblenden mit „Show request“
• Wählen Sie bei „Operation“ die Option „Sync Forced Full“ aus
• Optional: Wählen Sie die betroffenen Indizes unter „Services“ aus
• Klicken Sie unter „Schedule“ auf den Button „Run now“
• Klicken Sie unten rechts auf den Button „Close“, damit der Task nicht gespeichert und nur einmalig ausgeführt wird

Entfernen eines Nodes, der offline ist („force remove“)

Es kann sein, dass man einen Node entfernen möchte, der offline ist, wenn z. B. die betroffene Appliance nicht mehr in Verwendung ist und nicht mehr erreichbar ist. Um diesen Node unter „Nodes“ entfernen zu können, klicken Sie auf das Papierkorb-Symbol.

Sie werden mit folgendem Dialog aufgefordert, das Entfernen zu bestätigen: „Caution: This node is synchronized! Are you sure to remove Node inspirenode5.mycompany.com?“

Da der Node gerade nicht erreichbar ist, müssen Sie noch einen zweiten Dialog bestätigen: „Force remove Node inspirenode5.mycompany.com“

Node lässt sich nicht hinzufügen, wenn dieser davor mit „force remove“ entfernt wurde

Möchten Sie einen mit „force remove“ entfernten Node später wieder hinzufügen, kann es sein, dass sich der Node nicht mehr hinzufügen lässt (z. B. wenn sich in der Zwischenzeit der Master geändert hat, während der entfernte Node offline war). In diesem Fall müssen Sie folgende Schritte durchführen:

• Öffnen Sie die „Nodes“ Konfiguration am entfernten Node (nicht am Master!)
• Ein Warnungsdialog mit „Read-Only Mode“ wird angezeigt. Klicken sie im Dialog auf „Continue“
• Öffnen Sie die „Node Properties“ für den entfernten Node („i“-Symbol)
• Klicken Sie auf den Button „Reset this node“
• Öffnen Sie die „Nodes“ Konfiguration am Master
• Sie können den entfernten Node nun wieder hinzufügen

Wechseln des Masters, wenn dieser offline ist

Wenn der Master Node offline ist und in nächster Zeit nicht mehr online kommt, dann können Sie einen anderen Node auswählen, der zum neuen Master werden soll. Führen Sie dabei folgende Schritte aus:

• Öffnen Sie die „Nodes“ Konfiguration am Node, der zum neuen Master werden soll (nicht am momentanen Master!)
• Ein Warnungsdialog mit „Read-Only Mode“ wird angezeigt. Klicken sie im Dialog auf „Continue“
• Öffnen Sie die „Node Properties“ für den Node, den sie zum neuen Master machen wollen („i“-Symbol)
• Klicken Sie auf den Button „Propagate this node as master“

ACHTUNG: Wenn Sie Persisted Resources verwenden, wird die Datenbank für Persisted Resources neu erzeugt, was zu Folge hat, dass Ihre Änderungen verloren gehen. Außerdem müssen Sie Ihre Nodes neu starten, beginnend mit dem neuen Master:

• Öffnen Sie im Management Center das Menü „Services“
• Klicken Sie im Bereich „Nodes“ auf das Zahnradsymbol Ihres Nodes und wählen Sie „Stop“ aus
• Warten Sie, bis der Node gestoppt ist
• Starten Sie den Node wieder mit dem Zahnradsymbol und „Start“
• Wiederholen Sie diese Schritte mit allen Nodes, wobei Sie sich immer im Management Center des jeweiligen Node befinden müssen

Appendix

Überwachung von Tasks in app.telemetry

Das Ausführen von Tasks zur Synchronisierung der Daten, Konfiguration und Indizes kann mit app.telemetry überwacht werden. Tasks legen bei der Ausführung Service Check Dateien an, die mit app.telemetry Health Checks verwendet werden können. In den folgenden Unterabschnitten wird erklärt, welche Konfigurationsschritte für die Überwachung von Tasks nötig sind.

Anlegen der „Service Group“

Navigieren Sie zu Konfiguration der app.telemetry, indem Sie im Mindbreeze Management Center „Reporting“ „Telemetry Details“ „Configuration“ auswählen. Wählen Sie anschließend „Services“ aus und klicken Sie auf den Button „New Service Group“.

Vergeben Sie anschließend einen Namen und bestätigen Sie den Dialog mit „OK“.

Anlegen der „Services“ für jeden Knoten / Agent

Legen Sie in der gerade erstellten Service Group für jeden Master oder Producer Node ein Service an.

Für jedes angelegte „Service“ muss ein Name vergeben werden und der entsprechende Agent ausgewählt werden.

Wenn Sie 2 Producer Knoten haben, sollte Ihre Konfiguration ähnlich dem Screenshot unten sein:

Anlegen der „Service Checks“

Je nach Rolle eines Knotens können verschiedene Service Checks für die verfügbaren Tasks angelegt werden.

Anlegen der „Service Checks“ für den Master Knoten

Zur Überwachung der Daten- und Konfigurationssynchronisierung kann am Master-Knoten ein „Service Check“ angelegt werden.

Wählen Sie „Counter check using file system“ aus und bestätigen Sie Ihre Auswahl mit „Next“.

Wählen Sie „mindbreeze.api.v3.admin.SyncConfigAndData.txt“ als Counter Check File aus und wechseln Sie auf den Tab „Check Properties“.

Vergeben Sie einen Namen und tragen Sie folgende Werte ein:

• Check Interval [sec]*: 60 (es kann auch ein niedrigerer Wert ausgewählt werden)
• Value Expiration Factor: 0
• Warning Limits Numeric Ranges Above (≥): 1
• Critical Limits Numeric Ranges Above (≥): 1

Übernehmen Sie die Konfiguration des „Service Check“ mit dem Button „OK“.

Anlegen der „Service Checks“ für einen Producer Knoten

Zur Überwachung der Indexsynchronisierung auf dem/den Producer-Knoten ein „Service Check“ angelegt werden.

Wählen Sie „Counter check using file system“ aus und bestätigen Sie Ihre Auswahl mit „Next“.

Wählen Sie „mindbreeze.api.v3.admin.SyncIndex.txt“ als Counter Check File aus und wechseln Sie auf den Tab „Check Properties“.

Vergeben Sie einen Namen und tragen Sie folgende Werte ein:

• Check Interval [sec]*: 60 (es kann auch ein niedrigerer Wert ausgewählt werden)
• Value Expiration Factor: 0
• Warning Limits Numeric Ranges Above (≥): 1
• Critical Limits Numeric Ranges Above (≥): 1

Übernehmen Sie die Konfiguration des „Service Check“ mit dem Button „OK“.

Überprüfen des aktuellen Status

Um nun den aktuellen Status der Tasks zu überprüfen, gehen Sie auf „Status“ <konfigurierte Service Group> <konfiguriertes Service> (siehe Screenshot unten).

Update-Hinweise zwischen Image-Versionen (18.x auf 19.0)

Wenn Sie bereits ein Producer-Consumer Setup mit der Image-Version 18.x hatten und auf 19.0 updaten wollen, dann steht dieser Abschnitt für Sie zur Verfügung, um Ihnen bei einem Update auf die neue Version zu helfen.

Wie bereits erwähnt, verteilt der Master die Konfigurationen an alle synchronisierten Knoten. Bitte beachten Sie deshalb, dass die bestehenden Konfigurationen Ihrer anderen Mindbreeze InSpire Appliances nach einer gewissen Zeit überschrieben werden, nachdem sie als synchronisierte Knoten zum Master hinzugefügt worden sind. Falls Sie also auf den betroffenen Mindbreeze InSpire Appliances Konfigurationen haben, die nicht verloren gehen sollen, vergessen Sie nicht, davor ein Backup mit export_managerconfig.sh zu erstellen:

export_managerconfig.sh <backup path>

Bitte beachten Sie, dass das Verzeichnis <backup path> überschrieben wird, wenn es das Verzeichnis bereits gibt. Als Wert für <backup path> eignet sich beispielsweise /config/mesconfig/export.

Die folgenden Abschnitte beschreiben, wie verschiedene Anwendungsfälle in Ihrer vorherigen Version konfiguriert wurden und welche Schritte notwendig sind, diese in der neuen Version zu konfigurieren. Damit so die neuen Features verwendet werden können, ist ein Rückbau von manuellen Anpassungen notwendig.

Synchronisierung der Konfiguration

In Ihrem bisherigen Setup hatten Sie möglicherweise für jeden Consumer einen Cron-Job, der die Synchronisierung der Konfiguration vorgenommen hatte:

#Example: Sync Config to Consumer. Daily. IMPORTANT: replace <target> with hostname of consumer

30 23 * * * mes /opt/mindbreeze/scripts/export-and-sync-masterconfig-to-consumer.sh <target>

Diesen Cron-Job werden Sie in Zukunft nicht mehr benötigen und sollen ihn deswegen auskommentieren oder löschen. Sie müssen im Management-Center lediglich konfigurieren, in welchen Beziehungen Ihre Nodes stehen (Master, Producer, Consumer …), siehe dazu Verwaltung von Nodes. Es wird automatisch ein Task angelegt, der Ihre Konfiguration vom Master Node alle 15 Minuten auf alle nicht Master Nodes synchronisiert.

Synchronisierung der Indizes

In Ihrem bisherigen Setup hatten Sie entweder einen Cron-Job, der die Synchronisierung aller Indizes in einem Script ausgeführt hatte oder für jeden Index einen Cron-Job, der die Synchronisierung der Indizes mit dem Kommandozeilenwerkzeug mescontrol vorgenommen hatte:

#Example: Sync Index with port 23100. Every hour

0 * * * * mes /opt/mindbreeze/bin/mescontrol http://localhost:23100 syncdelta

Diesen Cron-Job werden Sie in Zukunft auch nicht mehr brauchen und sollten ihn deswegen auskommentieren oder löschen. Auch hier wird Ihnen automatisch ein Synchronisierungstask für die Indizes angelegt, nachdem Sie die Beziehungen Ihrer Nodes definiert haben (Master, Producer, Consumer …). Dieser führt standardmäßig die Operation „Sync Delta“ durch und wird alle 2 Stunden ausgeführt.

Konfiguration der Services

Des Weiteren haben Sie in Ihrer bisherigen Konfiguration angegeben, welche Indizes auf welche Consumer synchronisiert werden:

Es wird empfohlen, in der neuen Version nur den Producer Node auszuwählen, da der Index-Service automatisch auf dem/den Consumer Nodes laufen wird. Auch die Option „Sync“ (siehe Screenshot oben) soll nicht mehr verwendet werden.

Bei andere Service Typen (wie z. B. Client Service oder Caching Principal Resolution Services) verhalten sich ähnlich. Welche Services automatisch am Consumer laufen, kann in Abschnitt Service-Konfiguration im Manager UI nachgelesen werden.

Manuelles Anpassen der SSH-Keys

Ein manuelles Anpassen der SSH-Keys ist auf G7-Appliances nicht mehr notwendig.
Zusätzlich ist aus Sicherheitsgründen ein Zugriff über das Managementcenter nicht mehr möglich.