Diagnóstico con check.sh
Revise todos los componentes del servidor de HWD POS y repare lo que falte o esté mal configurado.
Qué hace check.sh
check.sh revisa los componentes principales de un servidor de HWD POS, muestra un informe ✓ / ✗ y después permite instalar o reparar los que falten o estén mal configurados. Es útil cuando una instalación quedó a medias o cuando alguien cambió la configuración del servidor.
Puede ejecutarse tantas veces como quiera: no borra datos.
Cómo ejecutarlo
Puede ejecutar la copia local que el instalador deja en el servidor o la versión publicada directamente desde la red.
sudo bash /var/www/HWDPOS/deploy/check.shAmbas formas muestran el informe y abren el menú de reparación.
Solo el informe (sin cambiar nada)
Con CHECK_ONLY=1 se ve el diagnóstico sin instalar ni modificar nada:
# Copia local
sudo CHECK_ONLY=1 bash /var/www/HWDPOS/deploy/check.sh
# Desde la red
curl -fsSL https://3r.com.pa/hwdpos_inst/check.sh | sudo CHECK_ONLY=1 bashTambién puede lanzarlo desde el panel del servidor: sudo hwdpanel → opción 10) Diagnóstico (check.sh). Consulte hwdpanel.
Qué revisa
- PHP y sus extensiones.
- La versión de PHP-FPM que realmente está en uso (no solo el comando
phpdel terminal). - MariaDB.
- El servidor web (Apache o Nginx) y la configuración del sitio.
- La base de datos de HWD POS.
- CUPS.
- Chrome/Chromium (lo ejecuta como el usuario web para confirmar que de verdad funciona).
- El worker de impresión
hwpos-printy el worker de complementos. - El panel local
hwdpanel. - El código de HWD POS.
- El puerto del sitio: el que está configurado, sin suponer que es el 80.
El menú de reparación
Después del informe aparece un menú con los componentes. Tras cada instalación se vuelve a revisar todo.
| Tecla | Acción |
|---|---|
| Un número | Instala o repara ese componente. |
| T | Instala o repara todo lo que falte. |
| U | Actualiza el panel hwdpanel desde la red. |
| S | Salir. |
Si el comando hwdpanel no existe (por ejemplo, tras una instalación parcial), check.sh lo reinstala desde la opción del panel de administración.
Actualizar hwdpanel
check.sh también puede actualizar el panel directamente:
sudo bash /var/www/HWDPOS/deploy/check.sh --update-panelAntes de sustituir la copia local crea una copia de seguridad .bak, comprueba la sintaxis del archivo nuevo y solo reemplaza la versión local si la comprobación es correcta.
Modos de instalación
check.sh detecta el modo del servidor (todo en uno, solo web o solo base de datos) según lo que está instalado y ajusta las comprobaciones:
- En un servidor solo web no marca como error la ausencia de MariaDB local; prueba la base de datos remota. Indique su dirección con
DB_HOST=<ip>. - En un servidor solo base de datos revisa MariaDB y que escuche en el puerto 3306.
Puede forzar el modo con MODE=web, MODE=db o MODE=all:
sudo MODE=web DB_HOST=10.0.0.5 bash /var/www/HWDPOS/deploy/check.shOtras variables que acepta: PHP_VER, APP_DIR, DB_NAME, DB_USER, DOMAIN. Consulte Variables del instalador.
Ubuntu/Debian frente a AlmaLinux
check.sh funciona en las dos familias admitidas:
| Ubuntu / Debian | AlmaLinux / Rocky / RHEL / CentOS | |
|---|---|---|
| Comprobación de paquetes | dpkg (p. ej. php8.3-fpm, phpX.Y-<extension>) | rpm (un único php-fpm; pdo_mysql viene dentro de php-mysqlnd) |
| Reparación | Instala con apt | Ejecuta install-almalinux.sh, que además deja SELinux y el cortafuegos en su sitio |
Si check.sh marcaba ✗ en todo en Rocky/Alma/CentOS, estaba usando una versión anterior que consultaba los paquetes con dpkg. Vuelva a descargarlo; la versión actual usa rpm.