Help System If you need Tech-Support, email Bill Krahmer at ElectraSoft See what is new at ElectraSoft |
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. Installation Notes: Permissions Problems If you experience permissions problems it is most likely that you have a [Standard User] account. Changing your account to an [Administrator] account will fix this problem. You can not change your [Standard User] account to an [Administrator] account while logged into your own account because, (you guessed it), you do not have permission. To change your [Standard User] account to an [Administrator] account: Log off your account, log on to an [administrator account], change your account to an [Administrator] account, and reboot the computer. If you are running Windows Vista: o Click the [Start] button o Locate and select [Switch User] o Log on to an [administrator account] o Click the [Start] button o Select [Settings] o Select [ Control Panel] o Select [User Accounts] o Select [Manage another account] o Find and select [your user account] o Select [Change the account type] o Change your account to [Administrator] o Select [Change Account Type] o Reboot the computer 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. - Run as an NT Service If you want to run 32bit Service Monitor as an NT Service, check: [X]Run as an NT Service - Do not close at: [OnEndSession] Running 32bit Service Monitor as a Windows NT Service will allow 32bit Service Monitor to be active when there is no one logged on. People can log in and out of NT without interrupting the Monitoring of Services. When started with NT Services, there is a 30 second delay in starting to give Windows time to start the Internet connection. - 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 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 be 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 your web site at http://www.mygreatsite.com - you would enter www.mygreatsite.com in this field. - 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 number of 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. The format for this is: [Port Number] [a space] [Short description or note to help you remember]. Only the number is used by the monitor. Your note or comment does not effect the operation of the monitor. - 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) Service check timeout. The amount of time to keep trying to check a service before timing out. The default service check timeout 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. - Phone/Pager Check this to have 32bit Service Monitor notify you by phone or by pager when the service is down. - Page Setup Click this button to edit the settings to have the modem page you. - 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 file 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 service from the top. - Countdown Alert countdown converts the number of minutes between checks to seconds and counts them down to 0. When the countdown reaches 0, the given service is checked. - Earth Spins while a service is being checked. When the monitor is disabled the earth is gray, but when the monitor is enabled it is in color. - Light Green when everything is ok. Yellow if the service has 1 or more failed checks, but has not failed the maximum allotted times. Red when the service has failed the maximum allotted times. Gray when the monitor is disabled. If you are using the System Tray feature, and all of the lights are green, the system tray icon will be green. If one or more of the lights turn yellow, the tray icon will turn yellow too. If one or more of the lights turn red, the tray icon will turn red too. In the system tray icon color scheme, the higher error level will always override the lower. - Failures and Alert Failurestells you the number of times the service has been down on a check. Where X is the number of times. Alerts tells you how many failed checks is required before alerting you that the site is down. 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. -Back to the Top-