ehealth SPECTRUM Integration

Transcription

1 User Guide May 2006 ehealth SPECTRUM Integration Whether you are a large enterprise or a service provider, your operations team faces a significant challenge maintaining critical service levels across complex network environments. ehealth SPECTRUM Integration helps address this challenge by combining the strength of ehealth s automated availability and performance management with the SPECTRUM network management platform, adding value to both industry-leading applications. SPECTRUM manages networks, pinpoints and corrects problems, and alerts you to changes in network or device status. The system creates a model of every entity in the network, including cables, network devices, servers, and applications. Since SPECTRUM also understands the relationship between network components, it provides a seamless view of the enterprise network. ehealth s historical data and automated reporting capabilities build on the SPECTRUM platform to automate the tasks of calculating long-term trends, baselining network resources, and providing performance reports for critical network components such as backbones, server clusters, and Internet links. ehealth s proactive troubleshooting and capacity planning features complete the picture, providing the full solution to manage your critical business services. By combining the best of both worlds, ehealth SPECTRUM Integration gives you significant time and productivity benefits. The integration allows you to: Use ehealth to automatically discover devices managed by SPECTRUM, eliminating the need to manually re-enter and continually update configuration data. Access ehealth reports, such as At-a-Glance and Trend, directly from the SPECTRUM OneClick topology, giving you a quick overview of device status and in-depth historical information. Manage Live Exceptions alarms from the SPECTRUM OneClick console, viewing Alarm Detail reports and clearing alarms to reduce the mean-time-to-repair for network issues. Access ehealth reports from SPECTRUM alarms, giving you a historical context for more effective troubleshooting. Use ehealth for capacity planning, proactive troubleshooting, performance optimization, and service level management of your network components managed by SPECTRUM. These productivity benefits allow you to maximize the return on your network investments, plan future growth, and document service levels, ultimately ensuring the long-term success of your business. ehealth SPECTRUM Integration combines the best in fault and performance management into a complete solution, ensuring the high availability and responsiveness of your mission-critical business services. Overview of this Guide This document explains how to set up the ehealth SPECTRUM Integration. This document provides the following information: Getting Started Review the system requirements and prepare the Setup Checklist. Setting Up Configure both ehealth and SPECTRUM to support the Integration. Using SPECTRUM Use the integration features in the SPECTRUM OneClick Console. Using ehealth Use the integration features in ehealth. Setup Checklist Record information needed to complete the setup process. May 2006

2 GETTING STARTED Setup Time It takes about 1.5 to 4 hours to set up the integration 1 hour To verify requirements and complete the setup checklist(s) 10 min. To add a license 1/2 hour To run the setup program and configure alarms. 2 min. 3 hrs. To configure SPECTRUM Global Collections and run ehealth discovery, depending on the number of elements Verify System Requirements Before you run the ehealth SPECTRUM Integration setup program, verify that your ehealth and SPECTRUM systems meet the following requirements: ehealth System ehealth Release Patch 7, or Release 5.7 Patch 3 or later. These releases support Solaris, Windows, and HP platforms. SPECTRUM OneClick Server SPECTRUM Release 8.0 or later. This release supports both Solaris and Windows platforms. For information on installing ehealth software, refer to the ehealth Installation Guide. For information on installing SPECTRUM software, refer to the SPECTRUM 8.0 Installation Guide and the OneClick Installation Guide. Understand Your Software Configuration There are three possible configurations for the ehealth SPECTRUM Integration: One ehealth system, one SPECTRUM server. One ehealth system, multiple SPECTRUM servers. Distributed ehealth, multiple SPECTRUM servers. Multiple standalone ehealth systems (not using Distributed ehealth) are not supported. Single ehealth System, Single (Separate) SPECTRUM Server. This configuration includes a SPECTRUM OneClick server and a SpectroSERVER, which can be separate systems. No special steps are required for this configuration. Single ehealth System, Multiple SPECTRUM Servers. You can configure ehealth to monitor multiple SPECTRUM servers, all of which can view ehealth reports. However, Live Health alarms can only be sent to one SPECTRUM server. When configuring Live Exceptions or Health reports to forward traps, specify a single SpectroSERVER as the SPECTRUM Trap Director to handle all traps. Distributed ehealth, Multiple SPECTRUM Servers. If you use Distributed ehealth, you can connect multiple ehealth systems with multiple SPECTRUM servers. When using Distributed ehealth: Configure each Distributed ehealth System to import information from a separate Global Collection on the SPECTRUM OneClick server. Configure each Distributed ehealth System to forward Live Exceptions traps to the single SPECTRUM Trap Director, as above. Configure Health reports on each ehealth system and the Distributed ehealth Console to forward traps to the single SPECTRUM Trap Director. Configure SPECTRUM to access reports on a single Distributed ehealth Console (front end). In this configuration the SPECTRUM OneClick server can view reports from any ehealth system. Complete the Setup Checklist For each SPECTRUM OneClick server you want to configure, copy and complete the Setup Checklist on the last page of this document. The checklist helps you to supply t he information for the setup program. 2

3 SETTING UP Add a License Your ehealth SPECTRUM Integration license supports any number of SPECTRUM servers. To add your license information: 1. On the ehealth console, select Setup > Enter Licenses. 2. In the Enter Licenses dialog box, click Add. 3. In the Add Licenses dialog box, enter your license information. Run the Setup Program The setup program prompts you for the information that you recorded on the ehealth SPECTRUM Integration Setup Checklist on page 9. To run the ehealth SPECTRUM Integration setup program: 1. Log in to the ehealth system as the ehealth administrator. 2. Open a terminal window and change to the ehealth directory by entering the following command, where ehealth is the full pathname: cd ehealth 3. Run the setup program by entering the following command:./bin/nhspectrumsetup The SPECTRUM Import Setup dialog box opens. Figure 1. SPECTRUM Import Setup Dialog Box 4.Using the Setup Checklist that you prepared (page 9), enter the following information: Hostname or IP address of the SPECTRUM OneClick server. Port number for OneClick server Web requests. Path where OneClick is installed on the server. Username used to log in to the OneClick server. Password for the specified user name. 5.Click OK. ehealth verifies your settings and displays a message notifying you if they are valid. NOTE NOTE The validation process may take a few seconds. Configure the ehealth Alarm Notifier If you use Live Health, you can configure the Live Exceptions browser to forward Live Health alarm traps to a SpectroSERVER. To configure Live Exceptions to forward traps: 1.Launch the Live Exceptions browser. 2.Select Setup > Trap Destinations. The Trap Destinations Manager dialog box appears. 3.Click New. 4.Using the Setup Checklist (page 9), specify the following information under Edit Trap Destination: Hostname of the SpectroSERVER. IP address of the SpectroSERVER. Port number for the SpectroSERVER. 5.Click Add. 6.Confirm that the name of the SpectroSERVER appears in the Existing Trap Destinations list, then click OK. 7.Select Setup > Notifier Rules. The Notifier Manager dialog box appears. 8.Click New. The Notifier Rule Editor dialog box appears. 9.In the Name field, enter SPECTRUM. 10.In the Action list, select Send Trap. 11.In the To NMS list, select the SpectroSERVER you specified in step Under When an alarm is, select both Raised and Cleared. 13.Under Elements within, specify either a specific technology type or All Tech/Subjects. 14.Click OK to save your Notifier rule. 3

4 Configure Health Reports You can also configure individual Health reports to forward traps for Health exceptions to the SpectroSERVER. When the scheduled Health report runs, ehealth sends an SNMP trap to the SpectroSERVER for each element in the Exceptions section of the Health report. NOTE Only scheduled Health reports forward exceptions. If you manually run a Health report, it will not forward exceptions. Configure SPECTRUM to Recognize the ehealth Server and to Clear Alarms After completing the ehealth setup, you must also configure SPECTRUM to recognize the ehealth server. To enable SPECTRUM to access ehealth reports: 1. Log in to the SPECTRUM OneClick homepage. 2. Select Administration at the top of the page. The administration pages menu appears. 3. Select ehealth Configuration. The ehealth Configuration window appears. To forward exceptions from Health reports: 1. Launch the ehealth Console. 2. Select Reports > Customize > Health Reports. 3. Select the report from which you want to forward Health exceptions. 4. In the Presentation Attributes drop-down list, select General. 5. Select NMS IP and Port Trap Address in the Attribute table. 6. In the Value field, specify the SpectroSERVER IP address and port number, separated by a colon. For example: : In the Presentation Attributes drop-down list, select Exceptions. 8. Select Send Exceptions SNMP Trap in the Attribute table. 9. Select Yes in the value field. 10.Click OK. Figure 2. ehealth Configuration Window 4. Using the Setup Checklist that you prepared (page 9), enter the following information: ehealth Server Name The Hostname or IP address of the ehealth server. ehealth Server Port The port number on which ehealth listens for Web requests. ehealth Admin Username The ehealth Web Administrator user name. ehealth Admin Password The ehealth Web Administrator password. To enable SPECTRUM to clear alarms: 5. To enable SPECTRUM to clear Live Health alarms, select Started in the Alarm Notifier Status section. NOTE If you configure ehealth to forward alarms to SPECTRUM, and configure SPECTRUM to view ehealth alarms, the alarm notifier enables you to clear those alarms directly from the OneClick console. 6. Click Save. 7. Configure SPECTRUM to view ehealth alarms, as described on page 5. 4

5 Configure SPECTRUM to View ehealth Alarms If you configured ehealth to forward Live Health alarms or Health exceptions to a SpectroSERVER, you must also configure SPECTRUM to receive the alarms. To enable SPECTRUM to view ehealth alarms: 1. Within SPECTRUM, use Create By Model Type to model the ehealth server as an EventAdmin model. 2. Launch the OneClick Console. 3. Select the EventAdmin model in the OneClick Topology. 4. Right-click on the EventAdmin model, then select Utilities > Attribute Editor. 5. In the Attributes tree, select User Defined, then click Add. 6. In the Attribute Selector window, select Other > EventAdmin. 7. In the Attributes for EventAdmin filter, enter map_traps_to_this_model_using_ip_header. The list is filtered to show only that attribute. 8. Select the map_traps_to_this_model_using_ IP_header attribute, then click OK. 9. In the Attribute Editor, select User Defined > map_traps_to_this_model_using_ip_header. 10.Click the arrow that points to the right. The attribute is moved to the right window. 11.In the right window, select map_traps_to_this_ model_using_ IP_header, then select Yes. 12.Click Apply. 13.In the Attribute Edit Results window, click Close. Create SPECTRUM Global Collections Global Collections help you organize the network elements managed by SPECTRUM into logical groups in the SPECTRUM OneClick Topology. ehealth uses specified Global Collections as a starting point to discover network elements managed by SPECTRUM. Therefore, before running the ehealth discover process, use Global Collections to specify which network elements you want ehealth to monitor. To create a Global Collection: 1.Log in to the SPECTRUM OneClick Console. 2.Create one or more Global Collections containing the devices you want to monitor with ehealth. NOTE If you are using Distributed ehealth, you must create a separate Global Collection for each Distributed ehealth System, so that different ehealth systems are not polling the same device. For more information on SPECTRUM Global Collections, refer to the Modeling Your IT Infrastructure Administrator Guide. Set Up ehealth Discovery The ehealth discover process reads the device information from the SPECTRUM collection To run the discover process: 1.On the ehealth Console, select Setup > Discover. The Discover dialog box opens. 2.In the Mode section, select the type of discover process that you want to run. 3.In the Discover Using section, select SPECTRUM Import. 4.In the Global Collection drop down menu, select the SPECTRUM Collection that you created in the previous section. 5.Click Discover. ehealth connects to the OneClick server and extracts the information from the SPECTRUM Collection, then discovers the appropriate elements. The Discovery Results are displayed in the Discovering dialog box. 6.When the discover process is complete, click Save. The results are saved to the Poller Configuration. 7.If you want to discover another SPECTRUM collection, repeat steps 4 through 6. 5

6 USING SPECTRUM With ehealth SPECTRUM Integration, you can perform the following tasks directly from the SPECTRUM OneClick console: Generate ehealth At-a-Glance and Trend reports for elements in the OneClick Topology. Generate At-a-Glance and Trend reports for alarms. View Alarm Detail reports for Live Health alarms. Clear Live Health alarms. Running Reports from the OneClick Console You can generate ehealth At-a-Glance and Trend reports from the OneClick console for any router, switch, LAN/WAN interface, or system represented in the OneClick Topology (Figure 3). ehealth SPECTRUM Integration To generate a Trend report: 1.Select the icon in your Topology that represents the interface, router, switch, or system for which you want to generate a report. 2.Right-click the icon, then select Trend Report (ehealth). 3.Select the Trend variable you want to plot. A new browser window opens. 4.Enter your ehealth Web user name and password. A status window appears displaying progress as the report generates. After several seconds, the report appears (Figure 4). Figure 4. ehealth Trend Report Figure 3. OneClick Topology Trend Reports. ehealth Trend reports display the performance of an element or a group of elements based on specific variables. You use these reports to identify the cause of unsatisfactory health ratings on specified elements. These reports display information for the previous 24 hours. At-a-Glance Reports. ehealth At-a-Glance reports provide detailed information for all critical performance parameters through a series of charts (see Figure 5). These charts show the trends for important variables such as the following: CPU utilization Buffer management Traffic activity by protocol Total throughput Disk faults Disk input and output To generate an At-a-Glance report: 1.Select the icon in your Topology that represents the interface, router, switch, or system for which you want to generate a report. 2.Right-click the icon, then select At-a-Glance Report (ehealth). A browser window opens. 6

7 3. Enter your ehealth Web user name and password. A status window appears displaying progress as the report generates. After several seconds, the report appears (Figure 5). Figure 5. ehealth At-a-Glance Report Viewing ehealth Reports for Alarms When you see an alarm in the OneClick alarm list, you can generate ehealth At-a-Glance and Trend reports to view historical data about the element generating the alarm. To generate reports from the OneClick alarm list: 1. Right-click the appropriate row in the alarm list, then select: At-a-Glance Report (ehealth) or Trend Report (ehealth). A new browser window opens. 2. Enter your ehealth Web user name and password. A status window appears displaying progress as the report generates. After several seconds, the report appears. Viewing Alarm Detail Reports for Live Health Alarms When you see a Live Exceptions alarm in the OneClick alarm list, you can view an Alarm Detail report for the alarm, in addition to the At-a-Glance and Trend reports. The alarm detail report provides in depth information about the alarm, including details about: Time The time the problem started that led to the alarm, and the duration the alarm has been active. Elements The name of the element that has the alarm, its technology type, IP address, and the total number of traps it has generated. Alarm Type The problem or condition that generated the alarm, and the severity level of the alarm. You can use this information along with the At-a- Glance and Trend reports to more effectively troubleshoot the cause of a problem. To view Alarm Detail reports: 1.Right-click the appropriate row in the alarm list, then select Alarm Detail. A new browser window opens. 2.Enter your ehealth Web user name and password. A status window appears on the screen and displays the progress as the report generates. After several seconds, the Alarm Detail report appears in the browser. Clearing Live Health Alarms When you determine that the problem causing a Live Health alarm has been fixed, or is not a real problem, you can clear the alarm from the OneClick console. To clear an alarm from the OneClick console: 1.Right-click the appropriate row in the alarm list, then select Clear Alarm. The alarm is cleared in both SPECTRUM and the ehealth Live Exceptions Browser. 7

8 USING ehealth Running Reports from the ehealth Console From the ehealth console, you can run additional types of reports on all of your elements, including the elements that you monitor with SPECTRUM. Depending on which ehealth applications you use, you can run the following reports from ehealth: At-a-Glance Show key performance indicators for a specific element to aid in troubleshooting. Top N Show which elements are the highest or lowest performers for key indicators. Trend Show historical performance for multiple variables or multiple elements. Health Provide current and historical data to identify problems proactively, and plan resources. MyHealth Provide custom, multi-chart views of specific, user specified data. What-If Show the effect of changes in capacity and demand to help in capacity planning. Service Level Show and analyze service level information for a complete business unit. You can use the ehealth console or Web interface to generate reports for a specific time period. You can also schedule ehealth reports to run automatically at specified times. For more information about ehealth reports and how to run them, refer to the ehealth Web Help. Launching the OneClick Console You can launch the SPECTRUM OneClick console directly from ehealth to access SPECTRUM s fault management, root cause analysis, and other network management features. To launch the OneClick Console from ehealth: 1. Log in to ehealth Web console. 2. Select the Live Health tab. 3. Click Launch OneClick. The SPECTRUM OneClick console opens. 4. Log in to the OneClick console using your SPECTRUM user name and password. Clearing SPECTRUM Alarms You can clear SPECTRUM alarms from the Live Exceptions Browser in ehealth. To clear an alarm in a Live Exceptions Browser: 1.Select a row in the Event Table that represents an alarm that you want to clear. 2.Right-click the row, and select Clear Alarm. A message appears to confirm clearing the alarm. 3.Click Yes. The alarm is cleared in both the Live Exceptions Browser and in SPECTRUM. Scheduling the Discover Process You can schedule the discover process to run periodically on specific days and times. Scheduling periodic discovery ensures that ehealth has the latest configuration data from SPECTRUM. ehealth can also you a log that lists any changes. To schedule the discover process: 1.From the ehealth Console, select Setup > Schedule Jobs. The Schedule Jobs dialog box opens. 2.Select Add Discover. The Add Scheduled Discover dialog box opens. 3.In the Mode section, select the type of discover process that you want to run. 4.In the Discover Using section, select SPECTRUM Import. 5.In the Global Collection drop down menu, select the SPECTRUM Collection you created in Create SPECTRUM Global Collections on page 5. 6.Optionally, in the Notify User field under options, specify the address of the users to whom you want to send the log file. 7.Under Schedule, specify the days and time that you want the discover process to run. 8.Click Schedule. The Add Scheduled Discover dialog box closes. 9.Click OK in the Schedule Jobs dialog box. 10.To schedule additional discover processes for other SPECTRUM collections, repeat the procedure. 8

9 ehealth SPECTRUM Integration Setup Checklist The following checklists describe the information you need to enter when setting up the ehealth SPECTRUM Integration. Complete the checklist for each ehealth system you want to configure, before you start the setup process. SPECTRUM OneClick Server Information The Hostname or IP Address of the SPECTRUM OneClick server. The Port Number on which OneClick listens for Web requests. Default Value: 80 The Path where OneClick is installed on the server. Default Value: spectrum Note: Use the default value unless you specified another path when installing OneClick. User name and Password for accessing this host. User name: Password: SpectroSERVER Information The Hostname of the SpectroSERVER that is configured to receive traps from ehealth. The IP address of the SpectroSERVER that is configured to receive traps from ehealth. The Port Number on which the SpectroSERVER receives traps. Default Value: 162 Note: If you are running Secure Domain Manager (SDM) or the SNMPv3 Proxy, the port number is defined by the brass_trap_port variable in the file SPECTRUM/SS/.vnmrc. The default value for the brass_trap_port variable is ehealth Server Information The Hostname or IP Address of the ehealth server. The Port Number on which ehealth listens for Web requests. Default Value: 80 Username and Password for ehealth Web Administrator access. Username: Password: Copyright 2006 CA. All rights reserved. 9