Adding and editing an Active Script Active Monitor

The Active Script monitor lets you write either VBScript or JScript code to perform specific customized checks on a device. If the script returns an error code, the monitor is considered down. A variety of Active Script resources are available on the Active Scripts Resource page.

Note: Ipswitch does not support any custom scripts you create; only the ability to use them in the Active Script monitor. For more information, see Extending WhatsUp Gold with scripting.

To add a new Active Script active monitor:

1. From the WhatsUp Gold web interface, go to Admin > Monitors. The Monitor Library dialog appears.
2. Click the Active tab. The Active Monitor list appears.
3. Click New. The Select Active Monitor Type dialog appears.
4. Select Active Script Monitor, then click OK. The New Active Script Monitor dialog appears.
5. Enter or select the appropriate information:
   • Name. Enter a unique name for the active monitor. This name displays in the Active Monitor Library.
   • Description. Enter additional information about the monitor. This description displays next to the monitor in the Active Monitor Library.
   • Timeout. Enter the length of time WhatsUp Gold attempts to connect to the selected device. When the time you enter is exceeded without connecting, a timeout occurs and WhatsUp Gold stops trying to connect to the SMTP server. This is considered a failed connection.
   • Script Type. Select either VBScript or JScript.
   • Use in rescan. Select this option to have the monitor appear in the Active Monitor list on the Device Properties dialog. WhatsUp Gold adds the monitor type to the device during a rescan, which is launched using Rescan on the Device Properties dialog, if the protocol or service is active on the device.
   • Use the Direct Data Access execution model. Select this option to use the Active Script Monitor execution model that was available prior to the WhatsUp Gold 16.2 SP3 release. This option may be more susceptible to Active Script monitor script errors; however, it allows you to use the Context.GetDB context object in scripts for direct interaction with the WhatsUp Gold database.
   • Use the Isolated Process execution model. Select this option to use the Active Script Monitor execution model that became available in the WhatsUp Gold 16.2 SP3 release. This option may be less susceptible to Active Script monitor script errors, therefore providing more protection and stability for the WhatsUp Gold poller engine (nmservice.exe); however, it DOES NOT allow you to use the Context.GetDB context object in scripts for direct interaction with the WhatsUp Gold database.
   • Script text. Enter your monitor code in this box.
6. Click OK to save changes.
7. After configuring an active monitor in the Active Monitor Library, add the monitor to devices.

To edit an existing Active Script active monitor:

1. From the WhatsUp Gold web interface, go to Admin > Monitors. The Monitor Library dialog appears.
2. Click the Active tab. The Active Monitor list appears.
3. Select the monitor you would like to edit, then click Edit. The Edit Active Script Monitor dialog appears.
4. Enter or select the appropriate information:
   • Name. Enter a unique name for the active monitor. This name displays in the Active Monitor Library.
   • Description. Enter additional information about the monitor. This description displays next to the monitor in the Active Monitor Library.
   • Timeout. Enter the length of time WhatsUp Gold attempts to connect to the selected device. When the time you enter is exceeded without connecting, a timeout occurs and WhatsUp Gold stops trying to connect to the SMTP server. This is considered a failed connection.
   • Script Type. Select either VBScript or JScript.
   • Use in rescan. Select this option to have the monitor appear in the Active Monitor list on the Device Properties dialog. WhatsUp Gold adds the monitor type to the device during a rescan, which is launched using Rescan on the Device Properties dialog, if the protocol or service is active on the device.
   • Script text. Enter your monitor code in this box.
5. Click OK to save changes.

See Also Configuring Active Monitors Adding and editing a Domain Service (DNS) Monitor Adding and editing a Service Monitor Adding and editing a Ping Monitor Adding and editing a Power Supply Monitor Adding and editing a SNMP Active Monitor Adding and editing an SSH Active Monitor Adding and editing a Telnet Monitor Using telnet to determine "Expect on Connect" string Adding and editing a TCPIP Monitor Adding and editing a WAP Radio Monitor