Command Line

Overview

The command-line installation runs a bash script that downloads the agent's binary from Granulate's S3 bucket and automatically installs the agent on the instance. The agent is available for both 64-bit and Arm v8 architectures.
In order to install Granulate's gAgent using the CLI installation method, simply run the following bash command on each virtual machine. The CLI based installation requires the following parameters:
  • Download Bucket - Granulate repository which stores the agent binary and installation script.
  • Client ID - A unique customer license key that is required for the agent's authentication.
  • Service ID - A customer-defined service identifier used to correlate all the agents that are installed in the same customer service.
1
curl -s https://s3.amazonaws.com/<download bucket>/granulate_run_gagent.sh | sudo \
2
CLIENT="<Client Key>" \
3
SERVICE="<Service Name>" \
4
bash
Copied!

Persistent Deployment

By default, the agents are installed in a volatile manner in which the gAgent deployment doesn't persist a restart or instance rotation. In order to deploy the gAgent in a non-volatile manner you can use one of the following:
Cloud Init Script
Cron Scheduling
Add Granulate CLI installation to the init script of the relevant autoscaling group/service. For example for AWS EC2 auto-scaling groups simply add the CLI command-line to the entire auto-scaling group's user-data script or the cloud-init script
Add the gAgent CLI installation to the Linux Cron Scheduler (Crontabs) to be run following a reboot. This will ensure the gAgent is re-installed following a restart occurs.
In order to add the gAgent installation to the Cron scheduler, simply run the following on each instance:
Open crontab file using
1
sudo crontab -e
Copied!
Add the following command line to the end of the file with the relevant S3 bucket details, Customer Key, and service name:
1
@reboot curl -s https://s3.amazonaws.com/<download bucket>/granulate_run_gagent.sh | sudo \
2
CLIENT="<Client Key>" \
3
SERVICE="<Service Name>" \
4
bash
Copied!
Last modified 6mo ago