Download a 30-Day free trial

HomeDocumentationPrinter Friendly Version

Documentation

1. Overview

1.1. Installation

System Requirements:
  -Windows XP (Home and Pro), Windows 2003 Server, and Windows Vista (all editions).
  -Microsoft .NET Framework 2.0.
The Simple Server Monitor installer will install the framework if it is not present.

The Simple Server Monitor installer can be obtained from our download page.  If the .NET runtime isn't already installed or the program needs to be installed into c:\Program Files, the installer must be ran from an Administrator account.  The application can be run for 30 days without a serial number.  After 30 days, a serial number must be entered for the application to run.

2. Configuration

2.1. Server

To add a server, select File -> Add Server, from the Main Menu, or right-click on the server panel and select Add Server. Doing either will bring up the "Add a Server" dialog.  Monitors are added to a server by right-clicking on the server in the Server Panel and selecting Add Monitor.

Server settings dialog.

Hostname:  This must be the server's IP address or fully qualified domain name (i.e. www.example.com).  This is a required field.
Friendly Name (optional): A name to identify this server.
Location (optional):  Where the server is located.  This allows you to sort your servers by location in the Server Panel.
Server Notes (optional): Any notes regarding this server.
Alert E-Mail Address(es): E-Mail addresses to send alert messages to when a monitor attached to this server fails.
Override E-Mail Addresses: Check this box to have alert messages sent the e-mail specified above, rather than the default e-mail addresses.
Server Monitoring Enabled: Check this box to enable monitoring for this server.
Create a Ping Monitor: Check this box to create a Ping monitor for this server.  The monitor will ping the server every 15 minutes.

2.2. E-Mail Alerts

E-Mail Alert settings dialog. 

Simple Server Monitor only e-mails monitor failures and recoveries.

E-Mail Address(es):  This is a comma separated list of e-mail addresses to send an alert to.  There must be at least one address.
SMTP Server:  The SMTP server to send the e-mail through.  It must be an IP address or a fully qualified domain name.
SMTP Port:  The port of the SMTP server uses.  Defaults to 25.
Check to use SSL:   Check this box if the SMTP server requires an SSL connection.
SMTP server requires a username and password:  Check this box if the SMTP server requires the user to authenticate.
UsernameThe user's SMTP username.
Password:  The user's SMTP password.
Enable e-mail alerts:  Check this box to enable e-mail alerts.
Customize E-Mail Button:  Clicking this button will bring up the Customize E-Mail Alerts dialog.
Test Settings Button:  Tests the given settings by logging into the specified SMTP server and sending test message.

2.3. Customize E-Mail Alerts


This dialog allows you to specify the body and subject for both the failure and recovery e-mail alerts. 

Variables that can be used:
%NOW% = Current time.
%NAME% = Servers's friendly Name.
%HOSTNAME% = Server's hostname.
%LOCATION% = Server's location.
%MONITOR% = Monitor summary.
%PORT% = Port being monitored.
%RESPONSETIME% = If the monitor response time (only applicable to monitor recoveries).
%ERROR% = Monitor error message (only applicable to monitor failures).

2.4. Pop-up Alerts


Enable pop-up alerts 

Display a pop-up alert when a monitor fails: Check this box to display a pop-up when a monitor fails.
Display the main application when closing a pop-up:  If the box is checked, the main application will open when the pop-up is closed.
Automatically close the pop up after XX seconds:  If the box is checked, the pop-up will automatically close after the given number of seconds.

2.5. Sound Alerts

Sound Alert

Sound alerts are played when a monitor fails.

Sound File:  This the sound file to play.  Only WAV files are supported.
Play a sound when a monitor fails:  Check this box to play the given sound when a monitor fails.

2.6. Launch External Application

Launch Alert

If enabled, the application is launched when a monitor fails.

Program:  The program to launch when a monitor fails. For example to integrate with Notepage's NotePager Pro SMS text message software, select Browse to find NPP.exe (usually C:\Program Files\NotePager Pro\NPP.exe)
Program Options:  The options to pass to the application when it launches.   Users can use the the four variables defined below as program options. Using NotePager Pro as an example again, you could enter "username from %HOSTNAME% %MONITORDETAILS% FAILED-Please check" to get an SMS text page to your pager or phone (where username is your user account with NotePager Pro, from is the "From" for the text message and everything after that is sent as the body of the message with the variable names replaced as appropriate).  
Run in a command shell:  If the box is checked, the program will be launched from a command shell (i.e. DOS prompt).  This option should only be used if you are launching a command line program.
Run a program when a monitor fails:  Check this box to launch the given application when a monitor fails.

Variables that can be used as program options.
%HOSTNAME% = The server's hostname
%LOCATION% = The server's location.
%MONITORTYPE% = The monitor's type (ping, http, etc.)
%MONITORDETAILS% = The monitor's details.

2.7. Log Settings

Log File:

Enable log file.
If file logging is enabled, you must specify a directory to place the log files.  The log files are comma separated files and are named simpleservermonitor_MMDDYYYY.csv.  The log files will be rotated daily and contain all Simple Server Monitor alerts (activation, success, failure, recovery, and deactivation). 

Event Log:

Enable logging to the event log.
If event logging is enabled, all Simple Server Monitor alerts except success are logged in the Application Event Log.


2.8. Ping Monitor

Ping monitor dialog.

Packet Size:
  The size of the data packet to ping the server with.  64 bytes is sufficient for most users.  The size must be between 8 and 1024 bytes.
Interval:  This is the number of minutes between the monitor queries.  It must be between 1 and 1440 (one day).
Timeout:  This is the number of milliseconds before the monitor query is considered a failure.
Monitor Enabled:  Check this box to enable the monitor.
Retries:  If the monitor fails, this number of times the monitor will attempt to reconnect before notifying you of the failure.  The retry attempts occur at one minute intervals, regardless of the interval setting.  The monitor will report the failure immediately in the Retries value is set to zero.

2.9. HTTP Monitor

HTTP monitor dialog.

The HTTP monitor connects to a HTTP server, sends the given request, waits for a response, and then disconnects.

URL Query String:  This is the page on the server the monitor should try to access (i.e. index.html, not http://www.example.com/index.html).  For the default page, the query string can be left empty.  If the request type is set to Post, you will need to provide the Post variables (i.e. page.aspx?var1=a&var2=b).
Use HTTPS:  Check this box if the monitor should connect using SSL/TLS.
Request Type:  The HTTP request type - Head, Get, or POST.
Server Port:  The port the monitor should connect to.  The default HTTP port is 80.  Valid port numbers are 1 to 65535.
Interval:  This is the number of minutes between the monitor queries.  It must be between 1 and 1440 (one day).
Timeout:  This is the number of milliseconds before the monitor query is considered a failure.
Retries:  If the monitor fails, this number of times the monitor will attempt to reconnect before notifying you of the failure.  The retry attempts occur at one minute intervals, regardless of the interval setting.  The monitor will report the failure immediately in the Retries value is set to zero.
Monitor Enabled:  Check this box to enable the monitor.

2.10. FTP Monitor

FTP Monitor

The FTP monitor connects to a FTP server and then disconnects. 

Login Anonymously:  Check this box to log into the FTP server anonymously.
Use SSL/TLS:  Check this box to connect to the FTP server using SSL/TLS.  The server must be running in SSL/TLS mode.
FTP username:  The FTP username to use.
FTP Password:  The  FTP password to use.
Server Port:  The port the monitor should connect to.  The default FTP port is 21.  Valid port numbers are 1 to 65535.
Retries:  If the monitor fails, this number of times the monitor will attempt to reconnect before notifying you of the failure.  The retry attempts occur at one minute intervals, regardless of the interval setting.  The monitor will report the failure immediately in the Retries value is set to zero.
Interval:  This is the number of minutes between the monitor queries.  It must be between 1 and 1440 (one day).
Timeout:  This is the number of milliseconds before the monitor query is considered a failure.
Monitor Enabled:  Check this box to enable the monitor.

2.11. SMTP Monitor

SMTP monitor dialog.

The SMTP monitor connects to a SMTP server, sends an e-mail, and then disconnects. 

Send E-Mail To:  The e-mail address to send the monitoring message to.
Send E-Mail From: The e-mail address that goes monitoring should appear to come from.
Use SMTP Authentication:  Check this box if the SMTP server requires a username and password.
SMTP Username:  The SMTP username to use.
SMTP Password:  The  SMTP password to use.
Use Secure SMTP:  Check this box to connect to the SMTP server using SSL.  The server must be running in SSL mode.
Server Port:  The port the monitor should connect to.  The default SMTP port is 25.  Valid port numbers are 1 to 65535.
Retries:  If the monitor fails, this number of times the monitor will attempt to reconnect before notifying you of the failure.  The retry attempts occur at one minute intervals, regardless of the interval setting.  The monitor will report the failure immediately in the Retries value is set to zero.
Interval:  This is the number of minutes between the monitor queries.  It must be between 1 and 1440 (one day).
Timeout:  This is the number of milliseconds before the monitor query is considered a failure.
Monitor Enabled:  Check this box to enable the monitor.

2.12. POP3 Monitor

POP3 monitor dialog.

The POP monitor connects to a POP server, logs in using the given username and password, and then disconnects. 

POP Username:  The POP username to use.
POP Password:  The  POP password to use.
Use Secure POP:  Check this box to connect to the POP server using SSL.  The server must be running in SSL mode.
Server Port:  The port the monitor should connect to.  The default POP port is 110.  Valid port numbers are 1 to 65535.
Retries:  If the monitor fails, this number of times the monitor will attempt to reconnect before notifying you of the failure.  The retry attempts occur at one minute intervals, regardless of the interval setting.  The monitor will report the failure immediately in the Retries value is set to zero.
Interval:  This is the number of minutes between the monitor queries.  It must be between 1 and 1440 (one day).
Timeout:  This is the number of milliseconds before the monitor query is considered a failure.
Monitor Enabled:  Check this box to enable the monitor.

2.13. IMAP Monitor

IMAP monitor dialog.

The IMAP monitor connects to an IMAP server, logs in using the given username and password, and then disconnects. 

IMAP Username:  The IMAP username to use.
IMAP Password:  The IMAP password to use.
Use Secure IMAP:  Check this box to connect to the IMAP server using SSL.  The server must be running in SSL mode.
Server Port:  The port the monitor should connect to.  The default IMAP port is 143.  Valid port numbers are 1 to 65535.
Retries:  If the monitor fails, this number of times the monitor will attempt to reconnect before notifying you of the failure.  The retry attempts occur at one minute intervals, regardless of the interval setting.  The monitor will report the failure immediately in the Retries value is set to zero.
Interval:  This is the number of minutes between the monitor queries.  It must be between 1 and 1440 (one day).
Timeout:  This is the number of milliseconds before the monitor query is considered a failure.
Monitor Enabled:  Check this box to enable the monitor.

2.14. Custom Monitor

Custom monitor dialog.

The custom monitor allows users to test a connection to any port on the server.  The monitor will connect to the give port  and then disconnect. 

Server Port:  The port the monitor should connect to.  Valid port numbers are 1 to 65535.
Interval:  This is the number of minutes between the monitor queries.  It must be between 1 and 1440 (one day).
Timeout:  This is the number of milliseconds before the monitor query is considered a failure.
Retries:  If the monitor fails, this number of times the monitor will attempt to reconnect before notifying you of the failure.  The retry attempts occur at one minute intervals, regardless of the interval setting.  The monitor will report the failure immediately in the Retries value is set to zero.
Use SSL/TLS:  Check this box to connect to the port using SSL/TLS.  The server must be running in SSL/TLS mode.
Monitor Enabled:  Check this box to enable the monitor.

Release Notes

1. 2.0

  • Monitoring engine now runs as a Windows Service. 
  • Added the ability to pause monitoring.
  • Added the ability to specify alert e-mail addresses on a per server basis.
  • Added user customizable e-mail alerts.
  • Added Office 2007 blue and black skins.
  • Other minor improvements and bug fixes.

2. 1.4

  • Added sound alerts.
  • Added the ability to launch an external application if a monitor fails.
  • Added a number of retries option to monitors. This is the number of times a monitor should retry to connect before reporting a failure.
  • Added a name field to Custom monitors.
  • Sending an e-mail from the SMTP monitor is now optional.
  • Pop-up alerts no longer steal focus.
  • Pop-up alerts can now be configured to not open the main console and to close after a set time period.
  • Updated the pop-up alert window to match current skin.
  • Fixed: Custom monitors connecting over SSL were not connecting correctly.
  • Fixed: Minor interface inconsistencies.

3. 1.3

  • Minor GUI enhancements.
  • Chart titles were not updating when the underlying server or monitor was updated.
  • Several bugs that caused the program to crash randomly.

4. 1.2.2

  • Added an icon toolbar.
  • Added an error reporter.
  • Updated data schema to be compliant with upcoming service version.
  • Fixed: Charts for disabled monitors were not grayed out on start up.
  • Fixed: Removed bare LF's in SMTP code.

5. 1.2

  • Allows non-standard ports for HTTP/HTTPS monitors.
  • Monitor charts are now sortable.
  • Server and monitor configurations are now stored in an XML format.
  • Log files are now comma separated files.
  • Starts up automatically when a user logs in (optional).
  • Several bug fixes and minor GUI enhancements.

6. 1.1

  • Added SSL/TLS support to the FTP monitor.
  • Added SSL/TLS support to the Custom monitor.
  • Decreased the number of background threads to 4 per CPU to increase throughput.
  • The Custom monitor no longer sends "Hello\n\n" after connecting.
  • Double clicking on a chart brings up larger version of the chart with more data points.
  • Removed gray background from charts.
  • Made other minor GUI enhancements.