Skip to main content

Installation checking items

Restarting the Service​

After installation, restart the Apache or PHP-FPM service so that the configured PHP extension module whatap.so is loaded. If the whatap-php service is not running or an error occurs, restart the service.

Red Hat/CentOS​

$ service whatap-php restart

Debian/Ubuntu​

$ sudo service whatap-php restart

FreeBSD​

$ service whatap_php restart

Windows​

net restart "WhaTap PHP"

Checking PHP Extension Module Installation​

Once installation is complete and the Apache or PHP-FPM service is restarted, the whatap.so PHP extension module will be loaded.
You can verify whether the PHP module is correctly installed using the following methods:

  1. Check whether the whatap.ini file has been created in the PHP additional INI path.

    • Linux/FreeBSD
    $ find / | grep whatap.ini
    • Windows
    dir /s C:\ | findstr whatap.ini

  2. Check whether the whatap.so file exists in the PHP extension directory.

    • Linux/FreeBSD
    $ find / | grep whatap.so
    • Windows
    dir /s C:\ | findstr php_whatap.dll

  3. Check whether the PHP extension module is active.

    • Linux/FreeBSD
    $ sudo php -m

    [PHP Modules]
    bz2
    calendar
    Core
    ctype
    curl
    date
    …
    whatap   # Module loaded
    …
    [Zend Modules]
    • Windows
    php -m | findstr whatap

    Expected Output

    whatap

  4. Check the status of the whatap-php service.

    • Linux/FreeBSD
    $ service whatap-php status
    • Windows
    sc query "WhaTap PHP"

    Or open services.msc to check WhaTap PHP service status.

    Expected Output

    SERVICE_NAME: WhaTap PHP
    STATE : 4 RUNNING

  5. Check the logs.

    Log File Location

    C:\Program Files\WhaTap\PHP\logs\
    ├── whatap-boot-YYYYMMDD.log    # Boot/start logs by date
    └── whatap-install.log          # Installation log

    View Logs

    REM View installation log
    type "C:\Program Files\WhaTap\PHP\logs\whatap-install.log"

    REM View latest boot log
    dir "C:\Program Files\WhaTap\PHP\logs\whatap-boot-*.log" /O-D
    type "C:\Program Files\WhaTap\PHP\logs\whatap-boot-20251117.log"

    PowerShell Live Log

    # Real-time monitoring of latest boot log
    $latestLog = Get-ChildItem "C:\Program Files\WhaTap\PHP\logs\whatap-boot-*.log" | Sort-Object LastWriteTime -Descending | Select-Object -First 1
    Get-Content $latestLog.FullName -Wait

  6. Go to Management > Agent Settings and confirm that the configured server has been added.

Last updated on