Perform PHP Agent Interactive Installation

Use the APM PHP interactive installation mode when you want to install the PHP Agent using a wizard-type installer.
apmdevops106
Use the APM PHP interactive installation mode when you want to install the PHP Agent using a wizard-type installer.
3
2
You require PHP root directory privileges to perform the PHP Agent interactive installation.
The
IntroscopeAgent.profile
file is located in the
<
PHP_Agent_Home
>/apmia/core/config
directory.
Install the PHP Agent
Prerequisite
Ensure that you manually create the PHP Agent Log directory
/opt/CA/APM/apm-phpagent/logs
in the
wily_php_agent.ini
file before starting with the install process.
To install the PHP Agent, perform the following steps:
  1. Run the
    mkdir -p /opt/CA/APM/apm-phpagent/logs
    command at a command prompt to create the default PHP Agent log directory. Substitute another value to create a custom PHP Agent log directory. The PHP log directory value is used later in the installation process.
  2. Run this command from the
    <
    PHP_Agent_Home
    >
    directory.
    ./installer.sh -install
  3. When the Install Menu displays, select
    1 - Configure and install CA APM PHP Probe Agent
    and press
    Enter
    . The installation process begins.
  4. Enter the app name for the PHP agent to use.
    Press
    Enter
    to use the default value of
    PHP App
    .
  5. If the installation is running on a remote computer, enter the Infrastructure Agent Host/IP address for the PHP agent to use.
    Press
    Enter
    to use the default value of
    127.0.0.1
    .
  6. Press
    Enter
    to use the default value of
    /opt/CA/APM/apm-phpagent/logs
    set in the
    wily_php_agent.ini
    file, or input a custom value, then press
    Enter
    .
    For example,
    /var/log/ca
    .
  7. Set the Infrastructure Agent port.
    Press
    Enter
    to use the default port
    5005,
    or input a custom value, then press
    Enter
    .
  8. If you have configured the Infrastructure Agent to use a port other than the default port 5005, set
    introscope.remoteagent.collector.tcp.port
    to the same port value in the the
    IntroscopeAgent.profile
    .
    introscope.remoteagent.collector.tcp.port = 5005
  9. The Installer starts, finds the PHP installations on the computer, and displays the installations that it finds.
    For example, this message displays that the installer found three existing PHP installation directories on the computer:
    1) /usr/bin
    2) /opt/php55_fpm/bin
    3) /opt/php7_fpm/bin
    0) Exit
    (Select 1-3, or all to install, 0 to exit)
    For example, enter
    1
    ,
    2
    , and
    3
    .
    The installer runs until the installation finishes.
  10. Select any or all the numbers that are associated with the discovered PHP installations.
  11. Restart the PHP service.
    For example, if you are using PHP-FPM, at a command prompt run the following command:
    systemctl restart php-fpm
Example 1: Successful Installation
You run this command from the
<
PHP_Agent_Home
>
directory:
./installer.sh -install
When the
Install Menu
displays, you enter
1 - Configure and install CA APM PHP Probe Agent
and you provide these inputs:
PHP Root : /usr/bin
Extensions directory : /usr/lib64/php/modules
PHP ini directory : /etc/php.d
The installer starts and displays this message as the installation proceeds:
1) PHP Root : /usr/bin
PHP Version : 5.5.38
Extensions directory : /usr/lib64/php/modules
Zend Thread Safety : Disabled
PHP ini directory : /etc/php.d
Installation Status :
Success
Example 2: Failed Interactive Installation Due to Unsupported PHP with ZTS Enabled
You run this command from the
<
PHP_Agent_Home
> directory:
./installer.sh -install
When the
Install Menu
displays, you enter
1 - Configure and install CA APM PHP Probe Agent
and you provide these inputs:
PHP Root : /opt/php55_fpm/bin
Extensions directory : /opt/php55_fpm/bin/lib/php/extensions/no-debug-zts-20121212
PHP ini directory : /opt/php55_fpm/etc/php.d
The installer starts and displays this message as the installation proceeds:
PHP Root : /opt/php55_fpm/bin
PHP Version : 5.3.26
Extensions directory :/opt/php55_fpm/bin/lib/php/extensions/no-debug-zts-20121212
Zend Thread Safety : Enabled
PHP ini directory : /opt/php55_fpm/etc/php.d
Installation Status : Failed
Reason : PHP Zend Thread Safety (ZTS) is enabled for the PHP installation located at /opt/php55_fpm/bin.Please contact Broadcom Support for PHP probe agent with ZTS support.
Troubleshooting
For information on how to configure PHP Agent 10.7+ with PHP 7.0.33 FPM on CentOS 7.6, see Configure PHP Agent 10.7+ with PHP 7.0.33 FPM on CentOS 7.6