Mise en service de l'appliance

À 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 ».

Selon les notes de version 4.8.7, il n'existe pas encore d'OVA au niveau 4.8.7. Une nouvelle appliance est mise en place avec l'OVA fournie et le YAML d'installation, puis portée en 4.8.7 avec EasyUC-Update.

Prérequis

• Un hyperviseur avec import d'OVA (VMware vSphere/ESXi ; autres hyperviseurs par import du disque).
• Valeurs indicatives pour une VM unique : 4 vCPU (8 recommandés), 8 Go de RAM (16 Go recommandés), disque de 100 Go, SSD si possible. 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.

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

1. Importez l'OVA dans votre hyperviseur et démarrez la VM.
2. Ouvrez la console de la VM et connectez-vous avec l'utilisateur de console. Le Main menu apparaît avec Administration et Setup Wizzard.
3. Sélectionnez Administration, puis Configure interfaces.
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. Sélectionnez Administration → Manage K3s → Initialize K3s.
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, le nombre de pods et le mot de passe initial du Manager. Le mot de passe est généré aléatoirement pour chaque appliance et il est également enregistré dans un fichier que seul root peut lire.
4. Notez le mot de passe initial dans un endroit sûr.
5. Ouvrez https://<your-appliance>/manager dans le navigateur. La page de connexion Easy-UC Cluster Manager s'affiche.
6. Connectez-vous avec Username et Password, puis sélectionnez Sign In.
7. Ouvrez le menu utilisateur en haut à droite et sélectionnez Passwort ändern. Saisissez Current Password, New Password et Retype New Password, puis confirmez avec Change Password.
8. Si nécessaire, configurez Zwei-Faktor-Anmeldung dans le même menu.

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

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 3 minutes. » : vérifiez l'heure, le disque et le réseau, puis ouvrez 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.