Skip to main content

Alpine Linux

Standard installation procedure​

  1. Download whatap-php.tar.gz and then unzip it based on the / directory. The monitoring installation file is created in the /usr/whatap/php directory.

    wget https://s3.ap-northeast-2.amazonaws.com/repo.whatap.io/alpine/x86_64/whatap-php.tar.gz
    tar -xvzf whatap-php.tar.gz -C /

  2. Run 'install.sh` that is the configuration script. By running this script, the PHP extension module configuration and whatap-php service daemon are registered. For more information, see the following.

Registering the PHP extension module and whatap-php service​

To automatically install the PHP extension module and whatap-php service, apply the following.

$ sudo /usr/whatap/php/install.sh
Input license key
xxxxxxxxxxxxxxxx                          # Enter the generated access key

Input whatap.server.host
192.x.x.x                                  # Enter the generated server IP

If the PHP extension module and whatap-php service are not recognized automatically, proceed with optional installation as the following.

If Apache commands (apachectl, httpd, apache2) and PHP commands (CLI) have not been set in the default path ($PATH), or multiple PHPs have been installed and there are multiple PHP commands (php5, php70, php-zts, zts-php…), select an applied version for processing.

$ sudo /usr/whatap/php/install.sh manual

Input license key
xxxxxxxxxxxxxxxx                            # Enter the granted access key

Input whatap.server.host
192.x.x.x                                    # Enter the granted server IP

Input : which apache or php-fpm ex)/usr/sbin/httpd, /usr/sbin/apache2, /usr/sbin/php-fpm ...
/usr/sbin/httpd                             # Enter the locations for apache and php-fpm commands

Input : which php ex) /usr/bin/php, /usr/bin/php5, /usr/bin/php70 ...
/usr/bin/php5                                # Enter the location of the php command

Configuration script (install.sh)​

Usage: install.sh [ commands manual|remove ]
    install.sh -l <license> -s <server> -v <php version> -i <php config file> -p <process_name> [-z ]
    install.sh -l <license> -s <server> -e <php command> -p <process_name> [-z ]
Commands
    auto(default) Auto scan web server and php environment
    manual User input web server and php environment
    remove Remove php extension and service(whatap-php)
Options
    -v <php version>     PHP version ex) 5.3, 5.4, 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0                        -v 5.3
                           --php-version 5.3
    -i <php config file> PHP config file
                           -i /etc/php.ini
                           --php-ini /etc/php.ini
    -e <php cli>         PHP CLI(command line interface)
                           -e /usr/bin/php
                           --php-exe: /usr/bin/php-fpm
    -p <process name>    Web server or PHP-FPM process name. for get used memory
                           -p httpd
                           -p httpd.worker, -process-name: php-fpm
    -l <license>         License key
                           -l xxxxxxxxxxxxxxx,
                           --license: xxxxxxxxxxxxx
    -s <server>          WhaTap Server Host
                           -s xx.xx.xx.xx/yy.yy.yy.yy,
                           --server xxx.xxx.xxx.xxx
    -z                   PHP thread safe
                           -z ,
                           --php-zts

  • license

    Granted access key.

  • server

    Granted server IP.

  • php version

    Server-installed PHP version(5.2. 5.3, 5.4, 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0).

  • php config file

    Set the full path of php.ini installed on the server (/etc/php.ini). Proceed with the configuration of the PHP extension.

  • php cli

    Using the executable command on the command line in the PHP command's full path (/usr/bin/php), you can check the basic PHP environment.

  • process name

    Apache running process name (httpd, apache2, httpd.worker…) or PHP-FPM running process name (php-fpm, php5-fpm). It collects the memory data running.

  • zts

    It sets whether or not to support Zend Thread Safe.

$ /usr/whatap/php/install.sh -l [granted access key] -s [granted server IP] -v [PHP version x.x] -i [full path of php.ini] -p [process name]
$ /usr/whatap/php/install.sh -l xxxxx -s 1.1.1.1/2.2.2.2 -v 7.0 -i /etc/php.ini -p httpd [-z]

whatap-php execution​

/usr/whatap/php/whatap-php
    Default restart
    Command start, stop, restart, version


## version checking
# /usr/whatap/php/whatap-php version
0.8.5.20201209


## execution checking
# ps -elf | grep whatap
  103 root      0:05 ./whatap_php_static -t=4

If the Apache or PHP-FPM service is restarted after installation, the set PHP extension module's whatap.so file is loaded.

Docker installation procedure​

  1. Unzip whatap-php.targ.gz in the /usr/whatap/php directory.

  2. Install Docker by using the install.sh script.

FROM alpine

RUN apk update && apk upgrade
RUN apk add php7 php7-fpm php7-opcache
RUN apk add php7-gd php7-mysqli php7-zlib php7-curl
RUN apk add php7-pdo php7-pdo_mysql
RUN apk add php7-pgsql

RUN apk add apache2 php7-apache2

# Install WhaTap PHP monitoring
ADD whatap-php.tar.gz /
RUN wget https://s3.ap-northeast-2.amazonaws.com/repo.whatap.io/alpine/x86_64/whatap-php.tar.gz
RUN tar -xvzf whatap-php.tar.gz -C /
RUN /usr/whatap/php/install.sh -l <Access Key> -s <Whatap server Host> -e <php CLI 경로> -p <Process Name>

Set to start the whatap-php daemon after running the container by adding the whatap-php execution command at the Docker's entry point.

/usr/whatap/php/whatap-php