Panel del servidor hwdpanel
Administre el servidor de HWD POS desde un menú de texto, sin usar la interfaz web.
El instalador crea el comando hwdpanel en el servidor (/usr/local/bin/hwdpanel). Es un menú de texto local para el día a día del servidor: reiniciar servicios, restablecer contraseñas, consultar credenciales, diagnosticar y más, todo sin abrir la interfaz web.
Abrir el panel
sudo hwdpanelLa parte superior de la pantalla muestra la carpeta del proyecto, la versión de PHP y el estado de los servicios. Escriba el número de una opción y presione Enter.
Si hwdpanel no existe (por ejemplo, tras una instalación parcial), check.sh puede reinstalarlo desde su opción Panel de administración.
Opciones del menú
| Grupo | Opción | Qué hace |
|---|---|---|
| Sitio web | 1 / 2 / 3 | Reiniciar, iniciar o detener el servidor web y PHP-FPM. |
| Impresión | 4 / 5 / 6 | Reiniciar, iniciar o detener el worker de impresión (hwpos-print). |
| Administración | 7 | Restablecer la contraseña de cualquier usuario o administrador (lista los usuarios y sus roles). |
| 8 | Mostrar las credenciales de la base de datos (leídas de la configuración real de la aplicación). | |
| 9 | Mostrar el entorno. | |
| 10 | Ejecutar el diagnóstico check.sh. | |
| 11 | Mostrar la IP del servidor y la URL de acceso. | |
| 12 | Actualizar el propio panel desde la red. | |
| Inteligencia | 13 | Instalar o actualizar el entorno de IA (opcional, vea abajo). |
| Búsqueda | 14 | Instalar o actualizar el servicio de búsqueda (Typesense, con arranque automático). |
| 15 | Gestionar las claves de búsqueda (listar, crear, eliminar). | |
| Servicios | 16 | Instalar o reinstalar los servicios de fondo (impresión + complementos). |
| 17 | Reiniciar todo (sitio + PHP + workers). | |
| 18 | Ver el registro de los servicios de fondo. | |
| Capacidad | 19 | Conexiones de la base y peticiones de PHP. |
| Reparar | 20 | Apache: corregir la cabecera que usa la app de entregas (cuando dice «Sin conexión»). |
| 0 | Salir. |
Capacidad de conexiones (opción 19)
El instalador calcula el número de procesos de PHP según la memoria del servidor (unos 60 MB por proceso, entre 10 y 80) y lo mantiene siempre por debajo del cupo de conexiones de la base de datos. La opción 19 muestra los valores actuales y permite aplicar los aconsejados, escribirlos a mano o poner el pico a cero para empezar a medir desde hoy. La misma información está dentro de HWD POS en Sistema → Capacidad de conexiones.
Después de una actualización
Si una actualización cambia los servicios de fondo, reinícielos una vez con la opción 17.
Entorno de IA (opción 13)
Crea un entorno virtual de Python con CatBoost, registra el intérprete en la aplicación e instala y arranca el servicio de reentrenamiento (hwpos-ai.service, que arranca solo al reiniciar el servidor). Después actívelo en HWD POS en /admin/ai. Es opcional y no se instala por defecto porque los paquetes de IA son pesados.
Servicio de búsqueda (opciones 14 y 15)
Consulte Búsqueda con Typesense.
Restablecer una contraseña
Desde el panel, elija la opción 7, seleccione el usuario e introduzca la nueva contraseña.
Tambié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 admin
php /var/www/HWDPOS/scripts/hwd-admin.php reset-password admin YOUR_NEW_PASSWORDEl segundo comando pide la nueva contraseña de forma interactiva. El tercero fija directamente la contraseña indicada.
Escribir la contraseña en la línea de comandos la deja en el historial del terminal. Es preferible la forma interactiva.
Otras utilidades administrativas
scripts/hwd-admin.php arranca la aplicación y usa su misma conexión a la base de datos, así que siempre lee la configuración vigente:
php /var/www/HWDPOS/scripts/hwd-admin.php db-info # datos de conexión a la base
php /var/www/HWDPOS/scripts/hwd-admin.php env # entorno
php /var/www/HWDPOS/scripts/hwd-admin.php list-users # usuarios y rolesActualizar el panel
El panel puede descargar su versión más reciente y reemplazar la copia local. Antes de sustituirla:
- crea una copia de seguridad con extensión
.bak; - comprueba la sintaxis del archivo nuevo;
- solo reemplaza la versión local si la comprobación es correcta.
Para actualizarlo, elija la opción 12 en el panel, o ejecute:
sudo bash /var/www/HWDPOS/deploy/check.sh --update-panelEn el menú de check.sh también puede usar la opción U.