Actualización del Sistema
Desde aquí instalas la última versión del facturador, con sus nuevas funciones y correcciones, sin entrar al servidor. Un asistente de 5 pasos revisa que todo esté listo, descarga los cambios y actualiza las bases de datos de tu panel y de todos tus clientes.
Para entrar, haz clic en Actualización en el menú lateral.
- Versión actual (arriba a la derecha): La versión instalada; por ejemplo,
v9.5.0. - Registro de Cambios (Changelog) (a la derecha): Los últimos cambios del sistema, con su fecha.
Advertencia
Antes de actualizar, haz un Backup de las bases de datos. Si algo sale mal, tendrás una copia de tus datos.
Consejo
Actualiza en un horario en que tus clientes no estén trabajando; por ejemplo, de noche. Así, si algo falla, no interrumpes su trabajo.
1. Revisa el servidor
Haz clic en Comenzar Comprobaciones. El sistema revisa que el servidor pueda descargar la nueva versión.
- Token GitLab: La clave de acceso al repositorio (el lugar donde se publica cada versión). Se configura en Configuración › Repositorio remoto; si es la primera vez, sigue el paso a paso.
- Conexión Git: Que el servidor pueda comunicarse con el repositorio.
- Permisos .git (pull): Que el sistema pueda escribir los archivos nuevos. Si falla, el sistema intenta corregirlo solo.
- Repositorio .git: Que la instalación tenga la carpeta de control de versiones.
- Versión detectada: La versión instalada.
- Siguiente: Seleccionar Rama: Se activa cuando las tarjetas 1, 2 y 3 están en verde.
Si una tarjeta sale en rojo, verás "No se cumplen todos los requisitos". Corrige lo que indica la tarjeta y pulsa Comenzar Comprobaciones de nuevo.
Si falla Permisos .git (pull)
Pasa cuando el sistema se instaló con un usuario distinto al del servidor web (por ejemplo, como root). Debajo del aviso verás el comando que lo corrige. Pásaselo a quien administra tu servidor.
Si tu sistema corre en Docker, quien administra el servidor puede ejecutar esto desde el servidor (fuera del contenedor). Hay que reemplazar <contenedor> por el nombre del contenedor php-fpm; por ejemplo, fpm_tu_sistema_com:
docker exec <contenedor> chown -R www-data:www-data /var/www/html
docker exec <contenedor> chmod -R 775 /var/www/html/.git
Solo cambia los permisos de los archivos, no su contenido. Se puede ejecutar con el sistema en uso.
2. Elige la versión
- Rama del Repositorio: La línea de versiones que vas a instalar. Normalmente solo verás
main, la versión estable. Déjala como está, salvo que tu proveedor te indique otra. - Rama Actual en Host: La rama que tiene hoy tu servidor.
- Ejecutar migraciones de base de datos (administrador y tenants): Actualiza las tablas de la base de datos de tu panel y de cada cliente. Viene marcada.
- Actualizar Sistema: Empieza la actualización. Con Regresar vuelves al paso anterior.
Peligro
Deja marcada la casilla de migraciones. Si la desmarcas, se instala el código nuevo pero las bases de datos se quedan como estaban, y el sistema puede fallar al usar las funciones nuevas.
Advertencia
Si eliges una rama distinta de la actual, el sistema te pedirá confirmar con Sí, actualizar. Cambia de rama solo si tu proveedor te lo indicó: una rama equivocada puede instalar una versión de prueba.
3. Espera a que termine
Los pasos 3, 4 y 5 corren solos, uno tras otro:
- Git Pull: Descarga los cambios de la nueva versión.
- Composer: Instala las librerías que necesita el sistema. Si no cambiaron, se salta este paso.
- Artisan: Actualiza las bases de datos y limpia la memoria temporal (caché) del sistema.
En el registro (la ventana negra) ves lo que se va haciendo.
- Registro: Al final dice [ACTUALIZACIÓN COMPLETADA CON ÉXITO].
- Validación post-actualización: Lo que debes revisar ahora (ver abajo).
- Terminar y Reiniciar: Vuelve al paso 1.
Peligro
No cierres ni recargues la página hasta ver ACTUALIZACIÓN COMPLETADA CON ÉXITO. Cada paso lo lanza la página: si la cierras a medias, los pasos que faltan no se ejecutan y el sistema puede quedar con el código nuevo y las bases de datos viejas. Si te pasó, vuelve a hacer la actualización desde el paso 1.
Revisa que todo funcione
- Abre el sistema en el navegador y comprueba que carga sin errores.
- Entra a la cuenta de un cliente y prueba lo más importante: iniciar sesión y emitir un comprobante.
- Comprueba que Versión actual muestra la versión nueva.
Si algo falla
El registro muestra el error en rojo y la actualización se detiene. Los errores más comunes:
- [ERROR Git Pull] con la lista "Archivos locales que impiden la actualización": alguien modificó archivos directamente en el servidor. Pásale la lista a quien administra tu servidor para que guarde o descarte esos cambios, y vuelve a actualizar.
- [ERROR Migraciones…]: una base de datos no se pudo actualizar. Pásale el mensaje a tu proveedor antes de volver a intentarlo. Ten a mano el Backup que hiciste antes.