Monitoring Process Servers

on-site-related topic

Monitoring Process Servers are Platform Agents that monitor processes, logs, or sockets. A monitoring Process Server cannot process jobs or handle file events.

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

Procedure

Create a Monitoring Agent with the Wizard

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

Create a Monitoring Agent Manually

  1. Navigate to Configuration > Software.
  2. Download the appropriate installer for your platform.
  3. Install the Process Server on the server you want to monitor, do not register the Platform Agent with the central Redwood Server. If possible, use the default values, you must remember the port for later. Copy the SharedSecret String to a temporary location.
  4. In Redwood Server, navigate to Environment > Process Servers.
  5. Choose New Process Server from the context menu, select Manual Setup.
  6. On the Services tab, select PlatformAgentService.
  7. On the Parameters tab, choose Add, fill RemoteHostName into the Name field, a fully qualified domain name into the value field.
  8. Choose Add and fill SharedSecret into the Name field, paste the SharedSecret String from the installation into the value field.
  9. If you could not use port 1555 during the installation, choose Add, fill RemotePort into the name field and fill the port you specified during installation into the Value field.
  10. Click Save & Close.

Example

Installation on GNU/Linux

  1. Navigate to Configuration > Software.
  2. Download the linux-x86.bin installer.
  3. Install the Process Server 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, hit the Return key to accept the port, 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 Process Server inside Redwood Server

  1. In Redwood Server, navigate to Environment > Process Servers.
  2. Choose New Process Server from the context menu, select Manual Setup.
  3. On the Services tab, select PlatformAgentService.
  4. On the Parameters tab, choose Add, fill RemoteHostName into the Name field, a fully qualified domain name into the value field.
  5. If you could not use port 1555 during the installation, choose Add, fill RemotePort into the name field and fill the port you specified during installation into the Value field.
  6. Click Save & Close.

See Also