Setting Up Service Availability 2 - CA Support...

CA eHealth®

Setting Up Service Availability 2.0r6.1

This documentation and any related computer software help programs (hereinafter referred to as the “Documentation”) is for the end user’s informational purposes only and is subject to change or withdrawal by CA at any time.

This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This Documentation is confidential and proprietary information of CA and protected by the copyright laws of the United States and international treaties.

Notwithstanding the foregoing, licensed users may print a reasonable number of copies of the Documentation for their own internal use, and may make one copy of the related software as reasonably required for back-up and disaster recovery purposes, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the provisions of the license for the product are permitted to have access to such copies.

The right to print copies of the Documentation and to make a copy of the related software is limited to the period during which the applicable license for the product remains in full force and effect. Should the license terminate for any reason, it shall be the user’s responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.

EXCEPT AS OTHERWISE STATED IN THE APPLICABLE LICENSE AGREEMENT, TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE.

The use of any product referenced in the Documentation is governed by the end user’s applicable license agreement.

The manufacturer of this Documentation is CA.

Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or their successors.

All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

Copyright © 2008 CA. All rights reserved.

CA Product References

CA Product ReferencesThis document references the following CA product:

CA eHealth® (eHealth)

CA AdvantEDGE View™ (AdvantEDGE View)

CA eHealth® SystemEDGE™ (SystemEDGE)

CA eHealth® Live Health® Application (Live Health)

Contact Technical SupportFor online technical assistance and a complete list of locations, primary service hours, and telephone numbers, contact Technical Support at http://ca.com/support.

3

Contents

Chapter 1: Installing Service AvailabilityService Availability Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7How to Set Up Service Availability Tests. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8SA Setup Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Test and Agent Setup Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Types of Tests to Run . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Agent Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Test Sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Test Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Platform Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

How to Set Up Service Availability. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Install Service Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Chapter 2: Upgrading Service AvailabilityGuidelines for Upgrading Service Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Service Availability Upgrade Process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Migrate Existing SA Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17Upgrade Service Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Chapter 3: Managing SA Agents and TestsDiscover SA Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23SA Workflow Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

View Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24Create Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Create Test Sets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Create Agent Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Create Test Profiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Guidelines for Using Commit to Propagate Tests to Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Types of Commits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Commit Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30View Commit Log Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Monitor Agents and Test Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Modify the Test Monitor page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Guidelines for Changing Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Edit the SA Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Run Historical Reports for Your Paths. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Supported Platforms for SA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Contents 5

Chapter 1: Installing Service Availability

This document explains how to install or upgrade Service Availability by using the eHealth Web interface. It also describes the SA workflow for creating tests or sets of tests, associating them with one or more agents in a test profile, and distributing those tests to SA agents.

This chapter contains the following topics:

Service Availability Overview

How to Set Up Service Availability Tests

SA Setup Prerequisites

Test and Agent Setup Prerequisites

How to Set Up Service Availability

Install Service Availability

Service Availability OvervieweHealth and Service Availability (SA) 2.0 help you create, manage, and monitor a variety of tests for measuring the performance of key business applications. These tests let you evaluate the availability and response times of those business services and help ensure their reliability.

The following diagram illustrates the SA workflow.

Installing Service Availability 7

How to Set Up Service Availability Tests

ry

Use the eHealth Web interface to view the available SystemEDGE agents where Service Availability tests will run.

How to Set Up Service Availability TestsComplete the following tasks to set up SA tests:

1. Plan and organize how and where to set up your tests and test systems.

2. Create tests to measure the performance of your business services, including Web services, network services, database services, email, file transfer services, custom tests, and robotic scripts for testing user services.

3. Group logically related tests into test sets and logically related SystemEDGE test systems into agent sets.

4. Create test profiles and populate them with associated sets of agents and tests for easy management of related testing and monitoring.

5. Deploy the test profiles to one or more test systems with the SA Commit operation. This step creates paths between each test source and destination.

6. Use SA to monitor the SA tests that are running and evaluate their performance. Go to the SA Monitor page to see the status and performance of any SA test.

7. View At-a-Glance reports for the paths that eHealth creates to get current and historical data for those paths.

DatabaseServers

SNMP

eHealth System

View eHealth reports

SA Web interfaceVirtual UserTest Set

HTTPTest Set

SQL QueTest Set

SA test system runson a SystemEDGE agentto test business services

Create tests &test profiles.Deploy andmanage tests.Monitor tests &evaluate testperformance.

continuously.

Commit Teststo Agents

8 Setting Up Service Availability 2.0

SA Setup Prerequisites

SA Setup PrerequisitesYou must do the following before installing SA:

Install eHealth Release 5.7 or later.

Note: For more information, see the eHealth Installation Guide.

Install SystemEDGE Release 4.2 or later second.

Note: For more information, see the eHealth SystemEDGE User Guide.

Install the SystemEDGE JRE Software Package for Version 2 next.

The JRE package is available from the SystemEDGE section of the eHealth Support Website:

http://support.concord.com/support/secure/software

Make sure that a minimum of 20 MB of disk space is available for SA 2.0.

Migrate your existing SA test paths before installing SA 2.0 if you are upgrading from a previous version of SA.

Make sure that the SNMP community string for SystemEDGE is set to read-write. SA writes tests to agents and requires write permission to do so.

Test and Agent Setup PrerequisitesBefore installing Service Availability, determine the number of test systems and agents that you intend to set up and where to install them. The recommended practice is to set up SA test systems in each of the key locations and business groups throughout your enterprise. This approach lets you simulate and monitor user activity for each of your critical business applications.

As part of your planning, consider the number, capacity and location of your SA est systems from the standpoint of being able to produce consistent test results.

Types of Tests to Run

If you have Web servers in your environment, you can use HTTP, HTTPS, and ping tests to test your Web servers. If you have DNS and DHCP servers, create DNS and DHCP tests. If you have special applications that you want to test, create Custom or Virtual User tests. Over 20 tests are available, as shown in the following table.

Active Directory Custom

DHCP DNS

File I/O FTTP

HTTP HTTPS


Test and Agent Setup Prerequisites

Agent Sets

SA 2.0 lets you group agents into agent sets so that you can manage them more easily and logically. An agent set is a collection of one or more SA agents that you can manage together. For example, you can create an agent set that includes all SA agents in a particular location or business organization like sales or manufacturing.

Test Sets

You can group tests into test sets. For example, you may want to create a test set that includes all your ping tests or a test set that includes all the tests you want to run from a specific SA test system—for example, a ping test, DNS test, TCP Connect test, and HTTP test. Grouping test resources logically (for specific business groups, key locations, or business applications) lets you monitor the performance and health of those related resources.

You create groups of tests and agents based on the type of information reporting you want. For example, you can create a set of tests to monitor the performance and availability of important Web resources or critical business applications for your entire enterprise or just one location. You can then view eHealth reports (directly from SA) to see if those important business resources have been performing as expected.

Test Profiles

A test profile is a logical association of tests or test sets with agents or agent sets. This dimension of SA makes managing and deploying tests to agents very easy. It lets you distribute a common set of SA tests to multiple SA agents and manage all of them together.

IMAP LDAP

MAPI NIS

NTTP Ping

POP3 Round Trip Email

SMTP SNMP

SQL Query TCP Connect

TFTP Virtual User


How to Set Up Service Availability

Platform Dependencies

When planning your SA tests, be sure to consider system platform dependencies that might influence the success of deploying groups of tests to multiple agents. For example, tests that require pathnames are not interchangeable between UNIX and Windows® because the pathname conventions are different (for example, backslashes in UNIX pathnames versus forward slashes in Windows).

Note: On AIX systems, you cannot install Service Availability on the same system where with the Oracle AIM is installed.

How to Set Up Service AvailabilityThe process for setting up SA is summarized as follows:

1. Make sure that eHealth Release 5.7 or later is installed and running on the system from which you intend to manage your agents and tests. eHealth must be installed and running before you install Service Availability.

2. Install SystemEDGE Release 4.2 or later on all systems from which you want to run SA tests. SystemEDGE must be installed before you install Service Availability. Standardizing the location in which you install SystemEDGE agents makes deployment and ongoing management simpler.

To configure SystemEDGE log file monitoring of SA test systems, CA recommends that you install the SystemEDGE agent in the default location. Otherwise, modify the AdvantEDGE View templates to include the correct path to the log files.

Note: For more information about log file monitoring, see the SystemEDGE User Guide.

3. Install the SystemEDGE JRE Software Package for Version 2 on all systems from which you want to run SA tests. SystemEDGE JRE must be installed before you install Service Availability. The JRE package is available from the SystemEDGE Downloads page of the eHealth Support Website:


4. Install SA 2.0 on all SystemEDGE agents from which you want to run SA tests.

5. Use eHealth to run the discover process for System and Response Elements modes to discover the SystemEDGE agents that you have installed. Create your tests, test sets, agents sets, and test profiles as necessary.

Note: You must use a read-write SNMP community string for Commit to succeed. Without it, your SA tests will not run.

6. Use Commit to update the agents.

7. View historical eHealth reports for your paths.

More information:

Commit Changes on page 30



Install Service AvailabilityFollow the instructions in this section if you are installing Service Availability for the first time.

To Install SA on a UNIX System

1. Verify that eHealth, SystemEDGE, and the SystemEDGE JRE package are installed, as described in the How to Set Up Service Availability on page 11.”

2. Log in as the root user on the system(s) from which you want SA tests to originate.

3. Verify that /plugins exists in the SystemEDGE agent installation directory.

The recommended directory is /opt/EMPsysedge/plugins. If that directory does not exist, verify that you have SystemEDGE Release 4.2 or later installed and then create the directory manually.

4. Insert the AdvantEDGE CD into the CD-ROM drive and mount it on the partition /cdrom.

For mounting instuctions, see your system documentation.

For Solaris systems, execute the following command:

mount -r -t hsfs /dev/sr0 /cdrom

5. Change to the SystemEDGE agent installation directory and load the files from the CD-ROM by executing the following commands (for Solaris):

cd /opt/EMPsysedge tar xvof /SvcRspFilepath/svcrsp.tar

6. Run the install script by executing the following commands (for Solaris):

cd /opt/EMPsysedge/plugins/svcrsp/./Install

Note: For AIX systems, the installation directory is as follows:

/usr/lpp/EMPsysedge (not /opt/EMPsysedge)

Similarly the install script for SA is in the following directory:

/usr/lpp/EMPsysedge/plugins/svcrsp/Install

Please pay particular attention to these sections of the SystemEDGE installation:

Managing Community Strings:

The installer shows your current SNMP community string setting(s). You need at least one read-only and one read-write community string. Without a read-write community string set, you cannot run SA tests.

Trap Destinations:

The eHealth server must be one of your trap destinations to support monitoring. The installer shows your current trap destination settings and lets you create new ones.



Installing and Licensing JDBC drivers:

You have two options: install a JDBC driver to support Microsoft SQL tests in SA and install a JDBC driver to support Oracle tests in SA. If you choose to install either or both drivers, you must accept the associated licensing agreement(s).

Finally, the installer takes you through the SystemEDGE licensing procedure.

7. Complete the agent licensing and then complete the procedures in the chapter about managing SA agents and tests.

Note: If the installation process does not succeed, read the install log to see if you have entered information incorrectly. This file is in the following location:

/tmp/svcrsp.install.log

To Install SA on Windows Systems

1. Verify that eHealth, SystemEDGE, and the SystemEDGE JRE package are installed, as described in How to Set Up Service Availability on page 11.

2. Log on to the Windows system as the administrator.

3. Insert the AdvantEDGE CD-ROM into the drive.

4. Double-click svcrsp.exe to launch the InstallShield installer.

The Service Availability Module Installation dialog appears.

5. Click Next.

An informational screen appears.

6. Click Next.

InstallShield installs the module on your system.

7. Click Finish.

8. Click Yes in the dialog to enable Service Availability monitoring in SystemEDGE.

9. Specify the number of threads you want Service Availability to run simultaneously and then click Next.

The default value is 10. If, however, you intend to run Virtual User tests (or run SA tests sequentially), specify 1.

A dialog asks if you want Service Availability to execute Custom (and Virtual User) scripts, File I/O tests, and allow Untrusted SSL Certificates.

10. Click the boxes next to the options that you want to enable and then click Next.

A dialog informs you that a TOS (Type of Service) registry entry has been created and set to enabled. (This change takes effect after you reboot.) If your routers are configured to use TOS, you can set TOS values with Service Availability.

11. Click Next.

A dialog informs you of the current SNMP read-write community string(s) and asks if you want to add new ones.



12. Add any new strings, separated by spaces, and then click Next.

A dialog informs you of the current SNMP read-only community string(s) and asks if you want to add new ones.

13. Add any new strings, separated by spaces, and then click Next.

A dialog informs you of the current SNMP trap community:destination pairs and asks if you want to add new ones.

14. Add any new pairs, separated by spaces, and then click Next.

A dialog asks if you want to download the JDBC drivers for Microsoft SQL Server, Oracle, or both.

15. Click the boxes for the databases against which you intend to run SQL tests and then click Next.

16. Click Yes to proceed with the database driver downloads.

17. Click Yes in the subsequent window to accept the license agreement for each driver.

The installation starts the SystemEDGE agent, and a dialog asks whether you want to license Service Availability now.

18. Click Yes.

The License Type dialog appears.

19. Accept the default of permanent or specify usage or partner.

A dialog asks if you are using a Web proxy.

20. Do one of the following:

If you are using a proxy server, click Yes and then specify a hostname, user name, and password for the proxy in the subsequent dialogs.

If you are not using a proxy server, click No.

The Web Licensing Account Information dialog appears.

21. Specify your licensing account user name and password and click Next.

A dialog informs you that license data will be sent to [email protected] and asks for confirmation.

22. Click OK.

The installer adds a licensing string for your Service Availability module to the drive:\Winnt\System32\sysedge.lic file and the InstallShield Wizard Complete dialog appears.

23. Click Finish and then complete the procedures in the chapter about managing SA agents and tests.

Note: For a complete list and description of the installed files, see the eHealth Help.


Chapter 2: Upgrading Service Availability


Guidelines for Upgrading Service Availability

Service Availability Upgrade Process

Migrate Existing SA Paths

Upgrade Service Availability

Guidelines for Upgrading Service AvailabilityBefore upgrading SA, pay close attention to the following:

Users upgrading from a previous version of Service Availability can still view, delete, and retire SA 2.0 paths in the eHealth Path Manager. You can no longer use Path Manager, however, to create new SA paths (tests). With eHealth 5.7 or later, you create and manage all SA tests from the SA Web interface.

Once you have upgraded your eHealth system and have migrated your SA paths, you can start using the SA 2.0 web console to make changes to existing SA tests and create new ones.

CA recommends that you upgrading your eHealth server before upgrading your SA agents to SA 2.0. Although eHealth versions prior to 5.7 can poll and report on SA agents that have been upgraded to SA 2.0, the new test format used by the SA 2.0 agent is not backward compatible with previous versions of eHealth. Any attempts made to create or modify SA tests on an upgraded SA 2.0 agent by previous versions of eHealth may cause erroneously formatted SA tests and will result in eHealth polling errors.

Before installing SA 2.0, you must install the SystemEDGE JRE Software Package for Version 2. This package was previously installed with SA, but now must be installed separately.

Upgrading Service Availability 15

Service Availability Upgrade Process

If you have more than one eHealth system running SA tests on a common agent, contact your eHealth Technical Support representative for assistance in upgrading eHealth.

If you are currently using Service Availability tests created with the eHealth Path Manager, you must migrate those test paths before you can use them in eHealth 5.7 or later.

Service Availability Upgrade ProcessTo upgrade SA, you must complete the follow tasks:

1. Upgrade eHealth to Release 5.7 or later first.

Note: For more information, see the eHealth Installation Guide.

2. Verify that polling is turned on for existing SA paths that need to be migrated.

3. Let the eHealth poller run for at least one complete polling interval (about five minutes).

4. Migrate your existing SA paths with the nhMigrateSaPaths utility.

5. Make a backup copy of the current SA installation directory on each SA test system and keep a copy of the configuration file, svcrsp.cf, for use later in the process.

6. Upgrade SystemEDGE to Release 4.2 or later for each SA test system.

7. Install the SystemEDGE JRE Software Package for Version 2 on each SA test system.

The JRE package is available from the SystemEDGE Downloads page of the eHealth Support Website:


8. Upgrade to SA 2.0 On each SA test system.

9. Use eHealth to run the discover process in System and Response Elements modes to rediscover all of the SystemEDGE agents.

10. Commit the agent updates to synchronize the agents with eHealth.

11. Create new tests, test sets, agents sets, and test profiles as necessary.

12. Monitor your agents and test profiles.

13. View historical eHealth and Live Health reports.

More information:

Guidelines for Upgrading Service Availability on page 15

Commit Changes on page 30

Monitor Agents and Test Profiles on page 31


Migrate Existing SA Paths

Migrate Existing SA PathsThe nhMigrateSaPaths utility migrates only those response paths that are currently in the eHealth database. If your current SA configuration file has Service Availability tests that do not exist as paths in eHealth, those paths are not in the current eHealth database and will not migrate successfully. To manage them through the SA 2.0 Web interface, you must create them again as new tests by using the Service Availability page of the Systems & Apps tab after upgrading eHealth and your SA agents.

Note: nhMigrateSaPaths is a run once tool. After this migration program has run successfully, the SA test configuration can be managed only from the new SA web interface. Any SA path modifications made from Path Manager after you migrate your SA paths are temporary and will be overwritten by SA once the SA agent has been upgraded to SA 2.0.

Run nhMigrateSaPaths once, as soon as possible, after upgrading to eHealth Release 5.7 or later and before upgrading your agents to SA 2.0.

eHealth does not overwrite existing SA test paths (agent-test pairs) that exist in the current configuration file, whether or not those tests were created originally in eHealth.

At startup, SA 2.0 updates the existing configuration file in the SA installation directory with any new configuration options. It does not change the settings for other (previous) configuration options.

To Migrate Existing SA Paths

1. Make sure that the eHealth system has been upgraded to Release 5.7 or later and that you have not created any SA 2.0 tests, test sets, or agent sets by using the Service Availability page of the Web interface.

Note: nhMigrateSAPaths will not run if there are pre-existing SA 2.0 paths. If any exist, you must use nhMigrateSaPaths -deleteConfig to remove those paths before you begin path migration.

2. Verify the following:

Your eHealth system is not the front end system in an eHealth cluster. In a Distributed eHealth environment, run nhMigrateSaPaths on all of the back-end systems that have Service Availability paths or elements configured.

eHealth is running.

Polling is turned on for all paths that you want to migrate.

Note: The nhMigrateSaPaths utility does not migrate paths that have polling turned off or paths that are polled remotely.

3. Open a command window on the eHealth system and execute one of the following commands.

On UNIX, the command format is:

NH_HOME/bin/nhMigrateSaPaths



NH_HOME

Represents the eHealth home directory.

On Windows, the command format is:

nhMigrateSaPaths

nhMigrateSaPaths verifies the following:

You have not run the utility previously on this system.

Service Availability paths exist in the eHealth Path Manager.

No duplicate paths exist in the eHealth Path Manager. If they do, nhMigrateSaPaths displays a list of the duplicates and exits. You must clean up the duplicates before running the utility again.

nhMigrateSaPaths checks for the following:

Any existing paths that have polling turned off or are retired.

Whether any paths are dynamic. If so, nhMigrateSaPaths lists the dynamic paths to let you delete or retire them before rerunning the utility.

Finally, nhMigrateSaPaths migrates any known paths and displays the number of paths migrated successfully.

Upgrade Service AvailabilityStandardizing the location in which you install SystemEDGE agents makes deployment and ongoing management simpler. If you want to configure SystemEDGE log file monitoring of SA test systems, CA recommends that you install the SystemEDGE agent in default locations. Otherwise, you must modify the AdvantEDGE View templates to include the correct path to the log files.

To Upgrade to SA 2.0 on UNIX Systems

1. Verify that eHealth Release 5.7 or later, SystemEDGE Release 4.2 or later, and the SystemEDGE JRE software package are installed, as described in the Service Availability Upgrade Process on page 16.

2. Log in as the root user on the SA system(s).

3. Verify that /plugins exists in the SystemEDGE agent installation directory. The recommended directory is /opt/EMPsysedge/plugins. If that directory does not exist, verify that you have SystemEDGE Release 4.2 or later installed and then create the directory manually.

4. Stop the SystemEDGE agent by executing the stop command for the SystemEDGE startup script.

For Solaris, execute the following command:

/etc/rc2.d/S99sysedge stop



Note: The location and name of the startup script varies by operating system. For information about the name and location of the SystemEDGE startup script for your operating system, refer to the eHealth SystemEDGE User Guide.

5. Make a copy of the current svcrsp.cf configuration file on each SA agent system (after migrating paths) for use later.

6. Insert the AdvantEDGE CD into the CD-ROM drive and mount it on the partition /cdrom.

Note: For mounting instuctions, see your system documentation.

For Solaris systems, execute the following command:

mount -r -t hsfs /dev/sr0 /cdrom

7. Change to the SystemEDGE agent installation directory and load the files from the CD-ROM by executing the following commands (for Solaris):

cd /opt/EMPsysedge tar xvof /SvcRspFilepath/svcrsp_full.tar

Note: For AIX systems, the installation directory is:

/usr/lpp/EMPsysedge (not /opt/EMPsysedge)

Service Availability is now installed.

Note: If you installed Service Availability in a location other than the default location, specify the correct install path for your installation. If you do not include the correct path, the SystemEDGE agent cannot load the module and Service Availability cannot collect data.

8. Put a copy of your backup SA configuration file into the current SA 2.0 install directory.

When SA starts, eHealth will update it with any new configuration options while maintaining your current configuration.

9. Configure SystemEDGE to load SA by opening the /etc/sysedge.cf file in a text editor.

Add the sysedge_plugin keyword and the path to the shared library for SA and then save the file.

For example, you would add the following text for a 64-bit Solaris system (on one line):

sysedge_plugin /opt/EMPsysedge /plugins/svcrsp/svcrsp-sparcv9.so

10. Restart the SystemEDGE agent by executing the following command from the /opt/EMPsysedge directory (for Solaris):

/etc/rc2.d/S99sysedge start

You can now complete the procedures for managing SA agents and tests.




To Upgrade to SA 2.0 on Windows Systems

1. Verify that eHealth Release 5.7 or later, SystemEDGE Release 4.2 or later, and the SystemEDGE JRE software package are installed, as described in the Service Availability Upgrade Process on page 16.

2. Log on to the Windows system as administrator.

3. Insert the AdvantEDGE CD-ROM into the CD-ROM drive.

4. Double-click svcrsp.exe to execute the InstallShield installer.

The Service Availability Module Installation dialog appears.

5. Click Next.

An informational screen appears.

6. Click Next.

InstallShield installs the module on your system.

7. Click Finish.

8. Click Yes to enable Service Availability monitoring in SystemEDGE.

9. Specify the number of threads that you want Service Availability to run simultaneously and then click Next.

The default value is 10. If, however, you intend to run Virtual User tests (or run SA tests sequentially), specify 1.

Note: To change configuration settings, edit this file:

\sysedge\plugins\svcrsp\svcrsp.cf

A dialog asks if you want Service Availability to execute Custom (and Virtual User) scripts, File I/O tests, and allow Untrusted SSL Certificates.

10. Click the boxes next to the options you want to enable and then click Next.

A dialog informs you that a TOS (Type of Service) registry entry has been created and set to enabled. (This change takes effect after you reboot.) If your routers are configured to use TOS, you can set TOS values with Service Availability.

11. Click Next.

A dialog informs you of the current SNMP read-write community string(s) and asks if you want to add new ones.

12. Add any new strings, separated by spaces, then click Next.

A dialog informs you of the current SNMP read-only community string(s) and asks if you want to add new ones.

13. Add any new strings, separated by spaces, then click Next.

A dialog informs you of the current SNMP trap community:destination pairs and asks if you want to add new ones.

14. Add any new pairs, separated by spaces, then click Next.

A dialog asks if you want to download the JDBC drivers for Microsoft SQL Server, for Oracle, or both.

15. Click the boxes for the databases against which you intend to run SQL tests and then click Next.



16. Click Yes to proceed with the database driver downloads.

17. Click Yes in the subsequent window to accept the license agreement for the driver.

18. Click OK.

The installation starts the SystemEDGE agent.

19. Click Finish.

You can now complete the procedures for managing SA agents and tests.



Chapter 3: Managing SA Agents and Tests


Discover SA Agents

SA Workflow Overview

Guidelines for Changing Configuration Settings

Edit the SA Configuration File

Run Historical Reports for Your Paths

Supported Platforms for SA

Discover SA AgentsThe eHealth discover process finds elements in your IT infrastructure and stores information about them in the eHealth database and poller configuration. After you install your SA agents, you must use your eHealth system to discover them.

Note: To upgrade SystemEDGE agents by using a push deployment from the eHealth web console, see the eHealth Help.

You must be an eHealth administrator to run the discover process.

To run the discover process

1. Select Setup, Discover from the eHealth console.

The Discover dialog appears.

2. Select System and Response Elements under Mode.

3. Specify the read and write community strings to use to discover the agents in the Community Strings field.

You need a write community string for SA to write tests to agents.

4. Locate Discover Using and specify the IP addresses of the systems on which you installed the SA agents.

5. Click Discover.

6. Click Save in the Discovering dialog.

Managing SA Agents and Tests 23


The elements that eHealth discovered are saved, and these agents are now displayed on the Agent Management page of the SA Web interface.

Note: For more information about running the discover process, click Help in the Discover dialog.

SA Workflow OverviewThe SA Web interface provides a central management console for your SA agents. You can use this interface to do the following:

1. View the list of available agents.

2. Create tests.

3. Group them into test sets (optional).

4. Group the agents into agent sets (optional).

5. Associate the agents and agent sets with tests and test sets by creating test profiles.

6. Use commit to propagate your tests to the agents.

7. Monitor the performance of tests, based on agents or test profiles.

View Agents

Before creating any tests, be sure that eHealth knows about your agents. You cannot write tests to agents until eHealth has discovered them.

To view the known agents

1. Go to the Service Availability page of the eHealth Web interface.

2. Click Agents.

The Agent Management page appears and lists each agent known to eHealth.

In SA 2.0, you associate agents with tests in a test profile and then deploy (by using Commit) the profile to the agents in the list. SA uses that information to create test paths automatically.

If agents do not appear in the list, eHealth has not discovered any agents. Verify the following:

The SystemEDGE agent and Service Availability module are installed on your systems.

The discover process was run for those systems using the System and Response Elements modes.



Create Tests

SA provides over 20 types of tests for evaluating the availability and performance of key business applications. SA 2.0 lets you create tests independently of agents and create sets of tests and associate them with an agent or a set of agents when you create a test profile. You can also deploy one or more tests to one or more agents by using test profiles.

To create a test

1. Go to the Systems & Apps page from the eHealth Web interface.

2. Select Service Availability and then click Tests.

The Test Management page appears.

3. Click Add.

The Create a New Test page appears.

4. Select the type of test to create from the Test Type list and complete the fields for name, description, and the test-specific options.

The online help from that page provides details and examples to help you complete the page for each type of test.

Note: When specifying pathnames for new tests that you create, be sure to use the correct formats for the operating system on which the test runs. Use forward slashes (/) for UNIX systems and backslashes (\) for Windows systems.

5. (Optional) Select Advanced to view and modify advanced options for the test.

6. Click Save when you have finished specifying options for the test.

To create a test that is very similar to a test you have already created

1. Select the test on the Test Management page.

2. Click Modify and specify a new test name.

3. Modify any options and then click Save As.

The new test is created.

Create Test Sets

You can group your SA tests logically by creating test sets. For example, one test set may contain a variety of tests whose purpose is to monitor the availability and performance of important Web sites. Another test set may focus on email or database performance. Your test sets may apply to the entire enterprise, to specific locations in the company, or to specific business units or organizations.

To create a test set

1. Go the Service Availability page from the eHealth Web interface and click Test Sets.



The Test Set Management page appears. If tests do not appear on this page, you have not created them.

2. Click Add.

The Create a new Test Set page, shown in the following graphic, appears.

3. Specify a name and (optional) description for the test set.

4. Select the tests that you want to add to the test set from the Available Tests list and then click Add.

To select multiple tests, press Ctrl and select the tests that you want to add.

5. (Optional) Select any test in the Member Tests list that you want to remove from the set and click Remove.

6. Click Save to create the test set.

The Test Set Management page appears.

Create Agent Sets

You can group your agents logically by creating agent sets. An agent set makes it possible to deploy the same test or test sets to a range of agents to set up uniform testing for various business organizations or locations. Agent sets enhance the flexibility of deploying tests and serve as a means of organizing the type of targets for which you produce eHealth reports.



To create an agent set

1. Go the Service Availability page from the eHealth Web interface and click Agent Sets.

The Agent Set Management page appears.

2. Click Add.

The Create a new Agent Set page appears.

3. Specify a name and (optional) description for the agent set.

4. Select the agents that you want to add to the agent set From the Available Agents list and then click Add.

To select multiple agents, press Ctrl and select the agents you want to add.

5. (Optional) the Member Agents list, select any agents in that you want to remove from the set, and click Remove.

6. Click Save to create the agent set.

The Agent Set Management page, shown in the following graphic, appears.

7. Finish creating agent sets and commit your changes as described in Commit Changes on page 30.



Create Test Profiles

Test profiles associate the tests and test sets that you create with agents and agent sets. You can add the same tests, test sets, agents, or agent sets to multiple profiles. When you create a test profile and commit changes, eHealth adds each test to the associated agent and creates a response path element for each agent-test association in the profile. Even if the same agent-test association exists in multiple profiles, eHealth creates only one path and adds it to the agent only once.

To create a test profile

1. Go to the Service Availability page from the eHealth Web interface and click Test Profiles.

The Test Profile Management page appears.

2. Click Add.

The Create a new Test Profile page appears.

3. Specify a name and (optional) description for the test profile.

4. Select Agent Sets or Single Agents and then select the agent sets or agents that you want to add to the profile.

5. Select Test Sets or Single Tests and then select the test sets or tests that you want to associate with the agent or agent set that you selected.

6. Click Add.

The association that you created appears.



7. Repeat steps 5 and 6 until you have finished associating agents and tests for this profile.

Note: SA does not distinguish between Windows and UNIX systems when deploying tests. When you associate tests with agents in the test profile, be sure not to associate a Windows-specific test with an agent on a UNIX system. For example, the MAPI and Virtual User tests can run only on Windows systems. If you create a test profile in which you apply those types of tests to agents on UNIX systems, SA creates the test profile but the tests will fail when the agent attempts to run them.

8. (Optional) Remove associations from the test profile by selecting the association and clicking Remove.

9. Click Save to create the test profile.

The Test Profile Management page appears.

10. Finish creating test profiles and commit your changes.

eHealth creates paths for each agent-test association in the profile and pushes the tests to the specified agents.

Guidelines for Using Commit to Propagate Tests to Agents

When you make changes through the Service Availability Web interface, the changes are saved in the eHealth database but are not transferred immediately to the eHealth poller configuration or the Service Availability agents. To create or modify eHealth paths and push changes to the SA agents, you must commit the changes.

You can commit changes by clicking Commit from the Service Availability page. The recommended practice is to commit changes all at once when you have completed the process of creating or modifying your tests, test sets, agent sets, or test profiles. The Test Profile Management page includes a Changes Committed column to indicate whether changes have occurred to any tests, test sets, or agent sets in the profile. If that column has a value of No, the information in the eHealth database is not up to date with the information that exists on the agent and in the poller configuration and, thus, requires a commit.

Types of Commits

You can select two types of commit:

An incremental commit updates the agents and the eHealth poller configuration with only those additions or modifications that occurred since the last commit (or with changes that were not pushed to an agent because the agent was inaccessible at that time.) An incremental commit is the default type of commit.

A full commit rebuilds the entire configuration on the selected agents and rebuilds the paths, synchronizing the agents with what is current in the eHealth database. A full commit takes longer than an incremental commit because it transfers more data.



Note: Use the full commit only if the information on the agent and in the eHealth database are not the same. For example, if you perform a commit and some agents do not get updated, the commit log file may recommend that you perform a full commit.

If your svcrsp.cf file on the agent system includes entries that do not exist within the eHealth database (any entries that you did not create through the SA Web interface), a full commit does not delete that information. A full commit deploys the information from the eHealth database to the agents by adding missing information and updating all entries that were added, modified, or deleted through the SA Web interface.

Commit Changes

You must commit changes made through the Service Availability Web interface to transfer them to SA agents and create or modify eHealth paths.

To commit changes

1. Click Commit Changes from the Service Availability page of the Systems & Apps tab.

The Commit Changes page appears.

2. Do one of the following:

For an Incremental commit (the default), click Commit.

For a Full Commit, select ‘Rebuild Full Configuration’ near the bottom of the Commit screen and click Commit.



To stop the commit process, click Stop. eHealth completes the updates process for the agent currently being addressed and then completes the commit process for just those agents that were contacted.

If an agent is unavailable when eHealth attempts to contact it, the Commit Changes Status page informs you that it could not update that agent. eHealth does not attempt to contact the agent again until the next time that you commit changes. The Committed Changes column on the Test Profile Management page continues to display No for any profiles to which that agent belonged until the agent is updated by a subsequent commit.

To exclude one or more agents from a commit operation, deselect that agent name.

View Commit Log Files

You can view log files for commit operations on the Commit Changes page. The logs provide detailed information about the changes, including which tests were added to, updated on, or deleted from each agent, and any agents that eHealth could not contact.

To view a log file

1. Select the log you want to view from the ‘Log files available to view’ list on the Commit screen.

2. Click Open.

The log file appears in a new window.

Monitor Agents and Test Profiles

You can monitor all of the tests running on an agent by clicking the Monitor button at the bottom of the left panel.

To monitor agents from the Monitor Setup screen

1. Select either Monitor by Agent or Monitor by Profile.

2. Select one agent or profile to monitor.

The Test Monitor page appears, listing all tests on the selected agents or test profiles.



Modify the Test Monitor page

When you are monitoring agents or test profiles, you can alter the information that displays on this page.

You can view relevant information and hide the information that is not relevant.

To change the columns that you want to display in the table

1. Select Show Column Config.

2. Select the columns that you want to display or deselect any columns that you do not want to display.

3. Click Update Page.

Note: For more information about columns, access the Web Help from this page.

You can filter the information on the page by hostname, test type, or row status. This features lets you narrow down the amount of information for snapshots of particular systems or problem areas.

To filter the information on the page

1. Select Show Filter Options.

2. Select a hostname from the Agent list, a test type from the Test Type list, or a row status from the Row Status list.

3. Click Update Page.

You can refresh the page, set a refresh interval, or reset the display defaults.


Guidelines for Changing Configuration Settings

To refresh the page, click Force Refresh.

To enable the page to refresh every 60 seconds, click Enable Refresh.

You can configure a different refresh interval from the AdvantEDGE View Preferences page.

To reset the display with the default options, click the Default Columns button at the bottom of the screen.

Guidelines for Changing Configuration SettingsFollow these guidlines when editing the SA configuration file:

On UNIX systems, you must make any configuration file modifications after installing or upgrading SA.

On Windows systems, you can specify some configuration parameters during installation. You can also edit the configuration file afterward.

If you deploy sets of tests from the eHealth server, set up the configuration file before deployment. In this way, you can push a common SA configuration to multiple systems where SystemEDGE agents and SA tests run.

You must edit the javabin field if your SystemEDGE agent is installed in a directory other than the default (/opt/EMPsysedge).

You can modify configuration settings any time after installing SA. Whenever you make such changes, you must stop and restart the SystemEDGE agents affected by those changes.

Edit the SA Configuration FileSome configuration options, such as security privileges, the maximum number of threads, or the location of Java Runtime Environment (JRE) files, are set by default. Others are disabled by default.

To change SA configuration settings

1. Stop the SA agent(s) whose configuration file you intend to change.

2. Open the svcrsp.cf file with an editor.

3. Review the settings for SA operating parameters that affect performance and security.

These parameters include the maximum number of threads, an alternate location for the JRE, or whether to allow SSL tests to work with sites that do not have trusted certificates.

4. Make any necessary changes and then save the file.


Run Historical Reports for Your Paths

5. Restart the SA agent(s).

Note: With security settings enabled, some operations such as File I/O and Custom tests may not run.

Run Historical Reports for Your PathsYou can link directly to the eHealth Run Reports page. After Service Availability has been running tests for at least one polling cycle (about five minutes), you can obtain historical data for the paths in a test profile.

To run an At-a-Glance report for a path in your test profile

1. Go to either the Modify Test Profile page or the Test Profile Monitor page and select Run-At-Glance at the bottom of the page.

2. Click the name of a path to link to the Run an At-a-Glance report page for that path.

3. Click Generate Report.

(Optional) You can specify a different Sample Size and Report time.

Note: For more information about running the report, click the Help icon.

An At-a-Glance report appears.

Note: A complete At-a-Glance report for the response path also includes charts for Attempts, Total Bytes, Total Throughput, and Total Errors. You can also run At-a-Glance reports for your response paths and response endpoints directly from the Run Reports tab of the eHealth Web interface.

To run additional eHealth reports, do one of the following:

Click on one of the charts to drill down to a Trend report for the path.

Return to the Run Reports tab to run Top N, Health, or Service Level reports for the path.

Supported Platforms for SAService Availability runs on the following platforms:

Sun™ Solaris™ SPARC Releases 2.6 through 2.10

Sun Solaris x86 Releases 2.6 through 2.9 (32-bit)

Microsoft Windows NT® 4.0 (Service Pack 6a or later), Windows 2000, Windows XP, and Windows 2003 (32-bit only)

HP-UX™/PA-RISC 11.0, 11i

AIX™ Releases 4.3.3 and 5.1 through 5.3 (32- and 64-bit).


Supported Platforms for SA

Digital® UNIX 4.0F and 4.0G, and Tru64™ 5.1A and 5.1B

Red Hat™ Linux™ Releases 6.0 through 9.0; Red Hat Enterprise Linux ES 2.1 (x86) and Red Hat Enterprise Linux WS/ES/AS 3.0 (Itanium®/x86)

Note: For more information about Service Availability, see the eHealth Help available from the SA Web interface and Monitoring Application Performance and Availability with Service Availability.


Setting Up Service Availability 2 - CA Support...

Documents

Transcript of Setting Up Service Availability 2 - CA Support...