Application d'une mise à jour d'EasyUC

À quoi cela sert

À partir de la version 4.8.7, une version d'EasyUC se présente sous la forme d'un fichier unique : easyuc-<version>-amd64.eucpkg. Il contient l'image de conteneur avec tous les services applicatifs et la signature. Vous déposez le fichier sur la page EasyUC-Update du Manager. Le Manager vérifie la signature et le contenu, puis distribue l'image à tous les nœuds en arrière-plan, tandis qu'EasyUC continue de fonctionner normalement.

La bascule ne démarre qu'avec Installieren… : le Manager sauvegarde la base de données, bascule vers la nouvelle version, exécute les migrations de base de données, redémarre les services et contrôle chaque service individuellement. Si l'une de ces étapes échoue après la bascule, le Manager revient de lui-même à la version précédente.

Ce chemin fonctionne sans accès à Internet pour l'appliance. Vous téléchargez le fichier depuis le portail client sur un poste de travail et le transférez au Manager dans le navigateur. Le Manager lui-même n'est pas modifié.

Prérequis

EasyUC Manager 1.15.0 ou version ultérieure. Les Managers plus anciens n'ont pas la page EasyUC-Update, voir le chapitre « Mise à jour de l'EasyUC Manager ».
Version d'EasyUC installée 4.8.5 ou ultérieure. Portez d'abord les systèmes plus anciens en 4.8.5.
K3s 1.34.0 ou ultérieur, tous les nœuds avec architecture amd64 et à l'état Ready.
Espace de stockage libre par nœud : image décompressée, plus la taille du paquet, plus 5 GiB. La carte de contrôle indique par nœud l'espace restant jusqu'à la limite.
Le fichier de paquet easyuc-<version>-amd64.eucpkg du portail client. Un fichier .sha256 à côté permet de vérifier le téléchargement. Taille d'un paquet complet : environ 1,6 à 2,2 Go ; limite de téléversement 4 GiB.
Une connexion au Manager et le mot de passe du Manager. L'installation le redemande.
Recommandé : une sauvegarde complète récente et des snapshots de VM avant la fenêtre de maintenance.

Pas à pas : téléverser le paquet et le faire vérifier

Ouvrez la page EasyUC-Update dans le Manager. La version en cours d'exécution est affichée en haut à droite sous Installiert.
Glissez le fichier sur la zone EasyUC-Update-Datei hierher ziehen ou sélectionnez klicken zum Auswählen.
Attendez la fin du téléversement. La page affiche la quantité transférée, la vitesse et le temps restant. Anhalten le met en pause ; pour le reprendre, déposez de nouveau le même fichier.
Après le téléversement, la carte de contrôle apparaît avec « Signatur und Inhalt werden geprüft … ». Attendez que l'état passe à geprüft.
Sur la carte de contrôle, examinez Signatur (valide, avec le nom de la clé), la ligne relative au redémarrage de Teams/ACD, l'indication sur les Datenbank-Migrationen et les Release Notes.
Surveillez le tableau Server : colonnes Ready, Platz bis zur Grenze et Vorbereitet. La distribution démarre d'elle-même. Valeur indicative : environ 15 minutes par nœud, 45 à 60 minutes avec trois nœuds.

Pas à pas : installer

Sur la carte de contrôle, sélectionnez Installieren…. Cela est possible pendant que la préparation est encore en cours ; l'installation attend alors que tous les serveurs soient préparés.
Dans la boîte de dialogue EasyUC <version> installieren, lisez Version, Signatur, Paket et Dauer nach dem Klick.
Lisez la section « Unterbrechung aller EasyUC-Dienste » et la section Ungünstigster Fall.
Saisissez le Manager-Passwort. La confirmation est valable cinq minutes et uniquement pour cette installation.
Sélectionnez Jetzt installieren.
Suivez la chronologie : Vorprüfung, Sicherung, Umschalten, Datenbank-Migration, Neustart der Dienste, Prüfung, Fertig. La page du Manager reste accessible pendant ce temps.
Attendez le message « EasyUC <version> ist installiert, alle Prüfungen sind bestanden. » L'interruption mesurée est affichée en dessous.
Connectez-vous à l'interface d'administration et vérifiez les fonctions les plus importantes (connexion, connexion CUCM, un appel de test via ACD ou Teams).

Champs et options

Champs et options
Champ / action	Signification et utilisation
Installiert	Version d'EasyUC en cours d'exécution.
Package state	wird geprüft, geprüft, abgelehnt, Server werden vorbereitet, bereit zur Installation, Vorbereitung unvollständig.
Vorabversion	Désigne un paquet du canal de préversion. Les Managers avec les paramètres par défaut n'acceptent pas de tels paquets.
Signatur	« gültig » avec le nom et le type de la clé. Les signatures non prises en compte sont listées en dessous avec le motif, par exemple « unbekannter Schlüssel ».
Teams/ACD-Neustart	« ja » : les médias ACD, le SBC Teams ou Teams PS redémarrent, et les appels en cours via Teams/ACD sont coupés. « nein » : ces services continuent de fonctionner sans changement. Avec 4.8.7, ils redémarrent une fois.
Datenbank-Migrationen	« ja » : un retour arrière ultérieur réinitialise aussi la base de données à l'état précédant immédiatement l'installation. « nein » : le retour arrière est possible sans la base de données.
Platz bis zur Grenze	Espace libre du nœud jusqu'à l'utilisation autorisée ; à côté, l'espace dont l'import a besoin.
Vorbereitet	État par nœud : en attente, en préparation (avec une phase telle que téléchargement, vérification, import, décompression), préparé, échoué.
Erneut verteilen	Relance la distribution vers les nœuds manquants.
Verwerfen	Supprime le paquet et retire de tous les nœuds les images qui n'appartiennent qu'à ce paquet.
Abbrechen (im Lauf)	Possible uniquement avant la bascule. EasyUC reste alors inchangé dans la version précédente.
Ohne Rückkehrmöglichkeit installieren…	N'apparaît que si les images de la version installée manquent sur au moins un nœud. Dans ce cas, il n'y a pas de retour arrière automatique après une erreur.
Duration	Selon les notes de version 4.8.7 : installation de 10 à 20 minutes après le clic, interruption attendue de 5 à 10 minutes. Avec retour arrière automatique, jusqu'à environ 1 heure 45 ; dans le cas extrême, les limites de temps permettent environ 4 heures.

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

La zone Versionen liste la nouvelle version avec « aktuell » et l'état « installiert ». La section « Prüfung je Dienst » affiche chaque service avec son résultat.
« Paket abgelehnt – es wird nicht installiert. » avec un motif : la signature, la version ou le contenu ne correspondent pas. Téléchargez de nouveau le fichier depuis le portail client et comparez la somme de contrôle SHA-256.
« … ist keine EasyUC-Update-Datei. Erwartet wird eine Datei easyuc-<version>-amd64.eucpkg aus dem Kundenportal. » : le mauvais fichier a été sélectionné.
« Nicht genug Platz für das Update: … » : le nœud du Manager manque d'espace de stockage. Supprimez les anciens paquets ou agrandissez le disque.
« Vorbereitung unvollständig (n von m Servern) » : un nœud n'est pas prêt ou manque d'espace. Lisez la cause dans la ligne du nœud, corrigez-la et sélectionnez Erneut verteilen.
« Verteilung pausiert: … » : le Manager attend, par exemple parce qu'un nœud n'est pas prêt. La distribution reprend d'elle-même.
« Es gibt bereits einen angefangenen Upload … Der Manager nimmt nur einen Upload gleichzeitig an. » : déposez le même fichier pour reprendre ou sélectionnez Verwerfen.
« Passwort falsch. » ou « Zu viele Fehlversuche. Bitte in … Sekunden erneut versuchen. » : vérifiez le mot de passe et attendez la fin du verrouillage.
« Installation fehlgeschlagen – vorheriger Stand wiederhergestellt. » : le Manager est revenu en arrière automatiquement. Le motif est affiché en dessous. Sous Versionen, Erneut installieren lance une nouvelle tentative.
« Fehlgeschlagen – Eingriff nötig. » : la page indique les étapes suivantes et les noms des sauvegardes internes. Contactez le support EasyUC avec ces informations.
« EasyUC-Update ist in diesem Manager nicht aktiviert » : la fonction est désactivée dans la configuration du Manager.