EasyUC
4.9.49

Installation, mises à jour et sauvegarde

Mise en service de l'appliance

Importez l'OVA, configurez le réseau et l'heure sur la console, initialisez K3s et ouvrez le Manager.

EasyUC · Version 4.9.49

Dans EasyUC : Console de la VM → Administration → Manage K3s → Initialize K3s (first node)

À quoi cela sert

EasyUC est livré sous forme d'appliance virtuelle (OVA). La VM fonctionne sous Linux avec un menu texte. Dans ce menu, vous configurez le réseau et l'heure, puis vous exécutez Initialize K3s une seule fois. Cette opération crée le cluster Kubernetes (K3s) avec le stockage, la gestion de la base de données, de la recherche et des services de messagerie, ainsi que l'EasyUC Manager.

L'initialisation s'effectue sans accès à Internet. Les images de conteneurs se trouvent déjà dans l'appliance. Vous installez ensuite l'application EasyUC elle-même dans le Manager, voir le chapitre « Installation d'EasyUC et sélection des modules ».

L'OVA actuelle EasyUC-Appliance-Manager-2.0.11-ESXi.ova contient EasyUC Manager 2.0.11, mais pas encore l'application EasyUC. Téléchargez l'OVA dans l'espace client sous Téléchargements (voir « Espace client : accès et téléchargements ») puis, après ce chapitre, installez EasyUC 4.9.49 dans le Manager via EasyUC-Update → Erstinstallation.

Prérequis

  • VMware ESXi. L'OVA s'importe avec « Créer une VM à partir d'un fichier OVF ou OVA » ; vous choisissez le groupe de ports lors de l'import.
  • L'OVA crée la VM avec 8 vCPU, 16 Go de RAM et un disque de 160 Go, de préférence sur SSD. Ne réduisez pas ces valeurs. Pour les clusters et les installations plus importantes, convenez du dimensionnement avec EasyUC.
  • Une adresse IP fixe, un masque de sous-réseau, une passerelle et au moins un serveur DNS.
  • Une source de temps NTP interne que la VM atteint sur UDP 123. La synchronisation périodique de l'heure par VMware Tools doit être désactivée.
  • Un accès à la console de la VM sur l'hyperviseur. Vous vous connectez avec l'utilisateur de console de l'appliance ; vous recevez les identifiants avec la livraison.
  • Le fichier OVA de l'espace client, vérifié par somme SHA-256 après le téléchargement (voir « Espace client : accès et téléchargements »).

Pas à pas : importer l'OVA et configurer le réseau

  1. Importez l'OVA dans ESXi avec « Créer une VM à partir d'un fichier OVF ou OVA », choisissez le groupe de ports et démarrez la VM.
  2. Ouvrez la console de la VM et connectez-vous avec l'utilisateur de console. Au premier démarrage, First boot setup apparaît avec Configure interfaces, NTP Server et Later / continue. Vous retrouvez les mêmes entrées à tout moment dans le Main menu sous Administration.
  3. Choisissez Configure interfaces (dans First boot setup ou sous Administration). Le nom d'hôte, le domaine et le DNS se trouvent dans le même formulaire.
  4. Sélectionnez l'interface réseau, puis IP Configuration.
  5. Sous Select IP configuration type, sélectionnez Manual.
  6. Saisissez IP Address, Netmask, Default Gateway, DNS 1 et, si nécessaire, DNS 2.
  7. Confirmez la question « Do you confirm the IP configuration? ».
  8. Vérifiez le résultat avec Show IP Configuration et Ping test.

Pas à pas : définir la source de temps

  1. Dans le menu Administration, sélectionnez NTP Server.
  2. Lisez l'affichage d'état (sources actives, état de synchronisation, synchronisation de l'heure par VMware, état de K3s/etcd) et confirmez.
  3. Saisissez votre source de temps interne. Séparez plusieurs sources par des espaces ou des virgules. Jusqu'à huit adresses IPv4/IPv6 ou noms d'hôte sont autorisés.
  4. Sélectionnez Check sources. Le menu interroge chaque source en lecture seule et ne modifie pas l'horloge pendant ce temps.
  5. Activez la configuration lorsque le menu indique « All activation gates passed. »
  6. Si l'horloge d'une appliance non encore initialisée présente un écart de plus de 250 ms, le menu propose Authorize once. Cette exception n'existe qu'avant l'initialisation de K3s.

Pas à pas : initialiser K3s et ouvrir le Manager

  1. Choisissez Administration → Manage K3s → Initialize K3s (first node). Dans First boot setup, l'entrée s'appelle Initialize K3s (first node of a new cluster).
  2. Dans la boîte de dialogue Install K3s, vérifiez Node IP, Interface et Node Name, puis confirmez.
  3. Attendez le message « K3s initialization completed! ». Il affiche les nœuds et les pods ainsi que la connexion au Manager : utilisateur admin et un mot de passe initial généré aléatoirement pour chaque appliance. Le mot de passe apparaît dans la fenêtre suivante et est aussi enregistré dans un fichier lisible uniquement par root.
  4. Notez le mot de passe initial dans un endroit sûr.
  5. Ouvrez https://<votre-appliance>/manager dans le navigateur. La page Anmelden (connexion) apparaît avec le sous-titre Easy-UC Cluster Manager.
  6. Connectez-vous avec Benutzername (nom d'utilisateur) admin et le mot de passe initial, puis choisissez Anmelden.
  7. Le Manager demande immédiatement votre propre mot de passe (« Initialpasswort muss geändert werden. »). Saisissez Aktuelles Passwort, Neues Passwort et Neues Passwort wiederholen, puis choisissez Passwort ändern. La console supprime ensuite le fichier du mot de passe.
  8. Si nécessaire, configurez Zwei-Faktor-Anmeldung dans le même menu.
  9. Installez maintenant EasyUC, voir « Installation d'EasyUC et sélection des modules ».

Pas à pas : modifier l'adresse IP ultérieurement (nœud unique uniquement)

  1. Définissez la nouvelle adresse sous Administration → Configure interfaces.
  2. Sélectionnez Administration → Manage K3s → Change K3s IP.
  3. Confirmez la question « Reconfigure K3s for new IP address? ». Le menu crée une sauvegarde etcd, arrête K3s, le redémarre avec la nouvelle adresse et restaure les données du cluster à partir de la sauvegarde.
  4. Attendez « K3s IP change completed », puis adaptez les enregistrements DNS et les cibles dans CUCM à la nouvelle adresse.

Champs et options

Champs et options
Champ / actionSignification et utilisation
Show IP Configuration / Show Routing tableAffiche les adresses et les routes de la VM.
Configure interfacesActive ou désactive l'interface réseau et la configure par DHCP (Automatic (DHCP)) ou de manière statique (Manual).
NTP ServerSources de temps internes pour systemd-timesyncd. Les serveurs de temps publics de secours sont désactivés. L'activation n'est autorisée qu'avec un nœud ou exactement trois nœuds dans le cluster.
Change passwordsModifie le mot de passe d'un utilisateur de console (au moins 5 caractères).
Internet AccessDirect connection ou HTTP Proxy avec Proxy IP, Proxy Port et authentification facultative.
Ping testVérifie si un hôte est joignable.
Increase disk sizeÉtend le système de fichiers après l'agrandissement du disque de la VM.
Manage K3sAvant l'initialisation : Initialize K3s (first node), Prepare this node for joining (nœud supplémentaire d'un cluster, appairé via Knoten hinzufügen dans le Manager) et Pairing status. Ensuite : K3s Status, Change K3s IP (nœud unique uniquement), Set EasyUC owner password, Cluster SSH key et Uninstall K3s.
Set EasyUC owner passwordDéfinit un mot de passe aléatoire de 24 caractères pour le compte propriétaire de l'interface d'administration et l'affiche une seule fois. EasyUC n'a pas de mot de passe par défaut.
Uninstall K3sSupprime K3s avec toutes les données du cluster. Le magasin d'images de l'appliance est conservé.
Reboot machineRedémarre la VM. K3s et EasyUC démarrent ensuite automatiquement.

Vérifier le résultat et résoudre les problèmes

  • K3s Status affiche le nœud à l'état Ready. Les pods qui ne sont pas en cours d'exécution peuvent y être supprimés afin d'être redémarrés.
  • La page Übersicht du Manager affiche la carte Knoten avec le nouveau nœud et sa charge.
  • « No valid IP address detected. Please configure the network interface first before installing K3s. » : configurez d'abord l'interface.
  • « K3s installed but not ready after 10 minutes. » : vérifiez l'heure, le disque et le réseau ; la fenêtre suivante affiche les dernières lignes du journal K3s. Ouvrez ensuite de nouveau K3s Status.
  • « EasyUC cluster is already initialized. Use 'Change K3s IP' if you need to reconfigure. » : l'appliance est déjà initialisée.
  • « ACTIVATION BLOCKED. No service was restarted. » dans le menu NTP : une vérification a échoué. L'entrée peut être enregistrée comme configuration en attente ; elle ne devient pas active d'elle-même, même après un redémarrage.
  • « Multiple nodes detected in the cluster » : la modification de l'adresse IP via le menu est bloquée dans les clusters comportant plusieurs nœuds.

Chapitres associés