5. 5
Preface
This guide explains how to install, license, and configure eHealth®
Service Availability Release 1.3 Patch level 1. This release of Service
Availability supports the monitoring of common Internet
applications on the following operating systems:
• Sun™ Solaris™ (SPARC) 2.6 through 2.9
• Microsoft Windows® NT 4.0, Windows® 2000,
Windows XP, and Windows 2003
• Red Hat™ Linux™ 6.0 through 9.0, and AS 2.1
• HP-UX™ 11.0 and 11i
Audience
This guide is intended for the person who is installing and
configuring Service Availability to monitor the response time and
availability of critical Internet applications. To use this guide, you
must have a basic familiarity with the SystemEDGE agent, the
Internet applications you are monitoring, and your operating
system environment.
About This Guide
This section describes the changes and enhancements that have
been made since the last release of this guide. It also includes the
documentation conventions used in this guide.
6. 6 • Preface
Revision Information
This guide supports eHealth Service Availability Release 1.3
Patch 1. Since the last release, this guide has been updated to
describe the following new features:
• Multi-threaded tests and the Java collector
• New columns in the Configuration Details table of the
Service Availability query and new fields in the Service
Availability table for throughput, results, and errors
• New tests for round-trip e-mail, HTTP content, and
running a record/playback script (virtual user)
• New arguments for tests
Documentation Conventions
Table 1 lists the conventions used in this document.
Table 1. Documentation Conventions (Page 1 of 2)
Convention Description
7. Text that refers to file or directory
eHealth Service Availability User Guide
names.
code Text that refers to system, code, or
operating system command line
examples.
emphasis Text that refers to guide titles or text
that is emphasized.
enter Text that you must type exactly as
shown.
Name Text that refers to menus, fields in
dialog boxes, or keyboard keys.
New Term Text that refers to a new term, that is,
one that is being introduced.
Variable Text that refers to variable values that
you substitute.
8. Technical Support • 7
Table 1. Documentation Conventions (Page 2 of 2)
Convention Description
→ A sequence of menus or menu
options. For example, File → Exit
means “Choose Exit from the File
menu.”
NOTE Important information, tips, or other
noteworthy details.
CAUTION Information that helps you avoid
data corruption or system failures.
WARNING Information that helps you avoid
personal physical danger.
eHealth Service Availability User Guide
Technical Support
If you have a Support Contract ID and password, you can
access our Support Express knowledgebase at the following
URL: http://search.support.concord.com.
If you have a software maintenance contract and need any
assistance with eHealth, contact Technical Support at the
following:
Phone: (888) 832-4340
(508) 303-4300
E-mail: support@concord.com
Web site: http://www.concord.com
9. 8 • Preface
Professional Services
If you need any assistance with customizing eHealth, contact
Professional Services at the following:
eHealth Service Availability User Guide
Phone: (800) 851-8725
Fax: (508) 486-4555
E-mail: proserv@concord.com
Web site: http://www.concord.com
10. 9
1
Introduction
Introducing eHealth Service Availability
eHealth SystemEDGE is a
Simple Network Management
Protocol (SNMP) agent that
enables remote management
systems to access important
information about systems.
eHealth® Service Availability is a plug-in to eHealth
SystemEDGE™ that monitors the response and availability of
critical network services. Through Service Availability, the
SystemEDGE agent performs active test transactions to
measure response time and track availability for the following
Internet applications:
• Domain Name System (DNS)
• File Transfer Protocol (FTP)
• Hypertext Transfer Protocol (HTTP)
• Secure HTTP (HTTPS)
• Packet Inter-Network Groper (PING) (also known as
Internet Control Message Protocol [ICMP] echo)
• Network News Transfer Protocol (NNTP)
• Post Office Protocol version 3 (POP3)
• Simple Mail Transfer Protocol (SMTP)
• Transmission Control Protocol connections
(TCP Connect)
11. 10 • Chapter 1 Introduction
Service Availability also enables you to create custom scripts
and programs and use them to define service tests for additional
services. In addition, you can create round-trip e-mail tests and
HTTP content tests. For Windows systems, you can also create
virtual user tests, which enable you to run a record/playback
script.
NOTE
eHealth Service Availability User Guide
Service Availability HTTPS tests do not support sites that
are signed by a private Certificate Authority. In this release,
the HTTPS test supports only sites that are signed by public
Certificate Authorities.
Using eHealth Service Availability
eHealth Service Availability provides the flexibility you need to
monitor service delivery. You can use Service Availability to
monitor all critical applications on a single system or to
monitor a particular service or application across a group of
systems. You can also modify Service Availability tests in real
time so that you always get the information you need.
The SystemEDGE agent provides configuration and reporting
for the Service Availability module through Simple Network
Management Protocol (SNMP). Its self-monitoring and
autonomous management capabilities work with the data that
Service Availability gathers.
You can configure Service Availability and the SystemEDGE
agent to do the following:
• Monitor the availability and response times of various Web
servers, and send a warning when the servers become
unavailable.
• Warn you of response slowdowns or unavailable
applications.
• Test site access and issue an alarm if it detects a service
disruption.
12. Multi-Threaded Tests • 11
eHealth Service Availability User Guide
1
Multi-Threaded Tests
Service Availability Release 1.3 and later is multi-threaded to
allow multiple, simultaneous tests. You can configure up to
1500 tests from one Service Availability module. You specify the
maximum number of threads the module should use during the
Service Availability installation. For more information, refer to
Chapter 2, “Installing eHealth Service Availability.” If you want
to modify the maximum number of threads after the
installation, you must edit the maxthreads entry in the
file. After you do so, you must stop and restart the SystemEDGE
agent. For instructions, refer to the eHealth SystemEDGE User
Guide.
Using eHealth Service Availability
Service Availability stores test information in the Service
Availability table and the file. You can create sample
test transactions with Service Availability by doing any of the
following:
• Manually editing the svcrsp.cf file. For more information,
refer to “Manually Editing the Service Availability
Configuration File” on page 41.
• Running the svcwatch utility. For more information, refer
to “Using the svcwatch Utility” on page 58.
• Using the SystemEDGE agent configuration file. For more
information, refer to “Using SystemEDGE to Monitor
Service Availability” on page 62.
• Using the graphical user interface of eHealth AdvantEDGE
View. For more information, refer to “Using AdvantEDGE
View to Monitor Service Availability” on page 66.
13. 12 • Chapter 1 Introduction
Performance Criteria Measured by eHealth Service
Availability
After you configure the tests you want, Service Availability
measures and reports on the following metrics for each test:
• Availability. The percentage of service requests that
succeed.
• Name lookup time. The time to resolve the server name to
a network address.
• Connection time. The time to connect to the server that is
providing this service.
• Transaction time. The time to perform the requested
transaction after the connection is established. For
example, this value can indicate the amount of time
required to download a Web page or check the mail status.
• Total response time. The total time for the service to
respond to the request. This value is simply the sum of the
measurements for name lookup time, connection time, and
transaction time.
• Bytes In and Bytes Out. The number of bytes sent and
received during the transaction phase of the test.
• Throughput. The sum of bytes sent and bytes received
during the last sample, divided by the number of seconds in
the sample.
For each metric (except availability), Service Availability
provides values for the last sample, as well as for the mean,
minimum, maximum, and sample variances.
If you are using AdvantEDGE View with Service Availability,
you can run a Service Availability query to obtain a graphical
view of those metrics. For more information, refer to “Using
AdvantEDGE View to Monitor Service Availability” on page 66.
eHealth Service Availability User Guide
14. 13
2
Installing eHealth Service Availability
This chapter describes how to install and license eHealth Service
Availability for UNIX™ and Microsoft® Windows® systems.
Before you install Service Availability, you must install, license,
and configure the SystemEDGE agent Release 4.1 Patch
level 1or later. For more information, refer to the eHealth
SystemEDGE User Guide.
NOTE
Service Availability Release 1.3 and later installs the Java
Runtime Environment (JRE) Release 1.4.2 for Solaris,
Linux, and Windows systems, and Release 1.4.1_03 for
HP-UX systems. These versions are the only supported JRE
versions for use with Service Availability.
Installing eHealth Service Availability on UNIX Systems
This section describes how to install Service Availability on
UNIX systems.
Installing the Software
Service Availability for UNIX systems is distributed as a tape
archive (tar) file named
.
15. 14 • Chapter 2 Installing eHealth Service Availability
NOTE
eHealth Service Availability User Guide
If you are installing Service Availability on a Solaris
operating system, ensure that you have installed any
patches for your operating system that are required to
support Java. For more information, refer to the Sun
Microsystems Web site at http://www.sun.com.
To install Service Availability on UNIX systems:
1. Log in as root by entering su and the root password at the
command prompt.
2. Verify that the subdirectory exists in the
SystemEDGE agent installation directory. The
recommended directory is
.
If that directory does not exist, verify that you have
SystemEDGE agent Release 4.1 Patch level 1 or later
installed, and then create the directory manually.
3. If you have an earlier version of Service Availability
installed, backup and rename that directory. Service
Availability 1.3 and later uses a Java collector and no longer
needs some of the files that existed in the old
directory.
4. Insert the AdvantEDGE CD into the CD-ROM drive and
mount it on the partition . For mounting
instructions, refer to your system documentation. For
example, enter the following command for Solaris systems:
mount -r -t hsfs /dev/sr0 /cdrom
5. Change directory to the SystemEDGE agent installation
directory, and load the files from the CD-ROM. For
example, enter the following commands for Solaris
systems:
cd /opt/EMPsysedge
tar xvof /fullPathToSvcRspFile/svcrsp.tar
Service Availability is now installed.
16. Installing eHealth Service Availability on Windows Systems • 15
eHealth Service Availability User Guide
1
2
6. Change directory to the subdirectory, and
open the file for editing.
7. Review the information in the maxthreads and javabin
fields, and edit them if you want to set a different maximum
number of threads or to indicate that your Java Runtime
Environment (JRE) exists in another directory.
NONTOETE
You must edit the javabin field if your SystemEDGE
agent is installed in a directory other than the default
(
). If you do not specify the correct
directory location, Service Availability cannot run.
8. Review the installed files. For more information, refer to
“eHealth Service Availability Files” on page 19.
9. License Service Availability. For more information, refer to
“Licensing eHealth Service Availability” on page 22.
Installing eHealth Service Availability on Windows
Systems
This section describes how to install Service Availability on
Windows systems.
Installing the Software
Service Availability for Windows is distributed as a
self-extracting, executable file named , which
includes a Visual Basic installer that you must run after you
extract it.
NOTE
When you are using AdvantEDGE View 3.0 or later with
eHealth Service Availability for Windows, you can
automatically deploy and license eHealth Service
Availability from AdvantEDGE View. For more
information, refer to the eHealth AdvantEDGE View User
Guide and Web Help.
17. 16 • Chapter 2 Installing eHealth Service Availability
To install Service Availability on Windows systems:
1. Log on to the Windows system as administrator.
2. Select Start → Programs → Command Prompt.
3. If you have an earlier version of Service Availability
eHealth Service Availability User Guide
installed, backup and rename that directory. Service
Availability 1.3 and later uses a Java collector and no longer
needs some of the files that existed in the old
directory.
4. Insert the AdvantEDGE CD-ROM into the CD-ROM
drive.
Windows automatically mounts the drive using the
CD-ROM drive’s corresponding drive letter. The drive
letter is specific to your system and depends on the number
and types of disks attached to your system. Step 5 in this
procedure uses D: as the CD-ROM drive. Modify that step
if necessary to use the drive letter for your system’s
CD-ROM drive.
5. Determine which directory you want to use as the
installation directory for Service Availability. If the
SystemEDGE agent is installed in , the
recommended installation directory is .
6. Copy the Service Availability installation package to the
directory by entering the following at the
command prompt:
D:fullpathtosvcrspfilesvcrsp.exe -dir C:sysedge
where D: is the CD-ROM drive for your system, and
is the installation directory.
7. Using Windows Explorer, navigate to the
directory, and double-click
. The Concord Service Availability installer
screen appears.
18. Installing eHealth Service Availability on Windows Systems • 17
eHealth Service Availability User Guide
1
2
8. You can accept the default values, or complete the screen as
follows:
a. Enter the maximum number of threads for the collector
to use in the Maximum Threads field. The default value
is 10.
NONTOETE
If you are intend to run Virtual User tests for more than
one record/playback executable on the same system, set
Maximum Threads to 1.
b. Enter the path to the JRE file in the Java Path
field. By default, the JRE is installed in
! !
. If you installed the
JRE in another directory, edit this field to indicate the
location of the JRE you are using.
19. 18 • Chapter 2 Installing eHealth Service Availability
eHealth Service Availability User Guide
NONTOETE
If the SystemEDGE agent is not installed in ,
you must edit this field to indicate the correct directory
location. For example, if you installed SystemEDGE in
, enter the following in the Java Path field:
! !
.
c. Enter the path where you installed Service Availability in
the SA Directory field. The default is
. Enter a different directory
if you installed Service Availability in another location.
d. Accept Enable TOS if you want to enable IP Type of
Service for your Service Availability tests. If your routers
are configured to use TOS, you can set TOS values for
use with Service Availability.
e. Accept Reboot Now unless you do not want to restart
your system immediately.
9. Click OK. The installer edits the file with these
values and edits the TCP/IP settings in your registry to
enable TOS, if you selected that option. You can later
change these settings by manually editing and
your registry (the HKEY_LOCAL_MACHINESYSTEM
CurrentControlSetServicesTcpipParameters
DisableTOSSetting key). A value of 0 for this registry key
enables Service Availability to modify the TOS setting. If
this key does not exist or is set to a value of -1, Service
Availability cannot modify TOS settings.
10. Review the installed files. For more information, refer to
“eHealth Service Availability Files” on page 19.
11. License Service Availability. For more information, refer to
“Licensing eHealth Service Availability” on page 22.
20. eHealth Service Availability Files • 19
eHealth Service Availability User Guide
1
2
eHealth Service Availability Files
This section describes the files installed with Service
Availability.
Files Installed for UNIX Systems
Table 2 shows the files that the Service Availability installation
program installs on UNIX systems.
Table 2. Files Installed on UNIX Systems
File Description
MFROOHFWRUMDU Java Archive (JAR) file for the Java collector
OLEMFROOHFWRUVO Java collector for Service Availability for HP-UX operating systems
OLEMFROOHFWRUVR Java collector for Service Availability for Solaris and Linux operating systems
MFROOHFWRUW[W Text file that provides messages about the status of the collector
UHOQRWHVW[W Readme file that includes installation instructions and error messages
VDLQVWDOOW[W Text file that provides messages about the installation
VYFUVSDVQ Service Availability management information base (MIB) specification
VYFUVSFI Configuration file for Service Availability; for more information about using
this file, refer to “Manually Editing the Service Availability Configuration File”
on page 41
VYFUVSSGI eHealth Service Availability User Guide (a PDF file of this guide)
VYFUVSVR Shared library module for Service Availability for 32-bit Solaris, HP-UX, and
Linux operating systems
VYFUVSKSX[VR Shared library module for Service Availability for 64-bit HP-UX systems
VYFUVSVSDUFYVR Shared library module for Service Availability for 64-bit Solaris systems
VYFUVSW[W Text file that provides informational messages about the initialization of the
Java collector
VYFZDWFK Configuration utility program for Service Availability; for more information
about using this utility, refer to “Using the svcwatch Utility” on page 58
21. 20 • Chapter 2 Installing eHealth Service Availability
Files Installed for Windows Systems
Table 3 shows the files that the Service Availability installation
program installs on Windows systems.
Table 3. Files Installed on Windows Systems
File Description
LQVWDOOYEV Visual Basic installer script for Service Availability
MFROOHFWRUGOO Java collector for Service Availability
MFROOHFWRUMDU Java Archive (JAR) file for the Java collector
MFROOHFWRUW[W Text file that provides messages about the status of the collector
ORJRJLI Logo file for the Service Availability installer
UHOQRWHVW[W Readme file that includes installation instructions and error messages
VDLQVWDOOW[W Text file that provides messages about the installation
VYFUVSDVQ Service Availability MIB specification
VYFUVSFI Configuration file for Service Availability; for more information about using this
file, refer to “Manually Editing the Service Availability Configuration File” on
page 41
VYFUVSGOO Dynamic link library (DLL) module for Service Availability
VYFUVSSGI eHealth Service Availability User Guide (a PDF file of this guide)
VYFUVSW[W Text file that provides informational messages about the initialization of the Java
collector
VYFZDWFKH[H Configuration utility program for Service Availability; for more information,
refer to “Using the svcwatch Utility” on page 58
Files Installed for All Systems
Service Availability 1.3 and later installs a !folder with a
number of files and subfolders in the SystemEDGE agent
installation directory. Click the #
file in this
directory for information about the version of Java and links to
the Sun Microsystems Web site.
eHealth Service Availability User Guide
22. Configuring SystemEDGE to Load Service Availability (UNIX Only) • 21
Table 4. Recommended sysedge.cf Entries
Platform Path to Shared Library
RSW(03VVHGJHSOXJLQVVYFUVSVYFUVSVR
Solaris SPARC (64-bit) RSW(03VVHGJHSOXJLQVVYFUVSVYFUVSVSDUFYVR
HP-UX (64-bit) RSW(03VVHGJHSOXJLQVVYFUVSVYFUVSKSX[VR
Windows NT 4.0, Windows 2000
Windows XP, and Windows 2003
?VVHGJH?SOXJLQV?VYFUVS?VYFUVSGOO
NOTE: The LQVWDOOYEVfile automatically adds this line to
6VWHP5RRW?6VWHP?VVHGJHFI.
eHealth Service Availability User Guide
1
2
Configuring SystemEDGE to Load Service Availability
(UNIX Only)
After you install Service Availability, you must configure the
SystemEDGE agent to load it. (For Windows systems, the
file performs this configuration automatically. For
UNIX systems, you must perform the configuration manually.)
You can configure SystemEDGE to load Service Availability by
editing the SystemEDGE configuration file. For more
information about the file, refer to the eHealth
SystemEDGE User Guide.
To edit the sysedge.cf file to load Service Availability:
1. Open
for editing.
2. Add the following line to the file, substituting the location
of the shared library for your operating system (as shown in
Table 4) for the pathToSharedLibrary variable:
sysedge_plugin pathToSharedLibrary
If you installed Service Availability in a location other than
the default location, edit the path to include the directories
you specified for your installation.
Solaris SPARC (32-bit), HPUX (32-bit), and
Linux
3. Save and close the file.
23. 22 • Chapter 2 Installing eHealth Service Availability
Licensing eHealth Service Availability
Like eHealth SystemEDGE, Service Availability utilizes a
host-based license method. Copies of Service Availability can
run only on systems that possess a valid license key for the
module, as well as a license key for the SystemEDGE agent.
The first time that you attempt to start the SystemEDGE agent
after installing Service Availability, the agent displays a message
that it could not find a valid license for Service Availability. It
then provides you with a public key (32 characters) that is used
to generate a permanent license key for your system.
You must use that key to obtain a license and then add the
license to the file. For an example, refer to the
sample license file in “Sample License File” on page 26.
Obtaining a License
To obtain a license, you can do any of the following:
• Run the Concord licenseme utility by changing to the
subdirectory of the SystemEDGE agent installation
(
or by default),
entering licenseme, and following the prompts. For
more information, refer to the eHealth SystemEDGE User
Guide.
• Use AdvantEDGE View. For more information, refer to
“Generating a License through AdvantEDGE View” on
page 25.
• Send an e-mail request to licenses@concord.com and place
the returned license key in the appropriate license file. For
more information, refer to the eHealth SystemEDGE User
Guide.
• Run the Concord licenseutil.pl script. For more
information, refer to the eHealth SystemEDGE User Guide.
• Complete the online license form through the Internet, as
described in the next section, “Generating the License
through the Web-based License Form.”
eHealth Service Availability User Guide
24. Licensing eHealth Service Availability • 23
1 NOTE
eHealth Service Availability User Guide
2
If you are using an evaluation copy of Service Availability,
you must request a temporary license that will enable it to
operate during the evaluation period.
For more information about licensing, refer to the eHealth
SystemEDGE User Guide or the AdvantEDGE View Web Help.
Generating the License through the Web-based
License Form
This section describes how to generate licenses using the
Web-based license form.
To generate a license for Service Availability:
1. Start the SystemEDGE agent.
Do the following for UNIX systems:
a. Log in as root.
b. Change directory (cd) to
.
c. Enter the following:
./bin/sysedge -b
Do the following for Windows systems:
a. Log in as the administrator.
b. Open a command prompt window, and enter the
following:
C:sysedgesetup -l
25. 24 • Chapter 2 Installing eHealth Service Availability
eHealth Service Availability User Guide
The SystemEDGE agent displays a message indicating that
you need a license for the Service Availability module on
this system. It displays a message similar to the following:
SystemEDGE Version 4.1 Patch level 4
Copyright 2003 by Concord Communications, Inc.
Please contact Concord Communications, Inc. to obtain a license
http://www.concord.com/support, Email: license@concord.com
Provide this: svcrsp pluto SunOS 5.9 8035b1f8f643ab43 1.3 Patch level 1
2. Using a Web browser, go to the licensing Web site at
http://license.concord.com, and select the Create License
option that matches your use of Service Availability.
NONTOETE
You must specify a user name and password to access
the license form.
3. Fill out the license form, entering the information that was
printed by the SystemEDGE agent. You must supply the
following information:
• Name
• E-mail address
• Software version number (1.3 in the example)
• Patch level (1 in the example)
• System name (pluto in the example)
• Operating system name (SunOS in the example)
• Operating system version (5.9 in the example)
• System identifier (8035b1f8f643ab43 in the example)
NONTOETE
Select the option for eHealth Service Availability from
the product list on the licensing form.
26. Licensing eHealth Service Availability • 25
eHealth Service Availability User Guide
1
2
After you submit the license request form, the Concord
Web server generates a license and displays it on your
Web browser. It also e-mails the license to the contact
person in your organization.
4. Copy the license into the file (located in
or
$%
$
'(), and save that file.
5. Restart the SystemEDGE agent.
For UNIX systems, enter the following:
./bin/sysedge -b
For Windows systems, stop and start the Windows Master
agent by entering the following:
C:net stop snmp
C:net start snmp
Service Availability is now licensed and ready to use.
Generating a License through AdvantEDGE View
If you are using AdvantEDGE View, you can use it to license
Service Availability if your system meets the following
requirements:
• The SystemEDGE agent Release 4.1 Patch level 1 or later
and AdvantEDGE View Release 3.2 Patch level 1 or later are
both installed on the system you want to license.
• The SystemEDGE agent is configured to send SNMP traps
to AdvantEDGE View and is configured with a read-write
community string so that AdvantEDGE View can use an
SNMP Set to transmit the license key to the agent. For more
information, refer to the section on configuring the
SystemEDGE agent in the eHealth SystemEDGE User Guide.
• The AdvantEDGE View system has access to the Internet,
either directly or through a Web proxy.
• The AdvantEDGE View user who is generating the license
has either write or admin permissions.
27. 26 • Chapter 2 Installing eHealth Service Availability
You can use AdvantEDGE View Agent Deployment or
AdvantEDGE View License Management to license Service
Availability. For information about these options, refer to the
eHealth AdvantEDGE View User Guide or the AdvantEDGE
View Web Help.
Sample License File
The following is a sample SystemEDGE agent license file. A
pound character (#) in column 1 indicates that the entire line is
a comment. This file includes a license for the SystemEDGE
agent and a license for Service Availability. The file can also
contain licenses for all other SystemEDGE plug-in modules.
# license file for SystemEDGE Agent
# Concord Communications, Inc.
# http://www.concord.com
#
# file /etc/sysedge.lic or %SystemRoot%system32sysedge.lic
# A valid license key has four parts of 8 characters per part
# parts are separated by space(s) with one license key per line
# sysedge jupiter sol2 5.9 807cb1da007cb1da 4.1 PL 4
e13311d3 0F2a7cb1 abC512dc fF8C923a
# svcrsp jupiter SunOS 5.9 807cb1da007cb1da 1.3 PL 3
a7943fde 098a87ij a4kiuf39 afafEkj4
eHealth Service Availability User Guide
28. Removing Service Availability • 27
eHealth Service Availability User Guide
1
2
Removing Service Availability
If you want to remove Service Availability from your system, do
the following:
1. Stop the SystemEDGE agent. For more information, refer
to the eHealth SystemEDGE User Guide.
2. Open the
or the
$%
$%
'( file for editing,
remove the sysedge_plugin line for Service Availability, and
then save and close the file.
3. Delete the folder from your
directory.
4. Restart the SystemEDGE agent.
29.
30. 29
3
Configuring eHealth Service Availability
This chapter explains how to configure eHealth Service
Availability to monitor services through the following methods:
• Adding entries to the file manually
• Using the svcwatch utility to create, modify, and delete tests
in the file
• Adding entries to the file manually
• Using AdvantEDGE View to create, modify, and delete tests
in the file
NOTE
For information about improving Service Availability
performance, refer to “Performance Tuning Strategies” on
page 69.
The Service Availability Table
Service Availability is implemented as an SNMP table
(svcRspTable) in the Systems Management MIB. The Service
Availability table provides information about each of the
services that the SystemEDGE agent is currently monitoring.
Each row of the table represents a single monitored service.
You can specify as many entries as you need for your
implementation of Service Availability. For each entry, the table
31. 30 • Chapter 3 Configuring eHealth Service Availability
provides information such as the service being monitored,
arguments that relate to that service (for example, the URL to
query), the interval at which the agent checks the service, and
the measurement results.
NOTE
eHealth Service Availability User Guide
All MIB objects that are related to eHealth Service
Availability exist at object identifier (OID) branch
1.3.6.1.4.1.546.16.6 in the Systems Management MIB. The
MIB is defined in the
)file, which is installed as
part of the Service Availability installation.
In addition to the Service Availability table, the Service
Availability MIB provides the following two MIB objects:
• svcRspVersion, which reports the Service Availability
version information.
• svcRspPID, which reports the process identifier of the
Service Availability collector process.
Table 5 describes the columns of the Service Availability table.
Table 5. Service Availability Table (Page 1 of 6)
MIB Object Description
svcRspTableIndex Row (index) of the Service Availability table for this entry. Each row
in the Service Availability table is uniquely identified by an index
number.
svcRspTableDescr A quoted string of up to 128 characters that describes the entry. This
field is entirely for the user and is not interpreted by the software.
32. The Service Availability Table • 31
eHealth Service Availability User Guide
1
3
Table 5. Service Availability Table (Page 2 of 6)
MIB Object Description
svcRspTableSvc The name of the service to be tested. The following are possible
values:
• CUSTOM
• DNS
• FTP
• HTTP
• HTTPS
• NNTP
• PING
• POP3
• RT_EMAIL
• SMTP
• TCPCONNECT
• VIRTUAL_USER (Windows only)
NOTE: Before you use the Virtual User test, you must enable the
SNMP service to interact with the desktop. For more
information, refer to “Modifying the SNMP Service for the
Virtual User Test” on page 39.
NOTE: For both the Custom and Virtual User tests, you must enable
scripting in the VYFUVSFIfile. For more information, refer to
“Enabling Scripting for Custom and Virtual User Tests” on
page 39.
svcRspTableArgs A quoted string (of up to 128 characters) that specifies the
service-specific arguments that the module uses for measuring
purposes. The service arguments are defined in Table 6 on page 35.
svcRspTableInterval An integer that indicates how often (in seconds) the agent should
measure the availability of the service. For example, the value 30
instructs the agent to sample the service every 30 seconds.
NOTE: This value must be a multiple of 30 seconds.
33. 32 • Chapter 3 Configuring eHealth Service Availability
Table 5. Service Availability Table (Page 3 of 6)
MIB Object Description
svcRspTableSamplesPerInterval An integer value that indicates the number of times that the agent
should perform the sample query at each interval. For example, you
can specify 3 to perform a PING measurement three times each
interval.
svcRspTableTimeout An integer value that indicates the time (in seconds) that this
measurement should wait for a response. A sample that does not
return within the timeout value is recorded as unavailable for the
purposes of the availability measurement.
svcRspTableStatsWindow An integer value that indicates the time (in seconds) to be used in
the statistical calculations. For instance, a value of 1800 specifies
that the agent will calculate all statistical results (for example, mean
and availability) over the last 30 minutes.
svcRspTableStatus Row status; one of the following values:
• active indicates that the entry is available for use
• notInService indicates that the entry is unavailable.
• destroy indicates that this entry and all instances associated
eHealth Service Availability User Guide
with it will be deleted.
These values are defined in detail in the SNMPv2 SMI row status
textual convention. Normally, a row is either active or notInService.
svcRspTableLastUpdate Time (based on sysUpTime) at which the agent last sampled this
service. A value of 0 indicates that this service has not yet been
sampled.
svcRspTableNumSamples Total number of samples that the agent has taken for this response
time entry since the row was initialized.
svcRspTableTotalLastSample Last recorded total response time (in milliseconds) for this service.
A value of 0 indicates that the last sample failed to respond within
the given timeout interval.
svcRspTableTotalMin Smallest successful total response time (in milliseconds) for this
service during the current measurement window.
svcRspTableTotalMax Largest successful total response time (in milliseconds) for this
service during the current measurement window.
34. The Service Availability Table • 33
eHealth Service Availability User Guide
1
3
Table 5. Service Availability Table (Page 4 of 6)
MIB Object Description
svcRspTableTotalMean Sample mean of the successful total response times (in
milliseconds) for this service during the current measurement
window.
svcRspTableTotalVariance Sample variance of the successful total response times (in
milliseconds) for this service during the current measurement
window.
svcRspTableTotalAvailability Percentage of the total response measurement attempts that were
successful during the current measurement window.
svcRspTableNameLastSample Last recorded name lookup time (in milliseconds) for this service. A
value of 0 indicates that the last sample failed to respond within the
given timeout.
svcRspTableNameMin Smallest successful name lookup time (in milliseconds) for this
service during the current measurement window.
svcRspTableNameMax Largest successful name lookup time (in milliseconds) for this
service during the current measurement window.
svcRspTableNameMean Sample mean of the successful name lookup times (in milliseconds)
for this service during the current measurement window.
svcRspTableNameVariance Sample variance of the successful name lookup times (in
milliseconds) for this service during the current measurement
window.
svcRspTableConnLastSample Last recorded connection time (in milliseconds) for this service. A
value of 0 indicates that the last sample failed to respond within the
given timeout.
svcRspTableConnMin Smallest successful connection time (in milliseconds) for this
service during the current measurement window.
svcRspTableConnMax Largest successful connection time (in milliseconds) for this service
during the current measurement window.
svcRspTableConnMean Sample mean of the successful connection times (in milliseconds)
for this service during the current measurement window.
35. 34 • Chapter 3 Configuring eHealth Service Availability
Table 5. Service Availability Table (Page 5 of 6)
MIB Object Description
svcRspTableConnVariance Sample variance of the successful connection times (in
milliseconds) for this service during the current measurement
window.
svcRspTableTranLastSample Last recorded transaction time (in milliseconds) for this service. A
value of 0 indicates that the last sample failed to respond within the
given timeout.
svcRspTableTranMin Smallest successful transaction time (in milliseconds) for this
service during the current measurement window.
svcRspTableTranMax Largest successful transaction time (in milliseconds) for this service
during the current measurement window.
svcRspTableTranMean Sample mean of the successful transaction times (in milliseconds)
for this service during the current measurement window.
svcRspTableTranVariance Sample variance of the successful transaction times (in
milliseconds) for this service during the current measurement
window.
svcRspTableBytesInLastSample The number of bytes that were received during the last sample.
svcRspTableBytesOutLastSample The number of bytes that were sent during the last sample.
svcRspTableTotalBytesIn The total number of bytes that were received since the module
started.
svcRspTableTotalBytesOut The total number of bytes that were sent since the module started.
svcRspTableThroughput The throughput (in bytes/sec), calculated over the statistics
window. This value results from adding the values for
BytesInLastSample and BytesOutLastSample, and dividing that
result by the number of seconds in the sample.
svcRspTableResults The results (not including errors) of the test. The values are specific
to the type of service that is being tested.
eHealth Service Availability User Guide
36. The Service Availability Table • 35
Table 5. Service Availability Table (Page 6 of 6)
MIB Object Description
svcRspTableErrorCode The error code that is returned by the test. The values are specific to
the type of service that is being tested.
svcRspTableTOSField The IP Type of Service (TOS) value to set in the IP header for each
test. If your routers are configured to support TOS, you can set this
field to the same value. You must select an appropriate value for
your environment.
eHealth Service Availability User Guide
1
3
Arguments for the Service Availability Table
Service Availability requires additional configuration
information to complete the sample transactions. You provide
this information in the Arguments field (svcRspTableArgs).
Table 6 shows the arguments that you must supply for each
service.
Table 6. Arguments for Each Service (Page 1 of 4)
Service Additional Information Required
CUSTOM The full pathname of the script to run for the test: /pathname/scriptname
NOTE: Before you create custom tests, you must edit the VYFUVSFIfile to
enable scripting. For more information, refer to “Enabling Scripting
for Custom and Virtual User Tests” on page 39.
DNS The hostname of the DNS server to test
FTP The hostname or IP address of the FTP server, followed by a valid FTP user
name and password, as follows:
ftp-server username password
37. 36 • Chapter 3 Configuring eHealth Service Availability
Table 6. Arguments for Each Service (Page 2 of 4)
Service Additional Information Required
HTTP The URL to test, optionally followed by any of the following: maximum frame
depth for the test; proxy address, proxy user name, and proxy password; and
a regular expression for content matching, as follows:
URL [max:depth:max-frame-depth] [proxy:proxy-addr]
[username:user] [password:pass] [search:regexpression]
NOTE: You must specify a complete and valid URL for the test to work.
For example, specify http://www.concord.com (instead of
www.concord.com).
The HTTP test downloads all frames, images, external scripts, and applets
during the page download so that the measurement reflects a user’s
experience when downloading a Web page. Set the max_depth argument to
the number of levels the test should traverse when downloading nested
frames. The default value is 3.
Set the search argument to a regular expression you want Service Availability
to match on the Web pages you test, The number of matches displays in the
Results column of the Service Availability table.
HTTPS The URL to test, optionally followed by any of the following: maximum frame
depth for the test; proxy address, proxy user name, and proxy password; and
a regular expression for content matching, as follows:
URL [max_depth:max-frame-depth] [proxy:proxy-addr]
[username:user] [password:pass] [search:regexpression]
NOTE: You must specify a complete and valid URL for the test to work. For
example, specify https://charge.mycredit.com (instead of
charge.mycredit.com). You must also specify a site that uses a public
Certificate Authority. Service Availability does not currently support
private Certificate Authorities.
The HTTPS test downloads all frames, images, external scripts, and applets
during the page download so that the measurement reflects a user’s
experience when downloading a Web page. Set the max_depth argument to
the number of levels the test should traverse when downloading nested
frames. The default value is 3.
Set the search argument to a regular expression you want Service Availability
to match on the Web pages you test. The number of matches displays in the
Results column of the Service Availability table.
eHealth Service Availability User Guide
38. The Service Availability Table • 37
eHealth Service Availability User Guide
1
3
Table 6. Arguments for Each Service (Page 3 of 4)
Service Additional Information Required
NNTP The hostname of the NNTP server
PING The hostname of the system to ping
POP3 The hostname of the POP3 server, followed by the POP3 user name,
password, and instructions about downloading the first e-mail or all e-mails,
and whether to delete the e-mails after downloading them, as follows:
pop3-server username:user password:pass download:first|all
delete:yes|no
You can use the download and delete arguments as follows:
• download:all —Downloads all messages
• download:first — Downloads the first message
• delete:yes — Deletes messages after downloading
• delete:no — Leaves messages on the server
RT_EMAIL The hostname of the SMTP server, the destination address, message size in
bytes, POP server user name and password, and optionally the interval at
which to test the POP service in msec, as follows:
smtp-server to-addr msg-size pop-server username:user
password:pass [pop-interval:msec]
NOTE: Create a test mailbox for use with this test. Do not run it against an
active mailbox. Also, the test can take a minute or longer to run.
Therefore, you must run the test for a minimum of 5 minutes with 1
sample at each interval.
39. 38 • Chapter 3 Configuring eHealth Service Availability
Table 6. Arguments for Each Service (Page 4 of 4)
Service Additional Information Required
SMTP The hostname of the SMTP server, the destination address, and the message
size in bytes, as follows:
smtp-server to-address message-size
TCPCONNECT The hostname and port of the system to test, as follows:
system-name port
VIRTUAL_USER The full pathname of the record/playback executable to run for the test,
followed by the script name, optional arguments to the script, and an
optional hostname and port, as follows:
C:pathTo_taskexec.exe C:pathTo_script.rob [arg1 arg
2...] [;hostname;port]
NOTE: The pathnames toWDVNH[HFH[H and scriptURE cannot include any
space characters. If those scripts are located in directories that include
space characters, you must move them to directories that do not
include spaces before you run the Virtual User test.
This test is available only on Windows systems. It assumes that you are using
a program like WinTask to record transactions. Before you create Virtual
User tests, you must edit the VYFUVSFIfile to enable scripting. For more
information, refer to “Enabling Scripting for Custom and Virtual User Tests”
on page 39. You must also modify the SNMP Service, as described in the next
section, “Modifying the SNMP Service for the Virtual User Test.”
NOTE: If you intend to set up tests for more than one record/playback
executable on the same system, you must edit theVYFUVSFIfile to set
maxthreads=1 to ensure that Service Availability does not attempt to
run more than one record/playback executable on the same system
simultaneously.
If you specify a hostname and port, Service Availability looks up the specified
system and attempts to connect to the specified port. If the connections are
successful, it attempts to execute the script (which works on the specified port
on the specified system). If you do not specify hostname and port, Service
Availability does not provide the DNS name resolution or connect times.
eHealth Service Availability User Guide
40. The Service Availability Table • 39
Index Service Arguments Interval SamplesPerInterval Timeout StatsWindow Status
10 HTTP(4) http://www.concord.com 60 1 10 3600 ACTIVE(1)
eHealth Service Availability User Guide
1
3
Enabling Scripting for Custom and Virtual User
Tests
For the Custom and Virtual User tests, you must enter the
following in the file:
allow_scripts
If the #allow_scripts line exists in your file, you can
remove the pound sign (#) to uncomment the line rather than
entering it again.
Modifying the SNMP Service for the Virtual
User Test
Before you use the Virtual User test, you must enable the SNMP
service to interact with the local desktop.
To enable the SNMP Service to interact with the
desktop:
1. Open the Services Control Panel.
2. Right-click SNMP Service, and select Properties.
3. Select the Log On tab.
4. Under Local System Account, select Allow service to
interact with desktop.
5. Click OK.
Sample Entry in the Service Availability Table
The following shows a sample entry for monitoring the HTTP
service in the Service Availability table.
The entry is the 10th row in the table, and its purpose is to
monitor the HTTP service by retrieving the Web page that is
located at http://www.concord.com. The agent performs this
query once every 60 seconds with a timeout of 10 seconds. The
41. 40 • Chapter 3 Configuring eHealth Service Availability
value of 3600 in the statistics window column indicates that the
agent uses only the last 3600 seconds (or 1 hour) of samples to
calculate statistical results. The current status of this row is
active.
Assigning Entry Rows for the Service Availability
Table
The Index column (svcRspTableIndex) is the row index of the
Service Availability table. You may choose, as a matter of local
policy, to reserve a block of rows to be used solely for system
administration. By reserving a block of rows, you can define a
consistent set of conditions (row entries) to be monitored
across all systems such that the same condition is defined in the
same row number on each of the systems. For example, you
might use row 11 (svcRspTableIndex = 11) to define an entry
for monitoring the DNS service throughout the enterprise. You
can then distribute this configuration to every system so that
they all use row 11 to measure the DNS service.
To reserve a block of rows:
1. Decide on a block of rows that you want to reserve for your
eHealth Service Availability User Guide
use in the Service Availability table.
2. Define a set of row entries (services to be measured) in the
configuration file (in the block of rows you
decided to reserve) For more information, refer to the next
section, “Manually Editing the Service Availability
Configuration File.”
3. Distribute the configuration file to all systems on
which Service Availability is installed.
4. Require end users to avoid your block of rows when
defining their own Service Availability table entries.
42. Manually Editing the Service Availability Configuration File • 41
eHealth Service Availability User Guide
1
3
Manually Editing the Service Availability Configuration
File
You can control the services that Service Availability monitors
by adding, deleting, or modifying entries in the Service
Availability configuration file ( ). You can also use the
svcwatch utility or the AdvantEDGE View interface to update
the file dynamically. For more information, refer to
“Using the svcwatch Utility” on page 58 and “Using
AdvantEDGE View to Monitor Service Availability” on page 66.
NOTE
You can edit the file only when the SystemEDGE
agent is not running. Before you begin editing thefile, you
must stop the SystemEDGE agent.
When the SystemEDGE agent starts (and the Service
Availability module is licensed and configured in the
and files), the agent reads the
file to determine the configuration. You can use this file to
specify the services that you want the agent to measure. If you
are configuring several systems to measure services throughout
an enterprise, you can create a single file and
distribute that file to all of your systems.
43. 42 • Chapter 3 Configuring eHealth Service Availability
The Service Availability configuration file consists of a series of
entries that are delimited by braces ({ }). Within each entry,
fields exist on separate lines. The format for an entry is as
follows:
{
eHealth Service Availability User Guide
Index
Description
Service
Arguments
Interval
SamplesPerInterval
Timeout
Window Size
SNMP Row Status
TOS
}
These entries match the first ten MIB objects in the Service
Availability table, as defined in Table 5 on page 30.
Sample Entries for the svcrsp.cf Configuration
File
This section provides several examples of how to monitor
services by adding entries to the file. In all of these
examples, the row status is set to active, and the TOS field is set
to 0, which indicates normal service.
44. Manually Editing the Service Availability Configuration File • 43
eHealth Service Availability User Guide
1
3
Measuring DNS Service Availability
You can add the following entry to to instruct Service
Availability to monitor the amount of time that is required to
resolve the IP address for http://www.concord.com using the
name server at 194.13.12.92. In your environment, use the IP
address of your local DNS server. The name that is being
resolved is not the most critical parameter.
{
10
Test DNS Lookup
DNS
194.13.12.92 http://www.concord.com
300
1
10
86400
active
0
}
The entry is created at row 10 in the Service Availability table,
and it instructs the agent to test the service once every 300
seconds (5 minutes), and to wait up to 10 seconds for a
successful response. The agent calculates statistics over the last
86,400 seconds (1 day).
45. 44 • Chapter 3 Configuring eHealth Service Availability
Measuring FTP Service Availability
The following entry instructs Service Availability to monitor the
amount of time required to log in to and test the status of the
FTP service at the host ftpserver.yourdomain. The username
(ftptest) and password (ftp123) must be a valid
username-password combination for an FTP user on this
server. Any valid account works.
{
eHealth Service Availability User Guide
20
Test FTP Service Availability
FTP
ftpserver.yourdomain ftptest ftp123
3600
1
10
604800
active
0
}
The entry is created as row 20 in the Service Availability table.
The agent tests the service once every 3600 seconds (1 hour)
and waits up to 10 seconds for a successful response. It
calculates statistics over the last 604,800 seconds (1 week).
46. Manually Editing the Service Availability Configuration File • 45
eHealth Service Availability User Guide
1
3
Measuring Web Server (HTTP) Response
The following entry instructs Service Availability to monitor the
amount of time required to access the main Web page at
http://www.concord.com. (You must enter the full Web
address, including http://.)
NOTE
All HTTP and HTTPS tests download all frames, images,
external scripts, and applets during the page download so
that the measurement reflects a user’s experience when
downloading a Web page. To control how many levels the
tests should traverse when downloading nested frames, set
the max_depth argument. The default value is 3.
{
30
Test Concord Web Server
HTTP
http://www.concord.com max_depth:2
60
1
20
300
active
0
}
The entry is created as row 30 in the Service Availability table.
The agent tests the service once every 60 seconds and waits up
to 20 seconds for a successful response. The max_depth
argument instructs the agent to traverse only 2 levels of nested
frames. The agent calculates statistics over the last 300 seconds
(5 minutes).
47. 46 • Chapter 3 Configuring eHealth Service Availability
Measuring Web Server (HTTP) Response by
Proxy
The following entry instructs Service Availability to monitor the
amount of time required to access the main Web page at
http://www.weather.com. In this case, the testing system does
not access the site directly; instead, it uses the Web proxy host
myproxy that is running on port 8080. (You must enter the full
Web address, including http://.)
{
eHealth Service Availability User Guide
31
“Test Weather Channel Server Via Proxy”
HTTP
“http://www.weather.com/ myproxy:8080
username:user password:private”
60
1
20
300
active
0
}
The entry is created as row 31 in the Service Availability table.
The agents tests the service once every 60 seconds and waits up
to 20 seconds for a successful response. The agent calculates
statistics over the last 300 seconds (5 minutes).
48. Manually Editing the Service Availability Configuration File • 47
eHealth Service Availability User Guide
1
3
Measuring Secure Web Server (HTTPS)
Response
The following entry instructs Service Availability to monitor the
amount of time required to access the main Web page at
charge.mycredit. (You must enter the full Web address,
including https://.)
{
32
“Test Secure Web Server”
“https://charge.mycredit/commit.exe proxy:8080 username:tester password:tech”
60
1
20
300
active
0
}
The entry is created as row 32 in the Service Availability table.
The agent tests the service once every 60 seconds and waits up
to 20 seconds for a successful response. The agent calculates
statistics over the last 300 seconds (5 minutes).
NOTE
Service Availability HTTPS tests do not support sites that
are signed by a private Certificate Authority. In this release,
the HTTPS test supports only sites that are signed by public
Certificate Authorities.
49. 48 • Chapter 3 Configuring eHealth Service Availability
Matching Web Server (HTTP/HTTPS) Content
The following entry instructs Service Availability to download
the Web page at http://www.weather.com and search the
content for the regular expression “cumulus.” The agent
records the number of times that cumulus appears in the
Results field for the test. (You must enter the full Web address,
including http://.)
NOTE
eHealth Service Availability User Guide
This example is valid for both the HTTP and HTTPS tests.
(For HTTPS, substitute HTTPS in the Service Type field
and the secure URL in the arguments field.)
{
33
“Test Content: cumulus”
HTTP
“http://www.weather.com/ search:cumulus”
60
1
20
300
active
0
}
The entry is created as row 33 in the Service Availability table.
The agent tests the service once every 60 seconds and waits up
to 20 seconds for a successful response. The agent calculates
statistics over the last 300 seconds (5 minutes).
50. Manually Editing the Service Availability Configuration File • 49
eHealth Service Availability User Guide
1
3
Measuring NNTP Service Availability
The following entry instructs Service Availability to monitor the
amount of time required to connect to the NNTP service at the
host news.yourdomain and to perform a simple transaction.
{
40
Test Net News Response
NNTP
news.yourdomain
3600
1
10
86400
active
0
}
The entry is created as row 40 in the Service Availability table.
The agent tests the service once every 3600 seconds (1 hour)
and waits up to 10 seconds for a successful response. The agent
calculates statistics over the last 86,400 seconds (1 day).
51. 50 • Chapter 3 Configuring eHealth Service Availability
Measuring Network Reachability (PING)
The following entry instructs Service Availability to monitor the
amount of time required to perform a network-level ping of the
host server.yourdomain. This test is an excellent way to
determine whether the system is running and network
connectivity exists.
{
eHealth Service Availability User Guide
50
Test PING Response
PING
server.yourdomain
60
3
5
86400
active
0
}
The entry is created as row 50 in the Service Availability table.
The agent tests the service 3 times every 60 seconds (1 minute)
and waits up to 5 seconds for a successful response. The agent
calculates statistics over the last 86,400 seconds (1 day).
52. Manually Editing the Service Availability Configuration File • 51
eHealth Service Availability User Guide
1
3
Measuring POP3 Service Availability
The following entry instructs Service Availability to monitor the
amount of time required to log in to and test the status of the
POP mail service at the host popserver.yourdomain. The
username poptest and password pop123 must be a valid
username-password combination for a POP user on this server.
Any valid account works, and the sample query does not affect
the contents of the mailbox.
{
60
Test POPmail Response
POP3
popserver.yourdomain proxy:8080 username:poptest password:pop123 download:all
delete:yes
300
1
10
21600
active
0
}
The entry is created as row 60 in the Service Availability table.
The mail proxy is at port 8080, and the test downloads all
messages and then deletes them after the test. The agent tests
the service once every 300 seconds (5 minutes), waits up to 10
seconds for a successful response, and calculates statistics over
the last 21,600 seconds (6 hours).
You can use the download and delete arguments as follows:
• download:all —Downloads all messages
• download:first — Downloads the first message
• delete:yes — Deletes messages after downloading
• delete:no — Leaves messages on the server
53. 52 • Chapter 3 Configuring eHealth Service Availability
Measuring Round-Trip E-Mail Response
The following entry instructs Service Availability to monitor
the amount of time required to send an e-mail of 2,000 bytes
from the mail server at server.mydomain to an account
(you@yourdomain.com) on the mail server server.yourdomain.
{
70
Test Round-Trip E-mail
RT_EMAIL
server.mydomain you@yourdomain.com 2000 server.yourdomain username:round
password:trip
300
1
5
86400
active
0
}
The entry is created as row 70 in the Service Availability table.
The agent tests the service once every 300 seconds (5 minutes)
and waits up to 5 seconds for a successful response. The agent
calculates statistics over the last 86,400 seconds (1 day).
NOTE
eHealth Service Availability User Guide
Create a test mailbox for use with the round-trip e-mail
test. Do not run it against an active mailbox. Also, run the
test for a minimum of 5 minutes with 1 sample at each
interval.
54. Manually Editing the Service Availability Configuration File • 53
eHealth Service Availability User Guide
1
3
Measuring Sendmail Service (SMTP) Response
The following entry instructs Service Availability to monitor the
amount of time required to connect to the SMTP service on the
host mailserver.yourdomain and to perform a null transaction.
This test is a good measure of the baseline time that is required
to send a mail message.
{
80
Test Sendmail Response
SMTP
mailserver.yourdomain you@test.com 10000
60
1
10
300
active
0
}
The entry is created as row 80 in the Service Availability table.
This test sends a sample e-mail of 10,000 bytes to you@test.com
from the SMTP server mailserver.yourdomain. The agent tests
the service once every 60 seconds and waits up to 10 seconds for
a successful response. The agent calculates statistics over the last
300 seconds (5 minutes). This configuration works well if you
are using a polling station to sample the mean and availability
values for this entry.
55. 54 • Chapter 3 Configuring eHealth Service Availability
Measuring TCP Service Connections
The following entry instructs Service Availability to monitor the
amount of time required to connect to port 2049 on the host
nfsserver.yourdomain. This test determines whether the service
is running and network connectivity exists.
{
eHealth Service Availability User Guide
90
Test TCP Connection
TCPCONNECT
nfsserver.yourdomain 2049
60
1
5
600
active
0
}
The entry is created as row 90 in the Service Availability table.
The agent tests the service once every 60 seconds (1 minute)
and waits up to 5 seconds for a successful response. The agent
calculates statistics over the last 600 seconds (10 minutes).
56. Manually Editing the Service Availability Configuration File • 55
eHealth Service Availability User Guide
1
3
Measuring Record and Playback Response
(Windows Only)
If you intend to set up tests for
more than one record/playback
executable on the same system,
you must edit theVYFUVSFIfile to
set maxthreads=1 to ensure that
Service Availability does not
attempt to run more than one
record/playback executable on
the same system simultaneously.
Before you can use the Virtual User test, you must enable the
SNMP Service to interact with the desktop, as described in
“Modifying the SNMP Service for the Virtual User Test” on
page 39. You must also edit the file to enable scripting,
as described in “Enabling Scripting for Custom and Virtual
User Tests” on page 39. You must be using a Windows system
and a record/playback program to record transactions.
The following entry causes Service Availability to execute the
*+
script. It does not specify any arguments to
the script:
{
95
Test Virtual User Record/Playback
VIRTUAL_USER
“C:wintaskbintaskexec.exe C:myScriptsplayback_script.rob;
MySystem:8080
120
1
10
3600
active
0
}
The pathnames to both the
taskexec.exe file and the playback
script cannot include any space
characters.
The entry, created as row 95 in the Service Availability table,
instructs WinTask to execute
*+
. It performs a
DNS lookup of the system MySystem on port 8080 and records
the name resolution and connection times. The agent tests the
service once every 120 seconds (2 minutes), waits up to 10
seconds for a successful response, and calculates statistics over
the last 3600 seconds (1 hour).
57. 56 • Chapter 3 Configuring eHealth Service Availability
Measuring Custom Services
Before you create Custom tests,
you must edit the VYFUVSFIfile to
enable scripting. For more
information, refer to “Enabling
Scripting for Custom and Virtual
User Tests” on page 39.
The following entry causes Service Availability to execute the
,script and to use the output as the
response time values for this custom service.
{
eHealth Service Availability User Guide
99
Test Custom Service
CUSTOM
/local/bin/custom-response
120
1
20
3600
active
0
}
The entry is created as row 99 in the Service Availability table.
The agent tests the service once every 120 seconds (2 minutes)
and waits up to 20 seconds for a successful response. The agent
calculates statistics over the last 3600 seconds (1 hour).
You can create a custom script to perform any desired test or
operation. You can write the script as a binary executable or in a
scripting language such as UNIX shell or Perl. Custom response
modules work like SystemEDGE agent extension objects. For
more information, refer to the section on extension objects in
the eHealth SystemEDGE User Guide.
Service Availability expects the custom script to provide a single
line of output with at least three values (and up to six values)
followed by a line feed (newline).
You can create custom scripts to instruct Service Availability to
monitor services other than the common network services it
can monitor automatically.
58. Manually Editing the Service Availability Configuration File • 57
eHealth Service Availability User Guide
1
3
The values that the script returns must be the following and
must return in the specified order:
1. DNS resolution time (required)
2. Connection time (required)
3. Transaction time (required)
4. Error code (optional)
5. Bytes in (optional)
6. Bytes out (optional)
In addition, the script must report all values for time in
milliseconds.
Service Availability calculates throughput based on the data the
script returns for bytes in and bytes out. Therefore, if the script
provides bytes in, it must also provide bytes out (and vice
versa). Therefore, correct output from the script must be one of
the following:
Output Option 1:
1. DNS resolution time
2. Connection time
3. Transaction time
Output Option 2:
1. DNS resolution time
2. Connection time
3. Transaction time
4. Error code
Output Option 3:
1. DNS resolution time
2. Connection time
3. Transaction time
4. Error code
5. Bytes in
6. Bytes out
59. 58 • Chapter 3 Configuring eHealth Service Availability
Manually Removing an Entry from svcrsp.cf
You can remove an entry from the Service Availability table by
removing the entry from the configuration file.
NOTE
eHealth Service Availability User Guide
Before you edit the file, you must stop the
SystemEDGE agent.
To remove an entry from the svcrsp.cf file:
1. Stop the SystemEDGE agent. For more information, refer
to the eHealth SystemEDGE User Guide.
2. Open the file for editing. Locate and remove the
entry you want to delete. Remove the entire entry,
including the brace characters ({ and }).
3. Save the file.
4. Restart the SystemEDGE agent.
Using the svcwatch Utility
svcwatch is a command-line utility that automatically
configures Service Availability to monitor the service that you
specify. You identify the service, arguments, measurement
interval, timeout, and statistics window. The svcwatch utility
issues an SNMP Set Request to create the appropriate entry in
the target Service Availability table. You can also edit the
file manually. For more information, refer to
“Manually Editing the Service Availability Configuration File”
on page 41.
NOTE
If you have configured the SystemEDGE agent to prevent
SNMP SET operations, you cannot use the svcwatch utility.
The command line syntax for svcwatch is as follows:
svcwatch host[:port][,timeout] community command
60. Using the svcwatch Utility • 59
eHealth Service Availability User Guide
1
3
Table 7 describes the svcwatch arguments.
Table 7. svcwatch Arguments
Argument Description
host[:port][,timeout] Specifies the hostname or IP address of the system that contains
the agent and MIB object to be monitored. If the agent is running
on an alternative User Datagram Protocol (UDP) port (for
example, 1691), specify that port number along with the
hostname/address with a colon separator. In addition, you can
specify an optional SNMP timeout value (in seconds) with a
comma separator.
community Specifies the community string that svcwatch uses in its SNMP
requests to the agent. Because svcwatch uses SNMP Set Requests,
the community string must provide read-write access to the
target agent.
command Specifies the command and associated arguments. Supported
commands include the following:
• add – for adding an entry; syntax is as follows:
add index descr svcType args interval
samples timeout winsiz
• setstatus – for setting the status of an entry; syntax is as
follows:
setstatus index status
• delete – for deleting an entry; syntax is as follows:
delete index
• list – for listing the current entries
• version – for providing version information
For information about the arguments for the add, setstatus, and
delete commands, refer to the next section, “svcwatch Command
Arguments.”
61. 60 • Chapter 3 Configuring eHealth Service Availability
svcwatch Command Arguments
Table 8 describes the svcwatch arguments that are associated
with the svcwatch commands.
Table 8. svcwatch Arguments Associated with Commands (Page 1 of 2)
Argument Description
index Specifies the row (index) of the Service Availability table for this entry.
descr Describes the rows in a quoted string of up to 128 characters.
service Specifies the service to monitor. One of the following:
• CUSTOM
• DNS
• FTP
• HTTP
• HTTPS
• NNTP
• PING
• POP3
• SMTP
• RT_EMAIL
• TCPCONNECT
• VIRTUAL_USER (Windows only)
NOTE: Before you use the Virtual User test, you must enable the SNMP service to
interact with the desktop. For more information, refer to “Modifying the
SNMP Service for the Virtual User Test” on page 39. In addition, before you
create Virtual User or Custom tests, you must edit the VYFUVSFIfile to enable
scripting. For more information, refer to “Enabling Scripting for Custom and
Virtual User Tests” on page 39.
args Specifies the service-specific arguments in a quoted string of up to 128 characters. For
information about values for this field, refer to Table 6 on page 35.
eHealth Service Availability User Guide
62. Using the svcwatch Utility • 61
Table 8. svcwatch Arguments Associated with Commands (Page 2 of 2)
Argument Description
interval Specifies an integer value that indicates how often (in seconds) the service should be
tested.
NOTE: This value must be a multiple of 30 seconds.
samples Specifies an integer value that indicates how many times the agent should monitor
timeout Specifies the time in seconds to wait for the service (in an integer value).
winsiz Specifies the amount of time in seconds during which the agent should take samples
• active – Activates a table row.
• notInService – Deactivates but preserves a row in the file.
• destroy – Deletes a row.
eHealth Service Availability User Guide
1
3
the service at each interval.
to include in statistical calculations.
status Row status; one of the following:
svcwatch Examples
This section includes examples for using the svcwatch utility.
All of these examples assume that you are running Service
Availability on a system with an IP address of 143.45.0.12 and a
community string of private.
Adding an Entry
Enter the following to create an entry in the Service Availability
table (at index 11) that tests the network reachability to the
system named pingtarget:
svcwatch 143.45.0.12 private add 11 Test PING PING pingtarget 120 1
10 3600
63. 62 • Chapter 3 Configuring eHealth Service Availability
Setting the Status for an Entry
Enter the following to set the status for the entry at index 12 in
the Service Availability table (at index 12) to notInService:
svcwatch 143.45.0.12 private setstatus 12 notInService
Deleting an Entry
Enter the following to delete the entry at index 14 in the Service
Availability table:
svcwatch 143.45.0.12 private delete 14
In some cases, it may not be possible to use the svcwatch utility
to delete entries. For example, if you have configured the
SystemEDGE agent to prevent SNMP SET operations, the
svcwatch utility does not work. In this situation, you need to
remove the entry from the Service Availability table manually.
For more information, refer to “Manually Removing an Entry
from svcrsp.cf” on page 58.
Listing Current Entries
Enter the following to delete the entry at index 13 in the Service
Availability table:
svcwatch 143.45.0.12 private svcwatch list
Using SystemEDGE to Monitor Service Availability
In addition to using the file to add monitoring entries
to the Service Availability table, you can add entries directly to
the SystemEDGE agent configuration file, . This
section describes how to use SystemEDGE threshold
monitoring and history collection to monitor metrics for
service availability.
eHealth Service Availability User Guide
64. Using SystemEDGE to Monitor Service Availability • 63
eHealth Service Availability User Guide
1
3
Each of the following examples presents a row number in the
range of 5000 to 5999; select a row number for your
configuration that conforms to your local policies. The metrics
used in this section are examples only; you can measure metrics
that are more suited to your environment. In addition, use
thresholds, numbers of samples, and intervals between samples
that make sense for your environment.
NOTE
Enter the commands throughout this section as one line.
Do not use a carriage return to match the formatting shown
here.
Using SystemEDGE Threshold Monitoring
This section provides examples for using SystemEDGE
threshold monitoring to monitor Service Availability metrics.
Enter the following examples into the file (in the
or $%
$%
'(directory) to instruct the
SystemEDGE agent to perform the monitoring that they
describe. For more information about SystemEDGE threshold
monitoring, refer to the eHealth SystemEDGE User Guide.
The most common values recorded in the Service Availability
table are the mean response time (svcRspTableTotalMean) and
mean availability (svcRspTableTotalAvailability). You can,
however, monitor any of the MIB variables, which are described
in Table 5 on page 30 and in the
)file that is installed
in the directory. For example, you can monitor the
variance (svcRspTableTotalVariance) to watch for periods of
large variation in response.
65. 64 • Chapter 3 Configuring eHealth Service Availability
Sending a Trap when a Service Fails to
Respond
To configure the SystemEDGE agent to send a trap when a
service fails to respond, you must monitor the
svcRspTableTotalLastSample MIB variable. This value records
the last sampled response time (in milliseconds [ms]) for this
service entry. If the last test failed, the value is zero.
If, for example, you have created a Web server
response-monitoring entry at row 100 of the Service
Availability table, and this entry tests the server every 60
seconds, set up a SystemEDGE self-monitoring entry to watch
the samples for that row and send a trap if the value is zero. To
do so, enter the following in :
monitor oid svcRspTableTotalAvailability.100 5001 0x0 60 absolute = 0
’Web Server Down’ ’’
Sending a Trap when a Response Sample is
Greater than 7000
To send a trap if any response sample is greater than 7000 ms,
enter the following in :
monitor oid svcRspTableTotalLastSample.100 5002 0x0 60 absolute 7000
’Web Server Too Slow’ ’’
Sending a Trap when the Mean Response Time
is Greater than 5000
To send a trap when the mean response time is greater than
5000 ms, enter the following in :
monitor oid svcRspTableTotalMean.100 10 0x0 60 absolute 5000 ’Web
Server Too Slow On Average’ ’’
eHealth Service Availability User Guide
66. Using SystemEDGE to Monitor Service Availability • 65
eHealth Service Availability User Guide
1
3
Sending a Trap when a New Maximum Value
Appears
To send a trap whenever a new maximum value appears,
regardless of the value, enter the following in :
monitor oid svcRspTableTotalMax.100 10 0x0 60 delta 0 ’New Maximum
Web Server Response’ ’’
Using SystemEDGE History Collection
This section outlines the use of SystemEDGE history collection
to track the value of important Service Availability metrics over
time. For more information about SystemEDGE history
collection, refer to the eHealth SystemEDGE User Guide.
Collecting History on Mean Response Time
To collect historical data on the mean service response time,
you must gather history on the svcRspTableTotalMean MIB
variable. This value records the mean over the sample window
for this service entry.
For example, if you have created a Web server
availability-monitoring entry at row 100 of the Service
Availability table, and this entry tests the server every 60
seconds, you can set up a SystemEDGE History table entry to
record the samples for that row. To do so, enter the following
command in :
emphistory 5002 60 svcRspTableTotalMean.100 400 ’Web Response History’
Collecting History on Connect Time
Enter this command to collect history on the connect time:
emphistory 5002 60 svcRspTableConnMean.100 400 ’Web Connection History’
67. 66 • Chapter 3 Configuring eHealth Service Availability
Using AdvantEDGE View to Monitor Service Availability
You can use Service Availability with AdvantEDGE View to run
queries for monitoring the response and availability of Internet
applications, and to add and modify entries in the file.
For more information about AdvantEDGE View, refer to the
eHealth AdvantEDGE View User Guide.
To run an AdvantEDGE View Application query for
Service Availability:
1. From the AdvantEDGE View interface, select the target
eHealth Service Availability User Guide
system or group from the System or Group list.
2. Select Service Availability from the Applications list.
3. Click the Applications icon.
AdvantEDGE View runs the query for the specified application
on the system or group you selected.
NOTE
If you run a query for a group of systems,
AdvantEDGE View requests additional information before
running the query. For more information, refer to the Web
Help for Service Availability.
AdvantEDGE View displays the following for the system you
queried:
• Mean Service Response Times chart
• Service Availability chart
• Configuration Details table
68. Using AdvantEDGE View to Monitor Service Availability • 67
eHealth Service Availability User Guide
1
3
Mean Service Response Times Chart
Figure 1 shows the Mean Service Availability Times portion of
the AdvantEDGE View Service Availability query.
Figure 1. Sample Mean Service Response Times Chart
69. 68 • Chapter 3 Configuring eHealth Service Availability
Service Availability Chart
Figure 2 shows the Service Availability portion of the
AdvantEDGE View Service Availability query.
Figure 2. Sample Service Availability Chart
Configuration Details Table
Figure 3 shows the Configuration Details table of the
AdvantEDGE View Service Availability query.
Figure 3. Section of a Sample Configuration Details Table
eHealth Service Availability User Guide
70. Performance Tuning Strategies • 69
eHealth Service Availability User Guide
1
3
You can add and modify entries in the Service Availability table
through AdvantEDGE View. To add an Entry, click Add
Service Availability Entry from the bottom of the Service
Availability query. To modify an entry, click Modify in the
Index column of the Configuration Details table for the row
you want to modify.
For more information about how to add and modify entries
through AdvantEDGE View, refer to the Service Availability
Web Help that is available from the AdvantEDGE View
interface.
Performance Tuning Strategies
If you find that each Service Availability test is taking longer to
complete than you expected, try the following to improve the
performance:
1. Increase the number of threads that the collector is using.
You can do so by editing the maxthreads argument in the
file. A larger number of threads allows the
collector to run more tests concurrently.
NONTOETE
Setting the maximum threads too high may have a
negative effect. You may need to use trial and error to
get the right number of threads for your system.
2. Increase the interval time. As the number of tests increase,
it becomes progressively more difficult for the collector to
process all the tests in a short interval time. Consider
increasing the interval by a 30-second increment. For
example, if you have 500 tests running at 30-second
intervals, try running them at 60-second or 90-second
intervals instead.
3. Decrease timeout values. Consider reducing your timeout
values if they are more than half of the interval time.
71. 70 • Chapter 3 Configuring eHealth Service Availability
4. Optimize the file. Put long-duration tests at the
eHealth Service Availability User Guide
beginning of the file, and short-duration tests at the end of
the file.
5. If you have attempted all of the other strategies and still do
not see a performance improvement, move some of the
tests to another system.
72. 71
Index
A
AdvantEDGE View
adding or modifying Service Availability
entries 69
Configuration Details table 68
Mean Service Response Times chart 67
Service Availability chart 68
using to monitor Service Availability 66
application query for Service Availability 66
arguments for service tests 35
C
Configuration Details table 68
configuration examples
custom scripts 56
DNS 43
FTP 44
HTTP 45
HTTP content 48
HTTPS 47
network reachability 50
NNTP 49
ping 50
POP 51
round-trip e-mail 52
secure Web server 47
sendmail 53
SMTP 53
TCP connection 54
Virtual User test 55
Web server availability 45
configuring eHealth Service Availability
overview 29
using the svcrsp.cf file 41
using the sysedge.cf file 62
configuring Service Availability
using AdvantEDGE View 66
using svcwatch 58
custom scripts
output 57
requirements 56
running 56
specifying script to use in arguments
field 35
D
deleting entries
manually 58
svcwatch 62
DNS
73. 72 • Index
arguments field 35
measuring time to resolve IP addresses 43
E
eHealth Service Availability
AdvantEDGE View 66
configuration overview 29
configuring in sysedge.cf 21
configuring Service Response table 41
initial configuration 41
installation
UNIX 13
Windows 15
installed files 19
licensing 22
overview 9
removing 27
uninstalling 27
e-mail, round-trip times 52
error codes 35
evaluation copy, licensing 23
examples. See configuration examples.
F
FTP
arguments field 35
measuring time to log in and test status 44
G
generating a license 23
eHealth Service Availability User Guide
H
HTTP
arguments field 36
measuring availability 45
measuring time to accessing a Web server
through a proxy 46
measuring Web server response time 45
monitoring content 48
HTTPS
arguments field 36
measuring time to access a secure
server 47
I
installation directory 16
installing eHealth Service Availability
UNIX 13
Windows 15
L
license
generating 23
sample 26
licensing
AdvantEDGE View
event processing 25
evaluation copy 23
overview 22
M
Mean Service Response Times chart 67
74. Index • 73
eHealth Service Availability User Guide
N
network reachability, measuring 50
NNTP
arguments field 37
measuring time to connect 49
O
obtaining a license 22
P
ping
arguments field 37
measuring time to perform 50
POP3
arguments field 37
measuring time to log in and optionally
download mail 51
R
record and playback 55
removing entries
manually 58
svcwatch 62
removing Service Availability 27
results 34
round-trip e-mail
arguments field 37
example 52
S
secure Web server availability, example 47
sendmail, measuring time to connect and
perform null transaction 53
Service Availability chart in
AdvantEDGE View 68
Service Availability table
arguments 35
assigning entry rows 40
format for entries 42
MIB objects 30
overview 29
removing entries
manually 58
svcwatch 62
SMTP
arguments field 38
availability, example 53
measuring time to connect and perform
null transaction 53
specifying TOS 35
svcrsp.cf file
custom script example 56
DNS example 43
format for entries 42
FTP example 44
HTTP content example 48
HTTP example 45
HTTP proxy example 46
HTTPS example 47
manually editing 41
NNTP example 49
PING example 50
POP3 example 51
record and playback example 55
removing entries 58
round-trip e-mail example 52
sample entries 42
SMTP example 53
TCP Connect example 54
Virtual User example 55
svcwatch utility
75. 74 • Index
adding an entry 61
deleting an entry 62
listing entries 62
setting status of an entry 62
using 58
sysedge.cf file
adding entries to monitor Service
Availability 62
configuring loading of Service
Availability 21
history collection for Service Availability
variables 65
thresholding monitoring of Service
Availability variables 63
sysedge.lic file 22
SystemEDGE agent
configuring 21
monitoring service response 62
sysedge.cf file 62
T
TCP
arguments field for TCP Connect service
38
measuring time to connect 54
temporary license 23
throughput 34
U
uninstalling Service Availability 27
using
AdvantEDGE View 66
svcwatch utility 58
eHealth Service Availability User Guide
V
virtual user test
arguments field 38
enabling SNMP service to interact with
desktop 39
76.
77. CONTACT CONCORD COMMUNICATIONS AT:
CONCORD COMMUNICATIONS, INC.
NORTH AMERICA
600 NICKERSON ROAD
MARLBORO, MASSACHUSETTS 01752
800-851-8725
P 508-460-4646
F 508-481-9772
CONCORD COMMUNICATIONS EUROPE
DELFTECHPARK 26
2628 XH DELFT
THE NETHERLANDS
P +31 (0) 15 2600 930
F +31 (0) 15 2600 929
CONCORD COMMUNICATIONS ASIA PACIFIC
LEVEL 7, 53 WALKER STREET
NORTH SYDNEY NSW 2060
AUSTRALIA
P 61-2-9965-0600
F 61-2-9929-0411
FRANCE: +33 (0) 1 4692 2420
GERMANY +49 (0) 89 944 90 105
UK: 00800 3283 2888
JAPAN 813-5778-7629
SINGAPORE: 65-4309533
CONCORD.COM