VoyenceControl Integration Module - Dell...Installing NNM Integration Module Client-Side Components...

EMC® VoyenceControl Integration Module

version 4.1.0

HP OpenView Network Node Manager (NNM)

GuideP/N 300-008-460

REV A01

EMC CorporationCorporate Headquarters

Hopkinton, MA 01748-91031-508-435-1000www.EMC.com

Integration Module for NNM

Integration Module Network Node Manager Version 4.1.0

COPYRIGHT

Copyright © 2009 EMC Corporation. All rights reserved.

Published June 2009

EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED "AS IS." EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.

For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.

All other trademarks used herein are the property of their respective owners.



TABLE OF CONTENTS

COPYRIGHT...................................................................................................................... 2

TABLE OF CONTENTS........................................................................................................ 3

INSTALLING THE NETWORK NODE MANAGER INTEGRATION MODULE ............................. 4 System and Platform Requirements ...................................................................................................4

VoyenceControl 4.1.0 ..................................................................................................................................... 4 Installing the NNM Integration Module Server-Side Components............................................................5 Installing the NNM Integration Module Client-Side Components .............................................................5

Introduction .................................................................................................................................................. 5 Prepare for installation.................................................................................................................................... 5 Run the Installer (Unix) .................................................................................................................................. 5 Run the Installer (Windows) ............................................................................................................................ 5 Installed Components ..................................................................................................................................... 6 Verifying Installation ...................................................................................................................................... 7 Additional Documentation ............................................................................................................................... 7 Uninstalling ................................................................................................................................................... 8

NNM Integration Module Client-Side Components ................................................................................8 Introduction .................................................................................................................................................. 8 VoyenceControl Traps..................................................................................................................................... 8 VoyenceControl Events ................................................................................................................................... 8 VoyenceControl Launch................................................................................................................................... 9 Event De-duplication ...................................................................................................................................... 9

NNM Client-Side Integration Module on Windows Server 2003...............................................................9 Installing the NNM Client-Side Integration Module on Windows Server 2003 ...........................................9

Verifying the Installation ................................................................................................................................13 Installing the Client-Side Integration Module on a Server.................................................................... 17 Uninstalling the NNM Client-Side Integration Module .......................................................................... 20

WHERE TO GET HELP ...................................................................................................... 22 Where to get help .......................................................................................................................... 22

INDEX ............................................................................................................................ 23



INSTALLING THE NETWORK NODE MANAGER INTEGRATION MODULE

This section describes the features of the VoyenceControl Network Node Manager (NNM) Integration Module. Specifically, the following sections are detailed:

Installing NNM Integration Module Server-side Components

Installing NNM Integration Module Client-Side Components

The NNM Integration Module Server-side Component provides the capability of listening for VoyenceControl events, transforming the events into SNMP traps, and then sending the traps to a SNMP trap listener.

System and Platform Requirements

VoyenceControl 4.1.0

Supported Operating Systems:

o Red Hat Enterprise Linux 4 and 5

o Windows Server 2003

o Solaris 10



Installing the NNM Integration Module Server-Side Components

Install the Server-side Component of the NNM Integration Module by running the Generic SNMP Integration Module.

1. Refer to the EMC VoyenceControl Integration Modules Installation and Configuration Guide document for Generic SNMP Integration Module installation instructions.

2. During the installation, the system prompts you to enter the name of the product you are integrating with. Enter NNM at the prompt.

Installing the NNM Integration Module Client-Side Components

Introduction You will be installing the NNM Integration Module Client-side Components. This provides the capability to view properly formatted SNMP traps sent from the NNM Integration Module Server-side Components, as well as launch the VoyenceControl Graphical User Interface from Network Node Manager.

Prepare for installation To install the client-side components, you must have a properly configured Network Node Manager

installation. Refer to the Network Node Manager Installation documentation for those prerequisites.

You must have a properly installed and configured Java V1.4.1 (or higher) environment. Use the java -fullversion command to determine the Java version currently installed. The client-side components do not require any additional hardware requirements beyond those required by the Network Node Manager and Java installations.

You should have a properly configured VoyenceControl server available. Note that you will not need a User ID or password to complete the installation.

It is advisable that you shutdown all Network Node Manager services prior to installation. During installation, several additions are made to the trapd.conf file. By shutting down the Network Node Manager services, you can ensure there are no resource contentions during the installation.

1. Change the directory where you placed the installer file. 2. Type: chmod 755 VoyenceControl_x_x_x_yyy_HPNNM_Client.bin to change the permissions on

the installer file to allow execution (Unix only), where x_x_x stands for the version number, and yyy stands for the build number.

Run the Installer (Unix) 1. Type the following command from the directory where you placed the installer file:

VoyenceControl_x_x_x_yyy_HPNNM_Client.bin, where x_x_x stands for the version number, and yyy stands for the build number.

2. Respond to each activity displayed on the Install Wizard. 3. When the installation is complete, you can delete the installer file to recover disk space. 4. Note that to view the documentation as part of the post-installation steps you must have the following

browser available in the PATH environment variable, based on the platform you are installing: Unix - Netscape

Linux - Mozilla

Run the Installer (Windows)

1. Select Start->Run from the task bar, and select Browse. 2. Navigate to the directory where you placed the installer file, and double-click

VoyenceControl_x_x_x_yyy_HPNNM_Client.exe, where x_x_x stands for the version number, and yyy stands for the build number.

3. Select OK. 4. Respond to each activity displayed on the Install Wizard. 5. When the installation is complete, you can delete the installer file to recover disk space.



Installed Components The following items make up the NNM Integration Module client-side installation.

Note that <install_dir> refers to the installation location of the client-side components, and <nnm_install_dir> refers to the NNM installation directory.

Installed Files

File Description Location

runVoyence.[bat|sh] Script that supports the Application Registration File

<install_dir>/bin

runClient.[bat|sh] Script that supports the additional action

<install_dir>/bin

runClient.cmd Script that supports the additional action (Windows only)

<install_dir>/bin

auth.conf JAAS configuration file required by VoyenceControl UI

<install_dir>/conf

VOYENCE-TRAP-MIB VoyenceControl MIB definition file

<install_dir>/conf

NnmClientSide.html Client-side component documentation

<install_dir>/docs

In addition to the above installed files, these additional modifications take place.

Installation Actions

Action Method Description

Load VoyenceControl MIB xnmloadmib -load Makes available all supported VoyenceControl traps and supporting trap data.

Load VoyenceControl EVENTS to trapd.conf

xnmevents -load Provides for properly formatted VoyenceControl traps displayed in the NNM Alarm Browser.

Creation of VoyenceControl Alarm category

xnmevents -load Facilitates displaying all VoyenceControl EVENTS in an application-specific browser, as well providing filtering capabilities.

Creation of a Launch VoyenceControl additional action

xnmevents -load Facilitates launching the VoyenceControl client by selecting an event in the Alarm Browser.

Creation of a VoyenceControl menu item in the NNM Tools menu

Creation of Application Registration File

Facilitates launching the VoyenceControl client by selecting Tools-> VoyenceControl NG



Verifying Installation After the installer completes, you can verify the installation (if desired) by completing the following steps:

1. From any Network Node Manager sub-map window, select Tools. You should see a Network Configuration Manager menu item.

2. From any Network Node Manager sub-map window, select Tools->SNMP MIB Browser. Then, double-click Private and Enterprises. Voyence is listed.

3. From any Network Node Manager sub-map window, select Options->Event Configuration. voyence (Enterprise ID .1.3.6.1.4.1.6615) listed in the Enterprise Identification window. You may need to scroll the window. Selecting voyence populates the Event Identification window with all the VoyenceControl events.

From the Event Configuration window, complete the following:

On Solaris

Select Edit->Configure->Alarm Categories.

On Windows

Select Edit->Alarm Categories.

A VoyenceControl NG Alarms category is displayed.

From the Event Configuration window, complete the following:

On Solaris

Select Edit->Configure->Additional Actions.

On Windows

Select Edit->Additional Actions.

You should see a Launch VoyenceControl NG action. (You may need to scroll down the window.)

Additional Documentation

After you have successfully installed the client-side components, you can read additional documentation specified in the following file:

<install_dir>/docs/NnmClientSide.html



Uninstalling

1. To uninstall the client-side components, issue the following command (preferably from a directory other than <install_dir>): <install_dir>/_uninst/uninstaller

2. After the uninstaller has completed successfully, manually remove the VoyenceControl Alarms category, and the launch VoyenceControl additional action, via the VoyenceControl user interface. This manual step is required, as the Network Node Manager does not provide a programmatic or command-line means for removing categories and additional actions. The following steps will remove the NCM Alarms category:

On Solaris

1. Access the Event Configuration dialog box from any Alarm Browser window (Actions:Configure Event), or from any submap (Options:Event Configuration).

2. From the Event Configuration menu bar, click Edit:Configure:Additional Actions. The Additional Actions window appears.

3. Select the Launch VoyenceControl NG additional action, and then click Delete. 4. In the Event Configuration window, click File:Save to save the changes.

On Windows

1. Access the Event Configuration dialog box from any Alarm Browser window (Actions:Configure Event), or from any submap (Options:Event Configuration).

2. From the Event Configuration menu bar, click Edit:Additional Actions. The Additional Actions window displays.

3. Select the Launch VoyenceControl NG additional action, and then click Delete. 4. In the Event Configuration window, click File:Save to save the changes.

Note: If you do not complete these steps and re-install the client-side components, the VoyenceControl Alarms category and the Launch VoyenceControl additional actions that exist in the trapd.conf file from the previous install are reused.

NNM Integration Module Client-Side Components

Introduction You have already installed the VoyenceControl Network Node Manager (NNM) Integration Module client-side components.

This provides the capability to view properly formatted SNMP traps sent from the NNM Integration Module server-side components, as well as launch the VoyenceControl UI from Network Node Manager.

VoyenceControl Traps Details of the VoyenceControl trap definitions can be inspected by selecting Options->Event Configuration, and then the Voyence Enterprise. This provides the complete list of Events.

VoyenceControl Events As part of the client-side installation, a properly formatted VoyenceControl event configuration file is loaded into the existing trapd.conf file, via xnmevents -load. This process creates Event blocks for each of the supported VoyenceControl traps.

Each Event block includes a directive to have the Event displayed in the VoyenceControl Alarm category, a default Event severity, a format directive that ensures that the Event is displayed in an easy-to-read format, and SDESC section that provides additional details regarding what can cause the Event to be received, along with instruction text.

Details of the VoyenceControl Event definitions can be inspected by selecting Options->Event Configuration, and then selecting the HP Enterprise. This provides the complete list of Events.



VoyenceControl Launch There are two methods to launch the VoyenceControl UI:

Method 1 involves selecting the Tools-> VoyenceControl menu item. This method launches Network Configuration Manager to the default initial view. You will be required to provide a valid user name and password on VoyenceControl UI startup.

Method 2 involves invoking an additional action on a VoyenceControl event that has been received in the Alarm Browser. After highlighting the desired event, select Actions->Additional Actions, from the Alarm Browser menu, and then select Launch Network Configuration Manager. The current version of the installation will also launch VoyenceControl to the default view.

Event De-duplication The client-side installation includes an event de-duplication configuration file found under <install_dir>/conf/dedup.conf. This file contains all the correct de-duplication rules for each VoyenceControl SNMP trap event.

To de-duplicate any VoyenceControl events in Network Node Manager, one or more items from this file can be added to the dedup.conf file of the Network Node Manager installation, using your favorite editor.

Typically, the Network Node Manager dedup.conf file can be found in the following locations:

On Solaris

/etc/opt/OV/share/conf

On Windows

c:\Program Files\HP OpenView\NNM\conf

Note: For NNM 7.5.x on Windows, the path is: c:\Program Files\HP OpenView\conf.

It is recommended that if the VoyenceControl Network Node Manager Integration Module has been configured to listen for the AuthorizationSucceededEvent, the voyenceEventUserAuthorizationSucceeded event be de-duplicated, as this event occurs often during normal VoyenceControl usage.

NNM Client-Side Integration Module on Windows Server 2003

This document will help when installing or uninstalling the VoyenceControl NNM Integration Module on a Windows server and the Linux server. This document is best viewed in MS Word’s Web Layout View.

Installing the NNM Client-Side Integration Module on Windows Server 2003

Follow the installation steps in the “NNM Client-Side Installation Notes” section. The following screen-shots are the steps referenced in that document.

These steps and screen-shots were taken from a Windows Server 2003 SP4, running Windows Release B.07.01.



1. Run the install program from Windows. 2. Click Next.

Integration Module for NNM 3. Click Next.

The defaults are listed below on the left. For NNM 7.5.x, you will need to change these to the ones shown on the right. (For example, remove the "\NNM\" part from the default directories.)

C:\Program Files\voyence\NNM => C:\Program Files\voyence

C:\Program Files\voyence\NNM\bin => C:\Program Files\voyence\bin

4. Click Next.

5. Enter the IP address of the VoyenceControl server, (for example, enter 192.168.87.8). 6. Click Next.




7. Click Next.

8. The installer will run. Select Yes to restart the computer. 9. Click Next.



The server now reboots.

10. Login, and start the Network Node Manager using: Start / Programs / Voyence / Network Node Manager Node Admin / Network Node Manager.

Verifying the Installation

1. From any sub-menu (shown here as the Internet window) - select Tools, then select SNMP MIB Browser.

2. Ensure that voyence is listed under the private – enterprises section as shown below. Close this window once you verify that voyence is listed.



3. From the Internet window, select Options, then select Event Configuration.

4. From the Event Configuration window, ensure that voyence is listed in the Enterprises pane, then select Edit, then select Alarms Categories.



5. Ensure that NCM Alarms is listed.

6. Close the Alarm Categories window. 7. From the Event Configuration window, select Edit, then select Additional Actions.

Integration Module for NNM 8. From the Edit Additional Actions window, make sure that Launch NCM is listed.

9. This completes the installation. You can now close the Edit Additional Actions and the Internet windows.

10. From the Alarm Categories window (displayed when launched the browser, select NCM Alarms.

11. Ensure the listing of alarms is displayed.




Installing the Client-Side Integration Module on a Server

[root@QA-PERF-AS1 root]# chmod +x VoyenceControl_x_x_x_yyy_HPNNM_Client.bin

[root@QA-PERF-AS1 root]# ./VoyenceControl_x_x_x_yyy_HPNNM_Client.bin -i console

Preparing to install...

Extracting the installation resources from the installer archive...

Configuring the installer for this system's environment...

Launching installer...

Preparing CONSOLE Mode Installation...

(created with InstallAnywhere by Zero G)

This installer was created with an unlicensed

version of InstallAnywhere.

Please contact [email protected] about licensing.

Introduction

InstallAnywhere will guide you through the installation of VoyenceControl Network Node Manager Integration Module.

It is strongly recommended that you quit all programs before continuing with

this installation.

Respond to each prompt to proceed to the next step in the installation. If you

want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.

PRESS <ENTER> TO CONTINUE: <CR>

Choose Install Set

Please choose the Install Set to be installed by this installer.

->1- Typical

2- Minimal

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT ......1<CR>



Choose Install Folder

Where would you like to install?

Default Install Folder: /opt/voyence

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

: <CR>

Get VoyenceControl NG Deployment Directory

Please choose the VoyenceControl deployment directory. This can be found in the JBoss installation directory under the server directory.

VoyenceControl NG Deployment Directory (DEFAULT: /home/jboss/server/powerup)

: <CR>

Get Network Node Manager trapd host

Please provide the hostname or IP address of the server running Network Node Manager trapd process.

NNM Trapd host (DEFAULT: ): 192.168.21.117<CR>

Get Network Node Manager trapd port

Please provide the port number of the Network Node Manager trapd process.

NNN Trapd port (DEFAULT: 162): <CR>

Pre-Installation Summary

Please Review the Following Before Continuing:

Product Name:

VoyenceControl Network Node Manager Integration Module

Install Folder:

/opt/voyence

Link Folder:

/root/voyence

Disk Space Information (for Installation Target):

Required: 1,409,570 bytes

Available: 8,232,812,544 bytes



PRESS <ENTER> TO CONTINUE: <CR>

Installing...

Installation Complete

Congratulations. VoyenceControl Integration Module Network Node Manager has been successfully installed to:

/opt/voyence

PRESS <ENTER> TO EXIT THE INSTALLER: <CR>

[root@QA-PERF-AS1 root]#


Uninstalling the NNM Client-Side Integration Module

These are additional steps to remove VoyenceControl from a Windows 2003 server.

1. Follow the Uninstalling steps in the “NNM Client-Side Integration Modules Installation Notes” section. The following screen-shots are the steps mentioned in that section.

2. From any sub-menu (shown here as the Internet window), select Options, then select Event Configuration from the Options drop-down menu.

3. From the Event Configuration window, select Edit, then select Alarms Categories.




4. From the Alarm Categories window, select NCM Alarms, then click Delete. Now, Close the Alarm Categories window.

5. From the Event Configuration window, select Edit, then select Additional Actions.

6. From the Edit Additional Actions window, select Launch NCM, then select Delete.

Uninstall in now complete.



WHERE TO GET HELP

Where to get help

EMC support, product, and licensing information can be obtained as follows.

Product information — For documentation, release notes, software updates, or for information about EMC products, licensing, and service, go to the EMC Powerlink website (registration required) at:

http://Powerlink.EMC.com

Technical support — For technical support, go to EMC Customer Service on Powerlink. To open a service request through Powerlink, you must have a valid support agreement. Please contact your EMC sales representative for details about obtaining a valid support agreement or to answer any questions about your account.

Sales and customer service contacts — For the list of EMC sales locations, please access the EMC home page at:

http://EMC.com/contact

http://powerlink.emc.com/

http://emc.com/contact



INDEX

A Additional Documentation, 7

C Client-Side Integration Module on Windows 2003

Server, 9 copyright, 2

E Event De-duplication, 9

I Installed Components, 6 Installing the Client-Side Integration Module on a

Server, 17 Installing the network Node Manager Integration

Module, 4 Installing the NNM Client-Side Integration Module

on a Windows 2003 Server, 9 Installing the NNM Integration Module Client-Side

Components, 5 Installing the NNM Integration Module Server-Side

Components, 5 Installing the SIM Integration Module Server-Side

Components, 5 Introduction, 5, 8

N NNM Integration Module Client-Side Components,

8

P Prepare for installation, 5

R Run the Installer (Unix), 5 Run the Installer (Windows), 5

S System and Platform Requirements, 4

U Uninstalling, 8 Uninstalling the NNM Client-Side Integration

Module, 20

V Verifying Installation, 7 Verifying the Installation, 13 VoyenceControl 4.1.0, 4 VoyenceControl Events, 8 VoyenceControl Launch, 9 VoyenceControl Traps, 8

W where to get help, 22

VoyenceControl Integration Module - Dell...Installing NNM Integration Module Client-Side Components...

Documents

Transcript of VoyenceControl Integration Module - Dell...Installing NNM Integration Module Client-Side Components...