Diagnostics with check.sh

What check.sh doesCopy Anchor Link

check.sh reviews the main components of an HWD POS server, prints a ✓ / ✗ report, and then lets you install or repair the ones that are missing or misconfigured. It is useful whenever an installation stopped halfway or someone changed the server configuration.

It is safe to run as many times as you like: it does not delete data.

Running itCopy Anchor Link

You can run the local copy that the installer leaves on the server, or run the published version directly from the network.

sudo bash /var/www/HWDPOS/deploy/check.sh

Both show the report and then open the repair menu.

Report only (change nothing)Copy Anchor Link

Set CHECK_ONLY=1 to see the diagnosis without installing or changing anything:

# Local copy
sudo CHECK_ONLY=1 bash /var/www/HWDPOS/deploy/check.sh

# From the network
curl -fsSL https://3r.com.pa/hwdpos_inst/check.sh | sudo CHECK_ONLY=1 bash

You can also run it from the server panel: sudo hwdpanel → option 10) Diagnostics (check.sh). See hwdpanel.

What it checksCopy Anchor Link

• PHP and its extensions.
• The PHP-FPM version actually in use (not just the php command in the terminal).
• MariaDB.
• The web server (Apache or Nginx) and the site configuration.
• The HWD POS database.
• CUPS.
• Chrome/Chromium (it runs the browser as the web user to confirm it really works).
• The print worker hwpos-print and the plugins worker.
• The local admin panel hwdpanel.
• The HWD POS code.
• The site port — the port that is actually configured, not assumed to be 80.

The repair menuCopy Anchor Link

After the report, a menu lists the components. Re-checks run after each installation.

Updating hwdpanelCopy Anchor Link

check.sh can also update the panel directly:

sudo bash /var/www/HWDPOS/deploy/check.sh --update-panel

Before replacing the local copy, it makes a .bak backup, checks the syntax of the new file, and only replaces the local version if the check passes.

Installation modesCopy Anchor Link

check.sh detects the mode of the server (all-in-one, web only or database only) from what is installed, and adapts its checks:

• On a web-only server it does not flag the missing local MariaDB as an error; it tests the remote database instead. Pass its address with DB_HOST=<ip>.
• On a database-only server it checks MariaDB and that it is listening on port 3306.

You can force the mode with MODE=web, MODE=db or MODE=all:

sudo MODE=web DB_HOST=10.0.0.5 bash /var/www/HWDPOS/deploy/check.sh

Other variables it accepts: PHP_VER, APP_DIR, DB_NAME, DB_USER, DOMAIN. See Installer variables.

Ubuntu/Debian versus AlmaLinuxCopy Anchor Link

check.sh works on both supported families:

RelatedCopy Anchor Link

• Common problems
• FAQ
• Upgrade and reinstall