Monitoring Platform Agents

on-site-related topic

Monitoring Platform Agents monitor processes, logs, or sockets. A monitoring Platform Agent cannot process Jobs or handle File Events.

Note: This topic covers on-site environments. For SaaS environments, see Install SaaS Platform Agents.

Procedure

Create a Monitoring Agent with the Wizard

  1. Navigate to Configure > Control > Job Servers.
  2. Select Monitoring Only and click Next.
  3. Fill in the hostname of the monitored system as well as a port.
  4. Click Next.
  5. Specify a name for the Job Server, select a time zone and the appropriate installer for your platform; choose Next.
  6. Choose the matching installer.
  7. Download the installer to the server you want to monitor and execute the binary as an administrative user (Administrator or root).
  8. Start the new service or daemon on your server.
  9. Back in the wizard, choose Next and verify that the Job Server is running in RunMyJobs.
  10. If the Job Server remains in status Connecting, check the Operator Messages and logs on the monitored server.
  11. Click Save & Close.

Create a Monitoring Agent Manually

  1. Navigate to Configure > Admin > Configuration > Software Groups.
  2. Download the appropriate installer for your platform.
  3. Install the Job Server on the server you want to monitor. Do not register the Platform Agent with RunMyJobs. If possible, use the default values, you must remember the port for later. Copy the SharedSecret String to a temporary location.
  4. In RunMyJobs, navigate to Configure > Control > Job Servers.
  5. Click New.
  6. Select Manual Setup.
  7. On the Services tab, select PlatformAgentService.
  8. On the Parameters tab, click Add.
  9. Enter the RemoteHostName into the Name field. Enter a fully qualified domain name into the Value field.
  10. Choose Add. Enter SharedSecret into the Name field, and paste the SharedSecret string from the installation into the Value field.
  11. If you could not use port 1555 during the installation, click Add. Enter RemotePort into the Name field and enter the port you specified during installation into the Value field.
  12. Click Save & Close.

Example

Installation on GNU/Linux

  1. Navigate to Configure > Admin > Configuration > Software Groups.
  2. Download the linux-x86.bin installer.
  3. Install the Platform Agent on the server you want to monitor.
  4. Enter 1 for English and hit the Return key on your keyboard.
  5. Hit the Return key to install the Platform Agent to /opt/redwood/agent.
  6. Hit the Return key to create the directory, if asked to.
  7. Hit the Return key to accept default as the name for your Platform Agent instance.
  8. The installer will detect an IP port to use for the Platform Agent, starting at 1555. Press Return key to accept the port number, and write it down if it is not 1555.
  9. Hit the Return key to accept user nobody for Jobs, since you are not going to schedule Jobs on this system with this Platform Agent.
  10. Hit the Return key to accept setuid as the default user switching method. Note that this will not be used.
  11. Enter N as you do not want to register the Platform Agent.
  12. Hit the Return key to have the Platform Agent start automatically when the system starts.
  13. Hit the Return key to accept that the Platform Agent is updated automatically.

Configure the Job Server in RunMyJobs

  1. In RunMyJobs, navigate to Configure > Control > Job Servers.
  2. Click New.
  3. Select Manual Setup.
  4. On the Services tab, add PlatformAgentService.
  5. On the Parameters tab, click Add Enter RemoteHostName into the Name field, and enter a fully qualified domain name into the Value field.
  6. If you could not use port 1555 during the installation, click Add. Enter RemotePort into the name field, then enter the port you specified during installation into the Value field.
  7. Click Save & Close.