ehealth Integration for HP OpenView User Guide

Transcription

1 ehealth Integration for HP OpenView User Guide MN-NHHPOV-003 July 2005

2 Important Notice Concord Communications, Inc., ehealth, ehealth Suite, the Concord Logo, eroi, AdvantEDGE, SystemEDGE, Live Health, Network Health, Live Status, System Health, Application Health, Automating Technology Management, Constellation, Enterprise, Enterprise Monitor, Firstsense, FirstSense and design, FirstSense Enterprise, Pulse, Pulsecheck, Token/Net, Token/Scope, We See It Happening, Fault Manager, Empire, Empire Technologies and/or other Concord marks or products referenced herein are either registered trademarks or trademarks of Concord Communications, Inc. Other trademarks are the property of their respective owners. SMIC. Copyright 1992 SynOptics Communications, Inc. All Rights Reserved. SynOptics makes no representations about the suitability of this software for any particular purpose. The software is supplied as is, and SynOptics makes no warranty, either express or implied, as to the use, operation, condition, or performance of the software. SynOptics retains all title and ownership in the software. ehealth incorporates compression code by the Info-ZIP group. There are no extra charges or costs due to the use of this code, and the original compression sources are freely available from ftp://ftp.cdrom.com/pub/infozip/ on the Internet and from the Concord Communications Web site: Copyright Bigelow and Holmes 1986, Lucida is a registered trademark of Bigelow & Holmes. Sun Microsystems Inc., AT&T, and Bigelow & Holmes make no representations about the suitability of the source code for any purpose. It is provided as is without express or implied warranty of any kind. General Notice: Some of the product names used herein have been used for identification purposes only and may be trademarks of their respective companies. Proprietary Notice The information and descriptions contained herein are the property of Concord Communications, Inc. Such information and descriptions may not be copied, disseminated, or distributed without the express written consent of Concord Communications, Inc. Concord Communications, Inc., assumes no responsibility for any inaccuracies that may appear in this document. Concord Communications, Inc., reserves the right to improve its products and change specifications at any time without notice. U. S. Government Restricted Rights Use, reproduction, and disclosure by the U.S. Government are subject to the restrictions set forth in FAR (c) (1) and (2) and DFARS (c) (1) (ii). U. S. Patent 5,615,323 Patents Pending Patent Information 2005 Concord Communications, Inc. All Rights Reserved

3 Table of Contents Preface 5 Audience About this Guide Reading Path Revision Information Documentation Conventions License Request Information Technical Support Professional Services Chapter 1 Product Overview 11 About ehealth About OpenView NNM About ehealth OpenView Using Live Health and ehealth OpenView Using Links to ehealth Chapter 2 Getting Started with ehealth OpenView 21 Before You Begin System Requirements License Requirements Multiple ehealth and NNM Systems Live Health Requirements

4 4 Table of Contents Installation Checklists Windows NNM Installation Checklist UNIX NNM Installation Checklist Installing ehealth OpenView Installing ehealth OpenView on Windows Installing ehealth OpenView on UNIX Configuring Live Health for ehealth OpenView Installing Live Health on OpenView NNMs Chapter 3 Using ehealth OpenView 41 Accessing ehealth from OpenView NNM Viewing ehealth Alarms from OpenView NNM Using the OpenView NNM Map Interface Troubleshooting Chapter 4 Uninstalling ehealth OpenView 51 Windows HP OpenView NNM Systems UNIX HP OpenView NNM Systems Index 55

5 Preface This guide uses the term ehealth OpenView to refer to this integration module. This guide describes how to install, configure, and use the ehealth Integration for HP OpenView module (ehealth OpenView). ehealth OpenView lets you access ehealth reports and the Live Trend application from HP OpenView Network Node Manager (NNM) systems. The ehealth Release 5.7 Patch 2 software supports HP OpenView (OpenView) Releases 7.01 and 7.5. This guide also supports earlier versions of ehealth OpenView. Table 1 lists the versions of OpenView that each ehealth Release supports. NOTE If you are using a later ehealth release, refer to the ehealth Readme file or Patch Readme file for the latest information on supported versions of OpenView. Table 1. Supported OpenView Releases ehealth Releases Supported OpenView Releases Patches 1 through 5 6.2, and Patch 6, and 5.7 Patch and 7.5 5

6 6 Preface Audience This guide is intended for network operators and administrators who use OpenView to monitor their network environments and who want to view data about these environments through ehealth reports and Live Trend charts. You must have both ehealth and OpenView administrative permissions to install and configure this integration module which resides on the OpenView NNM system. If you are the OpenView administrator and you do not have access to the ehealth system, you must coordinate with the ehealth administrator to perform the procedures necessary to set up this integration module. This guide identifies which procedures must be performed by each administrator. To install and use ehealth OpenView, you should be knowledgeable about network management, network terminology, and your network topology. NOTE OpenView and ehealth can reside on both Windows and UNIX platforms. You should have a good working knowledge of the platform on which these products reside in your environment. To perform the ehealth administrative tasks associated with configuring this integration module, you must be familiar with the ehealth Live Health Suite of products, particularly the Live Exceptions application. For conceptual information about this suite of products, refer to the ehealth Live Health User Guide. For administrative-level information and procedures, refer to the ehealth Live Health Administration Guide. About this Guide This guide assumes that you have already installed and are using OpenView NNM and that you are familiar with all aspects of managing this product. This guide provides the information that you need to integrate ehealth with OpenView.

7 About this Guide 7 It also describes the features and drilldown capabilities that this integration module provides. It does not describe how to use additional OpenView NNM features. For information about installing, configuring, and using this and other HP products, refer to the Hewlett-Packard Web site at and Hewlett-Packard documentation. You can also refer to the online Help that is available with OpenView NNM. If you are not currently using OpenView, or you are a new ehealth user, refer to Chapter 1 for product overview information. To learn more about ehealth, refer to the next section for a list of ehealth documents. Reading Path You need to install ehealth and become familiar with its features before you use the ehealth OpenView integration module. For information about ehealth, refer to the following documentation: Introduction to ehealth. This guide provides an introduction to and overview of ehealth. New Features in ehealth. This guide provides information about new features available with the current release. ehealth Installation Guide. This guide provides information about ehealth system requirements, licensing, installing the ehealth software, and starting the ehealth console. ehealth Administration Guide. This guide is intended for the person who must perform the critical ehealth administration tasks such as discovery, polling, database maintenance, or report administration. ehealth Reports Guide. This guide provides an overview of the types of reports that you can generate from the ehealth console and from the Web interface. ehealth Web Help. The Web Help provides detailed information about all ehealth reports that you can run from the Web interface.

8 8 Preface For detailed information about OpenView and other HP products, refer to their documentation. Revision Information This revision, which supports multiple versions of ehealth OpenView, includes updates to the Windows installation program. The new InstallShield Wizard reflects product naming updates. This guide also includes a section that describes how to send information from OpenView systems to the new ehealth troubleshooting tool. Documentation Conventions Table 2 lists the conventions used in this document. Table 2. Documentation Conventions (Page 1 of 2) Convention )LOHRU'LUHFWRU\1DPH code emphasis enter Name New Term Variable Description Text that refers to file or directory names. Text that refers to system, code, or operating system command line examples. Text that refers to guide titles or text that is emphasized. Text that you must type exactly as shown. Text that refers to menus, fields in dialog boxes, or keyboard keys. Text that refers to a new term, that is, one that is being introduced. Text that refers to variable values that you substitute.

9 License Request Information 9 Table 2. Documentation Conventions (Page 2 of 2) Convention NOTE CAUTION WARNING Description A sequence of menus or menu options. For example, File Exit means Choose Exit from the File menu. Important information, tips, or other noteworthy details. Information that helps you avoid data corruption or system failures. Information that helps you avoid personal physical danger. License Request Information Technical Support You must submit a completed License Request form for all ehealth products that you purchase. You can find this form in your ehealth package, on the TotalDoc online documentation CD-ROM, and on the corporate Web site. Fax it to the License Generation Group at (508) or forward it using to licenses@concord.com. If you have a Support Contract ID and password, you can access our Support Express knowledgebase at the following URL: If you have a software maintenance contract, you can obtain assistance with this product. Have your Support Contract ID available and contact Technical Support at the following: Phone: (888) Web site: (508) support@concord.com

10 10 Preface Professional Services If you need any assistance with customizing this product, contact Professional Services at the following: Phone: (800) Fax: (508) Web site:

11 1 Product Overview This chapter provides information about ehealth, OpenView NNM, and the ehealth OpenView integration module. About ehealth Concord s ehealth Suite of software products provides a comprehensive fault, availability, and performance management solution that spans the entire infrastructure: applications, systems, and networks. All Concord products are integrated and store data in the ehealth database. ehealth automates technology management for IT departments, telecommunication carriers, and service providers. With ehealth, you can manage the quality and performance of services such as data, voice, wireless, Internet, and cable. You can report on behavior for thousands of elements in real time, or you can generate reports on historical information. You generate these reports from the ehealth console or from the ehealth Web interface. You can run automatic, scheduled reports, create your own custom reports, view live data, or perform on-demand queries. For more information about running reports, refer to the ehealth Reports Guide. 11

12 12 Chapter 1 Product Overview While providing out-of-the-box support for many devices, ehealth does the following: Discovers devices in your infrastructure using Simple Network Management Protocol (SNMP) Frequently polls statistics collected by each device s Management Information Base (MIB) Collects information and stores it in a database where it is available for reporting Concord also provides several modules that enable ehealth to integrate with various network management software products. These integration modules enable you to use the reporting capabilities of ehealth to monitor data that third-party products gather about switches, routers, and other devices in your infrastructure. For more conceptual information about ehealth, refer to the Introduction to ehealth. About OpenView NNM Topology is the arrangement of network nodes and media within an enterprise networking infrastructure. OpenView NNM provides tools for fault, configuration, and performance management for TCP/IP and IPX/SPX networks. You can use OpenView NNM to discover objects in your network and monitor the status of your entire network environment. You can view your network topology through the OpenView map. You can also use NNM to do the following: Diagnose and respond to network faults and performance problems from a central location. Manage vendor devices that support SNMP. View network and system configuration information for nodes on your network through OpenView forms, tables, and graphs. Build MIB applications for enterprise-specific MIBs. Customize your management station by adding other tools and applications to the menu bar. Perform MIB data collection, storage, and graphing for trend analysis.

13 About ehealth OpenView 13 Figure 1 displays the OpenView NNM map interface. You can run NNM on Windows, Solaris, and HP-UX operating systems. 1 Figure 1. OpenView NNM Map Interface About ehealth OpenView For more information about OpenView NNM, refer to the online Help available with that product. You can also refer to the Hewlett-Packard Web site at and Hewlett-Packard documentation. ehealth OpenView enables you to access ehealth reporting features directly from OpenView NNM interfaces. From the OpenView NNM map interface, you can link to the ehealth Web interface and run At-a-Glance and Trend reports on objects in your network that both ehealth and OpenView NNM monitor. From the OpenView NNM Alarm Categories window, you can access an ehealth Alarms Browser window and run At-a-Glance reports, Trend reports, and Live Trend charts on ehealth alarms. (To use Live Trend, you must configure the ehealth Live Health software for the integration, as the following section describes.)

14 14 Chapter 1 Product Overview Traps are messages sent by an SNMP agent to an NMS (or other device) to indicate that a threshold has been reached or another user-defined condition has occurred. Alarms are notifications of problems or potential problems somewhere in the infrastructure. Using Live Health and ehealth OpenView The Live Health suite of applications includes Live Exceptions, Live Status, and Live Trend. These applications reside on the ehealth system and are enabled when the ehealth administrator adds a Live Health license to the ehealth system. The ehealth administrator uses the Live Exceptions application to send traps and alarms to the OpenView NNM system. The OpenView NNM administrator must download the Live Health client software from the ehealth system, and install it on the OpenView NNM system. You can then link to the Live Trend application and create charts that monitor statistics elements that ehealth is polling. For conceptual information about Live Exceptions and Live Trend, refer to the ehealth Live Health User Guide. NOTE If you are running multiple ehealth systems in your infrastructure, you must download the Live Health client software from the same ehealth system that is sending traps and alarms to your OpenView NNM system. Although Live Status is part of the Live Health suite and resides on the ehealth system, it is not integrated with OpenView. Figure 2 on page 15 illustrates the ehealth components that must reside on the ehealth system, and the components that must reside on the OpenView NNM system to enable you to use all of the functionality that this integration module provides.

15 About ehealth OpenView 15 ehealth System OpenView NNM System 1 ehealth Traps and Alarms ehealth Components Installed: ehealth software Live Health Suite (including Live Exceptions) ehealth OpenView License Links to Live Trend Charts, At-a-Glance Reports, and Trend Reports ehealth Components Installed: ehealth OpenView software Live Health Client software Figure 2. ehealth OpenView Integration Components Using Links to ehealth ehealth OpenView adds various ehealth links to OpenView NNM as this section describes. It adds an ehealth icon to the tool bar of the OpenView NNM map interface and adds an ehealth link to the Tools menu, as shown in Figure 3 on page 16.

16 16 Chapter 1 Product Overview Figure 3. ehealth Links on the OpenView Tools Menu When you click this icon or link, the ehealth Web interface appears in a Web browser, as shown in Figure 4. You can run At-a-Glance and Trend reports from this interface. For information about how to run these reports, refer to the ehealth Web Help. Figure 4. ehealth Web Interface The ehealth OpenView integration module adds links to the OpenView NNM map interface that also enable you to generate At-a-Glance reports and Live Trend charts for elements that are monitored by both the ehealth system and the OpenView NNM system. You access these links from the Performance menu, as shown in Figure 5 on page 17.

17 About ehealth OpenView 17 1 Figure 5. ehealth Links on the Performance Menu ehealth OpenView also adds an ehealth Alarms link to the OpenView Alarm Categories window, as shown in Figure 6. Figure 6. ehealth Alarms Drilldown Option When you click this link, the ehealth Alarms Browser appears, as shown in Figure 7 on page 18.

18 18 Chapter 1 Product Overview Figure 7. ehealth Alarms Browser You can select an alarm in this window and drill down to Live Trend to generate a chart for this alarm. You can also drill down to At-a-Glance and Trend reports. To view these drilldown options, select Actions Additional Actions. The Additional Actions on ehealth Alarms dialog box appears, as shown in Figure 8. Figure 8. Drilldown Options on Alarms The following links appear at the bottom of the Action list: ehealth At-a-Glance Report ehealth Live Trend ehealth Trend Report

19 About ehealth OpenView 19 When you select ehealth At-a-Glance Report or ehealth Trend Report, ehealth OpenView displays the report in a separate Web Browser. Figure 9 shows an example of a Trend report on a critical alarm. 1 Figure 9. Trend Report Generated from the Additional Actions on ehealth Alarms Dialog Box When you select ehealth Live Trend, ehealth OpenView displays a Live Trend chart in a separate Web browser. Figure 10 on page 20 shows an example of a Live Trend chart on a critical alarm.

20 20 Chapter 1 Product Overview Figure 10. Live Trend Chart Generated from the Additional Actions on ehealth Alarms Dialog Box For information about installing and configuring the components required to use this integration module, refer to Chapter 2, Getting Started with ehealth OpenView. For conceptual information about Live Trend and Live Exceptions, refer to the ehealth Live Health User Guide. For conceptual information about At-a-Glance and Trend reports, refer to the ehealth Web Help and the ehealth Reports Guide.

21 2 Getting Started with ehealth OpenView Before You Begin This chapter provides the information that you need to prepare for and install ehealth OpenView on the OpenView NNM system. It contains the following: System requirements Installation checklists ehealth OpenView installation procedures (UNIX and Windows) This chapter also includes information about configuring Live Health for ehealth OpenView. It outlines the procedures that the ehealth administrator must perform on the ehealth system and the procedures that the OpenView NNM administrator must perform on the NNM system. Where appropriate, this guide provides references to the ehealth documentation that explains these procedures in detail. Before you run the ehealth OpenView installation program, review the system requirements, complete the checklist that is appropriate for your OpenView NNM platform, and obtain an ehealth OpenView license and a Live Health license for your ehealth system. For information about how to request licenses, refer to License Request Information on page 9. 21

22 22 Chapter 2 Getting Started with ehealth OpenView The following steps outline the order in which you must perform the procedures to get started with ehealth OpenView. NOTE This guide assumes that you are already using OpenView NNM. For information about this product, refer to the online Help available from the OpenView NNM map interface and other Hewlett-Packard documentation. System Requirements 1. Install ehealth on a dedicated Solaris, HP, or Windows system. Refer to the ehealth Installation Guide for your platform. 2. Request an ehealth OpenView license and a Live Health license. Refer to License Request Information on page Review the system requirements in the following section. 4. Complete the checklist that is appropriate for the platform on which your OpenView NNM resides. Refer to Installation Checklists on page Start ehealth and license the integration module and Live Health. Refer to the ehealth Installation Guide for your platform. 6. Run the ehealth OpenView installation program that is appropriate for your platform. Refer to Installing ehealth OpenView on page Configure Live Health for ehealth OpenView. Refer to Configuring Live Health for ehealth OpenView on page 37. The ehealth OpenView integration module software is available on the ehealth product CD-ROM. You install this software directly on your OpenView NNM system.

23 System Requirements 23 You must install ehealth on a dedicated UNIX or Windows system according to the requirements and instructions provided in the ehealth Installation Guide for your platform. Concord recommends that you do not install ehealth on the same system on which OpenView NNM resides. If you want to report on ehealth alarms and drill down to Live Trend from OpenView NNM, refer to Live Health Requirements on page 24 for additional information. 1 2 You can install the 5.7 Patch 2 version of ehealth OpenView on NNM systems that are running OpenView Releases 7.01 and 7.5. If you are using an earlier version of ehealth OpenView, refer to Table 1 on page 5 for the versions of OpenView that your ehealth release supports. For information about OpenView requirements, refer to your Hewlett-Packard documentation. License Requirements You must install an ehealth OpenView license and a Live Health license on each ehealth system that will send alarms and traps to OpenView NNMs. For information about installing these licenses, refer to the ehealth Installation Guide for your platform. Multiple ehealth and NNM Systems You can run multiple ehealth and NNM systems in your infrastructure. One ehealth system can send traps and alarms to one NNM system or to multiple NNM systems. Multiple ehealth systems can also send traps and alarms to the same NNM system. NOTE ehealth and OpenView are not required to have the same operating system. For example, ehealth can reside on a Solaris operating system, while OpenView NNM resides on a Windows 2000 operating system.

24 24 Chapter 2 Getting Started with ehealth OpenView Installation Checklists Live Health Requirements If you want to use the Live Health reporting features that this integration module provides, you must install a Live Health license on each ehealth system that will forward alarms and traps to OpenView NNM systems. When you install this license, it enables access to the Live Health Suite on the ehealth Web interface. You must also install the Live Health client software on all OpenView NNM systems. When you install this software, it enables you to drill down to Live Trend. For information about how to install licenses, refer to the ehealth Installation Guide for your platform. For more information about how to install the Live Health client software and configure alarms, refer to Configuring Live Health for ehealth OpenView on page 37. The installation checklists outline the information that you must provide when you run the integration module installation program. Make copies of these checklists and add your system information prior to running the installation program. Concord recommends that you save the completed checklists for future reference. You can refer to them each time you run the installation program and use them to provide Concord Technical Support with information if you require assistance.

25 Installation Checklists 25 Windows NNM Installation Checklist If you are installing the ehealth OpenView integration module software on a Windows NNM system, use this checklist to record the information that you will need when you run the installation program. 1 2 Table 3. Windows OpenView NNM Checklist Description Information The port number of the ehealth Web server. Default: 80 The hostname of the ehealth system. NOTE: You must enter a fully qualified hostname. For example, larkspur.concord.com. This must be the name of the ehealth system that will send traps to the NNM system. The IP address of this ehealth system. NOTE: You must enter this value in dotted notation. For example,

26 26 Chapter 2 Getting Started with ehealth OpenView UNIX NNM Installation Checklist If you are installing the ehealth OpenView integration module software on a UNIX NNM system, use this checklist to record the information you will need when you run the installation program. Table 4. UNIX OpenView NNM Checklist Description Information The hostname of the OpenView NNM system. The IP address of the OpenView NNM. NOTE: You must enter this value in dotted notation. For example, Default: The installation program derives the IP address from the hostname of the OpenView NNM system, so you can accept the default. A user name that ehealth can use to log in to the OpenView NNM system. NOTE: This user name must provide access to the operating system and the OpenView database. The full pathname of a directory for the Netscape browser software. Default: /home/netscape/bin The port number of the ehealth Web server. Default: 80 The hostname of the ehealth system that will send traps to this NNM system. NOTE: You must enter a fully qualified hostname. For example, larkspur.concord.com. The IP address of the ehealth system. NOTE: You must enter this value in dotted notation. For example,

27 Installing ehealth OpenView 27 Installing ehealth OpenView Before you run the installation program on the NNM system, verify that the ehealth administrator has installed an ehealth OpenView license and a Live Health license on each ehealth system with which you plan to integrate. Use the procedure in the following section if the NNM resides on a Windows operating system. Use the procedure in Installing ehealth OpenView on UNIX on page 35 if the NNM resides on an HP-UX or Solaris operating system. 1 2 If you are installing a version of ehealth OpenView that is earlier than Release 5.6.5, the appearance of the Windows installation program will be different. However, all versions of the program prompt you for the same information. Installing ehealth OpenView on Windows When you run the Windows installation program, use the values that you recorded in the Windows NNM installation checklist on page 25. To install ehealth OpenView on Windows: 1. Close the OpenView NNM console. 2. Insert the ehealth product CD-ROM into the CD-ROM drive of the Windows OpenView NNM system. 3. Select Start Run. The Run dialog box appears. 4. In the Open field, enter the following command: cdromdrive:\\packages\openview\nt\setup.exe

28 28 Chapter 2 Getting Started with ehealth OpenView (Enter the drive letter that represents your CD-ROM drive for cdromdrive. For example, G:) This command launches the installation program. The Welcome dialog box appears on your screen. 5. Click Next. The Type of Installation dialog box appears and Full Install is selected by default.

29 Installing ehealth OpenView You can accept this value by clicking Next.The ehealth Integration Directory dialog box appears. The installation program displays the default directory in which it will install the software. Use this directory is selected by default. 1 2

30 30 Chapter 2 Getting Started with ehealth OpenView 7. Click Next to accept the default directory. The Enter Web Server Port dialog box appears and displays the default port number of the ehealth Web server. 8. You can accept this value by clicking Next. The Enter the ehealth Server dialog box appears.

31 Installing ehealth OpenView Enter the hostname of the ehealth system using the following format: hostname.company.com (Where hostname is the name of the ehealth system and company is your company name. For example, larkspur.concord.com.) 1 2 NOTE NOTE If you have more than one ehealth system in your infrastructure, you must enter the hostname of the ehealth system that will send traps to this OpenView NNM. 10. Click Next. The Enter the ehealth Server IP address dialog box appears. 11. Enter the IP address of the ehealth server in dotted notation. For example, NOTE NOTE If you are running ehealth on more than one system, you must enter the IP address of the ehealth system for which you entered a hostname on the previous screen.

32 32 Chapter 2 Getting Started with ehealth OpenView 12. Click Next. The program begins to install the software and the following dialog box appears: 13. Click Yes. When the installation is complete, the InstallShield Wizard Complete dialog box appears. 14. You must restart the system before you can use ehealth OpenView. Yes is selected by default. Accept this default by clicking Finish. When your system reboots, you must modify your NNM shortcut properties before you restart OpenView. For instructions, refer to the following section.

33 Installing ehealth OpenView 33 Modifying NNM Shortcut Properties The procedure in this section applies to Windows installations only. If you plan to use the OpenView NNM shortcut on your Windows desktop, you must perform the following procedure to ensure that the links to ehealth work properly on the OpenView NNM map interface. 1 2 To modify NNM shortcut properties: 1. On your desktop, right-click the Network Node Manager Icon and select Properties. The Network Node Manager Properties dialog box appears. 2. Click the Shortcut tab. 3. Enter the following in the Start in field: C:\Program Files\HP OpenView\NNM\bin NOTE NOTE If OpenView resides in a different directory on your system, modify this entry as necessary. You can refer to the path in the Target field to verify the drive on which OpenView resides on your system.

34 34 Chapter 2 Getting Started with ehealth OpenView 4. Click Apply, and then click Close. 5. Double-click the shortcut icon on your desktop to start the OpenView NNM console. If the integration was successful, an ehealth icon appears on the tool bar of the OpenView NNM map interface, as shown in Figure 11. Figure 11. ehealth Icon on OpenView NNM Tool Bar You can access the ehealth Web interface and run At-a-Glance and Trend reports, as outlined in Using Links to ehealth on page 15. However, the ehealth administrator must configure Live Exceptions to send traps and alarms to this NNM system. As the OpenView administrator, you must download and install the Live Health client software from the ehealth system before you can report on these traps and alarms. For more information, refer to Configuring Live Health for ehealth OpenView on page 37.

35 Installing ehealth OpenView 35 Installing ehealth OpenView on UNIX When you run the UNIX installation program, use the values that you recorded in the UNIX NNM installation checklist on page 26. The UNIX installation program presents a series of questions, validates your answers, and prompts you to supply a new answer if the one that you provided is invalid. When you run the installation program, default responses that are available for a particular question will appear in brackets [ ]. You can press Return to accept the default response. You can exit the installation program at any time by entering q to quit. 1 2 NOTE The root user must have remote login privileges. To install ehealth OpenView on UNIX: 1. Close the OpenView NNM console. 2. Insert the ehealth product CD-ROM into the CD-ROM drive of the UNIX OpenView NNM system. 3. Enter the command that is appropriate for your platform (where cdromdirectory represents the CD-ROM directory on your system): On a Solaris system, enter the following: cdromdirectory:/packages/openview/sunos5/install.ov On an HP system, enter the following: cdromdirectory:/packages/openview/hpux/install.ov The installation program menu appears and displays the following options: 1. Install OpenView integration 2. Uninstall OpenView integration q. Exit

36 36 Chapter 2 Getting Started with ehealth OpenView 4. Enter 1 to run the installation. The program prompts you for information about the OpenView system, IP addresses, and the port number and hostname of the ehealth system among other questions. 5. Enter the required information at the appropriate prompts. Use the values that you recorded in the UNIX NNM Installation Checklist on page 26. During the installation, the program displays various messages while it verifies user names, passwords, and version numbers. It also displays messages when the installation completes successfully. 6. Restart your OpenView NNM system to apply the changes. When the system reboots, you can restart the OpenView NNM console. If the integration was successful, an ehealth icon appears on the tool bar of the OpenView NNM map interface, as shown in Figure 11 on page 34. You can access the ehealth Web interface and run At-a-Glance and Trend reports, as outlined in Using Links to ehealth on page 15. However, the ehealth administrator must configure Live Exceptions to send traps and alarms to this NNM system. As the OpenView administrator, you must download and install the Live Health client software from the ehealth system before you can report on these traps and alarms. For more information, refer to the following section.

37 Configuring Live Health for ehealth OpenView 37 Configuring Live Health for ehealth OpenView To use the reporting capabilities of Live Health, the ehealth administrator must enable Live Health on the ehealth system and configure the Live Exceptions application (on the ehealth system) to send traps and alarms to the ehealth OpenView system. Configuring Live Health on the ehealth system involves performing the following procedures: Configuring Live Exceptions to generate alarms. 2. Defining trap destinations. (You can send alarms as SNMP traps to one or more trap destinations. These trap destinations are the NNM systems. You must define them for Live Exceptions.) 3. Creating Notifier rules for the specific alarms and traps that you would like to forward to NNM systems. For instructions on performing these procedures, refer to the ehealth Live Health User Administration Guide. As the OpenView NNM administrator, you must download the Live Health client software from the ehealth system that you specified during the installation. For instructions, refer to the following section. Installing Live Health on OpenView NNMs You can download the Live Health client software from the Web interface of the ehealth system. You must have an ehealth user name and password to perform the following procedure; if you do not, contact your ehealth Web administrator. To download and install Live Health on an OpenView NNM system: 1. On the OpenView NNM system, open a Web browser and enter the name of the ehealth system for which you entered information during the ehealth OpenView installation. For example: The Welcome page for the ehealth Suite appears on your screen.

38 38 Chapter 2 Getting Started with ehealth OpenView 2. Click Continue. The Enter Network Password dialog box appears. 3. Enter your ehealth user name and password and click OK. The ehealth Web interface appears. 4. Click the Live Health tab. The Live Health Welcome page appears and displays a link to download Live Health to your system. NOTE NOTE The ehealth software determines the operating system that you are using and displays the link that is appropriate for your platform. 5. Close any applications that are running on your system and click the download link. The File Download dialog box appears. 6. Select Run this program from its current location and click OK. NOTE NOTE If a Security Warning dialog box appears, you can optionally obtain information about this warning by clicking More info. After you read the information, click Yes to run the installation executable. The Setup Wizard for Live Health appears. 7. Click Next. If the setup program detects an existing version of Live Health on the system, it will ask if you want to re-install or un-install. You can select Re-install. If the setup program does not detect an existing version of Live Health, the installation completes automatically. The setup program displays a dialog box that indicates that the installation of Live Health was successful. 8. Click Finish. The Live Health Installer Information dialog box appears.

39 Configuring Live Health for ehealth OpenView Click Yes to restart your system for the configuration changes to take effect. You can now access Live Trend from OpenView NNM in addition to ehealth At-a-Glance and Trend reports. You access these features through links on the OpenView NNM map interface and through the Alarm Categories window as Chapter 3, Using ehealth OpenView describes. 1 2

40

41 3 Using ehealth OpenView This chapter describes how you can view alarm information from ehealth, and it also describes the ways in which you can run ehealth reports from OpenView NNM. NOTE The ehealth features described in this chapter operate as standard OpenView NNM features. For information about the OpenView NNM map interface and standard OpenView software features, refer to Hewlett-Packard s documentation. Accessing ehealth from OpenView NNM When you start OpenView NNM, the Alarm Categories window and the OpenView NNM map interface appear. These provide access to ehealth information. 41

42 42 Chapter 3 Using ehealth OpenView For information about OpenView NNM alarm categories, refer to the OpenView NNM documentation. Viewing ehealth Alarms from OpenView NNM OpenView NNM displays the Alarm Categories window when the system starts. This window displays links to standard OpenView NNM alarm categories, and also displays an ehealth Alarms link. When you select ehealth Alarms, OpenView NNM displays the ehealth Alarms Browser window.

43 Accessing ehealth from OpenView NNM 43 Table 5 describes the columns in the ehealth Alarms Browser. Table 5. ehealth Alarms Browser Column Descriptions (Page 1 of 2) 1 Column Ack Cor Severity Purpose Indicates whether or not the alarm has been acknowledged. You can acknowledge an alarm by selecting the check box in this column, or by selecting the alarm and selecting Actions Acknowledge. You can unacknowledge an alarm by deselecting the check box, or by selecting the message and selecting Actions Unacknowledge. Indicates whether or not the alarm has been correlated to a problem. Indicates the severity of each alarm. Each alarm type is color-coded. The alarm severities and corresponding color codes, listed in order from most severe (worst) to least severe (normal), are as follows: Critical (Red) indicates that the object or an element on the object is down. Major (Orange) indicates that the object or an element on the object is up but has too many errors or might fail. Minor (Yellow) indicates that the object or an element on the object is up but is contributing to delay. Warning (Blue) indicates that the object or an element on the object is up but has a workload that is unusual in comparison to a baseline. Normal (Blue) is an informational message that indicates that the object and all elements of the object are operating within normal parameters. 3

44 44 Chapter 3 Using ehealth OpenView Table 5. ehealth Alarms Browser Column Descriptions (Page 2 of 2) Column Date/Time Source Message Purpose Shows the local date and time when the trap was generated by the ehealth server. Shows the name or internet address of the device where the alarm originated. A text message describing the condition or action that caused the alarm to be generated. To view a report for an ehealth alarm, select the alarm, and then select Actions Additional Actions. OpenView NNM displays the Additional Actions on ehealth Alarms dialog box. Scroll to the bottom of the Action list and do the following: To view an ehealth Trend report for the selected ehealth alarm, select ehealth Trend Report, and click OK. To view an ehealth At-a-Glance report for the selected ehealth alarm, select ehealth At-a-Glance-Report, and click OK. To view an ehealth Live Trend chart about the selected ehealth alarm, select ehealth Live Trend, and click OK.

45 Accessing ehealth from OpenView NNM 45 The remaining selections in the Action list are standard OpenView NNM actions which allow you to restrict the scope of any action. For information about these actions, refer to the OpenView NNM online Help. Using the OpenView NNM Map Interface When you start OpenView NNM, the internet level of the OpenView network map appears. 1 3 The OpenView NNM map interface provides access to ehealth in the following ways: Access to the ehealth Web interface through the Tools menu. Access to ehealth At-a-Glance reports and Live Trend charts through the Performance menu. Access to ehealth At-a-Glance reports, Trend reports, and Live Trend charts about an element from the ehealth traps element icon. (This icon appears only when traps are present for the selected element.) The following sections provide information about using these links.

46 46 Chapter 3 Using ehealth OpenView Using the Tools Menu The OpenView NNM Tools menu provides an ehealth link to the Administration page of the ehealth Web interface. You must have ehealth administrative permissions to access this page. Select Tools ehealth:ehealth Console. The ehealth Web interface appears. You must log in to this interface using your ehealth user name and password. When you access the Administration page, you can refer to the Web Help and the ehealth Administration Guide for detailed information about managing ehealth from this page. Using the Performance Menu The OpenView NNM Performance menu provides an ehealth link that enables you to access network performance information for objects in your network that both ehealth and OpenView NNM monitor. When you drill down to the Segment map and select an icon for an object in your network, the At-a-Glance Reports and Live Trend links are enabled on the Performance menu for objects. NOTE If the object is not monitored by both ehealth and OpenView NNM, the links are not enabled.

47 Accessing ehealth from OpenView NNM You can do one of the following: Select Performance ehealth At-a-Glance-Report to view an At-a-Glance report for this system in your network. Select Performance ehealth Live Trend to view Live Trend information for this system in your network. For detailed information about Live Trend charts, refer to the online Help for Live Trend. For information about the standard OpenView NNM Performance menu options, refer to the online Help. When you view an At-a-Glance report or Live Trend information from OpenView NNM, the software starts the Web browser configured for your system. Using the ehealth Element Icon You can display lower levels of the OpenView NNM map interface by double-clicking the Internet icon. The interface displays icons that represent network segments. You can display individual objects contained in a network segment by double-clicking a segment icon.

48 48 Chapter 3 Using ehealth OpenView When you select an object on the map, and right-click, OpenView displays a Symbol: name menu. You can use the Symbol menu to view ehealth At-a-Glance reports and Live Trend information. To view ehealth reports, do the following: Right-click an icon and select ehealth At-a-Glance-Report Right-click on an icon and select ehealth Live Trend

49 Troubleshooting 49 Troubleshooting When you view an At-a-Glance report or Live Trend information from OpenView NNM, the software starts the Web browser configured for your system. For information about using the standard OpenView NNM features on the Symbol menu, refer to the online Help. If you experience problems while using ehealth OpenView, Concord Technical Support may direct you to create a troubleshooting Zip file that it will use to diagnose these problems. ehealth provides a troubleshooting tool that collects copies of files from various subdirectories of the ehealth system to create this Zip file. However, because ehealth OpenView runs on OpenView NNM systems, you must run the nhovgetsupportinfo.ovpl command on the OpenView system to send copies of files to the ehealth system. Perform the following procedure from the command line on your OpenView NNM system (Windows or UNIX) before you use the troubleshooting tool on the ehealth Web interface. To send ehealth OpenView troubleshooting information to ehealth: 1. Change to the OpenView home directory. NOTE NOTE On UNIX systems this directory is typically located in RSW29. On Windows systems, you can enter cd %NH_OV_HOME% to locate this directory Enter the following command: nhovgetsupportinfo.ovpl -host hostname (Where hostname is the fully qualified hostname of the ehealth system to which you are sending information. For example, larkspur.concord.com.)

50 50 Chapter 3 Using ehealth OpenView When you run this command, it retrieves the following information from the NNM for use by the ehealth troubleshooting tool: Output from ovtopodump -rl The OpenView version number Copies of all files in the openview homeqhwkhdowkgdwd directory Copies of nethealth.envvars files in the openview homeelqdirectory A copy of $nh_ov_home/conf/c/trapd.conf When Technical Support directs you to create the troubleshooting Zip file, you access the link to the troubleshooting tool on the ehealth system through the Web interface. To access the ehealth troubleshooting tool: 1. Log in to the ehealth Web interface as the administrator. 2. On the Administration tab, click Site Management and then click Advanced Logging. 3. On the Advanced Logging page, click the Create Technical Support Information link. 4. Complete the fields on the Create Technical Support Information page according to the instructions in the Web Help. For more information about the troubleshooting tool and how to send the troubleshooting Zip file to Technical Support, refer to the Help for this page.

51 4 Uninstalling ehealth OpenView This chapter explains how to uninstall the ehealth OpenView software from either a Windows or UNIX HP OpenView NNM system. Removing this software disables the ehealth integration capability. Windows HP OpenView NNM Systems To uninstall ehealth OpenView from a Windows HP OpenView NNM system: 1. Click the Start menu and select Settings Control Panel Add/Remove Programs. 2. Click ehealth Integration for HP OpenView. 3. Click Change/Remove. A prompt confirming the removal appears. 4. Click Yes. After 30 seconds or so, a message appears confirming that you have successfully uninstalled the software. 51

52 52 Chapter 4 Uninstalling ehealth OpenView UNIX HP OpenView NNM Systems To uninstall ehealth OpenView from a UNIX HP OpenView NNM system: 1. Log in as root. NOTE NOTE The root user must have remote login privileges. 2. Close the OpenView NNM console. 3. Insert the ehealth product CD-ROM into the CD-ROM drive of the UNIX OpenView NNM system. 4. Enter the command that is appropriate for your platform (where cdromdirectory represents the CD-ROM directory on your system): On a Solaris system, enter the following: cdromdirectory:/packages/openview/sunos5/install.ov On an HP system, enter the following: cdromdirectory:/packages/openview/hpux/install.ov The installation program menu appears and displays the following options: 1 Install OpenView integration 2 Uninstall OpenView integration q Exit 5. Enter 2 at the installation menu prompt. 6. Enter the ehealth OpenView system hostname at the next prompt: Please enter the hostname of the OpenView system. OpenView system hostname [nailgun] (or q to quit):

53 UNIX HP OpenView NNM Systems Enter the ehealth OpenView system IP address: Please enter the IP address in dotted notation of the OpenView system. For example, OpenView system IP address [ ] (or q to quit): Status messages appear as the software is uninstalled. 1 4

54 54 Chapter 4 Uninstalling ehealth OpenView

55 Index A alarm drilldowns 44 severity codes 43 traps 14 Alarm Categories window 42 C checklist UNIX 26 Windows 25 color codes, alarm severity 43 configuring Live Health 37 D drilldowns 44 E ehealth accessing from OpenView 41 alarms browser 42 drill down to reports 44 viewing 42 element icon 47 Internet icon 16 Live Trend, chart example 20 report example 19 reports, accessing from OpenView 45 Web interface, accessing from OpenView 45 ehealth OpenView ehealth links 15 installing on UNIX 35 installing on Windows 27 reporting features 13, 45 using with Live Health 14 examples ehealth Alarms Browser 18 ehealth Web Interface 16 Live Trend chart 20 OpenView Tools menu 16 Performance menu 17 Trend report 19 I installation checklist UNIX 26 55