Overview

This article will describe how to set up and run a recovery script with an Uptime Infrastructure Monitor Action Profile. There are three main steps for this process:

Creating a Recovery Script

The recovery script will depend on the desired action and will need to be developed based on the user's specific environment. After the agent-side script is written, the Uptime Infrastructure Monitor agent will need to be configured to execute it. As a minimum, configure the following settings for each agent-side command:

Verify that the agent-side command permissions allow the execution of the command by the user that the agent is run as. If the commands within your script require additional system permissions, you may need to alter the security settings for the execution of the agent.

Creating a Monitoring Station Script

The next step is to write a monitoring station script that will attempt to execute your agent-side script so the action profile can perform the task based on the script's output. The monitoring station script can be written in any language and format provided that it adheres to these general rules:

In most cases the monitoring station script will contact an agent system and attempt to run a pre-defined agent-side script. You can use any transport tool (e.g. rexec, rsh or ssh) to contact the agent system. However, we recommend using the bundled agentcmd or netcat utility to contact your agent systems from your monitoring station script.

The agentcmd utility is commonly called in the format listed below to execute a command on the agent-side system. The following example uses the settings that were configured above to execute the agent-side script:

The netcat utility is commonly called in the format listed below to execute a command on the agent-side system. This example uses the settings that were configured above to execute the agent side script:

For monitoring stations running on Windows:

    1. Open a command prompt and go to the <uptime dir>uptimescripts folder.
    2. Run the following command to verify if you can create a rexec session:
      agentcmd.exe -s -p 9998 [hostname] "rexec [password] [CommandName]"
      For example: C:Program Filesuptime softwareuptimescripts>agentcmd.exe -s -p 9998 testhost "rexec uptime test"

Creating an Action Profile and Adding it to a Service Monitor

The next step is to create an Uptime Infrastructure Monitor Action Profile. Detailed steps for this process can be found on the Help link of the Uptime Infrastructure Monitor web interface. However, the basic functions are as follows:

Example Monitor Configuration

Related Article

Creating an Action Profile to Start Any Windows Service