Install PHP Agent With ZTS

The following topics provide installation details for various scenarios:

Files Added Post the PHP ZTS Install

The following files are added after installing the PHP Agent:

  • Configuration files

    For Splunk AppDynamics, the two PHP configuration files are: php.ini and appdynamics_agent.ini fragment. Splunk AppDynamics settings can be found in either of the .ini files, depending on the operating system under which your PHP is installed. The PHP Agent installer adds the appdynamics_agent.ini file to the directory that contains your php.ini file. You can find this directory using the following command:

    php -i | grep -e "Additional .ini files parsed"

    If the installer is not able to determine the directory where the ini fragments for your PHP deployment exist, it displays the required Splunk AppDynamics ini fragment and prompts you to copy and paste it into your main php.ini file. Also, see http://php.net/manual/en/configuration.file.php for information about the possible locations for the configuration file.

  • .so files

    The installer also installs the appdynamics_agent.so file in your PHP extensions directory. You can find this directory using the following command:

    php -i | grep extension_dir
  • Logs

    For each application, there is an agent log and a proxy log. By default, the agent log is written to $<php_agent_install>/logs/agent.log. The log contains the transactions that the agent processes and then sends to the proxy. The default pattern for agent log naming is:

    • agent.log: the current log
    • agent.log.1: most recent log
    • agent.log.2: second most recent log
    • agent.log.3: third most recent log
    • agent.log.4: fourth most recent log
    • agent.log.5: fifth recent log

You can find the licenses of the third-party libraries under the directory license in the agent installation folder: appdynamics-php-zts-agent-linux_x64/license.

Install a Machine Agent on a PHP Node

You can install a Machine Agent on a node that runs the PHP Agent. However, if you install the Machine Agent on a PHP Agent node and you specify the tier and node name in the controller-info.xml file of the Machine Agent, the PHP Agent does not successfully register with the Controller.

To avoid this:

  • Install the PHP Agent before you install the Machine Agent
  • If you install the Machine Agent on the machine hosting the instrumented PHP node, do not specify the application, tier or node name in the controller-info.xml file of the Machine Agent. If you do, the PHP Agent may fail to register.