NetWispDOCS
Primeros pasos

Actualizar el panel a la última versión

Cómo ver si salió versión nueva, qué hace el botón de actualizar y qué mirar si la actualización no termina bien.

Menú Configuración, tarjeta Sistema · Actualizar. La tarjeta Versión y actualizaciones te dice en qué Versión estás, en qué Modo corre, qué Base de datos usa y cuánto Disco libre te queda.

## Ver si hay versión nueva

Al abrir esa pantalla el panel le pregunta al canal en ese momento, no te sirve lo de hace rato. Debajo de los recuadros sale uno verde si estás al día, o uno ámbar con la versión nueva y, si el canal las trae, sus notas.

  1. Pulsa Comprobar ahora, arriba a la derecha de la tarjeta, cuando quieras volver a preguntar.
  2. Te contesta en pantalla: o hay versión nueva, o ya estás en la última.
  3. Si no hay canal, ahí dirá Sin canal de actualización configurado. Si el canal no contesta, te avisa que no se pudo consultar.

## Actualizar

  1. Primero, en la tarjeta Respaldos de la base de datos, pulsa Crear respaldo.
  2. Vuelve arriba y pulsa Actualizar ahora, el botón ámbar del recuadro.
  3. Confirma. Deja la pestaña abierta: el panel vigila la versión y se recarga solo al terminar.
  4. Si aparece un momento Actualizando el panel…, es parte del proceso, reintenta solo.

## Qué pasa por dentro

  1. Se lee el aviso de versión del canal y se verifica su firma antes de usar ningún dato suyo. Si la firma no valida, se aborta y no se toca nada.
  2. Se descarga el paquete y se compara su huella sha256 con la del aviso firmado.
  3. Se respaldan la base de datos y el código que tienes puesto.
  4. Se instala el código nuevo, se aplican las migraciones, se limpia lo compilado y se recarga php-fpm.
  5. Se comprueba la salud del panel contra este mismo servidor, no contra la URL pública. Si no responde, repone el código anterior y vuelve a comprobar.

Tu .env, tus dependencias, tus archivos subidos y tus datos no se tocan.

## Automática o a mano

Debajo está la casilla Actualización automática, que revisa cada 6 horas. Desmárcala si prefieres decidir tú cuándo se actualiza; el botón sigue funcionando igual.

## Si no termina bien

  1. Si sale que la actualización está tardando más de lo normal, recarga en un rato y mira el recuadro Versión.
  2. El detalle queda en el servidor: en api/storage/logs/update-manual.log cuando lo lanzas con el botón, y en api/storage/logs/update.log cuando corre solo.
  3. Si el recuadro ámbar no trae botón, esa instalación es Docker o manual y se actualiza publicando la imagen o con git pull más las migraciones.