MPBX-UPGRADE-USAGE | invalid_argument | Línea de comandos incorrecta (salida 2). | Vea mpbx upgrade --help, mpbx config --help, mpbx selftest --help. |
MPBX-UPGRADE-MANIFEST | invalid_argument | Un release.json está mal formado, tiene un formato desconocido, lista más de dos fuentes directas (N-2), lista una fuente que no es más antigua, tiene una referencia de imagen que no es válida, o una versión de destino no tiene contrato de puertos mientras que la instalada sí lo tiene. | Use el paquete tal como se publicó; un manifiesto de versión lo escribe build-bundle.sh, no una persona. |
MPBX-UPGRADE-SAME-VERSION | refusal | El paquete es la versión instalada. | No hay nada que hacer. Para reparar archivos de la misma versión, vuelva a ejecutar el instalador. |
MPBX-UPGRADE-DOWNGRADE | refusal | El paquete es más antiguo que la versión instalada. | Volver atrás es una reversión: mpbx-ctl rollback restaura la copia previa a la actualización. Un binario más antiguo nunca se ejecuta sobre un esquema más nuevo. |
MPBX-UPGRADE-SKIP | refusal | La versión instalada no es una desde la que el destino se actualiza directamente (más de dos versiones atrás, N-2, DECISIONS Round 5). El mensaje indica la versión que debe instalar primero. | Actualice a la versión intermedia indicada y luego al destino. |
MPBX-UPGRADE-CHANNEL | refusal | El destino está en otro canal (stable, beta, nightly) que la instalación. | Pase --allow-channel-change si lo que quiere es cambiar de canal. |
MPBX-UPGRADE-BREAKING-PORTS | refusal | Un puerto predeterminado cambia entre las versiones (PLAT-UPD-007). No declarado: nunca es instalable. Declarado (breaking: ["ports"]): necesita --accept-breaking. | Lea las notas de la versión, actualice los firewalls, troncales y clientes, y luego acepte. |
MPBX-UPGRADE-BREAKING | refusal | El destino declara otros cambios incompatibles. | Lea las notas de la versión y después pase --accept-breaking. |
MPBX-UPGRADE-RELEASE-MISMATCH | refusal | El release.json del paquete no describe la imagen que nombra: hay otra versión de release incorporada en el binario, u otra migración más reciente. | El paquete y images.env no corresponden entre sí; use las imágenes de la versión del paquete. |
MPBX-UPGRADE-SCHEMA-AHEAD | refusal | La base de datos tiene migraciones que el destino no conoce: es más nueva que el destino (una actualización abandonada sin reversión, o un intento de degradar). | Primero revierta la actualización más nueva (mpbx-ctl rollback). |
MPBX-UPGRADE-SCHEMA-MODIFIED | refusal | Una migración aplicada es distinta del archivo del destino (las migraciones solo se agregan). | No instale esta versión sobre esta base de datos; repórtelo. |
MPBX-UPGRADE-SCHEMA-DIRTY | refusal | Una migración quedó registrada como fallida a medias. | Restaure la última copia de seguridad y luego actualice. |
MPBX-UPGRADE-DB-VERSION | refusal | Postgres, ClickHouse o Valkey es más antiguo de lo que admite la versión de destino (requires en su release.json, W7-PLAT-01a). El mensaje indica el servicio, su versión y el mínimo. | Actualice primero ese servicio. Los incluidos vienen con el paquete; uno externo (Kubernetes external-db) lo actualiza quien lo administre. |
MPBX-UPGRADE-CERT-EXPIRED | refusal | Un certificado TLS activo de toda la instalación venció; la actualización reinicia el borde con él. Los certificados de empresa no se verifican. | Renuévelo o suba uno nuevo (consola de administración, Certificados; certificados), o pase --accept-expired-cert si la actualización debe continuar. |
MPBX-UPGRADE-SETTING-REMOVED | refusal | Está definida una variable de entorno que la versión de destino ya no lee (deprecated en su release.json). El mensaje indica qué la reemplaza. | Cambie a la nueva configuración en .env y luego actualice. Una variable solo marcada como obsoleta se lista como nota, no se rechaza. |
MPBX-UPGRADE-DATABASE | unavailable | No se pudo leer Postgres (o ClickHouse) para la verificación, la exportación o la autoprueba. | El mensaje nombra el paso; verifique que las bases de datos estén en ejecución (mpbx-ctl ps). |
MPBX-UPGRADE-EXPORT-DIFFERS | (resultado) | mpbx config export --compare encontró tablas que difieren (salida 1); se listan. Después de una reversión, esto significa que la restauración no devolvió la configuración previa a la actualización. | Revise las tablas listadas. Los datos posteriores a la actualización se conservan en las bases mpbx_pre_rollback_* y en la copia de seguridad de precaución. |
MPBX-UPGRADE-EXPORT-FORMAT | invalid_argument | El archivo que se pasó a --compare no es una exportación de configuración de un formato compatible. | Compare con el config-export.json de la copia. |
MPBX-SELFTEST-FAILED | (resultado) | Falló una verificación de la autoprueba (salida 1); cada línea nombra la verificación. Después de una actualización, el control ofrece la reversión (o la ejecuta con --auto-rollback). | Revise la línea que falla: postgres-login (un inicio de sesión de superusuario o BYPASSRLS: el aislamiento está desactivado), rls-probe (el inicio de sesión ve filas de empresa sin una empresa), postgres-schema, schema-lint, valkey, clickhouse, http, auth-gate, sign-in. |