Skip to main content

Agent Update

Package updates allow you to update the PHP monitoring service while retaining existing settings.
Normal updates are supported from version 0.2.7 and later.
For earlier versions, you must uninstall and reinstall the agent.

Caution

If the PHP extension shared library (.so) file changes while Apache is running, the Apache daemon may terminate abnormally.
Always stop the Apache server before performing an update.

Red Hat/CentOS​

  1. Clear the cache to refresh package information.
$ yum clean all

  1. Stop Apache or PHP-FPM services.

  2. Update the whatap-php package.

$ yum update whatap-php
Note

If you want to install a specific version:

$ yum update whatap-php-{version}

Debian/Ubuntu​

  1. Refresh package information.
$ sudo apt-get update

  1. Stop Apache or PHP-FPM services.

  2. Update the whatap-php package.

$ sudo apt-get install --only-upgrade whatap-php
Note

To install a specific version:

$ sudo apt-get install whatap-php={version}

FreeBSD​

Uninstall and reinstall the agent. Follow the steps below:

  1. Stop Apache or PHP-FPM services.

  2. Uninstall and reinstall.

$ /usr/whatap/php/install.sh remove

$ wget https://s3.ap-northeast-2.amazonaws.com/repo.whatap.io/freebsd/10/whatap-php-0.4.10.txz
$ pkg install whatap-php-0.4.10.txz
  1. Register PHP extension module and whatap-php service.
$ /usr/whatap/php/install.sh
Note

To install a specific version:

$ wget https://s3.ap-northeast-2.amazonaws.com/repo.whatap.io/freebsd/10/whatap-php-{version}.txz
$ pkg install whatap-php-{version}.txz

After installation, start Apache or PHP-FPM services.

Windows​

Running the installer (whatap_php_setup.exe) updates the agent while keeping existing settings.

warning

We recommend stopping the web server before updating and starting it again afterward.

GUI Update​

  1. Stop the web server (Apache or IIS):
net stop Apache2.4
REM or
iisreset /stop
  1. Run the installer to update the agent.
whatap_php_setup.exe
  1. Start the web server.
net start Apache2.4
REM or
iisreset /start

CLI Automatic Update​

If an existing installation is found, the installer automatically enters update mode.

  1. Stop the web server.
net stop Apache2.4
  1. Run the installer.
whatap_php_setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART
  1. Start the web server.
net start Apache2.4

Example Batch Script​

@echo off
echo Stopping web server...
net stop Apache2.4

echo Updating WhaTap PHP Agent...
whatap_php_setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

if %errorlevel% equ 0 (
    echo Update completed successfully!
) else (
    echo Update failed with error code: %errorlevel%
    exit /b %errorlevel%
)

timeout /t 3

echo Starting web server...
net start Apache2.4
echo Update completed!