Download and Installing
The recommended and easiest way to install the UpGuard unix agent is using the provided one-liner install scripts from the Add Node wizard. Install one-liners exist most unix/linux distributions including OS X, Ubuntu, Debian, Cent OS, RHEL and AIX. To access this simply login and click the Discover subnavigation button under the Discover heading.
Click Linux / Unix.
Select your OS from the dropdown list and then copy the one line command.
Run this command on your target node. The command will:
- Download and install the agent
- Register the node with the website
- Start the agent in daemon mode
After the install script has run, return to the UpGuard website and click Continue to scan your node.
You can update the UpGuard agent by visiting the downloads page and downloading a copy of the latest installer.
The UpGuard agent can be uninstalled by running the appropriate OS uninstall one-liner.
Uninstallation can be verified by running
ps -ef | grep guardrail.
The uninstall one-liner will not remove from the node from the UpGuard website. This will need to be done manually.
sudo /Library/Application\ Support/ScriptRock/GuardrailAgent/uninstall.sh
RedHat / CentOS
yum remove scriptrock-guardrail-agent
Ubuntu / Debian
apt-get remove scriptrock-guardrail-agent
The agent can be restarted by stopping and starting its service.
sudo guardrail_agent service stop sudo guardrail_agent service start
Kicking off a Node Scan
guradrail_agent process will poll for node scan tasks to run from the UpGuard
website. Alternatively, the
guardrail_agent can also kick off a node scan on its own.
grepfor the process id of
ps -ef | grep guardrail_agent
Send the process a USR1 signal:
kill -s USR1 <guardrail_agent_pid>
A node scan will then be kicked off and can be viewed running under Report -> Job History.