Appliance in Betrieb nehmen

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

Laut Release Notes 4.8.7 gibt es noch keine OVA mit Stand 4.8.7. Eine neue Appliance wird mit der gelieferten OVA und der Installations-YAML aufgesetzt und danach über EasyUC-Update auf 4.8.7 gebracht.

Voraussetzungen

• Hypervisor mit OVA-Import (VMware vSphere/ESXi; andere Hypervisoren über Import des Datenträgers).
• Richtwert für eine einzelne VM: 4 vCPU (8 empfohlen), 8 GB RAM (16 GB empfohlen), 100 GB Datenträger, möglichst SSD. 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.

Schritt für Schritt: OVA importieren und Netzwerk einstellen

1. Importieren Sie die OVA in Ihren Hypervisor und starten Sie die VM.
2. Öffnen Sie die VM-Konsole und melden Sie sich mit dem Konsolenbenutzer an. Es erscheint das Main menu mit Administration und Setup Wizzard.
3. Wählen Sie Administration und dort Configure interfaces.
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.
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, Anzahl der Pods und das Anfangspasswort des Managers. Es wird je Appliance zufällig erzeugt und zusätzlich in einer nur für root lesbaren Datei abgelegt.
4. Notieren Sie das Anfangspasswort an einem sicheren Ort.
5. Öffnen Sie im Browser https://<ihre-appliance>/manager. Es erscheint die Anmeldung Easy-UC Cluster Manager.
6. Melden Sie sich mit Username und Password an und wählen Sie Sign In.
7. Öffnen Sie oben rechts das Benutzermenü und wählen Sie Passwort ändern. Tragen Sie Current Password, New Password und Retype New Password ein und bestätigen Sie mit Change Password.
8. Richten Sie bei Bedarf im selben Menü die Zwei-Faktor-Anmeldung ein.

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

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 3 minutes.“: Zeit, Datenträger und Netzwerk prüfen, 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.