- 2 Minutes to read
- Print
- DarkLight
- PDF
Linux Install Overview
- 2 Minutes to read
- Print
- DarkLight
- PDF
Our Linux monitoring agent is a Java application that runs as a deamon service on your server.
Retrace also works with Docker. Please check out our installation guide for using Retrace with Docker or Docker Swarm.
Installing Retrace
Here is a script you can copy into your terminal that will download, un-tar, and install the agent all in one step. It is an interactive installer and will ask you for your activation key and environment name.
wget https://s1.stackify.com/Account/AgentDownload/Linux --output-document=stackify.tar.gz && tar -zxvf stackify.tar.gz stackify-agent-install-32bit && cd stackify-agent-install-32bit && sudo ./agent-install.sh
When prompted, enter your activation key that can be found within your Retrace account.
Enter your Environment Name when prompted. Your Environment will group your servers and Apps, so be sure to specify something meaningful (Prod, QA, etc).
Performing a "Silent" (Unattended or Automated) Install
If you are want to automate the installation, you can add a couple more parameters to the script and it can run silently and will not be interactive.
You need to add your key
and environment
as parameters.
wget https://s1.stackify.com/Account/AgentDownload/Linux --output-document=stackify.tar.gz && tar -zxvf stackify.tar.gz stackify-agent-install-32bit && cd stackify-agent-install-32bit && sudo ./agent-install.sh --key your_activation_key --environment your_environment_name
By adding these parameters, the installer will use the key and environment provided on the command line and won't prompt for any additional information during installation.
Updating an Existing Installation
If you already have an agent installed and need to manually update it (for instance, an automated update failed for some reason), use the following steps: Stop existing service if running (‘sudo service stackify-agent stop’, ‘sudo /etc/init.d/stackify-agent stop’, etc.)
sudo service stackify-agent stop
Run the original installation script with "--update" following the end of the script:
wget https://s1.stackify.com/Account/AgentDownload/Linux --output-document=stackify.tar.gz && tar -zxvf stackify.tar.gz stackify-agent-install-32bit && cd stackify-agent-install-32bit && sudo ./agent-install.sh --update
Start the service (‘sudo service stackify-agent start’, ‘sudo /etc/init.d/stackify-agent start’, etc.)
sudo service stackify-agent start
How to Uninstall Retrace
To remove the Stackify agent from you device, use the following command: Stop existing service if running (‘sudo service stackify-agent stop’, ‘sudo /etc/init.d/stackify-agent stop’, etc.)
sudo service stackify-agent stop
Remove the existing service:
sudo ./agent-install.sh --remove
Troubleshooting Installation
If your install is held up by glibc.i686 install, try running: 'yum install glibc.i686' You may see this output:
No package glibc.i686 available.
Error: Nothing to do
Check the yum.conf file, for an exclusion explicitly set for ".i686" files. This command is attempting to install 'glibc.i686' which would be excluded by this. Ex:
exclude=.i386 .i586 .i686 nginx php mysql
Advanced Configuration
Custom Server Name
During the install you can customize the server name used.
--devicealias "custom server name"
Stackify User IDs
The Stackify Agent creates a stackify user and group on install.
The ID for these can be customized during the install.
--uid #
and --gid #
Disable Change Detection
Change detection can be disabled via the stackify-agent.conf file by adding in
changeDetection=false