EasyUC
4.9.49

Installation, Updates & Sicherung

Appliance in Betrieb nehmen

OVA importieren, Netzwerk und Zeit an der Konsole einstellen, K3s initialisieren, Manager öffnen.

EasyUC · Version 4.9.49

In EasyUC: VM-Konsole → Administration → Manage K3s → Initialize K3s (first node)

Wozu dient das

EasyUC wird als virtuelle Appliance (OVA) ausgeliefert. In der VM läuft ein Linux mit einem Textmenü. Über dieses Menü stellen Sie Netzwerk und Zeit ein und starten einmalig Initialize K3s. Dabei entsteht der Kubernetes-Cluster (K3s) mit Speicher, Datenbank-, Such- und Nachrichtendienst-Verwaltung und dem EasyUC Manager.

Die Initialisierung läuft ohne Internetzugang. Die Container-Images liegen bereits in der Appliance. Die eigentliche EasyUC-Anwendung installieren Sie anschließend im Manager, siehe Kapitel „EasyUC installieren und Module wählen“.

Die aktuelle OVA EasyUC-Appliance-Manager-2.0.11-ESXi.ova enthält den EasyUC Manager 2.0.11, aber noch keine EasyUC-Anwendung. Sie laden die OVA im Kundenbereich unter Downloads herunter (siehe „Kundenbereich: Zugang und Downloads“) und installieren EasyUC 4.9.49 nach diesem Kapitel im Manager über EasyUC-Update → Erstinstallation.

Voraussetzungen

  • VMware ESXi. Die OVA wird über „VM aus OVF- oder OVA-Datei erstellen“ importiert; die Portgruppe wählen Sie beim Import.
  • Die OVA legt die VM mit 8 vCPU, 16 GB RAM und 160 GB Datenträger an, möglichst auf SSD. Verkleinern Sie diese Werte nicht. Für Cluster und größere Installationen stimmen Sie die Größe mit EasyUC ab.
  • Feste IP-Adresse, Netzmaske, Gateway und mindestens ein DNS-Server.
  • Eine interne NTP-Zeitquelle, von der VM per UDP 123 erreichbar. Die periodische Zeitsynchronisation der VMware Tools muss ausgeschaltet sein.
  • Zugriff auf die VM-Konsole des Hypervisors. Die Anmeldung erfolgt mit dem Konsolenbenutzer der Appliance; die Zugangsdaten erhalten Sie mit der Lieferung.
  • Die OVA-Datei aus dem Kundenbereich, nach dem Download per SHA-256-Prüfsumme kontrolliert (siehe „Kundenbereich: Zugang und Downloads“).

Schritt für Schritt: OVA importieren und Netzwerk einstellen

  1. Importieren Sie die OVA in ESXi über „VM aus OVF- oder OVA-Datei erstellen“, wählen Sie die Portgruppe und starten Sie die VM.
  2. Öffnen Sie die VM-Konsole und melden Sie sich mit dem Konsolenbenutzer an. Beim ersten Start erscheint First boot setup mit Configure interfaces, NTP Server und Later / continue. Dieselben Einträge finden Sie jederzeit im Main menu unter Administration.
  3. Wählen Sie Configure interfaces (im First boot setup oder unter Administration). Hostname, Domain und DNS stehen im selben Formular.
  4. Wählen Sie die Netzwerkschnittstelle und dann IP Configuration.
  5. Wählen Sie bei Select IP configuration type den Eintrag Manual.
  6. Tragen Sie IP Address, Netmask, Default Gateway, DNS 1 und bei Bedarf DNS 2 ein.
  7. Bestätigen Sie die Abfrage „Do you confirm the IP configuration?“.
  8. Prüfen Sie das Ergebnis mit Show IP Configuration und Ping test.

Schritt für Schritt: Zeitquelle einstellen

  1. Wählen Sie im Menü Administration den Eintrag NTP Server.
  2. Lesen Sie die Statusanzeige (aktive Quellen, Synchronisationszustand, VMware-Zeitsynchronisation, Zustand von K3s/etcd) und bestätigen Sie.
  3. Tragen Sie Ihre interne Zeitquelle ein. Mehrere Quellen trennen Sie mit Leerzeichen oder Komma. Erlaubt sind bis zu acht IPv4-/IPv6-Adressen oder Hostnamen.
  4. Wählen Sie Check sources. Das Menü fragt jede Quelle nur lesend ab und stellt die Uhr dabei nicht.
  5. Aktivieren Sie die Konfiguration, wenn das Menü „All activation gates passed.“ meldet.
  6. Weicht die Uhr einer noch nicht initialisierten Appliance um mehr als 250 ms ab, bietet das Menü einmalig Authorize once an. Diese Ausnahme gibt es nur vor der K3s-Initialisierung.

Schritt für Schritt: K3s initialisieren und Manager öffnen

  1. Wählen Sie Administration → Manage K3s → Initialize K3s (first node). Im First boot setup heißt der Eintrag Initialize K3s (first node of a new cluster).
  2. Prüfen Sie im Dialog Install K3s die Werte Node IP, Interface und Node Name und bestätigen Sie.
  3. Warten Sie auf die Meldung „K3s initialization completed!“. Sie zeigt Knoten und Pods sowie die Anmeldung am Manager: Benutzer admin und ein je Appliance zufällig erzeugtes Anfangspasswort. Das Passwort erscheint im nächsten Fenster und liegt zusätzlich in einer nur für root lesbaren Datei.
  4. Notieren Sie das Anfangspasswort an einem sicheren Ort.
  5. Öffnen Sie im Browser https://<ihre-appliance>/manager. Es erscheint Anmelden mit dem Untertitel Easy-UC Cluster Manager.
  6. Melden Sie sich mit Benutzername admin und dem Anfangspasswort an und wählen Sie Anmelden.
  7. Der Manager verlangt sofort ein eigenes Passwort („Initialpasswort muss geändert werden.“). Tragen Sie Aktuelles Passwort, Neues Passwort und Neues Passwort wiederholen ein und wählen Sie Passwort ändern. Danach löscht die Konsole die Passwortdatei.
  8. Richten Sie bei Bedarf im selben Menü die Zwei-Faktor-Anmeldung ein.
  9. Installieren Sie jetzt EasyUC, siehe „EasyUC installieren und Module wählen“.

Schritt für Schritt: IP-Adresse später ändern (nur Einzelknoten)

  1. Stellen Sie unter Administration → Configure interfaces die neue Adresse ein.
  2. Wählen Sie Administration → Manage K3s → Change K3s IP.
  3. Bestätigen Sie die Abfrage „Reconfigure K3s for new IP address?“. Das Menü legt eine etcd-Sicherung an, stoppt K3s, startet mit der neuen Adresse und stellt die Clusterdaten aus der Sicherung wieder her.
  4. Warten Sie auf „K3s IP change completed“ und passen Sie DNS-Einträge sowie die Ziele im CUCM an die neue Adresse an.

Felder und Optionen

Felder und Optionen
Feld / AktionBedeutung und Verwendung
Show IP Configuration / Show Routing tableZeigt Adressen und Routen der VM.
Configure interfacesNetzwerkschnittstelle aktivieren, deaktivieren und per DHCP (Automatic (DHCP)) oder fest (Manual) einstellen.
NTP ServerInterne Zeitquellen für systemd-timesyncd. Öffentliche Ausweich-Zeitserver sind abgeschaltet. Die Aktivierung ist nur bei einem Knoten oder genau drei Knoten im Cluster zugelassen.
Change passwordsPasswort eines Konsolenbenutzers ändern (mindestens 5 Zeichen).
Internet AccessDirect connection oder HTTP Proxy mit Proxy IP, Proxy Port und optionaler Anmeldung.
Ping testErreichbarkeit eines Hosts prüfen.
Increase disk sizeDateisystem nach einer Vergrößerung des VM-Datenträgers erweitern.
Manage K3sVor der Initialisierung: Initialize K3s (first node), Prepare this node for joining (weiterer Knoten eines Clusters, Kopplung über Knoten hinzufügen im Manager) und Pairing status. Danach: K3s Status, Change K3s IP (nur Einzelknoten), Set EasyUC owner password, Cluster SSH key und Uninstall K3s.
Set EasyUC owner passwordSetzt für das Eigentümerkonto der Admin-Oberfläche ein zufälliges Passwort mit 24 Zeichen und zeigt es einmal an. EasyUC hat kein Standardpasswort.
Uninstall K3sEntfernt K3s samt allen Clusterdaten. Der Image-Bestand der Appliance bleibt erhalten.
Reboot machineStartet die VM neu. K3s und EasyUC starten danach automatisch.

Ergebnis prüfen und Fehler eingrenzen

  • K3s Status zeigt den Knoten mit Zustand Ready. Nicht laufende Pods lassen sich dort zum Neustart löschen.
  • Die Manager-Seite Übersicht zeigt die Karte Knoten mit dem neuen Knoten und dessen Auslastung.
  • „No valid IP address detected. Please configure the network interface first before installing K3s.“: Zuerst die Schnittstelle einstellen.
  • „K3s installed but not ready after 10 minutes.“: Zeit, Datenträger und Netzwerk prüfen; das folgende Fenster zeigt die letzten K3s-Logzeilen. Danach K3s Status erneut aufrufen.
  • „EasyUC cluster is already initialized. Use 'Change K3s IP' if you need to reconfigure.“: Die Appliance ist bereits initialisiert.
  • „ACTIVATION BLOCKED. No service was restarted.“ im NTP-Menü: Eine Prüfung ist nicht bestanden. Die Eingabe lässt sich als vorgemerkte Konfiguration speichern; sie wird auch nach einem Neustart nicht von selbst aktiv.
  • „Multiple nodes detected in the cluster“: Eine IP-Änderung über das Menü ist in Clustern mit mehreren Knoten gesperrt.

Weiterlesen