On this page:
This topic describes how to install the PHP Agent using the included install.sh script.
The following steps describe how to install the PHP Agent with the installation script,
Verify support and system requirements for your environment as described in Install the PHP Agent.
Create the php-agent installation directory. The directory should be owned by the same user that runs Apache or PHP-FPM (FastCGI Process Manager). AppDynamics recommends naming the directory
This document refers to the PHP Agent installation directory as:
If there is more than one Apache instance on a machine, run
install.sh once for each Apache, each time with the appropriate node,
php_ini dir and
php_ext dir options. In this case see also Run the PHP Proxy Daemon Manually. See Files Added to Your Installation for information about the default installation directories. From the command line, change directories to the PHP agent installation directory and untar the agent distribution tarball, as in the following example:
cd <php_agent_install> tar -xvjf appdynamics-php-agent-x64-linux.tar.bz2
php – Make every directory that leads to the PHP agent logs directory readable and executable by all and writable by the directory owner:
chmod -R 755 <php_agent_install>
logs – If possible, make the logs subdirectory readable/writable/executable by all:
chmod 777 <php_agent_install>/logs
Directory access permissions of 777 may be too permissive for some organizations. In this case, simply make sure that the directory is owned by the apache/php/proxy user.
Run the installation script using this syntax:
<php_agent_install>/install.sh [-s] -a=<account_name>@<account_access_key> [--http-proxy-host=<proxy_host>] [--http-proxy-port=<proxy_port>] [-e <php_ext_dir>] [-i <php_ini_dir>] [-p <php_binary_dir>] [-v <php_version>] <controller-host> <controller-port> <app_name> <tier_name> <node_name>
The command arguments are described as follows:
http-proxy-port>to route data to the controller through a proxy server. The
<http-proxy-host>is the host name or IP address of the proxy server. The
<http-proxy-port>is the proxy server's HTTP or HTTPS port, whichever you are using. If you set the http-proxy-host you must set the http-proxy-port as well.
appdynamics_agent.sofile. Needed on Ubuntu as well as when the default PHP CLI binary cannot be determined.
appdynamics_agent.inifile. Needed on Ubuntu as well as when the default PHP CLI binary cannot be determined.
trueto defend PHP in long-running CLI applications. Defaults to
If all options are used, the -e, -i and -v options have precedence over the -p option.
On Ubuntu the installation needs to be performed as the root user. Also, you need to use the -e option to indicate the correct extensions directory for the appdynamics_agent.so file and the -i option for the correct ini directory for the
Restart the web server, unless you are installing an agent to monitor PHP-CLI only.
If your installation failed, see Resolve PHP Agent Installation Issues.
The following illustrates a sample command to install the agent:
install.sh controller 8090 -a=PHPCust@XC6v2n8m2$543 myApp myTier myNode
To install the agent using SSL, use the -s switch, as follows:
install.sh -s -a=PHPCust@XC6v2n8m2$543 controller1.appdynamics.com 8818 myApp myTier myNode
The following sample command illustrates installation with a proxy server present:
install.sh --http-proxy-host=myproxyhost --http-proxy-port=8099 -a=PHPCust@XC6v2n8m2$543 controller 8090 myApp myTier myNode