APM_9.5 NSM Integration Guide

8/12/2019 APM_9.5 NSM Integration Guide

1/101

Integration for CA NSM GuideRelease 9.5

CA Application PerformanceManagement


2/101

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, withoutthe 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 2013 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong totheir respective companies.


3/101

CA Technologies Product References

This document references the following CA Technologies products and features:

CA Application Performance Management (CA APM)

CA Application Performance Management ChangeDetector (CA APM

ChangeDetector)

CA Application Performance Management ErrorDetector (CA APM ErrorDetector)

CA Application Performance Management for CA Database Performance (CA APM

for CA Database Performance)

CA Application Performance Management for CA SiteMinder (CA APM for CA

SiteMinder)

CA Application Performance Management for CA SiteMinder Application ServerAgents (CA APM for CA SiteMinder ASA)

CA Application Performance Management for IBM CICS Transaction Gateway (CA

APM for IBM CICS Transaction Gateway)

CA Application Performance Management for IBM WebSphere Application Server

(CA APM for IBM WebSphere Application Server)

CA Application Performance Management for IBM WebSphere Distributed

Environments (CA APM for IBM WebSphere Distributed Environments)

CA Application Performance Management for IBM WebSphere MQ (CA APM for

IBM WebSphere MQ)

CA Application Performance Management for IBM WebSphere Portal (CA APM forIBM WebSphere Portal)

CA Application Performance Management for IBM WebSphere Process Server (CA

APM for IBM WebSphere Process Server)

CA Application Performance Management for IBM z/OS (CA APM for IBM z/OS)

CA Application Performance Management for Microsoft SharePoint (CA APM for

Microsoft SharePoint)

CA Application Performance Management for Oracle Databases (CA APM for Oracle

Databases)

CA Application Performance Management for Oracle Service Bus (CA APM for

Oracle Service Bus) CA Application Performance Management for Oracle WebLogic Portal (CA APM for

Oracle WebLogic Portal)

CA Application Performance Management for Oracle WebLogic Server (CA APM for

Oracle WebLogic Server)

CA Application Performance Management for SOA (CA APM for SOA)


4/101

CA Application Performance Management for TIBCO BusinessWorks (CA APM for

TIBCO BusinessWorks)

CA Application Performance Management for TIBCO Enterprise Message Service

(CA APM for TIBCO Enterprise Message Service)

CA Application Performance Management for Web Servers (CA APM for Web

Servers)

CA Application Performance Management for webMethods Broker (CA APM for

webMethods Broker)

CA Application Performance Management for webMethods Integration Server (CA

APM for webMethods Integration Server)

CA Application Performance Management Integration for CA CMDB (CA APM

Integration for CA CMDB)

CA Application Performance Management Integration for CA NSM (CA APM

Integration for CA NSM)

CA Application Performance Management LeakHunter (CA APM LeakHunter)

CA Application Performance Management Transaction Generator (CA APM TG)

CA Cross-Enterprise Application Performance Management

CA Customer Experience Manager (CA CEM)

CA Embedded Entitlements Manager (CA EEM)

CA eHealth Performance Manager (CA eHealth)

CA Insight Database Performance Monitor for DB2 for z/OS

CA Introscope

CA SiteMinder

CA Spectrum Infrastructure Manager (CA Spectrum)

CA SYSVIEW Performance Management (CA SYSVIEW)


5/101

Contact CA Technologies

Contact CA Support

For your convenience, CA Technologies provides one site where you can access the

information that you need for your Home Office, Small Business, and Enterprise CA

Technologies products. Athttp://ca.com/support,you can access the following

resources:

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 [email protected].

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.
http://www.ca.com/supporthttp://www.ca.com/supporthttp://www.ca.com/supportmailto:[email protected]:[email protected]:[email protected]://www.ca.com/docshttp://www.ca.com/docshttp://www.ca.com/docshttp://www.ca.com/docsmailto:[email protected]://www.ca.com/support


6/101


7/101

Contents 7

Contents

Chapter 1: Introduction 11

How Integration Works .............................................................................................................................................. 11

Architecture Diagram ................................................................................................................................................. 12

Benefits ...................................................................................................................................................................... 12

Chapter 2: Installing CA Introscope Integration for CA NSM 15

Remove CA Introscope to Unicenter NSM Integration Release 1.x ......................................................................... 15

Remove the Integration Pack from the Enterprise Manager ..................................................................................... 16

Remove the Integration Pack from the NSM Bridge Proxy ........................................................................................ 16

Remove the Integration Pack from Unicenter WorldView ........................................................................................ 16Remove the Integration Pack from Unicenter Management Portal .......................................................................... 17

Remove Objects from the WorldView Repository ..................................................................................................... 17

Remove the Introscope Web Services API/SDK 7.2 ................................................................................................... 18

Pre installation Requirements .................................................................................................................................... 18

Feature Prerequisites ................................................................................................................................................. 19

Installation Archives ................................................................................................................................................... 20

Installation Sets .......................................................................................................................................................... 21

Features of CA Introscope Integration for CA NSM ................................................................................................. 21

User Rights ................................................................................................................................................................. 22

Installation Scenarios ................................................................................................................................................. 22

Installation Modes...................................................................................................................................................... 22

Install using the GUI Installer ..................................................................................................................................... 23

Use the Integration Pack Configuration UI ......................................................................................................... 24

Install using Silent Mode ............................................................................................................................................ 25

Silent Installer Properties .................................................................................................................................... 25

Install Using the Console Mode .................................................................................................................................. 27

Re-install CA Introscope Integration for CA NSM ..................................................................................................... 27

Install on a Machine with an Existing Integration ...................................................................................................... 28

Verify the Installation ................................................................................................................................................. 29

Uninstall CA Introscope Integration for CA NSM ..................................................................................................... 29

Remove CA Introscope Objects ......................................................................................................................... 30

Chapter 3: Configuring and Managing Whats Monitored 33

Overview .................................................................................................................................................................... 33

Required Configurations ..................................................................................................................................... 33

Configure the Alternate Bind Address ....................................................................................................................... 34


8/101

8 Integration for CA NSM Guide

Configure the Unicenter Management Portal ............................................................................................................ 34

Using the CA NSM Configuration UI ........................................................................................................................... 35

Access the CA Introscope Integration for CA NSM Configuration UI ................................................................ 35

Configure Introscope Enterprise Manager Host ................................................................................................. 36

Configure CA NSM ...................................................................................................................................................... 39

Edit the NSM WorldView Repository .................................................................................................................. 39

Edit the NSM Enterprise Manager Host .............................................................................................................. 39

Configure Monitoring .......................................................................................................................................... 40

Configure Message Formatting ........................................................................................................................... 41

Configure Status Mapping ................................................................................................................................... 41

(Optional) Enable DEBUG logging in the Introscope-NSM bridge ....................................................................... 43

Chapter 4: Using CA Introscope Integration for CA NSM 45

View CA Introscope objects in Management Command Center .............................................................................. 45

View Introscope Objects in the Management Command Center Tree Hierarchy............................................... 46

View Dashboards of CA Introscope Objects in the Management Command Center ........................................ 46

View CA Introscope Alerts in the Management Command Center Event Console ........................................... 47

View CA Introscope Objects in the Unicenter Management Portal ......................................................................... 47

View CA Introscope Objects in CA NSM WorldView 2D Map ................................................................................... 48

View CA Introscope Alerts in the CA NSM Event Console ........................................................................................ 49

Chapter 5: Integrating CA NSM with CA CEM 51

About CA NSM with CA CEM ...................................................................................................................................... 52

CA NSM Integration Overview ................................................................................................................................... 53

CA NSM to CA CEM Integration Terminology ............................................................................................................. 53

CA NSM Terms .................................................................................................................................................... 54

CA NSM to CA CEM Term Mapping ..................................................................................................................... 55

Chapter 6: Installing CA CEM Integration for CA NSM 57

Install the CA CEM Integration Pack for CA NSM ....................................................................................................... 57

Verify the Integration Installation ....................................................................................................................... 58

Install Custom Dashboards for Unicenter Management Command Center .............................................................. 59

Verify the Installation .......................................................................................................................................... 59

Set CA NSM Connection Information .................................................................................................................. 60

Chapter 7: Configuring the CA CEM and NSM Connections 61

Set CA CEM Connection Information ......................................................................................................................... 61

Configure Unicenter Management Portal with CA CEM ............................................................................................ 61

(Optional) Enable DEBUG logging in the CEM-NSM bridge ........................................................................................ 63


9/101

Contents 9

CA CEM-NSM Bridge Maintenance ............................................................................................................................ 63

CA CEM-NSM Bridge Start/Stop .......................................................................................................................... 63

Other Maintenance Information ......................................................................................................................... 63

Integrate with Unicenter Management Portal.................................................................................................... 64

Chapter 8: Using CA NSM with CA CEM 67

View CA CEM Objects in CA NSM ............................................................................................................................... 67

View CA CEM objects in Unicenter Explorer .............................................................................................................. 67

View CA CEM Objects in Management Command Center ......................................................................................... 69

View CA CEM Objects in Unicenter WorldView 2D Map ............................................................................................ 71

View CA CEM Objects in Unicenter Management Portal ........................................................................................... 71

View CA CEM Incidents in the CA NSM Event Console .............................................................................................. 73

Receive and Update CA CEM Objects in the CA NSM WorldView Repository ........................................................... 73

Synchronize CA CEM Data ................................................................................................................................... 74

Modify the Hierarchy of CA CEM Managed Objects ........................................................................................... 74

Receive and Update the Status of CA CEM Objects ................................................................................................... 75

Customize CA NSM Alarmset Severity Status Mappings ............................................................................................ 76

CA NSM Resources ..................................................................................................................................................... 77

CA NSM Documentation ..................................................................................................................................... 77

Appendix A: Troubleshooting 79

Verify CA NSM Integration with CA CEM.................................................................................................................... 79

Symptoms and Solutions-(NSM and CA CEM) ............................................................................................................ 80

Appendix B: CA CEM-NSM Bridge Properties 83

Edit the cemBridgeConnector.properties File ............................................................................................................ 83

WEBAPP_CONTAINER_HOST .............................................................................................................................. 84

WEBAPP_CONTAINER_PORT .............................................................................................................................. 84

CEM.1.HOST ........................................................................................................................................................ 84

CEM.1.PORT ........................................................................................................................................................ 85

CEM.1.USER......................................................................................................................................................... 85

CEM.1.PASSWORD .............................................................................................................................................. 86

CEM.1.TOPIC_BIZ_PROCESS_UPDATES_SUBSCRIBE ........................................................................................... 86

CEM.1.TOPIC_BIZ_TRANSACTION_UPDATES_SUBSCRIBE .................................................................................. 86

CEM.1.TOPIC_USER_GROUP_UPDATES_SUBSCRIBE .......................................................................................... 87CEM.1.TOPIC_INCIDENT_UPDATES_SUBSCRIBE ................................................................................................. 87

CEM.1.TOPIC_BIZ_TRANS_SEVERITY_UPDATES_SUBSCRIBE .............................................................................. 88

CEM.1.TOPIC_USER_GROUP_SEVERITY_UPDATES_SUBSCRIBE ......................................................................... 88

CEM.1.CEM_CONNECTION_CHECK_SEC ............................................................................................................. 89

Filter User Groups, Business Services, and Business Transactions............................................................................. 89


10/101


CEM.1.USER_GROUP_FILTER_REGEX .................................................................................................................. 90

CEM.1.BIZ_PROCESS_FILTER_REGEX .................................................................................................................. 90

CEM.1.BIZ_TRANSACTION_FILTER_REGEX .......................................................................................................... 91

Edit the nsmBridgeConnector.properties File ............................................................................................................ 91

NSM_WV_HOST .................................................................................................................................................. 92

NSM_WV_USER .................................................................................................................................................. 92

NSM_WV_PASSWORD ........................................................................................................................................ 92

NSM_WV_DISABLE .............................................................................................................................................. 93

NSM_CONNECTION_CHECK_SEC ........................................................................................................................ 93

NSM_EM_HOST................................................................................................................................................... 94

NSM_EM_DISABLE .............................................................................................................................................. 94

Edit the cemNsmBridge.properties File ..................................................................................................................... 94

CEMNSM_CREATENODE_TESS ............................................................................................................................ 95

CEMNSM_CREATENODE_USERGROUPS ............................................................................................................. 95

CEMNSM_WTO_SOURCE .................................................................................................................................... 95CEMNSM_WTO_TEXT ......................................................................................................................................... 96

Index 99


11/101


Chapter 1: Introduction

The CA Introscope Integration for CA Network and Systems Management (CA NSM)

enhances the CA Introscope platform with capabilities that allow you to create

monitoring solutions suitable to the requirements of the NSM managed environment.

The CA Introscope Integration for CA NSM provides out-of-the-box integration of

industry-leading business application performance management solution of CA with CA

NSM. This integrated solution can import CA Introscope performance agents, status,

alerts, and summary dashboards to CA NSM. The solution allows you to take advantage

of CA Introscope deep visibility into production web applications automatically,

without requiring J2EE or .NET expertise.

This section contains the following topics:

How Integration Works(see page 11)

Architecture Diagram(see page 12)

Benefits(see page 12)

How Integration Works

CA Introscope Integration for CA NSM integrates CA Introscope business application

performance agents into the CA Management Database (CA MDB). The integration

allows CA Introscope agents to be represented as managed objects within CA NSM.

These managed objects can also be utilized within CA NSM Business Process Views (BPV)

for defining custom management views incorporating business application and

infrastructure elements. Performance status and alerts from CA Introscope are

available within Unicenter Management Portal, 2D Map, Management Command

Center, Object Explorer, and the NSM Event Console. This solution enables proactive

incident management, simple correlation of business application, systems, network

availability, and performance. For an illustration of the integration pack architecture,

seeArchitecture diagram(see page 12).


12/101

Architecture Diagram


Architecture Diagram

Benefits

CA Introscope Integration for CA NSM:

Monitors mission critical web applications within the CA NSM consoles for moreeffective and consolidated monitoring and triage across their entire infrastructure.

Allows IT organizations to collaborate more effectively by presenting CA

Introscope-collected business application performance alerts in a manner native

to their management tools.


13/101

Benefits


Simplifies monitoring processes by allowing business application performance alerts

from CA Introscope to participate in centralized correlation, notification, and

resolution processes.


14/101


15/101


Chapter 2: Installing CA Introscope

Integration for CA NSM


Remove CA Introscope to Unicenter NSM Integration Release 1.x(see page 15)

Remove the Integration Pack from the Enterprise Manager(see page 16)

Remove the Integration Pack from the NSM Bridge Proxy(see page 16)

Remove the Integration Pack from Unicenter WorldView(see page 16)

Remove the Integration Pack from Unicenter Management Portal(see page 17)

Remove Objects from the WorldView Repository(see page 17)

Remove the Introscope Web Services API/SDK 7.2(see page 18)

Pre installation Requirements(see page 18)

Feature Prerequisites(see page 19)Installation Archives(see page 20)

Installation Sets(see page 21)

Features of CA Introscope Integration for CA NSM(see page 21)

User Rights(see page 22)

Installation Scenarios(see page 22)

Installation Modes(see page 22)

Install using the GUI Installer(see page 23)

Install using Silent Mode(see page 25)

Install Using the Console Mode(see page 27)

Re-install CA Introscope Integration for CA NSM(see page 27)

Install on a Machine with an Existing Integration(see page 28)

Verify the Installation(see page 29)

Uninstall CA Introscope Integration for CA NSM(see page 29)

Remove CA Introscope to Unicenter NSM Integration Release

1.x

Previous versions of this integration pack, CA Introscope to Unicenter NSM Integration,

have to be first manually removed from your computer. Then, you can install CA

Introscope Integration for CA NSM successfully. If you install CA Introscope

Integration for CA NSM without removing the previous version of the integration, data is

duplicated in the CA NSM WorldView repository. If the same CA Introscope Enterprise

Manager alerts are configured, duplicate alert notifications are created in the EventConsole.

To delete the previous version, remove components from the following areas manually:

Introscope Enterprise Manager hostRemove the integration pack from the

Enterprise Manager(see page 16).


16/101

Remove the Integration Pack from the Enterprise Manager


NSM Bridge Proxy hostRemove the integration pack from the NSM Bridge Proxy

(see page 16).

Unicenter WorldView hostRemove the integration pack from Unicenter

WorldView(see page 16).

Unicenter Management Portal hostRemove the integration pack from Unicenter

Management Portal(see page 17).

WorldView Repository hostRemove objects from the WorldView repository(see

page 17).

CA Introscope web services API/SDK 7.2Remove the CA Introscope web

services API/SDK 7.2(see page 18).

Remove the Integration Pack from the Enterprise Manager

To install CA Introscope Integration for CA NSM successfully, ensure all the previousversions of this integration are removed from your computer.

Follow these steps:

1.

Go to the directory on the Enterprise Manager host.

2. Go to the/extdirectory and remove NsmBridge-EM.jar.

3. Go to the /config directory and remove WilyNsmBridge.properties.

4.

Go to the /webapps directory and removeAgentDashboard.war and

castylesr2.war.

Remove the Integration Pack from the NSM Bridge Proxy

To install CA Introscope Integration for CA NSM successfully, ensure all the previous

versions of this integration are removed from your computer.

Follow these steps:

1. Uninstall the CA Introscope NSM Bridge Proxy service by running

UninstallApp-NT.bat from the introscope\nsmbridge\jsw\bindirectory.

2. Go to the NSM Bridge Proxy host and remove the introscope\nsmbridge directory.

Remove the Integration Pack from Unicenter WorldView

To remove a previous integration pack from Unicenter WorldView, go to the Unicenter

WorldView host and remove IntroscopeAgentDashboard.rhpfrom the /WVEM/BIN directory.


17/101

Remove the Integration Pack from Unicenter Management Portal


Remove the Integration Pack from Unicenter Management

Portal

To install CA Introscope Integration for CA NSM successfully, ensure all the previousversions of this integration are removed from your computer.

Follow these steps:

1. Go to the Unicenter Management Portal host and select UMP, Manage

Components.

2. Click the Connection hyperlink for the Unicenter WorldView Management

component.

3. Click the Delete hyperlink and OK.

4.

Click OK to confirm you want to delete the data source.

5.

Click Back.

6. Click the Connection hyperlink for the Introscope Dashboard component.

7.

Click the Delete hyperlink and OK.

8. Click OK to confirm you want to delete the data source.

9. Click Back.

10.

Exit the Unicenter Management Portal.

Remove Objects from the WorldView Repository

To install CA Introscope Integration for CA NSM successfully, ensure all the previous

versions of this integration are removed from your computer.

Follow these steps:

1. Click the Start button on the Windows platform, point to Programs, and navigate to

Computer Associates, Unicenter, NSM WorldView, Object Browser,

ManagedObject, BusinessView.

2. From the right pane under WilyBV, right-click objects, select Delete Object, then

select the Delete child objects, and click OK.

3.

Select Host, Windows_NetServer from the left pane.

4. Delete all instances of Wily and WilyAgent.

5. Delete Classes using Computer Associates, Unicenter, NSM, WorldView, Class

Wizard.

6. Select the Modify Existing Class check box.


18/101

Remove the Introscope Web Services API/SDK 7.2


7. Expand ManagedObject.

8. Expand BusinessView.

9. Click WilyBV.

10.

Click Delete Class.

11. Click Yes to confirm the action.

12. From ManagedObject, expand Host and Windows_NetServer.

13.

Click Wily.

14. Click Delete Class.

15. Click Yes to confirm the action.

16. Click WilyAgent.

17. Click Delete Class.

18.

Click Yes to confirm the action.

19. Exit the system.

Remove the Introscope Web Services API/SDK 7.2

The web services API/SDK version 7.2 must be removed. The war and jar files must be

manually removed from your computer to install CA Introscope Integration for CA NSM

successfully.

Follow these steps:

1.

Go to \ext and remove IscopeAlertsExt-EM.jar.

2. Go to the \webapps directory and remove

introscope-web-services.war and castylesr2.war.

Pre installation Requirements

Verify the following requirements before installing CA Introscope Integration for CA

NSM:

Verify that your system contains the components necessary for the features you

want to installFeature prerequisites(see page 19).

Download the installation files from the archive that best suits your

environmentInstallation archives(see page 20).

Familiarize yourself with the installation sets to help you determine which is the

best fit for your environmentInstallation sets(see page 21).


19/101

Feature Prerequisites


Familiarize yourself with the CA Introscope Integration for CA NSM features to

help you determine which is the best fit for your environmentCA Introscope

Integration for CA NSM features(see page 21).

Verify that the person performing the installation has the appropriate user rights

assignedUser rights(see page 22).

Determine what installation scenario and mode best suits your

environmentInstallation scenarios(see page 22) andInstallation modes(see

page 22).

Feature Prerequisites

You must have at least one of the NSM components that are installed before proceeding

with installing the CA Introscope Integration for CA NSM.

Use this table to familiarize yourself with the prerequisites for this CA IntroscopeIntegration for CA NSM features:

Required Components

CA Introscope Integration for NSM

Windows Server 2003 operating system

Administrator rights

Event Management - Event Agent (included with 11.1 SP1 or higher)

WorldView - Administrative Client (included with 11.1 SP1 or higher)

Operating System Support

CA Introscope Integration for NSM Server


Management Command Center (included with 11.1 SP1 or higher)

Integration for Portal Server


Unicenter Management Portal (included with 11.1 SP1 or higher)

CA NSM Support

See the CA APM Compatibility Guidefor the supported versions of CA

NSM.


20/101

Installation Archives


Required Memory

The minimum memory requirement for a computer hosting CA NSM

Integration product is 2 GB.

Virtual and Physical Environment Support

The integration must be on the same Virtual host as the NSM Server.

The integration is supported in physical and virtual environments; verify that

the sizing requirements of NSM are met with more capacity for the integration.

The integration pack works with any NSM version higher than 11.1 SP1, but it

has only been certified with NSM 11.2P version 1.

Installation Archives

Installation archives for Windows platforms and its contents vary depending on thedownloaded package.

Windows:

CA_APM_Introscope_NSM_Integration_Windows_Installer.zip

Archive contents:

Apache-tomcat-5.5.25.zip

These files are applicable only to the Windows platform. They are required to install

the CA Introscope Integration for NSM.

IntroscopeIntegrationNSM.zip


the Integration for NSM Server.

IntroscopeIntegrationPortal.zip


the Integration for Portal Server.

install.exe

The installer executable for the Windows Server platform.

silentInstallerSample.properties

The properties file necessary to install CA Introscope Integration for CA NSM using

silent mode.

More Information



21/101

Installation Sets


Installation Sets

Use installation sets to install the entire set of product features, or components

applicable only to your environment. The installer includes a drop-down list of preset

installation options that include:

CA Introscope NSM Integration Server

CA Introscope Integration for CA NSM.

CA NSM Server

Integration for NSM Server.

CA NSM Management Portal Server

Integration for Portal Server.

Custom

User can select features.

Features of CA Introscope Integration for CA NSM

The integration offers various features for various platforms. The following section helps

you determine which features best suit your environment.

CA Introscope Integration for CA NSM

Applicable only for the Windows Server platform where you want to installIntegration service.

Provides the connection between CA Introscope and CA NSM.

Integration for CA NSM Server

Applicable only for the Windows Server platform where you want to install files

specific to NSM Server to view dashboards.

Provides the Administration GUI.

Provides support for NSM Management Command Center and 2D Map.

Integration for Portal Server

Applicable only for the Windows Server platform where you want to install filesspecific to Portal Server to launch dashboards from Portal Explorer.

Provides support for the Unicenter Management Portal.


22/101

User Rights


User Rights

You must have the proper user rights to install the CA Introscope Integration for CA

NSM.

Windowsthis platform requires you to have administrator rights.

Installation Scenarios

Determine which installation scenario best suits your environment:

Install using the GUI Installer(see page 23)Use if you are installing the integration

for the first time on your computer and you have no other integration packs on

your computer.

Re-install CA Introscope Integration for CA NSM(see page 27)Use if you have

installed CA Introscope Integration for CA NSM and you want to re-install or add afeature of the same integration pack.

Install on a Computer with an Existing Integration(see page 28)Use if you have

other integrations on your computer.

Installation Modes

The following modes are available when installing the integration pack:

GUI Installera series of windows that guide you through the installation and

summarize the results when complete. The installer defaults to GUI mode on

Windows Server platforms.

Consolea series of text prompts that guide you through the installation and

summarize the results when complete. Use console mode to install on computers

without video cards, or Xservers.

Silentinvoked from the command line, the silent mode installer obtains input

from a specified response file. The silent mode installer eases the process of

performing multiple installations. The installer runs in the background and does not

provide outputyou check the install log to verify the installation results.

More information

Install using the GUI Installer(see page 23)Install Using the Console Mode(see page 27)



23/101

Install using the GUI Installer



We recommend that you use the GUI installer if you are installing CA Introscope

Integration for CA NSM for the first time and the computer has no other integration

pack that is installed on it.

Use the GUI installer to install CA Introscope Integration for CA NSM on a Windows

platform.

Note: If the installation fails for any feature or combination of features, the log file,

CAWily_Introscope_NSM_IntegrationPack_InstallLog.log, is placed on the desktop for

Windows. The log file is located in the \directory.

Follow these steps:

1. Download the installation archive for your platform:

Windows:CAWily_Introscope_NSM_IntegrationPack_Windows_Installe

r.zip

2. Extract the archive into a temporary folder.

The installation archive contents are extracted to the location.

3. Run the GUI:

Windows: Double-click install.exe.

The GUI launches.

4. Select the Install Set check box and any check boxes for more features you want to

install.

5.

Depending on the features that are installed, some or all of these guidelines must

be followed when entering information.

The Installation Folder screen appears.

6.

By default, the default Installation folder is C:\Program

Files\CAWily\IntegrationPack. If you specify a different location, verify that a valid

folder name is entered and do not leave the field empty and click Next.

The Administrators Credentials screen appears.

7. If the Integration Pack user check box is selected, the installer uses the

administrator user as an Integration Pack user. By default this check box is selected.

If you do not want to use the same credentials for the integration pack user, clearthe Use this user as the Integration Pack user check box. Enter a user ID and

password for the Integration Pack user and click Next.

If you are installing the CA Introscope Integration for NSM, the Tomcat Server

Ports screen appears.


24/101



8. If you are configuring Tomcat Server Ports, then enter the necessary values and

click Next.

Enter a valid value from 1024 through 65535 in the Connection Port field that is

not in use.

Enter a valid value from 1024 through 65535 in the Shutdown Port field that is

not in use.

9. If you are installing the CA Introscope Integration for NSM, the GUI installer screen

appears. Enter the necessary values and click Next.

The Installation Complete screen appears. Thereafter, depending on what you have

selected to install the GUI installer screens vary.

10.

Select the Launch Configuration UI check box to launch the CA Introscope

Integration for CA NSM configuration UI.

The shortcut for the configuration UI is created in the

\and/or on the Windows desktop.

11.

Click Done to complete the installation.

After Introscope Integration for CA NSM has been installed successfully, the

following directory structure is created:

\CAWily_Introscope_NSM_IntegrationPack

More information

Installation Archives(see page 20)

Installation Sets(see page 21)

Features of CA Introscope Integration for CA NSM(see page 21)

Using the CA NSM Configuration UI(see page 35)

Use the Integration Pack Configuration UI

If you use the Introscope Integration Pack GUI installer, the integration pack

configuration user interface opens when the installation is complete if the Launch

Configuration UI check box is selected in the last screen of the wizard. This is applicable

only for the Windows platform.

Use oneof the following methods to launch UI:

Double-click the shortcut icon on the Windows desktop.

Assuming you selected defaults when installing the integration pack, you can also

use the following URL in a browser: http://:8082/CA-Wily-Introscope-NSM-IP/.


25/101

Install using Silent Mode



This section explains how to install the CA Introscope Integration for CA NSM using the

silent installation mode. When installing in silent mode, configuration values are read

from the properties file so no user interaction is required and installation proceeds

unattended.

User configuration values for the silent installer are stored as a set of variables in the

silentInstaller.propertiesfile. You set these variables by editing the

silentInstallerSample.propertiesfile that is provided and renaming it.

Include the full path when executing commands if this file is not located in the same

directory as install.exe. You can save the file with any name to any location.

Note:If the installation fails for any feature or combination of features, the log file, CA

APM_NSM_IntegrationPack_InstallLog.log, is placed on the desktop for Windows. The

log file can be found in the \directory.

Follow these steps:

1. Edit and save the silentInstallerSample.propertiesfile provided in the installation

archive and rename it to silentInstaller.properties.

2.

Use the following command to install in silent mode:

Windows:

install.exe i silent f

If the silent installation fails, a silent.install.failed.txtfile is created. This file provides

more details and is located in the directory where you have launched the installation

from.

More information

Silent Installer Properties(see page 25)

Silent Installer Properties

This section explains the variables in the silentInstallerSample.propertiesfile.

Important!If any variable value is not set correctly, installation can fail or provide

unintended results. Use caution when editing the installer file.

IA_CHOSEN_INSTALL_FEAT, URE_LIST=

Select the features that you want to install.


26/101



To install more than one feature, separate the features with a comma:

IntegrationPackrequired to install the CA Introscope Integration for NSM

feature.

IntegrationNSMrequired to install the Integration for NSM Server feature.

IntegrationPortalrequired to install the Integration for Portal Server feature.

Example:

IA_CHOSEN_INSTALL_FEATURE_LIST=IntegrationPack, Integration NSM

USER_INSTALL_DIR

Installation folder.

When setting paths on Windows systems, the backslash character must be escaped

(doubled). For example:

C:\\Program Files\\CAWily\\IntegrationPack

USER_TOMCAT_INPUT_USER

User name of a valid Tomcat administrator. This value must not be empty.

USER_TOMCAT_INPUT_PWD

Password of a valid Tomcat administrator. This value must not be empty.

USER_TOMCAT_INPUT_CONFIRM_PWD

Provide the same password as for USER_TOMCAT_INPUT_PWD.

USE_SAME_TOMCATUSER_FOR_IP

Set to 1 if you want to use the same Tomcat user credentials for the Integration

Pack user. If not, set to 0.

If set to 1, the following variables are ignored:

USER_IP_INPUT_USER

USER_IP_INPUT_PWD

USER_IP_INPUT_CONFIRM_PWD

USER_IP_INPUT_USER

Valid Integration Pack user name. This value must not be empty and it must not be

the same as the Tomcat user name.

USER_IP_INPUT_PWD

Valid Integration Pack user password. This value must not be empty.

USER_IP_INPUT_CONFIRM_PWD

Provide the same password as for USER_IP_INPUT_PWD.


27/101

Install Using the Console Mode


USER_TOMCAT_CONNECTION_PORT

Tomcat connection port. The default value is 8082.

Note: You can change the connector port number by editing the server.xml in the

WILYNSM_HOME\apache-tomcat-5.5.25\conf directory.

USER_TOMCAT_SHUTDOWN_PORT

Tomcat shutdown port. The default value is 8005.

IA_EM_HOME_DIR

Introscope installation folder.

When setting paths on Windows systems, the backslash character must be escaped

(doubled). For example:

On Windows, it would look like:

C:\\Introscope

USER_INPUT_LAUNCH_UI

Set to 0. This value is used to launch the configuration UI on Windows. However, it

does not launch the configuration UI in silent install mode.

Install Using the Console Mode

This section explains how to install the CA Introscope Integration for CA NSM from the

console.

If the installation fails for any feature or combination of features, the log file, CA

APM_NSM_IntegrationPack_InstallLog.log, is placed on the desktop for Windows. This

file can be found in the \directory.

To install from the console, type the following command:

Windows:install.exe i console

Re-install CA Introscope Integration for CA NSM

Re-installing CA Introscope Integration for CA NSM or any of its features requires a

slight variation in the installation process when you use the GUI Installer for these

features:

CA Introscope Integration for NSM:

You do not have to specify a path for the Installation folder.


28/101

Install on a Machine with an Existing Integration


You do not have to enter administrator credentials for the Tomcat server,

Tomcat ports, or the integration pack user credentials. The Installer obtains the

credentials for the existing integration pack.

The properties file, IscopensmProperties.xml, is preserved.

The Tomcat server requires a restart.

Introscope Integration for NSM Server:


Integration Pack for Portal Server:


When you install CA Introscope Integration for CA NSM on a computer with an existing

integration pack using the console and silent modes, the procedures do not vary.

More Information




Install on a Machine with an Existing Integration

Installing CA Introscope Integration for CA NSM or any of its features on a computerwith an existing integration pack requires a slight variation in the installation process

when you use the GUI Installer for these features:

CA Introscope Integration for NSM:


You do not have to enter administrator credentials for the Tomcat server or

Tomcat ports. The Installer obtains the credentials for the existing integration

pack.

If you select the Use Tomcat Administrator as the Integration Pack user check

box, then you do not have to enter user credentials for the integration pack.

The Installer obtains the user credentials for the existing integration pack. If

you do not select the check box, enter user credentials for the integration pack.

The Tomcat server requires a restart.

Introscope Integration for NSM Server



29/101

Verify the Installation


Integration Pack for Portal Server


When you install CA Introscope Integration for CA NSM on a computer with an existing

integration pack using the console and silent modes, the procedures do not vary.

More Information




Verify the Installation

You can verify that CA Introscope Integration for CA NSM was installed successfully, by

launching the configuration user interface.Using the CA NSM configuration UI(see

page 35).

Uninstall CA Introscope Integration for CA NSM

To remove the CA Introscope Integration for CA NSM, use the Uninstaller.

When you run the executable, all CA Introscope Integration for CA NSM features are

removed except for the Introscope objects. Introscope objects must be removed from

the WorldView repository manually using the Object Browser or ManagementCommand Center.

Follow these steps:

1. Go to

\CAWily_Introscope_NSM_IntegrationPack\CAWily_Introscope_NS

M_IntegrationPack.

2.

Double-click Uninstall CAWily_Introscope_NSM_IntegrationPack.exe.

The Uninstaller launches.

3.

Click Uninstall to remove the CA Introscope Integration for CA NSM.

More information

Remove CA Introscope Objects(see page 30)


30/101



Remove CA Introscope Objects

If you uninstall the CA Introscope Integration for CA NSM, remove CA Introscope

objects from the WorldView repository manually. You can remove from the

Management Command Center or using the Object Browser. However, we recommendthat you use the Management Command Center because you can delete multiple

objects from a class in a single action.

To remove CA Introscope objects from the Management Command Center:

1. Open Management Command Center.

The Management Command Center console page appears.

2.

From the drop-down list in the left pane, select Business Service Views.

3. Right-click Introscope Enterprise Manager and click Delete.

A message appears confirming the action.

4. Select the Delete child objects (irreversible) check box and click Yes.

All CA Introscope objects are deleted.

To delete CA Introscope objects from the Object Browser:

1. Open Object Browser.

2. From the tree view in the left pane select TNGRoot, ManagedObject,

IntroscopeEnterpriseManagers.

The following classes appear:

IntroscopeAgent

IntroscopeAlert

IntroscopeEM

IntroscopeHost

IntroscopeManagementModule

IntroscopeProcess

3. Select a class.

All objects belonging to that class appear in the right-hand pane.

4.

Right-click an object from the right-hand pane and select Delete.

A message appears confirming the action.

5.

Select the Delete child objects check box and click OK.

6.

Repeat the steps necessary to delete an object until all of the objects belonging to aparticular class have been deleted.

After you have deleted all CA Introscope objects from all of the classes, delete the

classes.

7. Use Computer Associates, Unicenter, NSM, WorldView, and Class Wizard to delete

classes.


31/101



8. Select the Modify Existing Class check box.

9. Expand TNGRoot and ManagedObject.

10. Expand IntroscopeEnterpriseManagers.

11.

Select a class.

12. Select Delete Class.

13. Click Yes.

14. Repeat the steps necessary to delete all IntroscopeEnterpriseManagers classes.

15. Exit the system.

After you have deleted all CA Introscope classes, CA Introscope Integration for CA

NSM is uninstalled successfully.


32/101


33/101


Chapter 3: Configuring and Managing

Whats Monitored

This chapter provides instructions for configuring the CA Introscope Integration for CA

NSM.


Overview(see page 33)

Configure the Alternate Bind Address(see page 34)

Configure the Unicenter Management Portal(see page 34)


Configure CA NSM(see page 39)

Overview

After you have installed CA Introscope Integration for CA NSM and its components,

configure its settings using the following web-based configuration GUIs:

CA Introscope Integration for CA NSM configuration UIConfigures the host of

Enterprise Manager, CA NSM WorldView repositories, CA NSM Event Manager,

alerts to monitor, map alert statuses, and format alert messages.

Configuration UI for Unicenter Management PortalConfigures the CA NSM Event

Manager host and CA NSM WorldView repositories for the Portal Manager.

More information


Configure the Unicenter Management Portal(see page 34)

Required Configurations

Before you can use CA Introscope Integration for CA NSM, configure the following

settings:

Configure Introscope Enterprise Manager Host(see page 36)


Configure Monitoring(see page 40)


34/101

Configure the Alternate Bind Address


Configure the Alternate Bind Address

If you deploy the integration pack on an NSM computer with two network cards, yet the

Enterprise Manager has access to only one due to your network configuration, edit the

IscopensmMisc.propertiesfile to specify the alternate bind address of the NSM server to

which the Enterprise Manager has access. The Enterprise Manager is forced to make a

connection to the NSM server on this network card.

Follow these steps:

1.

Go to

\apache-tomcat-5.5.25\webapps\CA-Wily-Introscope-NSM-IP\

WEB-INF\config and open IscopensmMisc.properties.

2.

Edit this property value as follows:

ALTERNATE_BIND_ADDRESS=[the address/hostname to which the Introscope Enterprise

Manager has access].

3.

Restart the Apache Tomcat for CA APM Integration Packs service.

Configure the Unicenter Management Portal

The Unicenter Management Portal displays CA NSM WorldView management data. The

web-based GUI lets you manage data by navigating WorldView objects, viewing alert

statuses, viewing CA Introscope Dashboards, and viewing Enterprise Manager console

messages. However, configure the Unicenter Management Portal.

Follow these steps:

1.

Launch Internet Explorer.

2. Enter the Manage Portal URL and port in the address bar. For example:

http://myumpserver:8090.

3.

Click Task 1. To configure portal to connect to your WV and Enterprise Manager.

The Manage Components page appears.

4. Click Set UKB to configure the Knowledge Base.

The Manage Configuration page appears.

5. Enter the host name in the Knowledge Base host name field and save the

information.The Manage Components page appears.

6. Select the Component check box next to Unicenter Event Management, and then

click the Connection hyperlink to configure the Enterprise Manager connection.


35/101

Using the CA NSM Configuration UI


The Manage Data Sources: Unicenter Event Management page appears.

7. Add the servers and select whether you want it to be the default and save your

settings.

The Manage Components page appears.

8. Select the Component check box next to Unicenter WorldView Management, then

click the Connection hyperlink to configure the WorldView connection.

The Manage Data Sources: Unicenter WorldView Management page appears.

9. Add the servers and select whether you want it to be the default and save your

settings.

The connections are configured.


Configure the following settings with the CA Introscope Integration for CA NSM

configuration GUI:

Configure Introscope Enterprise Manager Host(see page 36).


Configure Monitoring(see page 40)

Configure Message Formatting(see page 41)

Configure Status Mapping(see page 41)

Access the CA Introscope Integration for CA NSM Configuration UI

Use the configuration UI to set CA NSM settings.

To access the configuration UI, go to http://localhost:8082/CA-Wily-Introscope-NSM-IP/

or http://:8082/CA-Wily-Introscope-NSM-IP/ where is the host on which the administration GUI was installed.

More Information



36/101



Configure Introscope Enterprise Manager Host

In the CA NSM Configuration UI, select the Enterprise Managers for which you want to

generate objects or console messages in the WorldView repository.

The arrow icons can be clicked to sort data ascending/descending in its respective

column. The status icon expresses whether the server is connected or disconnected.

The Connection Status represents the Enterprise Manager status:

Unknownthe connection status was not validated when the information was

entered, and its status is unknown. If you click Refresh Status or select another tab

in the business application, the connection status updates to Connected or

Disconnected.

Connected the Enterprise Manager is up and the Integration Pack service is able

to connect to it.

Disconnectedthe Integration Pack service is unable to connect to the EnterpriseManager. The Enterprise Manager is either down or wrongly defined, meaning the

credentials or Enterprise Manager host entered was not valid.

More Information

Add an Introscope Enterprise Manager Host(see page 36)

Delete an Introscope Enterprise Manager Host(see page 37)

Edit an Introscope Enterprise Manager Host(see page 38)

Add an Introscope Enterprise Manager Host

Add an Enterprise Manager host if you want to generate objects or messages for its

monitored alerts.

Follow these steps:

1.

From the CA Introscope Integration for CA NSM configuration UI, select the

Introscope Enterprise Manager Hosts Configuration tab.

2. Click Add.

The Add Enterprise Manager Host page opens.

3.

Enter the information for the required and optional settings:

Host (required)

The name of the computer hosting the Enterprise Manager host and with the

Web Services SDK installed.


37/101



Web Server Port (required)

The web server port as specified in the Enterprise Manager configuration file.

User (required)

The user name of the person assigned credentials to the Enterprise Manager.

This user also needs Web Services access.

Password

The password, if applicable, of the user who has been assigned a user name for

the Enterprise Manager.

Enable WorldView Updates

Enables the creation of CA NSM WorldView repository objects from monitored

alerts. To create the objects in CA NSM, the CA NSM WorldView Repository

credentials must be specified on the CA NSM Configuration tab. Configure CA

NSM.

Enable Console Message Updates

Enables console message updates and generates CA NSM Event Console

messages from monitored alerts. To receive alert notifications on the CA NSM

console, the CA NSM Enterprise Manager host must be specified on the CA

NSM Configuration tab. Configure CA NSM.

4. Click one of the available buttons on the right-hand pane:

Validate Connection to verify the credentials that are provided have Web

Service access.

The Validate Connection button only validates the connection. Click OK to add

the Enterprise Manager host.

OK to add the Enterprise Manager host information and return to the previous

page that lists all Enterprise Manager hosts.

An Enterprise Manager Host with an Unknown status is initially added. As you

begin to use the business application or if you click refresh, the credentials are

verified. The status now changes to Connected assuming the credentials are

valid.

Cancel to refrain from adding any Enterprise Manager host details and return

to the previous page.

Delete an Introscope Enterprise Manager Host

Delete an Enterprise Manager host if you no longer want to generate objects or

messages for its monitored alerts.

Follow these steps:

1. From the CA Introscope Integration for CA NSM configuration UI, select the



38/101



2. Use the check boxes to select the Enterprise Manager host you want to delete.

3. Click the Delete hyperlink in the table header.

A confirmation message appears to verify the action.

4.

Click Yes.

Edit an Introscope Enterprise Manager Host

You can edit the Enterprise Manager Host details.

Follow these steps:

1. From the CA Introscope Integration for CA NSM configuration UI, select the


2.

Click the host name hyperlink in the Host column of the Introscope Enterprise

Managers.

3. Edit any of the necessary details that are entered when the host was added. For

more information.

4.

Click any of the following buttons in the right-hand pane to:

Validate Connection to verify the credentials that are provided have Web

Service access.

The Validate Connection button only validates the connection. Click OK to add

the Enterprise Manager host.

OK to add the Enterprise Manager host information and return to the previous

page that lists all Enterprise Manager hosts.

An Enterprise Manager hosts with an Unknown status is initially added. As youbegin to use the business application or if you click refresh, the credentials are

verified. The status is now changed to Connected assuming the credentials are

valid.

Cancel to refrain from adding any Enterprise Manager host details and return

to the previous page.

More information

Add an Introscope Enterprise Manager Host(see page 36)


39/101

Configure CA NSM


Configure CA NSM

In the CA Introscope Integration for CA NSM configuration UI, configure CA NSM. After

you configure this setting, the CA NSM WorldView repository creates a business service

view named Enterprise Managers.This view contains CA Introscope objects that are

generated from CA Introscope alerts you choose to monitor. If WorldView updates for

an Introscope Enterprise Manager host are enabled in the Introscope Enterprise

Manager Hosts Configuration tab, then the NSM connection information must be

provided.

More Information

Edit the NSM Enterprise Manager Host(see page 39)

Edit the NSM WorldView Repository(see page 39)

Edit the NSM WorldView Repository

In the CA Introscope Integration for CA NSM configuration UI, edit the connection

information for the NSM WorldView repository. A business service view named

Enterprise Managers contains CA Introscope objects that are generated from CA

Introscope alerts you choose to monitor in this repository.

Follow these steps:

1. From the CA Introscope Integration for CA NSM configuration UI, select the CA

NSM Configuration tab.

2.

Click Edit.

3. Update the necessary fields.

4. Click OK to apply the settings or Cancel to return to the previous page.

Edit the NSM Enterprise Manager Host

In the CA Introscope Integration for CA NSM configuration UI, edit the NSM host

information. The NSM Enterprise Manager host contains Event Console messages

generated from CA Introscope alerts you choose to monitor.

Follow these steps:

1.

From the CA Introscope Integration for CA NSM configuration UI, select the CA

NSM Configuration tab.

2. Click Edit.

3.

Update the necessary fields.


40/101

Configure CA NSM


4. Click OK.

Configure Monitoring

In the CA Introscope Integration for CA NSM configuration UI, select which alerts to

monitor. The alert creates objects in the NSM WorldView repository and generate

messages in the NSM Enterprise Manager Console. The items that are displayed on this

page are only the management modules and alerts that are set to active in CA

Introscope.

Follow these steps:

1. Select the Monitoring Tab from the CA Introscope Integration for CA NSM

configuration UI.

2.

Use the check boxes to select the alerts you want to monitor.

Note: CA NSM cannot import alerts that use Unicode characters. For these objectsto be viewed in CA NSM, their names must be changed to use only ascii characters.

For more information about this issue, see Knowledge Base Article TEC534282

https://support.ca.com/irj/portal/anonymous/redirArticles?reqPage=search&searc

hID=TEC534282.

3. Click oneof the available buttons:

Saveto monitor Enterprise Managers, Management Modules, and Alerts,

which are saved in the configuration file and can be viewed in the Management

Command Center. The selected Enterprise Managers, Management Modules,

and Alerts can be viewed in NSM Management Command Center. If an

Enterprise Manager or Management Module is deselected, it appears as

unknown in NSM. Likewise, if a Management Module or alert was previouslyselected and is deselected, it appears as unknown in NSM.

Note: You can view only simple alerts in the Monitor tab.

If you do not see the list of Management Modules under an Enterprise

Manager name, then set the

"introscope.alerts.extension.managementmodules.enable" property in the

IntroscopeEnterpriseManager.properties file. For more information, see the

"Configure the alerts extension" in the CA Application Performance

Management API Reference Guide.

Resetto reset the tree elements to their default values or a previous state.

Refreshto get the updated information about the Enterprise Manager,

Management Module, and alerts from the corresponding Enterprise Manager.

If new alerts or management modules are added to the Enterprise Manager

after starting the integration pack. Refresh the page to get the most recent

information.
https://support.ca.com/irj/portal/anonymous/redirArticles?reqPage=search&searchID=TEC534282https://support.ca.com/irj/portal/anonymous/redirArticles?reqPage=search&searchID=TEC534282https://support.ca.com/irj/portal/anonymous/redirArticles?reqPage=search&searchID=TEC534282https://support.ca.com/irj/portal/anonymous/redirArticles?reqPage=search&searchID=TEC534282https://support.ca.com/irj/portal/anonymous/redirArticles?reqPage=search&searchID=TEC534282https://support.ca.com/irj/portal/anonymous/redirArticles?reqPage=search&searchID=TEC534282


41/101

Configure CA NSM


Configure Message Formatting

Message formatting lets you specify the format of the alert string and set the data

source value. Formatting replaces certain characters to ease the parsing of the alert in

the NSM Event Console.

Follow these steps:

1.

From the CA Introscope Integration for CA NSM configuration UI, select the

Message Formatting tab.

2. Enter the data source value in the Console Message Source field.

Identifies the source of the message to the Event Console. The console message is

prefixed with a string that helps identify the source of the message on the NSM

Event Console. The default value is WilyAgent.

3.

Enter the format using a mix of text and parameters in the Format field.

Click next to Console Message Parameter Help to expand help on the

parameters available for use in the Console Message Format. This format is used

when generating NSM Enterprise Manager console messages from monitored CA

Introscope alerts. The parameters are replaced with corresponding data from the

alert being used to generate the console message. If you manipulate message

parameters and there are spaces within the parameter tags ("%" and "%"), that

string is not considered when checking for valid parameters.

4. Enter strings to exclude in the Strings to Omit field.

These strings are omitted from the variable values that are substituted in the

message.

5. Click Generate Sample Message Output to verify that the message format appears

as you have specified.

If you decide not to apply the new message format, click Set to Defaultto reapply

the default format.

Configure Status Mapping

Use this page to map the CA Introscope alert status to the corresponding NSM status

and severity. The mappings apply to all alerts, rather than to a specific management

module or alert.

For example, if you apply the default settings, and the status of CA Introscope alertsturned Critical, they appear as red objects in 2D Map of CA NSM and Management

Command Center, and are reported with an Error severity in Enterprise Manager

console message of CA NSM.


42/101

Configure CA NSM


The default settings are:

Introscope Alert

Status

NSM Managed

Object Status

NSM Event Console

Message Severity

NSM Event Console

Message Color

Normal Normal Success GreenWarning Warning Warning Yellow

Critical Critical Error Red

Unknown Unknown Informational Black

If you choose to change the default settings, the options are as follows:

Introscope Alert Status

Normal

Warning

Critical

Unknown

NSM Settings

NSM Managed Object Status

Normal

Warning

Critical

Unknown

Major Minor

Down

NSM Event Console Message Severity

Success

Informational

Warning

Error

NSM Event Console Message Color

Black

Red

Orange

Yellow


43/101


44/101


45/101


Chapter 4: Using CA Introscope

Integration for CA NSM


View CA Introscope objects in Management Command Center(see page 45)

View CA Introscope Objects in the Unicenter Management Portal(see page 47)

View CA Introscope Objects in CA NSM WorldView 2D Map(see page 48)

View CA Introscope Alerts in the CA NSM Event Console(see page 49)

View CA Introscope objects in Management Command Center

The Management Command Center (available with CA NSM version 11.1 sp1 or higher)

provides a hierarchical tree structure for viewing CA Introscope objects. The objects

can be visualized in an infrastructure hierarchy or custom created business service views

hierarchy.

Each monitored object has a set of properties and an associated status. The child object

status propagates up the tree to their parent objects. The parent objects inherit the

worst status of the children objects.

The default class level hierarchy that is published from CA Introscope to CA NSM is as

follows:

ManagedObject

IntroscopeEnterpriseManagersIntroscopeEM

IntroscopeManagementModule

IntroscopeHost

IntroscopeProcess

IntroscopeAgent

IntroscopeAlert

More information:

Configure Status Mapping(see page 41)

View Introscope Objects in the Management Command Center Tree Hierarchy(see page

46)

View Dashboards of CA Introscope Objects in the Management Command Center(see

page 46)

View CA Introscope Alerts in the Management Command Center Event Console(see

page 47)


46/101

View CA Introscope objects in Management Command Center


View Introscope Objects in the Management Command Center Tree Hierarchy

You can view CA Introscope objects in the Management Command Center Tree

Hierarchy. Use the following options to view objects in a tree hierarchy:

Objects appear in various states in the Management Command Center tree hierarchy

that is based on the following rules:

After you have installed and started the integration pack, objects for the

management modules you chose to monitor will appear with a Normalstatus under

their respective Enterprise Managers if the WorldView update is enabled.

If you monitor a new Management Module, it appears in the Management

Command Center and its status is Normal. The status remains Normaluntil an alert

is triggered for the management module.

If a Management Module is enabled for monitoring, it appears in the Management

Module with a Normal status. If the Management Module has alerts, it assumes the

status of the alert being monitored with the most critical status.

If you turn off Management Module monitoring, the Management Module objects

have an Unknown status in the Management Command Center.

If you turn on Management Module monitoring, the Management Module objects

have a Normal status in Management Command Center.

If the integration pack is disconnected, all Management Module objects have an

Unknown status.

Follow these steps:

1. Start NSM, MCC.

The Management Command Center console page appears.

2. Select Business Service Views from the drop-down list in the left pane to see the

business service view nodes.

3.

Right-click Introscope Enterprise Manager objects to see what menu items are

available.

4. Select different views from the right pane to explore CA Introscope objects in

different ways.

View Dashboards of CA Introscope Objects in the Management Command Center

You can view dashboards of CA Introscope objects in the Management Command

Center using the following options.

Follow these steps:


47/101

View CA Introscope Objects in the Unicenter Management Portal


1. Select Business Service Views from the drop-down list in the left pane.

2. Select the Introscope Enterprise Managers node, Introscope Management Module

node, Introscope Agent node, or Introscope Alert node.

3.

Select the corresponding Introscope dashboard from the drop-down list in the rightpane:

Introscope Enterprise Management Node

Introscope Enterprise Manager Dashboard

Introscope Management Module Node

Introscope Management Module Dashboard

Introscope Agent Node

Introscope Agent Dashboard

Introscope Alert Node

Introscope Alert Dashboard

The dashboard for SiteMinder reporter appears.

View CA Introscope Alerts in the Management Command Center Event Console

Use this option to view CA Introscope Alerts in the Management Command Center

Event Console.

Follow these steps:

1.

Start NSM, MCC.

2. Select Enterprise Management from the drop-down menu in the left pane.

3. Select Event Management, Console Logs.

4.

Click the Launch Console Logs from the right pane.

View CA Introscope Objects in the Unicenter Management

Portal

The Unicenter Management Portal provides a role-based, personalized, and

consolidated view of Unicenter WorldView managed objects using a web portal

interface. Using Unicenter Management Portal, you can navigate to Introscope

WorldView objects, view object severities, Introscope Dashboards, and Event Console

messages.


48/101

View CA Introscope Objects in CA NSM WorldView 2D Map


Follow these steps:

1. Verify that you have installed the Integration Pack for Portal Server.

2. Open a web browser and enter the Unicenter Management Portal URL and port in

the address bar. For example:

http://myumpserver:8090

3. Select the Knowledge tab and then the Library tab.

4.

Select Enterprise Management, Unicenter Event Management, Event Console from

the tree in the left pane.

View Event Console messages in the right pane.

From this view:

Click the Log Messages tab to view more details.

Select a message in the bottom pane and click Go to view more details.

Select Business Processes from the left pane and navigate through to see all

Business Service Views for a summary view of Introscope WorldView objects.

From the Unicenter Management Portal View:

Click the Portal Explorer button next to the Introscope Enterprise Managers

BPV in the right pane to open the Portal Explorer.

Navigate to the Introscope objects in the left pane to view more details.

Select an Introscope object from the left pane and click Go to see the available

dashboards:

Introscope Enterprise Manager Dashboard

Introscope Management Module Dashboard

Introscope Agent Dashboard

Introscope Alert Dashboard

View CA Introscope Objects in CA NSM WorldView 2D Map

CA NSM WorldView 2D Map provides a visual tool for exploring CA Introscope objects.

Follow these steps:

1.

Start NSM, WorldView, 2D Map.

2. Double-click objects to see the next level of details.

The WorldView 2D Map window appears.


49/101

View CA Introscope Alerts in the CA NSM Event Console


From this view, you can right-click an CA Introscope object and can select the

Investigate options. The corresponding CA Introscope dashboard appears in a new

window.

View CA Introscope Alerts in the CA NSM Event Console

The CA NSM Event Console lets you monitor the status of events, respond to abnormal

events as they occur, and rectify critical situations immediately. The console organizes

the events in pages that you can navigate. The console has the returned view of events.

You can filter and search for specific events from this view.

Follow these steps:

1. Start NSM, Enterprise Management, Enterprise Manager Classic.

2. Double-click Windows, Event, Console Logs to view log messages.

The

Documents

APM_9.5 NSM Integration Guide