Actualizaciones
MonoPbx comprueba por sí solo si hay una versión nueva y, en la mayoría de las instalaciones, puede actualizarse con un botón. Esta página explica qué hace la comprobación, qué hace el botón y qué ejecutar a mano cuando no hay botón.
Ver si hay una actualización
Abra Sistema, Actualizaciones (/admin/upgrades, administradores del sistema). La tarjeta Actualización del software muestra una de estas respuestas:
- Está al día (1.2.0).
- La versión 1.3.0 está disponible (instalada: 1.2.0). con un enlace a las Notas de la versión.
- La búsqueda de actualizaciones está desactivada. (véase «Instalaciones sin internet» más abajo).
- Un motivo breve cuando no se pudo conectar con el canal de versiones.
La PBX busca una vez al día, y Comprobar ahora busca de inmediato. La comprobación solo lee un archivo público pequeño (release.json) del canal de versiones. No instala nada y no envía nada sobre su instalación ni sobre sus llamadas. Mientras haya una versión nueva, la entrada Actualizaciones del menú de la consola muestra una marca Novedad.
El canal (stable, beta o nightly) es aquel con el que se hizo la instalación.
Actualizar con un clic
Pulse Actualizar ahora. La ventana explica qué va a pasar:
- Primero se hace una copia de seguridad completa (una instantánea), para que siempre pueda volver atrás.
- La versión nueva se descarga, se comprueba y se inicia, y debe superar su autoprueba.
- Si la autoprueba falla, MonoPbx vuelve solo a la versión anterior, con los datos de antes de la actualización.
La PBX queda fuera de línea unos minutos y las llamadas en curso terminan, así que elija un momento tranquilo. La consola se desconecta mientras se reinicia; la página sigue preguntando y muestra los pasos: solicitada, descarga, comprobación, copia de seguridad, instalación, inicio y actualización de los datos, autoprueba. Al terminar verá uno de tres resultados:
| Resultado | Significado |
|---|---|
| Se actualizó a 1.3.0 | La versión nueva funciona y superó su autoprueba. |
| La actualización no superó su autoprueba | La versión anterior vuelve a funcionar con los datos de antes de la actualización. No se pierde nada. Consulte a soporte, con el paquete de soporte, antes de intentarlo de nuevo. |
| La actualización no se completó | Se muestra el motivo. Si dice que no se cambió nada, la versión anterior sigue funcionando. |
Necesita el permiso system.operations:write (System Owner). Cada solicitud queda registrada en el registro de auditoría (upgrade.requested). Tras una actualización correcta la instantánea se conserva, así que Revertir en la misma página sigue disponible.
Cuando no hay botón
El botón solo aparece cuando la versión puede instalarse directamente (como máximo dos versiones atrás, el mismo canal, sin cambios incompatibles declarados) y esta instalación puede actualizarse sola. En otro caso la página muestra Actualizar desde la línea de comandos con el comando exacto y explica por qué:
| Su instalación | Actualización con un clic | Qué ejecutar |
|---|---|---|
| Instalador de VM o paquete Debian | Sí, a partir de la segunda actualización (la primera después de instalar una versión anterior a esta función se hace a mano y la deja preparada). | sudo mpbx-ctl upgrade --channel stable |
Docker Compose sin la herramienta del host (mpbx-ctl) | No | El comando que muestra la página: necesita mpbx-ctl del paquete de Compose. |
| Kubernetes | No | deploy/k8s/scripts/upgrade.sh upgrade --overlay overlays/SU-OVERLAY --release release.json; la página muestra la línea completa, incluida la descarga de release.json. |
Una versión que requiere su decisión (un cambio incompatible, más de dos versiones o otro canal) se muestra con sus motivos y nunca se inicia desde la consola. Lea sus notas de la versión y actualice desde la línea de comandos con la opción que indiquen.
Instalaciones sin internet
Una instalación sin acceso a internet puede desactivar la comprobación: ponga MPBX_UPDATE_CHECK=off en el archivo .env de la instalación (instalador de VM: /opt/mpbx/compose/prod/.env) y ejecute sudo mpbx-ctl up; en Kubernetes defínalo como variable de entorno del Deployment mpbx-api. La página dirá entonces La búsqueda de actualizaciones está desactivada y nada sale del host. Actualice una instalación así con un paquete que haya copiado: sudo mpbx-ctl upgrade <mpbx-bundle.tar.gz>.
Si aloja una copia del canal de versiones dentro de su red, ponga su dirección (https://...) en MPBX_UPDATE_BASE_URL y, si hace falta, MPBX_UPDATE_CHANNEL.
Actualizaciones programadas
Para que la instalación se actualice sola en una ventana de mantenimiento, consulte «Actualizaciones automáticas programadas» en la guía de actualización (mpbx-ctl auto-update). La página Actualizaciones muestra su programación y cómo terminó la última ejecución.
Revertir
Antes de cada actualización el host guarda una instantánea. Revertir (en la misma página) restaura la versión y los datos de una instantánea; para confirmar escriba el id de la instantánea. Todo lo escrito desde entonces sale del sistema en ejecución, pero se conserva en las bases de datos que la reversión renombra; no se elimina nada.