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 Nodes wizard. Install one-liners exist for most unix/linux distributions including OS X, Ubuntu, Debian, Cent OS, RHEL and AIX. Navigate to Discover and Add Nodes to open the Add Nodes wizard.
Locate the type of operating system or device you want to install the agent on. You can also use the search bar to narrow down the list.
Click the operating system of the new node and then select Use Agent.
Copy and paste the one-liner into a terminal window logged into the node you want to install the agent on.
The one-liner should:
- Download and install the agent
- Register the node with the website
- Start the agent in daemon mode
After the agent has successfully registered and reported in, the Wait for connection section should show a node as being registered. You can then proceed to scan the node for the first time by clicking Scan 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.