PHP Agent Installation - Ubuntu and Debian

​

Install the agent

1. Add repository and gpg key Execute the following command to add the gpg key.
   curl https://s3.amazonaws.com/atatus-artifacts/gpg/atatus-sha512.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/atatus-sha512.gpg
   
   Execute the following command to add the debian repository.
   echo "deb https://s3.amazonaws.com/atatus-artifacts/atatus-php/debian stable main" | sudo tee -a /etc/apt/sources.list.d/atatus-php-agent.list
   
2. Install php agent
   sudo apt-get update
   
   sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent -y
   
   APM_LIC_KEY - add the Atatus APM License key in this line of code. YOUR_APP_NAME - add the application name in this line of code.
   For an on-premise server, also set these lines in atatus.ini:

   atatus.collector.notify_host = "YOUR_ON_PREMISE_HOST"
   atatus.collector.notify_ssl = YOUR_ON_PREMISE_SSL
   
3. Restart your web server and PHP - FPM Stop and Start your servers such as nginx, php-fpm, apache, httpd, etc. Then you will see the performance data in a few minutes. Just access your server from your web app or mobile app or curl. You will visualize your application’s metrics within minutes.

# Verify package installed
rpm -qa | grep atatus-php-agent

# Verify PHP extension loaded
php -i | grep atatus

​

Upgrade the agent (to the next version)

sudo apt-get update

apt policy atatus-php-agent
sudo apt-get install --only-upgrade atatus-php-agent

​

Install specific version of agent

• Remove Atatus agent completely.

sudo apt-get purge atatus-php-agent

• Check list of available Atatus versions.

apt policy atatus-php-agent

(or)

apt-cache policy atatus-php-agent

# Sample output for apt-cache policy

atatus-php-agent:
  Installed: 1.18.0-1
  Candidate: 1.18.0-1
  Version table:
 *** 1.18.0-1 500
        500 https://s3.amazonaws.com/atatus-artifacts/atatus-php/debian stable/main amd64 Packages
        100 /var/lib/dpkg/status

• Install specific version of Atatus agent.

sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent="SPECIFIC_VERSION" -y

# Install specific version 1.18.0
sudo ATATUS_LICENSE_KEY="APM_LIC_KEY" ATATUS_APP_NAME="YOUR_APP_NAME" apt-get install atatus-php-agent="1.18.0-1" -y

​

For Ubuntu 20.04 and below

curl https://s3.amazonaws.com/atatus-artifacts/gpg/atatus-sha512.gpg | sudo apt-key add -