Aplicar una actualización de EasyUC

Para qué sirve

A partir de la versión 4.8.7, una versión de EasyUC se entrega como un único archivo: easyuc-<version>-amd64.eucpkg. Contiene la imagen de contenedor con todos los servicios de la aplicación y la firma. Usted arrastra el archivo a la página EasyUC-Update del Manager. El Manager verifica la firma y el contenido y distribuye la imagen a todos los nodos en segundo plano mientras EasyUC sigue funcionando con normalidad.

El cambio de versión solo comienza con Installieren…: el Manager hace una copia de seguridad de la base de datos, cambia a la nueva versión, ejecuta las migraciones de la base de datos, reinicia los servicios y comprueba cada servicio por separado. Si alguno de estos pasos falla después del cambio, el Manager vuelve por sí solo a la versión anterior.

Esta vía funciona sin acceso a Internet para la appliance. Usted descarga el archivo del portal de clientes en un puesto de trabajo y lo transfiere al Manager desde el navegador. El Manager en sí no se modifica.

Requisitos

EasyUC Manager 1.15.0 o posterior. Los Managers anteriores no tienen la página EasyUC-Update; consulte el capítulo "Actualizar el EasyUC Manager".
EasyUC versión 4.8.5 o posterior instalado. Lleve primero los sistemas anteriores a 4.8.5.
K3s 1.34.0 o posterior, todos los nodos con arquitectura amd64 y en estado Ready.
Almacenamiento libre por nodo: imagen descomprimida más el tamaño del paquete más 5 GiB. La tarjeta de comprobación muestra por nodo cuánto espacio queda hasta el límite.
El archivo de paquete easyuc-<version>-amd64.eucpkg del portal de clientes. Un archivo .sha256 junto a él permite verificar la descarga. Tamaño de un paquete completo: de 1,6 a 2,2 GB aproximadamente; límite de carga de 4 GiB.
Un inicio de sesión en el Manager y la contraseña del Manager. La instalación la solicita de nuevo.
Recomendado: una copia de seguridad completa actual e instantáneas de las VM antes de la ventana de mantenimiento.

Paso a paso: cargar el paquete y dejar que se verifique

Abra la página EasyUC-Update en el Manager. La versión en ejecución se muestra arriba a la derecha, en Installiert.
Arrastre el archivo al área EasyUC-Update-Datei hierher ziehen o seleccione klicken zum Auswählen.
Espere a que termine la carga. La página muestra la cantidad transferida, la velocidad y el tiempo restante. Anhalten la pausa; para reanudarla, arrastre de nuevo el mismo archivo.
Tras la carga aparece la tarjeta de comprobación con "Signatur und Inhalt werden geprüft …". Espere hasta que el estado cambie a geprüft.
En la tarjeta de comprobación, revise Signatur (válida, con el nombre de la clave), la línea sobre el reinicio de Teams/ACD, la indicación sobre Datenbank-Migrationen y las Release Notes.
Observe la tabla Server: columnas Ready, Platz bis zur Grenze y Vorbereitet. La distribución comienza por sí sola. Valor de referencia: unos 15 minutos por nodo, de 45 a 60 minutos con tres nodos.

Paso a paso: instalar

En la tarjeta de comprobación, seleccione Installieren…. Es posible mientras la preparación sigue en curso; la instalación espera entonces hasta que todos los servidores estén preparados.
En el cuadro de diálogo EasyUC <version> installieren, lea Version, Signatur, Paket y Dauer nach dem Klick.
Lea la sección "Unterbrechung aller EasyUC-Dienste" y la sección Ungünstigster Fall.
Introduzca Manager-Passwort. La confirmación es válida durante cinco minutos y solo para esta instalación.
Seleccione Jetzt installieren.
Siga la línea de tiempo: Vorprüfung, Sicherung, Umschalten, Datenbank-Migration, Neustart der Dienste, Prüfung, Fertig. Mientras tanto, la página del Manager sigue accesible.
Espere el mensaje "EasyUC <version> ist installiert, alle Prüfungen sind bestanden." Debajo se muestra la interrupción medida.
Inicie sesión en la interfaz de administración y compruebe las funciones más importantes (inicio de sesión, conexión con CUCM, una llamada de prueba a través de ACD o Teams).

Campos y opciones

Campos y opciones
Campo / acción	Significado y uso
Installiert	Versión de EasyUC en ejecución.
Package state	wird geprüft, geprüft, abgelehnt, Server werden vorbereitet, bereit zur Installation, Vorbereitung unvollständig.
Vorabversion	Marca un paquete del canal de versiones preliminares. Los Managers con la configuración predeterminada no aceptan estos paquetes.
Signatur	"gültig" con nombre y tipo de la clave. Las firmas que no se tienen en cuenta se enumeran debajo con el motivo, por ejemplo "unbekannter Schlüssel".
Teams/ACD-Neustart	"ja": se reinician los medios de ACD, el SBC de Teams o Teams PS, y se cortan las llamadas en curso a través de Teams/ACD. "nein": estos servicios siguen funcionando sin cambios. Con la 4.8.7 se reinician una vez.
Datenbank-Migrationen	"ja": una reversión posterior restablece además la base de datos al estado inmediatamente anterior a la instalación. "nein": la reversión es posible sin la base de datos.
Platz bis zur Grenze	Espacio libre del nodo hasta el uso permitido; al lado, el espacio que necesita la importación.
Vorbereitet	Estado por nodo: en espera, en preparación (con una fase como descarga, comprobación, importación, descompresión), preparado, fallido.
Erneut verteilen	Vuelve a desencadenar la distribución a los nodos que faltan.
Verwerfen	Elimina el paquete y retira de todos los nodos las imágenes que solo pertenecen a este paquete.
Abbrechen (in the run)	Solo es posible antes del cambio de versión. EasyUC permanece entonces sin cambios en la versión anterior.
Ohne Rückkehrmöglichkeit installieren…	Solo aparece cuando faltan las imágenes de la versión instalada en al menos un nodo. En ese caso no hay reversión automática tras un error.
Duration	Según las notas de la versión 4.8.7: instalación de 10 a 20 minutos después del clic, interrupción prevista de 5 a 10 minutos. Con reversión automática, hasta aproximadamente 1 hora y 45 minutos; en el caso extremo, los límites de tiempo permiten unas 4 horas.

Comprobar el resultado y resolver problemas

El área Versionen muestra la nueva versión con "aktuell" y el estado "installiert". La sección "Prüfung je Dienst" muestra cada servicio con su resultado.
"Paket abgelehnt – es wird nicht installiert." con un motivo: la firma, la versión o el contenido no coinciden. Descargue de nuevo el archivo del portal de clientes y compare la suma de comprobación SHA-256.
"… ist keine EasyUC-Update-Datei. Erwartet wird eine Datei easyuc-<version>-amd64.eucpkg aus dem Kundenportal.": se seleccionó un archivo equivocado.
"Nicht genug Platz für das Update: …": al nodo del Manager le falta almacenamiento. Descarte paquetes antiguos o amplíe el disco.
"Vorbereitung unvollständig (n von m Servern)": un nodo no está listo o tiene poco espacio. Lea la causa en la fila del nodo, corríjala y seleccione Erneut verteilen.
"Verteilung pausiert: …": el Manager está esperando, por ejemplo porque un nodo no está listo. La distribución continúa por sí sola.
"Es gibt bereits einen angefangenen Upload … Der Manager nimmt nur einen Upload gleichzeitig an.": arrastre el mismo archivo para reanudar o seleccione Verwerfen.
"Passwort falsch." o "Zu viele Fehlversuche. Bitte in … Sekunden erneut versuchen.": compruebe la contraseña y espere a que termine el bloqueo.
"Installation fehlgeschlagen – vorheriger Stand wiederhergestellt.": el Manager ha revertido automáticamente. El motivo se muestra debajo. En Versionen, Erneut installieren inicia un nuevo intento.
"Fehlgeschlagen – Eingriff nötig.": la página indica los siguientes pasos y los nombres de las copias de seguridad internas. Póngase en contacto con el soporte de EasyUC con esta información.
"EasyUC-Update ist in diesem Manager nicht aktiviert": la función está desactivada en la configuración del Manager.