Preguntas frecuentes
Respuestas breves a las preguntas más habituales sobre la instalación y el uso de un servidor de HWD POS.
Cuentas y acceso
En el servidor, abra el panel y elija la opción 7 (Restablecer contraseña); después seleccione el usuario e introduzca la nueva contraseña:
sudo hwdpanelTambién puede usar directamente la herramienta administrativa:
php /var/www/HWDPOS/scripts/hwd-admin.php list-users
php /var/www/HWDPOS/scripts/hwd-admin.php reset-password <usuario>El segundo comando pide la nueva contraseña de forma interactiva. Consulte hwdpanel.
La genera el instalador y la guarda en un archivo que solo puede leer root:
sudo cat /var/www/HWDPOS/deploy/DB-CREDENTIALS.txtEn un servidor de solo base de datos no hay carpeta del sistema, así que está en /root/HWDPOS-DB-CREDENTIALS.txt. También puede verla con sudo hwdpanel → opción 8 (Credenciales BD).
Instalación
Si todavía puede elegir, use Ubuntu Server 24.04 LTS: es el sistema sobre el que principalmente se configura y se prueba HWD POS. Ubuntu 22.04, Debian 12, AlmaLinux 9/8, Rocky Linux, RHEL y CentOS Stream también están admitidos y quedan igual de funcionales. Consulte Requisitos.
No. Windows Server no está admitido: el sistema usa servicios de systemd, rutas de impresión de Linux y pcntl. Tampoco se admite ningún Linux con PHP anterior a 8.1.
Sí. No borra datos: vuelve a dejar en su sitio los permisos, la configuración del servidor web, los servicios y el cortafuegos. Además conserva la contraseña de la base que ya funciona y la aplica al usuario de la base, de modo que el archivo de credenciales y la base coinciden siempre. Es la forma más rápida de arreglar un servidor que alguien ha modificado.
Lo más sencillo es reejecutar el instalador con WEB_PORT:
curl -fsSL https://3r.com.pa/hwdpos_inst/bootstrap.sh | sudo WEB_PORT=8080 bashActualiza a la vez el host virtual, el Listen del servidor web, el cortafuegos y las direcciones del resumen. Se rechazan los puertos 22, 3306 y 8108 porque ya los usa el sistema. Después, las terminales y tablets deben usar la dirección con el puerto, por ejemplo http://192.168.1.50:8080/. Consulte Configuración del servidor web.
Necesita salida a internet: para activar la licencia, buscar actualizaciones y enviar correo. No hace falta que sea accesible desde internet; todo funciona en la red local.
No. Publicar el servidor en internet solo hace falta si quiere entrar desde fuera de la tienda; en ese caso, agregue HTTPS por su cuenta (por ejemplo, con Let's Encrypt). Los instaladores no lo configuran.
Actualizar y reinstalar
Desde el propio sistema: Sistema → Actualizaciones. Comprueba si hay una versión nueva, la descarga, hace un respaldo de la base y de los archivos y la aplica. La actualización solo toca el código del sistema, no los complementos, la configuración ni las subidas.
Antes, haga un respaldo de la base desde Sistema → Respaldos de base de datos. Si la actualización cambia los servicios de fondo, reinícielos una vez con sudo hwdpanel → opción 17. Consulte Actualizar y reinstalar.
Esto borra todos los datos de la tienda. Hágalo solo en un servidor de pruebas o si de verdad quiere empezar de nuevo, y haga antes un respaldo.
sudo rm -f /var/www/HWDPOS/storage/installed.lock
sudo mysql -e "DROP DATABASE hwd_pos;"Después abra otra vez http://IP-DEL-SERVIDOR/install para ejecutar el asistente de instalación.
Funciones opcionales
No. Typesense es un buscador opcional, tolerante a erratas. Sin él (o si está caído), todas las búsquedas usan la búsqueda SQL de siempre, así que nunca se queda sin búsqueda. Consulte Búsqueda con Typesense.
Solo para imprimir documentos A4 y para impresoras de red por IPP/AirPrint. Las impresoras térmicas (ESC/POS, 80 mm y 58 mm) funcionan sin ellos. Use WITH_PRINTING=no en un servidor que no imprime. Consulte Impresión.