Instrument PHP Applications AppDynamics Pro Documentation Version 4.0.x Page 1 Instrument PHP Applications . 3 Install the PHP Agent . 8 Install the PHP Agent using a Shell Script . 11 Install the PHP Agent using RPM . 15 Upgrade the PHP Agent . 19 Uninstall the PHP Agent . 20 Resolve Installation Issues for PHP . 21 Special Considerations for PHP on Mac OSX . 23 PHP Supported Environments . 23 AppDynamics for PHP Architecture . 27 Controller Information in the PHP Configuration Files . 28 Special Procedures for PHP CLI . 31 Set Up a Multi-Tenant Proxy for PHP Agents . 33 Run the Proxy Daemon Manually for PHP Agents . 34 Configure Manual Startup of the runProxy Script for PHP Agents . 34 Execute the runProxy Script Manually . 35 Page 2 Instrument PHP Applications On this page: Before You Begin Instrument Your PHP Application Related pages: AppDynamics Essentials Upgrade the PHP Agent Uninstall the PHP Agent Install the PHP Agent PHP Supported Environments AppDynamics for PHP Architecture Resolve Installation Issues for PHP Watch the video: Quick Install: App Agent for PHP Use these instructions to install the PHP Agent using the Agent Download Wizard in the Controller. This installer configures your agents with the values that you supply in the wizard. This is the simplest way to install the agent. If you downloaded the agent from the AppDynamics download zone, see Install the PHP Agent an d its subpages to instrument your application manually, using either a shell script or an RPM installer. If you are instrumenting an application running on Mac OSX, you need to instrument it manually using the shell script. If you are instrumenting a PHP CLI script, see Special Procedures for PHP CLI. Before You Begin 1. Confirm you have access to a controller, the web application where you monitor your application performance: If you use a SaaS controller, AppDynamics sent you the controller host in your Welcome Email. If you use the on-premise controller, you supplied the host and port at install time. 2. Verify you have root access to run the install. 3. Verify support for your environment at PHP Supported Environments. Instrument Your PHP Application There are four steps to instrument your PHP application and begin monitoring: Copyright © AppDynamics 2012-2015 Page 3 1. Download: Use the Agent Download Wizard to configure and download the agent. 2. Install: Unzip the agent on your server and run the install script. 3. Apply Load: Restart your web server and application and apply load to activate instrumentation. 4. View Your Application: Log on to the Controller to monitor application performance. Download the PHP Agent The Agent Download Wizard walks you through configuration steps and helps you download the agent. Show me the Download Agent Wizard steps... 1. Log on to the Controller and click the Agent Download Wizard tab. The download wizard configures the agent with information to connect to the Controller. 2. Click PHP, then click Next. 3. Click to Select Operating System and 32-bit or 64-bit bit System, then click Next. Copyright © AppDynamics 2012-2015 Page 4 4. The Controller Location URL window displays the connection info for the Controller. Click Next. Click SSL to enable SSL encryption between the agent and the Controller. Enter the SSL port. For AppDynamics SaaS, the SSL port is 443. 5. Enter an application name or, click an existing application name if one exists. Then click Next. For new users, it is OK to use the default "MyApp". You can change it later when know more about how you want to organize your applications in AppDynamics. Copyright © AppDynamics 2012-2015 Page 5 6. Enter a tier name. Then click Next. For new users, it is OK to use the default "MyTier". You can change it later when know more about how you want to organize your applications in AppDynamics. 7. Click Click here to Download to download the App Agent for PHP. Now you're ready to install the agent on your app server. Copyright © AppDynamics 2012-2015 Page 6 Install the PHP Agent on your app server After you download the agent, install it to your app server. The final window of the Agent Download Wizard includes brief instructions for installing the agent. 1. Log on as an administrator to the machine running your PHP application. Unzip the agent zip file into a directory that can be accessed the same user that runs Apache or php-fpm. For example, for a 64 bit agent on Linux: unzip appdynamics-php-agent-x64-linux-tar-self-service.zip -d /opt/appdynamics/appagent 2. Run the installer script. sudo bash runme.sh By default the PHP agent installer uses the PHP directory specified in your environment's PATH variable to determine where to install the agent. If you are using a different PHP installation not specified in the PATH environment variable, follow the instructions below to run the installer with custom options instead of using the Agent Download Wizard. Install the PHP Agent using a Shell Script Install the PHP Agent using RPM Now you're ready to restart your application and put some load on it. Apply load to your application 1. Restart your web server. 2. Apply load to your application. The agent instruments the application code and reports metrics back to the Controller. You're ready to begin monitoring. View your application Copyright © AppDynamics 2012-2015 Page 7 Log on to the Controller to see your application in action. From here, you can install more agents or you can begin monitoring your application. The links below will help you get started: Install the PHP Agent On this page: Prerequisites for Agent Installation Installing the PHP Agent Files Added to Your Installation Installing the Standalone Machine Agent on a PHP Node Related pages: Install the PHP Agent using a Shell Script Install the PHP Agent using RPM Special Procedures for PHP CLI Special Considerations for PHP on Mac OSX Upgrade the PHP Agent Resolve Installation Issues for PHP You can install the PHP Agent using either a shell script (install.sh) or the RPM Package Manager (RPM). These instructions assume that you are installing the AppDynamics PHP Agent in a standard PHP environment, specifically: a single PHP installation running on the Linux or OSX machine PHP running in a single Apache or FPM pool Copyright © AppDynamics 2012-2015 Page 8 standard packages have been used to install PHP, Apache and/or PHP-FPM no customizations have been made to your PHP configuration It is possible that the installer will work if one or more of these assumptions is violated. This installation results in an AppDynamics model of your application consisting of one application, one tier, and one node. Prerequisites for Agent Installation 1. Confirm that you have a supported environment installed on the server and that the server is configured correctly to run PHP scripts. How you do this depends on your PHP environment. For example, in our Ubuntu 12+ web server running Apache we use: sudo apt-get install apache2 php5 php5-cli php -i In our CentOS 5+ web server running Apache mod_ssl we use: sudo yum install httpd mod_ssl php53 php53-cli php -i 2. Confirm that your PHP was not built with the enable-debug configure option. The PHP Agent is incompatible with PHP builds that were compiled with debugging symbols. To determine whether your PHP was built with debugging symbols you can use the following command: php -i | grep -e "Debug Build" The response should be: Debug Build => no 3. Install the PHP application that you want to monitor, if it is not already installed. 4. Download the the appropriate PHP agent installer for your platform. On RedHat and CentOS: PHP Agent - 32 bit RPM PHP Agent - 64 bit RPM On all other Linux: PHP Agent - 32 bit Linux Copyright © AppDynamics 2012-2015 Page 9 PHP Agent - 64 bit Linux On Mac OSX: PHP Agent - 64 bit OSX If you use an on-premise Controller, download the latest version of the AppDynamics Controller. The download site is http://download.appdynamics.com. 5. Be prepared to provide the following information to the installation script: controller host and controller port: These are the host name or IP address and the port number of the AppDynamics controller that the agent connects to. SaaS customers receive this information from AppDynamics. On-premise customers establish these settings when they install the controller. AppDynamics application name: This is the name that you assign to the business application you will monitor with AppDynamics. AppDynamics tier name: This is the name that you assign to the tier you will monitor with AppDynamics. AppDynamics node name: This is the name of the basic unit of processing that the agent monitors. If you have an on-premise AppDynamics controller running in multi-tenant mode or if you are using the AppDynamics SaaS Controller, you will also need to provide the following, which were included in your Welcome email from AppDynamics: AppDynamics account name AppDynamics account key 6. Stop the Apache server. Tip: Do not install the PHP Agent along with other non-AppDynamics Application Performance Management (APM) tools, especially in a production environment. The PHP agent installation may fail if there are other APM products installed in the same managed environment. Installing the PHP Agent To use install.sh, see Install the PHP Agent using a Shell Script. Use install.sh to install on OSX as well as LInux. To use RPM, see Install the PHP Agent using RPM. To instrument PHP CLI, see also Special Procedures for PHP CLI. To instrument an application on OSX, see Special Considerations for PHP on Mac OSX.