Help System If you need Tech-Support, email us at support@electrasoft.com (Bill Krahmer) See what is new at ElectraSoft:www.electrasoft.com |
Subject: Item Number: 1. About This Manual 1 Buttons and Dialog Box Items 1 2. Getting Started 2 Installing 32bit Service Monitor 2 3. [Global Options] Tab 3 Global Options 3 Session Log File Status 3 4. Configure/Monitor Services 4 Service X ]> 4 Service X 4 Define Service 4 Configure Alerts 4 Select Alerts 4 Status Area 4 5. Activity Log 5 Activity Log 5 6. Menu Items 6 Exit 6 SessionLog 6 Sound 6 Help 6 Register 6 |
Item 1 - About This Manual - Buttons and Dialog Box Items While reading this manual, words in square brackets [ ] will be in reference to [Buttons and Dialog Box Items].-Back to the Top- Item 2 - Getting Started - Installing 32bit Service Monitor Go to http://www.electrasoft.com/32bs.htm and download the newest version. During installation, it will ask you for your registration name and email address. Enter the name and email address you want 32bit Service Monitor to be registered to. This is the name and email address that you will be known to us at ElectraSoft as. Item 3 - [Global Options] Tab - Global Options - Use System Tray Check this if you want 32bit Service Monitor to minimize to the system tray instead of the Windows Task Bar. - Hide in Tray at Startup if [Tray] is Checked Check this if you want 32bit Service Monitor to hide in system tray at startup. - Show only first line of response in Activity Log If you are checking a large file, like index.htm, it may not be necessary to fill the Activity Log with the contents of this file. check this check box so it will only show a one line response. - Max services examined simultaneously This is the number of services that will be checked at simultaneously. ie: If you have 20 services being monitored and when they are checked, if you only want to check 2 at one time then check the next 2 when those checks have completed, you would set this value to [2]. - Max number of services available This is the number of services that will be able to br monitored at the same time. The number of services available will be the number of service tabs you will be able to select under [Configure/Monitor Services] Deciding how many services to select: Each service that you allow uses considerable memory and resources. Whether or not you fill in the service forms or run them, they use approximately the same amount of memory. So if you need to monitor more services, select as many as you need. If you need less services, you should select less. - Session Log File Status - No session log file Select this if you do not want 32bit Service Monitor to keep any session logs. - One log file, append to it each session Select this if you want 32bit Service Monitor to keep one session log and append each session's log to it. - New log file with new name each session Select this if you want 32bit Service Monitor to create a new session log for each session of 32bit Service Monitor. - Delete all Session Log files on exit Check this to have 32bit Service Monitor delete any session log files saved. This will take place upon exiting 32bit Service Monitor. Item 4 - [Configure/Monitor Services] Tab - Service X ]> This is the first item in the tab. It is a drop down list box. You can select which service to view/configure with this list. The following settings for the [Configure/Monitor Services] Tab will be in all of the Service X tabs. Where X is a number between 1 and the [Max number of services available], which is selected in the Global Options. - Service X These are tabs 1 - 20 that are services you can choose to view/configure. In any of these tabs, the following fields and information will be there: - Define Service - Service Name This is where you can specify the name of the service you want to monitor. This is for your reference, so you can identify a certain service. - Host/Site/IP This is where you specify the host/IP address of the service you want to monitor. ie: If you wanted to monitor youw web site at http://www.mygreatsite.com , you would enter: [www.mygreatsite.com] in this field (without the square brackets). - Command/Script (optional) You can type in a single command or a reciprocal script. Running a Command/Script: If the service checks ok, then it looks to see if there is a command or script to be run. If there is no command or script, the service check returns and logs an ok. If there is a command or script, it must also check ok if the service check is to log an ok. Script Format: The odd lines (1,3,5,7,etc) are sent to the service. The even lines (2,4,6,8,etc) are the responses that you are expecting from the service. In most cases only the significant characters of the response are needed. For instance, if the expected response is [220 Please enter your user name], you would only need to put 220 as the response line. Then you can send an optional QUIT and expect back a response of [221-You have transferred 0 bytes in 0 files. See the port [21 ftp] example below. How the Command/Script Works: The first line is sent to the service. The next line is compared to the response from the service. If the response is the same as the script line, the service is checked as ok. If not, it is logged as an error. If the script has an uneven number of lines, the script will always return ok, because being that the last expected response is not defined, the response is logged but it is not considered while determining the error condition. Command/Script example for port [80 http]: ---- start script ---- GET / 200 ---- end script ---- This script will read your default home page. This is usually index.html, index.htm, or default.html. GET /thispage.htm will read thispage.htm and GET /thispage.html will read thispage.html. If the script is successful, it will return with something like: HTTP/1.1 200 OK If the script fails, it will return with something like: HTTP/1.1 302 Found The format may change a little from one server to another. 32bit Service Monitor will resolve this for you. You are only interested in the numbers 200 and 302. Command/Script example for port [21 ftp]: ---- start script ---- USER UserName 220 PASS PassWord 230 QUIT 221 ---- end script ---- Command/Script example for port [25 smtp]: ---- start script ---- 220 QUIT 221 ---- end script ---- Note that the first line of this script can be a blank line. If we make a good connection, we may not need to send a command to get a responce. As with an SMTP, we need to get the 220 responce to the succsessful connect. So the first line of the Script should be blank. If it is blank, we will not send the command, but we will receive the SMTP 220 responce to the connect. Then we send the command QUIT, and the SMTP will respond with a 221. If you have a one line command or script ie: [GET /]. The command will show in the activity log. The response will also show in the activity log, but the check will always be seen as checking ok. This ok scenario assumes that everything else was ok up to the point of running the command or script. If there is an error making connect with the service before the script is run, the check will return an error. When the user define number of failed or errored checks are satisfied, the user defined alerts will be activated. - Port (0 - 65535) Port is where you can specify the port number on the remote [Host, Name, or IP] that is being monitored. The port used for a web site is usually port [80 http]. An FTP site is usually on port [21 ftp]. In the list of port numbers, the service name usually used on that port appears next to the number. - Configure Alerts - Minutes between checks This is where you specify the number of minutes between checks on the specified service being monitored. - Failed checks before alert This is where you specify the number of failed checks before you are alerted. - Timeout, seconds (20) This is where you specify the amount of time to keep trying to check a service. The default is 20 seconds. If 20 seconds is specified, the service will be given 20 seconds to respond before being counted as a failed check. - Select Alerts In order from top to bottom and left to right: - Error Sound Check this to have 32bit Service Monitor play the Windows default error sound when the service is down. - Play WAV file Check this to have 32bit Service Monitor play a specified WAV file when the service is down. - Repeatedly Check this to have 32bit Service Monitor play the specified sound in a continuous loop until the service is back up or until you uncheck it. - Browse Click this button to browse and select a WAV file to play if [Play WAV file] is checked. - Test Click this button to test the sound currently selected. - Show Alert Message Box Check this to have 32bit Service Monitor pop up an alert window when the service is down. - Send Email at Beginning of Alert Check this checkbox to have 32bit Service Monitor email a message to you, telling you when the service goes down. This message can be emailed to one email address or to a whole list of email addresses. - Edit Email Click this button to edit the email message that will tell you the service is down. - Send Email at Ending of Alert Check this checkbox to have 32bit Service Monitor email a message to you, telling you when the service is back up. This message can be emailed to one email address or to a whole list of email addresses. - Edit Email Click this button to edit the email message that will tell you the service is back up. - Pager Check this to have 32bit Service Monitor notify you by a pager when the service is down. - Page Setup Click this button to edit the settings for the pager and modem settings. - Execute Program Check this to have 32bit Service Monitor start a specified program when the service is down. - Browse Click this button to browse and select an executable file to run if [Execute Program] is checked. - Test Click this button to test the executable currently selected. - Status Area - Monitor Service When this is checked, the current service will be monitored. - Reset Click this button to: reset the number of failed checks to 0, check the service right away, and start the count down to check the servicefrom the top. - Errors and Alert Errorstells you the number of times the service has been down on a check. Where X is the number of times. Alerts Item 5 - [Activity Log] Tab - Activity Log Here is where you will see the activity log since 32bit Service Monitor was started. When you exit and start the program, the activity log will clear and start a new log in here for the session. Item 6 - Menu Items - Exit Click this to exit 32bit Service Monitor. - SessionLog Click this to open the current Session Log/Activity Log in your Windows default text editor. - Sound - Sound, Enable/Disable When [Disable] is clicked, the sound alerts in 32bit Service Monitor will be disabled. If there are any sounds queued to be played from an alert, the events will be deleted and the sounds will not be played. The next time the Sound menu is brought down, it will read [Enable] instead of [Disable], or vice versa. - Sound, Flush Queue When [Flush Queue] is clicked, any sound that is queued to be played due to an alert, will be deleted and the sounds will not be played. - Help Click this to bring up the menu of help and information items. - Register If you are an unregistered user (If you have not paid for 32bit Service Monitor), then you will see this menu item. Click it if you wish to register (Pay for 32bit Service Monitor). You can try 32bit Service Monitor before you buy it. If you want to continue using this software after trying it, you must purchase it by registering it with ElectraSoft. This means you have a chance to test the performance of 32bit Service Monitor before committing yourself to buying it. Before paying, you will only be able to monitor one service at a time. After you pay ElectraSoft for the use of [32bit Service Monitor], you will be able to monitor up to five services at a time.tells you how many failed checks is required before alerting you that the site is down. -Back to the Top-