Installation erster Cluster, Node 1

In diesem Abschnitt wird die Installation des ersten Cluster-Nodes einer neuen CoreBiz-Cluster-Umgebung erläutert.

Mit dieser Installation werden alle Grunddaten dieser neuen CoreBiz-Cluster-Umgebung eingerichtet. Der zweite Node oder weitere Cluster einer Multi-Cluster-Umgebung basieren auf diesem Setup.

Prüfung

Nachdem alle Voraussetzungen erfüllt wurden, kann mit der Installation des ersten Cluster-Nodes begonnen werden.

1. Vorbereitung des Servers

  • Booten Sie den ersten Server so, dass vom Installationsmedium/ISO-Image gebootet wird.

  • Starten Sie den Server. Folgender Bildschirm (Beispiel) wird nach dem Booten des Servers angezeigt:

    Install the Server - first prompt

2. Wahl der Installation

  • Wählen Sie zuerst den Menüpunkt:
    CoreBiz VSB: Virtual Server Base

  • Und im nächsten Bildschirm den folgenden Menüpunkt aus:
    CoreBiz VSB: Virtual Server Base installieren (Default)

    Mit diesem Schritt wird auch die grundlegenden Dienste für den ersten Node installiert und konfiguriert. Dies beinhaltet:

    • VSB

    • DRBD

    • BAS

  • Es kann vorkommen, dass die Installation fehlschlägt, weil die verwendete Hardware des Servers sehr neu ist und der mitgelieferte stabile Ubuntu-Kernel diese noch nicht vollständig unterstützt. In diesem Fall können Sie die Installation mit der HWE-Variante (Hardware Enablement) vornehmen, die einen aktuelleren Kernel bereitstellt.

  • Eine bestehende Default-Installation kann jederzeit zu einer HWE-Installation hochgestuft werden. Hierfür ist lediglich ein Befehl auf der Kommandozeile erforderlich.

    HWE-Installation unter CoreBiz 9.0
    sudo apt-get install --install-recommends linux-generic-hwe-24.04

3. Installation des OS

Nun wird der Server installiert. Dieser Schritt folgt im Wesentlichen der gewohnten Installation von Ubuntu-Distributionen.

  • Wählen Sie die Sprache und die Tastaturkonfiguration der Installation aus.
    Diese Einstellungen müssen bestätigt werden.

  • Definieren Sie jetzt Ihren (Benutzer-)Namen und Ihr Passwort und bestätigen Sie dies.

    • Für die VSB-Installation wird für jeden Cluster-Node ein eigener Benutzer mit einem eigenen Passwort für das Betriebssystem benötigt. Diese Daten sind für jeden Cluster-Node individuell.

    • Benutzer und Passwort bleiben ein wichtiger Bestandteil zur Anmeldung in der Shell an einem virtuellen Gast über VNC. Sollte das Passwort in Vergessenheit geraten, kann es neu gesetzt werden. Für weitere Details siehe die Computer-Verwaltung im Administrationshandbuch.
    Die Eingabe des Servernamens basiert auf dem standardisierten Konfigurationsprozess von Ubuntu und kann frei gewählt werden. Er wird anschließend in der eigentlichen CoreBiz-Konfiguration festgelegt und überschreibt diese Eingabe.

  • Im Bildschirm der SSH-Konfiguration:

    • Es wird dringend empfohlen, den OpenSSH-Server zu installieren.

    • Sollten Sie bereits einen SSH-Key haben, empfiehlt sich der Import eines Public-Keys aus der Liste der möglichen Quellen. Damit kann der Server von Anfang an sicher per SSH mit Key-based Authentication angesprochen werden.

      Public Keys werden in der Regel pro Server vergeben und nicht automatisch an andere Server im Verbund weitergegeben. Lediglich die auf dem ersten Knoten installierte BAS erhält initial die identischen Zugangsdaten wie der VSB.
      Configure SSH

      • Aus sicherheitstechnischen Gründen ist eine Key-based Authentifizierung mit SSH einem Standard-Login vorzuziehen und sollte deshalb unbedingt eingerichtet werden.

      • Im Zuge von cbsetup wird die Kennwortauthentifizierung für SSH deaktiviert. Sie kann jedoch durch eine manuelle Änderung in der CoreBiz Konfiguration wieder aktiviert werden.

    • Man kann einen SSH-Public-Key manuell importieren, am einfachsten über eine SSH-Verbindung mit Kennwortauthentifizierung.

      IP-Adresse abfragen (falls per DHCP vergeben)
      ip addr show
      Von einem Host, der den SSH-Public-Key hat
      ssh-copy-id -i ~/.ssh/<public-key>.pub <user>@<IP-Adresse>

  • Nach Bestätigung dieses Schritts wird der Server installiert. Dies wird durch eine Erfolgsmeldung und weiterführende Informationen angezeigt.

  • Rebooten Sie den Server, sobald die Installation abgeschlossen ist.

    • Bei physischen Servern muss nichts zusätzlich getan werden, da die Bootreihenfolge, wie in den Voraussetzungen erwähnt, bereits festgelegt wurde.

    • Bei virtuellen Maschinen ist dies eventuell anders. Lassen Sie die VM herunterfahren und schalten Sie sie vor dem Reboot aus. Stellen Sie dann die Boot-Reihenfolge wie im Link beschrieben um.

4. Neustart des Servers

Nach der Installation des Betriebssystems bootet der VSB von der HDD.

Das Installationsmedium / ISO-Image muss dabei verbunden bleiben.
Der erste Neustart dieses Cluster-Nodes kann mehrere Minuten dauern. Dies ist normal und kein Grund zur Besorgnis.

5. Erster Login

Nach dem Neustart des Servers erfolgt als nächster Schritt der erste Login.

Das unten beschriebene cbsetup-Kommando kann auf zwei Wegen aufgerufen werden:

  • Über das Terminal des Servers:
    Sollte am Terminal die Anzeige nicht dargestellt werden, drücken Sie CTRL + l (kleines L) oder die Eingabetaste.

  • oder per SSH:
    Wenn während der Ersteinrichtung ein lokaler DHCP-Server vorhanden ist, bezieht der VSB darüber eine temporäre IP-Adresse. Damit kann die Erstkonfiguration bereits per SSH erfolgen. Die dauerhafte IP wird in den ersten Schritten gesetzt; ab dem Zeitpunkt ist auch ohne DHCP eine SSH-Verbindung möglich.

    Hat der VSB eine temporäre IP-Adresse per DHCP erhalten, kann man diese über einen Login am Terminal abfragen. Nach der Erstkonfiguration ist die CoreBiz-Umgebung mit ihren statischen IP-Adressen oder Hostnamen erreichbar.
    CoreBiz-Server
    ip addr show
    Client mit dem Private Key
    ssh <username>@<ip-addresse>
    Wenn bereits einmal eine SSH-Verbindung zu dieser vom DHCP vergebenen IP-Adresse hergestellt wurde, wird auf der Konsole eine Warnung angezeigt. In dem Fall muss man die SSH Known Hosts anpassen.

  • Wenn die Einrichtung direkt per SSH erfolgt, können Texte per Shift + Rechte Maus Taste markiert und mit Shift + Ctrl + c kopiert bzw. mit Shift + Ctrl + v eingefügt werden. Desweiteren ist die Benutzung der Maus zur Auswahl eines Menüpunktes möglich

  • Wenn die Einrichtung an der physischen Konsole oder bei virtuellen Servern beispielsweise mit VNC erfolgt, sind das Markieren, Kopieren und Einfügen von Texten nicht möglich. Dies betrifft ebenfalls die Steuerung mit der Maus. Alle Eingaben müssen daher per Tastatur erfolgen.

Die folgende Beschreibung basiert auf einer Einrichtung per Terminal/SSH, bei der VNC nicht verwendet wird.

6. Das cbsetup-Kommando

Nach der Anmeldung wird eine menügeführte Konfiguration des Servers durchgeführt. Zu den konfigurierten Komponenten gehören unter anderem die zu verwendenden Netzwerkschnittstellen, die IP-Adressen, der Hostname des Nodes, LDAP und SAMBA, DRBD, die BAS und weitere Einstellungen. Notwendige Komponenten werden in diesem Schritt automatisch installiert.

  • Um die Konfiguration zu starten, wird das Setup mit folgendem Kommando gestartet:

    sudo cbsetup

    Die angezeigte Sprache kann für die Konfiguration, welche bei der Installation gewählt wurde, überschrieben werden, sofern eine Übersetzung vorhanden ist. Dazu wird dem Befehl eine Bash-Umgebungsvariable vorangestellt. Hier ein Beispiel für Englisch:

    LANG=en_EN.UTF-8 sudo cbsetup

  • Im folgenden Bildschirm wird ausgewählt, was installiert und konfiguriert werden soll.
    Wählen Sie "Erster Knoten des ersten Clusters".

    Setup Variants

  • Über diesen Menüpunkt werden die Basis-Installation und Basis-Konfiguration einer CoreBiz-Cluster-Umgebung vorgenommen. Die einzelnen Themenblöcke (linke Spalte) müssen vollständig und der Reihe nach abgearbeitet werden.

    Setup of the Basic Tool

  • In der rechten Spalte wird ein ausführliches Protokoll jedes Schritts gezeigt. Zur Dokumentation ist dieses Protokoll auch unter /var/log/corebiz/cbsetup/cbsetup-<Startzeitpunkt>.log zu finden (nur als Administrator lesbar).

6.1. Allgemeine Hinweise

  • Die für die Konfiguration notwendigen und vorbereiteten Daten für Netzwerk- und Clustereinstellungen können in den Voraussetzungen nachgelesen werden.

  • Rekonfiguration:

    • Änderungen am Netzwerk und den Cluster-Parametern können so lange durchgeführt werden, bis der Schritt DRBD-Konfiguration erstellen gestartet wurde. Jede Änderung bedingt, dass alle Schritte bis dorthin wiederholt werden.

    • Nach dem Start von DRBD-Konfiguration erstellen, dürfen keine Änderungen an den Einstellungen mehr vorgenommen werden.
    Nach dem Beenden des gesamten Installationsprozesses wird für jede grundlegende Änderung der Konfiguration ein kompletter Neustart inklusive des Aufspielens des Betriebssystems empfohlen. So wird verhindert, dass mögliche Reste der alten Konfiguration zurückbleiben.

  • Erstellung logischer Volumes:
    Wenn der LVM ein logisches Volume, beispielsweise die des ISO-Images, aufgrund überschrittener Kapazitätsgrenzen nicht erstellen kann, kann die Größe in den Cluster-Parametern nochmals nach unten angepasst werden.

  • Hinweis zu Schritt: BAS als Container starten:
    In diesem Schritt sind Fehlermeldungen im Log, die auftreten, weil ein Daemon nicht gestartet werden kann, prozessbedingt und normal. Sie können ignoriert werden.

7. CMC

Die CMC ist die Anlaufstelle, über die im Regelbetrieb sämtliche Vorgänge gesteuert und weitere Konfigurationen oder Installationen vorgenommen werden können.

7.1. CMC-Login

Nach Abschluss von Installation und Konfiguration ist die CoreBiz Management Console (CMC) per Browser erreichbar. Die URL kann dem cbsetup-Log entnommen werden.

  • User:
    Administrator

  • Password:
    Jenes, das im Schritt Cluster-Parameter vergeben wurde.


Login to CMC

7.2. CMC-Startseite

Nach dem erfolgreichen Login, wird der CMC-Welcome-Screen angezeigt. Von hier aus können Sie weitere Schritte vornehmen.

Beim ersten Login ist als Anzeigesprache die Sprache ausgewählt, die im Browser als bevorzugte Sprache eingestellt ist. Sie können die Sprache aber auch direkt in der CNC ändern (Deutsch und Englisch sind aktuell verfügbar).

EN User Settings DE

CMC Welcome Screen EN

CMC Welcome Screen Settings

CMC Welcome Screen DE
Aus sicherheitstechnischen Überlegungen wird empfohlen, den bestehenden Benutzer Administrator durch einen neuen Benutzer mit Admin-Rechten zu ersetzen.

7.3. CMC Computer

Die mit dem CoreBiz Directory gejointen Hosts sind in der CMC im Abschnitt Computer zu finden. Das sind die BAS und der erste Cluster-Node. Der zweite Cluster-Node ist ebenfalls eingetragen, hat aber als MAC-Adresse nur Nullen und dient der Vorbereitung. Dies ändert sich, sobald die Installation und Konfiguration des zweiten Cluster-Nodes durchgeführt wurden. Dann wird hier die MAC-Adresse des zweiten Nodes angezeigt.

8. Abschluss

Nachdem die Konfiguration dieses Nodes abgeschlossen ist und ein Login in der CMC erfolgreich durchgeführt wurde, ist die Konfiguration vollständig und persistent. Der erste Cluster-Node ist nun einsatzbereit. Ein Neustart ist nicht erforderlich. Durch den letzten Schritt wurden sämtliche temporäre Einstellungen entfernt, inklusive einer per DHCP zugewiesenen IP-Adresse. Ein erneuter Login per SSH ist nun entweder über die statische IP-Adresse oder den Hostnamen des Cluster-Nodes möglich.