CA Spectrum and CA NetQoS Performance Center

Integration Guide
CA Spectrum r9.2.1 / CA Performance Center r6.1

This documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to as the Documentation) is for your 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 may not be disclosed by you or used for any purpose other than as may be permitted in (i) a separate agreement between you and CA governing your use of the CA software to which the Documentation relates; or (ii) a separate confidentiality agreement between you and CA. Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the Documentation, you may print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced copy. The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed. 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 YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE. The use of any software product referenced in the Documentation is governed by the applicable license agreement and such license agreement is not modified in any way by the terms of this notice. 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. Copyright 2011 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

CA Technologies Product References

This document references the following CA Technologies products: CA Spectrum (CA Spectrum) CA NetQoS Performance Center (CA Performance Center) CA NetQoS ReporterAnalyzer (ReporterAnalyzer) CA NetQoS NetVoyant (NetVoyant) CA NetQoS Event Manager (Event Manager) CA Application Delivery Analysis, formerly known as CA NetQoS SuperAgent (SuperAgent)

Contact CA Technologies
Contact CA Support For your convenience, CA Technologies provides one site where you can access the information you need for your Home Office, Small Business, and Enterprise CA Technologies products. At http://ca.com/support, you can access the following: Online and telephone contact information for technical assistance and customer services Information about user communities and forums Product and documentation downloads CA Support policies and guidelines Other helpful resources appropriate for your product

Providing Feedback About Product Documentation If you have comments or questions about CA Technologies product documentation, you can send a message to techpubs@ca.com. If you would like to provide feedback about CA Technologies product documentation, complete our short customer survey, which is available on the CA Support website at http://ca.com/docs.

Contents
Chapter 1: About CA Spectrum-Performance Center Integration 7
CA Spectrum-Performance Center Integration Version Requirements .............................. 8 Model Synchronization Eligibility ................................................................ 8 Device Model Synchronization .................................................................. 8

Chapter 2: About CA Spectrum-Performance Center Integration Architecture Chapter 3: Configuring CA Spectrum-Performance Center Integration

11 13

Configure CA Spectrum as a Data Source in the Performance Center ............................. 13 Enable CA Spectrum-Performance Center Event Polling.......................................... 14

Chapter 4: CA Spectrum-Performance Center Integration Known Anomalies Chapter 5: Modifying Data Sources After CA Spectrum-Performance Center Integration Chapter 6: Restoring the SpectroSERVER Database

15

17 19

Remove CA Spectrum as a Data Source in the Performance Center .............................. 19

Chapter 7: Enabling Debug Logging Index

21 23

Contents 5

Chapter 1: About CA Spectrum-Performance Center Integration

CA Spectrum-Performance Center Integration extracts event data from the Event Manager and converts it into CA Spectrum events. This, in turn, raises CA Spectrum alarms on models in the SpectroSERVER topology. Event polling is enabled via the Administration Page for CA Spectrum-Performance Center Integration Configuration. The default polling interval is 60 seconds. As clear events are processed, corresponding CA Spectrum alarms are located and cleared automatically. Polling for Threshold and Incident events begins once synchronization has completed. The alarms can be viewed and administered from the OneClick Console.

Note: Changes to alarms in the OneClick Console, such as a user clearing an alarm, will transition the associated Performance Center Events status to Closed. Clearing a Performance Center-based alarm in the OneClick Console will transition the status of the associated Performance Center Event to Closed. For more information about managing alarms in the OneClick Console, see the Operator Guide. Each landscape in a CA Spectrum distributed environment has an event poller assigned to it. This event poller periodically connects to the Event Manager and extracts landscape-specific events which are converted into CA Spectrum alarm set or clear events asserted on models in the landscape.

Chapter 1: About CA Spectrum-Performance Center Integration 7

CA Spectrum-Performance Center Integration Version Requirements

CA Spectrum-Performance Center Integration Version Requirements

CA Spectrum-Performance Center Integration (r9.2.1) requires the following versions: Required components: Performance Center: 6.1.158(+) Event Manager: 2.1.114(+)

Optional components (latest versions): NetVoyant ReporterAnalyzer SuperAgent

Model Synchronization Eligibility

CA Spectrum requires that one of the following sets of criteria be met for a model to be eligible for synchronization with Performance Center: Models derived from CA Spectrum model type Device that have: A valid IP address A Model_State (attribute 0x1007c) of Active Note: If Model_State is not Active, the models processing will be postponed until the next synchronization. Models derived from CA Spectrum model type Port that have: A parent device that has been synchronized A valid IfIndex value

All landscape models

Device Model Synchronization

For device model synchronization, CA Spectrum-Performance Center Integration uses Model_Class (attribute 0x11ee8) to determine the Performance Center SubType of a device, in accordance with the following table information.

Model Class Router

SubType Router

8 Integration Guide

Device Model Synchronization

Model Class Switch-Router Switch Workstation-Server

SubType Router Switches Workstations

For models whose Model_Class is not specified in the previous table, the default SubType of 'Other' is used.

Chapter 1: About CA Spectrum-Performance Center Integration 9

Chapter 2: About CA Spectrum-Performance Center Integration Architecture

CA Spectrum-Performance Center Integration architecture has the following process flow: A single SpectroSERVER or Distributed SpectroSERVER (DSS) can be synchronized with Performance Center by specifying the OneClick web server as a Performance Center data source. Full synchronization occurs when the data source is first added to Performance Center. Important! Full synchronization should be run during non-business hours when possible. Incremental synchronization occurs every five minutes. Any models added or removed from the DSS are processed.

Each landscape in the DSS is defined as a Performance Center group. Devices and interfaces in the DSS are synchronized with Performance Center and added to the appropriate landscape group. OneClick polls Event Manager for events that are relevant to a specified landscape group. This polling happens every 60 seconds by default. Any retrieved events are then translated to CA Spectrum events which will generate/assert alarms against the appropriate model.

Chapter 2: About CA Spectrum-Performance Center Integration Architecture 11

Chapter 3: Configuring CA Spectrum-Performance Center Integration

To configure CA Spectrum-Performance Center Integration, complete the following steps: 1. Configure CA Spectrum as a Data Source in the Performance Center (see page 13) 2. Enable CA Spectrum-Performance Center Event Polling (see page 14)

Configure CA Spectrum as a Data Source in the Performance Center

As part of setting up CA Spectrum-Performance Center Integration, you must add CA Spectrum as a data source in Performance Center so that these components can share information. Follow these steps: 1. Launch the Performance Center console and click Admin. The Administration page opens. 2. Click Data Sources in the Settings section. The Data Source page opens. 3. Click New. The Add New Data Source page opens. 4. Select Spectrum Infrastructure Manager from the Source Type drop-down list. 5. Type the host name for OneClick in the Host Name field. 6. Type the port number for OneClick in the Port field. 7. Click Save. You have now added CA Spectrum as a data source and the synchronization process is initiated.

Chapter 3: Configuring CA Spectrum-Performance Center Integration 13

Enable CA Spectrum-Performance Center Event Polling

Enable CA Spectrum-Performance Center Event Polling

As part of the CA Spectrum-Performance Center Integration, you must enable event polling and specify how often CA Spectrum will query Event Manager for events. This is done from the Integration Configuration page in the OneClick Administration pages. Note: Only the Threshold and Incident events will be retrieved by this polling. Follow these steps: 1. Click Administration in the OneClick home page. The Administration Pages open. 2. Click Performance Center Integration Configuration in the left panel. The Performance Center Integration Configuration page opens. 3. Enter the desired polling interval, in seconds, in the Event Polling Interval field. 4. Select the Enabled option in the Event Polling field. 5. Click Save. The event polling settings you configured take effect on the next poll cycle. Note: For more about the Performance Center Integration Configuration Page, see the Administrator Guide.

14 Integration Guide

Chapter 4: CA Spectrum-Performance Center Integration Known Anomalies

CA Spectrum-Performance Center Integration has the following known anomalies: If a device is modeled as a non-proxy model on more than one landscape, event processing behavior will be undefined. Some data sources do not support IPv6 addresses. Any device that CA Spectrum reports with an IPv6 primary address will not be mapped to devices reported by data sources that do not support IPv6 addresses. To correct the mapping, you can destroy the CA Spectrum model and rediscover it using an IPv4 address. After the next incremental synchronization, the model will be mapped properly. If a model is in maintenance mode in CA Spectrum when a Performance Center-based event is received, that event will not be processed by CA Spectrum, per normal maintenance mode behavior. If the Event Manager data source is removed, CA Spectrum may fall out of sync and not recover. If this occurs, it is recommended that CA Spectrum be removed and re-added as a data source once the Event Manager has been added back in.

More information: Remove CA Spectrum as a Data Source in the Performance Center (see page 19) Modifying Data Sources After CA Spectrum-Performance Center Integration (see page 17)

Chapter 4: CA Spectrum-Performance Center Integration Known Anomalies 15

Chapter 5: Modifying Data Sources After CA Spectrum-Performance Center Integration

If you need to remove a data source in the Performance Center after CA Spectrum-Performance Center Integration has been established (for example, during an upgrade), you must follow certain steps when adding it back for the CA Spectrum-Performance Center Integration to synchronize correctly. Important! If the correct procedure is not followed, data between CA Spectrum and Performance Center may not synchronize correctly. Use the following guidelines when adding back a data source in Performance Center after CA Spectrum-Performance Center Integration has already been configured: If CA Spectrum exists as a data source in Performance Center when you add back another data source, restart tomcat. If CA Spectrum does not exist as a data source in Performance Center, add any non-CA Spectrum data sources first and then add CA Spectrum as a data source.

Chapter 5: Modifying Data Sources After CA Spectrum-Performance Center Integration 17

Chapter 6: Restoring the SpectroSERVER Database

To restore the SpectroSERVER database to a previous state after CA Spectrum-Performance Center Integration, complete the following steps. Important! If the following steps are not performed in the specified order, data between CA Spectrum and Performance Center may not synchronize correctly. Follow these steps: 1. Remove CA Spectrum as a data source in the Performance Center (see page 19). 2. Restore the SpectroSERVER database. Note: For information about restoring the SpectroSERVER database, see the Database Management Guide. 3. Restart the OneClick server. 4. Add CA Spectrum as a data source in the Performance Center (see page 13).

Remove CA Spectrum as a Data Source in the Performance Center

Remove CA Spectrum as a data source in the Performance Center as part of the process when restoring the SpectroSERVER database to a previous state. This process helps ensure correct synchronization between CA Spectrum and the Performance Center after the database has been restored. Follow these steps: 1. Launch the Performance Center console and click Admin. The Administration page opens. 2. Click Data Sources in the Settings section. The Data Source page opens.

Chapter 6: Restoring the SpectroSERVER Database 19

Remove CA Spectrum as a Data Source in the Performance Center

3. Select the OneClick host name and click Delete. The Delete Data Source page opens. 4. Click Delete. The data source is successfully deleted, and synchronization between CA Spectrum and Performance Center no longer occurs.

20 Integration Guide

Chapter 7: Enabling Debug Logging

To facilitate the investigation of issues, enable Performance Center Integration debug logging on the OneClick Web Server. Note: Enabling the Performance Center Integration debug logging can potentially generate a large volume of data in a short amount of time.

Chapter 7: Enabling Debug Logging 21

Index
A
alarm clearing 7 alarm set 7 anomalies 15 Performance Center version 8

R
ReporterAnalyzer 8 router 8

C
configuring 13 contacting technical support 3 customer support, contacting 3

S
SpectroSERVER database 19 SuperAgent 8 support, contacting 3 switch 8 switch-router 8 synchronization 11

D
data sources 13, 15, 17 adding 13 removing 19 debug logging 21 device model synchronization 8 distributed SpectroSERVER 11

T
technical support, contacting 3

W
workstation-server 8

E
Event Manager 11 version 8 event polling 7, 11, 14

F
full synchronization 11

I
incremental synchronization 11 IPv6 addresses 15

M
maintenance mode 15 model eligibility 8 Model_class 8

N
NetVoyant 8 non-proxy model 15

P
Performance Center group 11 Performance Center Integration Configuration Page 14

Index 23