Linux

Installing using systemd

Follow these steps to install the Raygun Agent on a Linux x64 machine running under systemd.

Step 1 - Install dependencies

Ensure you have the dependencies needed to run the commands below.

sudo apt-get -y install unzip

Step 2 - Download and extract the agent

Create a directory to install the Raygun Agent to. If you install the Raygun Agent to a different directory then also update the raygunagent.service file with the same directory.

Afterwards, download the Raygun Agent zip file to that directory and give execute permission to the Agent and CLI executables.

sudo mkdir -p /opt/raygun/agent

sudo curl -O "https://downloads.raygun.com/APM/latest/RaygunAgent-Linux-(x64).zip"
sudo unzip -d /opt/raygun/agent "RaygunAgent-Linux-(x64).zip"
sudo rm "RaygunAgent-Linux-(x64).zip"
sudo chmod +x /opt/raygun/agent/RaygunAgent

Step 3 - Install the systemd service

Copy the raygunagent.service configuration file to the systemd directory and reload the daemon to pick up the new service.

sudo mv /opt/raygun/agent/raygunagent.service /etc/systemd/system/
sudo systemctl daemon-reload

Step 4 - Start the service

Start the new service.

sudo systemctl enable raygunagent
sudo systemctl start raygunagent

Run the Agent via Terminal

Running the Agent in the terminal is as simple as calling the executable. This can be used when you want to run the Agent temporarly, or you want to run it without using systemd.

After downloading and unzipping the Agent:

# Change the permissions on the RaygunAgent and rgc (cli) to be executable
sudo chmod +x ./RaygunAgent

# Start the Agent with -c
# -c runs it in Console mode to listen for ctrl+C to exit
# omit -c if not running in a Console
sudo ./RaygunAgent Agent -c

Next Step

Once the Agent is installed, you can begin profiling your application. Please refer to the Profiler Setup for instructions on setting up the profiler for your Language/Environment.