1. The latest agent can also be downloaded from the Applications Manager web client, from the Add new Monitors page.

1. Once the latest version has been downloaded, login to the machine in which the old agent is installed.
   
2. Install the latest version by double clicking on the MSI file. During installation, an option to overwrite the existing installation will appear.
   

                             

1. Proceed with the installation. It will overwrite the existing version without the loss of any existing settings.         
      

1. Once the latest version has been downloaded, Copy and unzip the agent under the /opt/zpa/bin directory (such that /opt/zpa/bin/zpa contains the extracted files of the latest agent) by executing the following commands one by one:                      
   

1.   cp agent_php.zip /opt/zpa/bin
   
2.  cd /opt/zpa/bin
   
3. unzip agent_php.zip                              
   

1. Copy the latest "upgrade" file from the extracted path to /opt/zpa/bin (overwrite the existing upgrade file) by executing the following command:
   

cp /opt/zpa/bin/zpa/bin/upgrade /opt/zpa/bin/

1. Execute the upgrade binary by executing the following commands one by one:                                                         
   

1. cd /opt/zpa/bin     
   
2. chmod +x upgrade 
   
3. ./upgrade                
   

1. Restart the PHP agent using the following command:                                                         
   

sh run.sh restart

1. Restart your web server / FPM server using the following commands:
   

$ sudo service apache2 restart

$ sudo service php-fpm restart

PHP Agent Version above 3.2.2

PHP agent can be upgraded in 2 ways:

• Auto upgrade
• Manual upgrade
  

Auto upgrade:

• When this feature is enabled, the latest version of the agent will be automatically downloaded and deployed when it is available.
• After the deployment process is complete, you will be requested to restart your application server. Once the server is restarted the updated version will take effect.
• To enable this feature, APM -> Applications/Instances -> Monitor Actions > Edit -> APM Insight Agent Configuration Profile -> Edit Icon () -> Basic Configuration Profiles > Enable Agent Auto-Upgrade.

Note: Auto upgrade feature will only work for major version changes in agent. Minor changes will not be covered in this.

Manual upgrade:

• By default, auto-upgrade option is disabled. When a new version of the agent is available, users will be notified in the APM Instance view.
  
  

• Users can initiate the upgrade process by clicking on Update Agent link in the above said notification. On doing so, the latest version will be downloaded and deployed.
• After the deployment process is complete, you will be requested to restart your application server. Once the server is restarted, the updated version will take effect.
  

     

Note: For Windows agent, the manual restart is not required.