Saltar al contenido
facturadathium.cloud

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.

Pantalla Actualización del Sistema con la versión actual v9.5.0, el asistente en el paso Validaciones y el Registro de Cambios a la derecha Pantalla Actualización del Sistema con la versión actual v9.5.0, el asistente en el paso Validaciones y el Registro de Cambios a la derecha
  • 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.

Paso 1 Pre-Validaciones del Servidor con las tarjetas Token GitLab (1), Conexión Git (2), Permisos .git (3), Repositorio .git (4) y Versión detectada (5) en verde, y el botón Siguiente: Seleccionar Rama (6) Paso 1 Pre-Validaciones del Servidor con las tarjetas Token GitLab (1), Conexión Git (2), Permisos .git (3), Repositorio .git (4) y Versión detectada (5) en verde, y el botón Siguiente: Seleccionar Rama (6)
  1. 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.
  2. Conexión Git: Que el servidor pueda comunicarse con el repositorio.
  3. Permisos .git (pull): Que el sistema pueda escribir los archivos nuevos. Si falla, el sistema intenta corregirlo solo.
  4. Repositorio .git: Que la instalación tenga la carpeta de control de versiones.
  5. Versión detectada: La versión instalada.
  6. 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

Paso 2 Selección y Cambio de Rama con Rama del Repositorio main (1), Rama Actual en Host (2), la casilla Ejecutar migraciones de base de datos (3) y el botón Actualizar Sistema (4) Paso 2 Selección y Cambio de Rama con Rama del Repositorio main (1), Rama Actual en Host (2), la casilla Ejecutar migraciones de base de datos (3) y el botón Actualizar Sistema (4)
  1. 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.
  2. Rama Actual en Host: La rama que tiene hoy tu servidor.
  3. 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.
  4. 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.

Paso 5 con el log del servidor terminado en ACTUALIZACIÓN COMPLETADA CON ÉXITO (1), el recuadro Validación post-actualización (2) y el botón Terminar y Reiniciar (3) Paso 5 con el log del servidor terminado en ACTUALIZACIÓN COMPLETADA CON ÉXITO (1), el recuadro Validación post-actualización (2) y el botón Terminar y Reiniciar (3)
  1. Registro: Al final dice [ACTUALIZACIÓN COMPLETADA CON ÉXITO].
  2. Validación post-actualización: Lo que debes revisar ahora (ver abajo).
  3. 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

  1. Abre el sistema en el navegador y comprueba que carga sin errores.
  2. Entra a la cuenta de un cliente y prueba lo más importante: iniciar sesión y emitir un comprobante.
  3. 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.