APM_9.5 NSM Integration Guide
-
Upload
ggenmailru -
Category
Documents
-
view
251 -
download
0
Transcript of 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
-
8/12/2019 APM_9.5 NSM Integration Guide
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
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)
-
8/12/2019 APM_9.5 NSM Integration Guide
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)
-
8/12/2019 APM_9.5 NSM Integration Guide
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 -
8/12/2019 APM_9.5 NSM Integration Guide
6/101
-
8/12/2019 APM_9.5 NSM Integration Guide
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/12/2019 APM_9.5 NSM Integration Guide
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
-
8/12/2019 APM_9.5 NSM Integration Guide
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
-
8/12/2019 APM_9.5 NSM Integration Guide
10/101
10 Integration for CA NSM Guide
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
-
8/12/2019 APM_9.5 NSM Integration Guide
11/101
Chapter 1: Introduction 11
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).
-
8/12/2019 APM_9.5 NSM Integration Guide
12/101
Architecture Diagram
12 Integration for CA NSM Guide
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
13/101
Benefits
Chapter 1: Introduction 13
Simplifies monitoring processes by allowing business application performance alerts
from CA Introscope to participate in centralized correlation, notification, and
resolution processes.
-
8/12/2019 APM_9.5 NSM Integration Guide
14/101
-
8/12/2019 APM_9.5 NSM Integration Guide
15/101
Chapter 2: Installing CA Introscope Integration for CA NSM 15
Chapter 2: Installing CA Introscope
Integration for CA NSM
This section contains the following topics:
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).
-
8/12/2019 APM_9.5 NSM Integration Guide
16/101
Remove the Integration Pack from the Enterprise Manager
16 Integration for CA NSM Guide
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
17/101
Remove the Integration Pack from Unicenter Management Portal
Chapter 2: Installing CA Introscope Integration for CA NSM 17
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
18/101
Remove the Introscope Web Services API/SDK 7.2
18 Integration for CA NSM Guide
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).
-
8/12/2019 APM_9.5 NSM Integration Guide
19/101
Feature Prerequisites
Chapter 2: Installing CA Introscope Integration for CA NSM 19
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
Windows Server 2003 operating system
Management Command Center (included with 11.1 SP1 or higher)
Integration for Portal Server
Windows Server 2003 operating system
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
20/101
Installation Archives
20 Integration for CA NSM Guide
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
These files are applicable only to the Windows platform. They are required to install
the Integration for NSM Server.
IntroscopeIntegrationPortal.zip
These files are applicable only to the Windows platform. They are required to install
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
Install using Silent Mode(see page 25)
-
8/12/2019 APM_9.5 NSM Integration Guide
21/101
Installation Sets
Chapter 2: Installing CA Introscope Integration for CA NSM 21
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
22/101
User Rights
22 Integration for CA NSM Guide
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)
Install using Silent Mode(see page 25)
-
8/12/2019 APM_9.5 NSM Integration Guide
23/101
Install using the GUI Installer
Chapter 2: Installing CA Introscope Integration for CA NSM 23
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
24/101
Install using the GUI Installer
24 Integration for CA NSM Guide
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/.
-
8/12/2019 APM_9.5 NSM Integration Guide
25/101
Install using Silent Mode
Chapter 2: Installing CA Introscope Integration for CA NSM 25
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
26/101
Install using Silent Mode
26 Integration for CA NSM Guide
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
27/101
Install Using the Console Mode
Chapter 2: Installing CA Introscope Integration for CA NSM 27
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
28/101
Install on a Machine with an Existing Integration
28 Integration for CA NSM Guide
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:
You do not have to specify a path for the Installation folder.
Integration Pack for Portal Server:
You do not have to specify a path for the Installation folder.
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 using the GUI Installer(see page 23)
Install Using the Console Mode(see page 27)
Install using Silent Mode(see page 25)
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 specify a path for the Installation folder.
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
You do not have to specify a path for the Installation folder.
-
8/12/2019 APM_9.5 NSM Integration Guide
29/101
Verify the Installation
Chapter 2: Installing CA Introscope Integration for CA NSM 29
Integration Pack for Portal Server
You do not have to specify a path for the Installation folder.
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 using Silent Mode(see page 25)
Install Using the Console Mode(see page 27)
Install using the GUI Installer(see page 23)
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)
-
8/12/2019 APM_9.5 NSM Integration Guide
30/101
Uninstall CA Introscope Integration for CA NSM
30 Integration for CA NSM Guide
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
31/101
Uninstall CA Introscope Integration for CA NSM
Chapter 2: Installing CA Introscope Integration for CA NSM 31
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
32/101
-
8/12/2019 APM_9.5 NSM Integration Guide
33/101
Chapter 3: Configuring and Managing Whats Monitored 33
Chapter 3: Configuring and Managing
Whats Monitored
This chapter provides instructions for configuring the CA Introscope Integration for CA
NSM.
This section contains the following topics:
Overview(see page 33)
Configure the Alternate Bind Address(see page 34)
Configure the Unicenter Management Portal(see page 34)
Using the CA NSM Configuration UI(see page 35)
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
Using the CA NSM Configuration UI(see page 35)
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 CA NSM(see page 39)
Configure Monitoring(see page 40)
-
8/12/2019 APM_9.5 NSM Integration Guide
34/101
Configure the Alternate Bind Address
34 Integration for CA NSM Guide
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
35/101
Using the CA NSM Configuration UI
Chapter 3: Configuring and Managing Whats Monitored 35
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.
Using the CA NSM Configuration UI
Configure the following settings with the CA Introscope Integration for CA NSM
configuration GUI:
Configure Introscope Enterprise Manager Host(see page 36).
Configure CA NSM(see page 39)
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
Install using the GUI Installer(see page 23)
-
8/12/2019 APM_9.5 NSM Integration Guide
36/101
Using the CA NSM Configuration UI
36 Integration for CA NSM Guide
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
37/101
Using the CA NSM Configuration UI
Chapter 3: Configuring and Managing Whats Monitored 37
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
Introscope Enterprise Manager Hosts Configuration tab.
-
8/12/2019 APM_9.5 NSM Integration Guide
38/101
Using the CA NSM Configuration UI
38 Integration for CA NSM Guide
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
Introscope Enterprise Manager Hosts Configuration tab.
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)
-
8/12/2019 APM_9.5 NSM Integration Guide
39/101
Configure CA NSM
Chapter 3: Configuring and Managing Whats Monitored 39
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
40/101
Configure CA NSM
40 Integration for CA NSM Guide
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 -
8/12/2019 APM_9.5 NSM Integration Guide
41/101
Configure CA NSM
Chapter 3: Configuring and Managing Whats Monitored 41
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
42/101
Configure CA NSM
42 Integration for CA NSM Guide
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
-
8/12/2019 APM_9.5 NSM Integration Guide
43/101
-
8/12/2019 APM_9.5 NSM Integration Guide
44/101
-
8/12/2019 APM_9.5 NSM Integration Guide
45/101
Chapter 4: Using CA Introscope Integration for CA NSM 45
Chapter 4: Using CA Introscope
Integration for CA NSM
This section contains the following topics:
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)
-
8/12/2019 APM_9.5 NSM Integration Guide
46/101
View CA Introscope objects in Management Command Center
46 Integration for CA NSM Guide
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:
-
8/12/2019 APM_9.5 NSM Integration Guide
47/101
View CA Introscope Objects in the Unicenter Management Portal
Chapter 4: Using CA Introscope Integration for CA NSM 47
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
48/101
View CA Introscope Objects in CA NSM WorldView 2D Map
48 Integration for CA NSM Guide
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.
-
8/12/2019 APM_9.5 NSM Integration Guide
49/101
View CA Introscope Alerts in the CA NSM Event Console
Chapter 4: Using CA Introscope Integration for CA NSM 49
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