HP NNM iSPI Performance for Quality Assurance Software

For the Windows® and Linux® operating systems

Software Version: 10.10

Customized output from:

Network Node Manager iSPI Performance for Quality Assurance 10.10 Interactive Installation Guide

Document Release Date: November 2015

Software Release Date: November 2015

HP logo

Legal Notices

Warranty

The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.

The information contained herein is subject to change without notice.

Restricted Rights Legend

Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Copyright Notice

© Copyright 2010-2015 Hewlett-Packard Development Company, L.P.

Trademark Notices

Adobe® is a trademark of Adobe Systems Incorporated.

Apple is a trademark of Apple Computer, Inc., registered in the U.S. and other countries.

AMD is a trademark of Advanced Micro Devices, Inc.

Google™ is a registered trademark of Google Inc.

Intel®, Intel® Itanium®, Intel® Xeon®, and Itanium® are trademarks of Intel Corporation in the U.S. and other countries.

Linux® is the registered trademark of Linus Torvalds in the U.S. and other countries.

Internet Explorer, Lync, Microsoft, Windows, and Windows Server are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.

Oracle and Java are registered trademarks of Oracle and/or its affiliates.

Red Hat® Enterprise Linux Certified is a registered trademark of Red Hat, Inc. in the United States and other countries.

sFlow is a registered trademark of InMon Corp.

UNIX® is a registered trademark of The Open Group.

 
 
 
 

Network Node Manager iSPI Performance for Quality Assurance 10.10 Interactive Installation Guide

Choose a Task

Install
Upgrade
Uninstall

Welcome to the NNM iSPI Performance for QA Interactive Installation Guide. This guide enables you to specify the task that you want to perform, and then view or print a customized guide. This customized guide includes only the requirements and tasks that apply to your selection. (The HP Network Node Manager iSPI Performance for Quality Assurance Software is referred to as the NNM iSPI Performance for QA in this guide.)

Start by choosing a task from the options on the left.

Choose an Upgrade Path

10.0x to 10.10
9.2x to 10.10

The NNM iSPI Performance for QA supports the following upgrade paths:

  • 10.0x to 10.10
  • 9.2x to 10.10

Choose an Operating System Choose an Operating SystemChoose the Operating System on which the NNM iSPI Performance for QA is installed

Windows
Linux
Linux

The NNM iSPI Performance for QA supports the following operating systems:

  • Windows

  • Linux

  • For a complete list of the supported versions of Windows and Linux operating systems, see the NNMi Ultimate or Premium Support Matrix.

Choose a Cluster Type

NNMi is in Application Failover
NNMi is in a high-availability (HA) cluster

Specify the type of cluster in which NNMi is installed. Do not select anything if NNMi is not installed in an Application Failover or HA cluster.

Choose a Database

Using an Embedded database with NNMi
Using an Oracle database with NNMi

The NNM iSPI Performance for QA provides two database options:

  • Embedded
  • Oracle

View or print

You can view your customized document on the screen, or print it.

If you have a PDF print driver installed on your computer, click Print to create PDF documents that are customized according to your selections. PDF print drivers are available from several open source and third-party providers.

Check your selections

The following steps are customized according to your selections:

 

Check that your selections are correct. If any selections are not correct, click Change.

Before Installing the NNM iSPI Performance for QA

Before you begin the installation process, read the following documents to better prepare for this NNM iSPI Performance for QA installation:

Note: For the latest versions of all documents, go to: https://softwaresupport.hp.com/group/softwaresupport/home.

You must have an HP Passport ID to access this web site.

Database Details

Make a note of the following Oracle database details:

  • Port: The port used by the Oracle database.
  • Oracle Database server name: The Fully Qualified Domain Name (FQDN) of the Oracle server.
  • Oracle Database name: The Oracle database to be used at the time of the NNM iSPI Performance for QA installation.
  • Oracle Database user name: The Oracle database user name to be used at the time of the NNM iSPI Performance for QA installation.
  • Password: Password for the above user. The password to be used at the time of the NNM iSPI Performance for QA installation.

You must create a new Oracle database instance before installing the NNM iSPI Performance for QA. While installing and configuring the NNM iSPI Performance for QA, do not use the same Oracle instance that was configured with NNMi.

System Requirements

Verify that your system meets the hardware and software requirements. For more information about the hardware and software requirements, see the Support Matrix.

Port Requirements

Make sure the following ports are available at the time of installation:

  • 54041
  • 54045
  • 54047
  • 54048
  • 54049
  • 54084
  • 54086
  • 54087
  • 54088
  • 54089
  • 54092
  • 54712
  • 54713
  • 54714

During installation, you must also configure ports for the following:

  • HTTP communication (if not configured, the default port used by the NNM iSPI Performance for QA is 54040)
  • HTTPS communication (if not configured, the default port used by the NNM iSPI Performance for QA is 54043)
  • JNDI (if not configured, the default port used by the NNM iSPI Performance for QA is 54046)

For more information about the ports used by the NNM iSPI Performance for QA, see HP Network Management Software Ports Reference.

NNMi and NPS Installation

Make sure that NNMi and Network Performance Serve (NPS) are successfully installed and configured.

Note: NPS is not a prerequisite for the NNM iSPI Performance for QA installation if you do not intend to have NPS on the same server as that of the NNM iSPI Performance for QA.

Create a Web Service Client User Account

The NNM iSPI Performance for QA installer requires you to provide the credentials of an NNMi Web Service Client user account. An NNMi Web Service Client user account is used only to provide access for software that is integrated with NNMi. Follow the instructions in NNMi Help for Administrators to create a Web Service Client user account.

Tip: Most iSPI installers require you to provide the credentials of a Web Service Client user account. You can use a single Web Service Client user account for installing any number of iSPIs.

Installing the NNM iSPI Performance for QA

Before you install the NNM iSPI Performance for QA in an Application Failover environment, follow these steps:

  1. As a precaution, do the following:

    • Run the nnmconfigexport.ovpl script on both the active and standby NNMi management servers.

    • Back up the NNMi data on both the active and standby NNMi management servers.

  2. On the active NNMi management server, run the nnmcluster -dbsync command and wait for the command execution to complete. On the standby NNMi management server, run the nnmcluster -shutdown command.

    On the standby NNMi management server, run the nnmcluster -shutdown command.

  3. Edit the following file on the standby NNMi management server:

    %NnmDataDir%\shared\nnm\conf\props\nms-cluster.properties
    /var/opt/OV/shared/nnm/conf/props/nms-cluster.properties
  4. Comment out the com.hp.ov.nms.cluster.name option and save the file.
  5. Create the following trigger file, which makes the embedded database to stop running in the standby mode and to start fully running:

    %NnmDataDir%\tmp\postgresTriggerFile
    /opt/OV/tmp/postgresTriggerFile
  6. Run the ovstart command on the standby NNMi management server. This brings up the NNMi services in the standalone (unclustered) state.

  7. Now start the NNM iSPI Performance for QA installation on the standby server.

Enable the Maintenance Mode on the Active Node

You must install the NNM iSPI Performance for QA on the active node first. Before you install the NNM iSPI Performance for QA, follow these steps:

  1. Log on to the active node.
  2. Put the NNMi resource group to the HA maintenance mode by placing the maintenance file under the following directory:

    %nnmdatadir%\hacluster\<resource_group>

    /var/opt/OV/hacluster/<resource_group>

  3. Run the ovstatus -c command to make sure that ovjboss is running.

Installation Procedure

To install the NNM iSPI Performance for QA, follow these steps:

  1. Log on to the NNMi management server as Administratorroot.
  2. Go to the installation media root directory by following these steps:

    1. Download the NNM iSPI Performance for QA media .TAR file (QA iSPI 10.10) (QA iSPI 10.10) to the NNMi management server.
    2. Extract the contents of the downloaded .TAR file, and then go to the directory where you extracted the file.

    Alternatively, if you obtained the physical DVD or the ISO image of the NNM iSPI Performance for QA media instead of the .TAR file, do one of the following on the NNMi management server:

    • Insert the DVD into the DVD drive, mount the DVD drive, and then go to the root of the mounted DVD drive.
    • Mount the ISO image of the installation media, and then go to the media root.

  3. Double-click the setup.exe file. The HP Software Installer Wizard for the NNM iSPI Performance for QA opens.

    Run the following command in the media root directory:

    ./setup.bin

  4. Choose the language you want to use and click OK. The installer configures your system for the installation and initializes the installation process.

    Note: The installer automatically chooses the locale of the NNMi installation. Do not change the setting.
  5. When you receive the "You may have to restart your system for the configuration changes made to the system to take effect. Would you like to quit this installation?" message, click Continue.
  6. On the Introduction (Install) page, review the overview information, and then click Next.
  7. On the License Agreement page, review the End User License Agreement, select I accept..., and then click Next.
  8. On the Product Customization page, select Typical, and then click Next.

    On the Product Customization page, select one of the following options:

    • If you want to use an Oracle database that runs on the standard port (1521), go to step 9.

    • If you want to use an Oracle database that runs on a non-standard port (other than 1521), go to step 10.

  9. On the Server Configuration page, in the Choose the Database Type section, select HP Software Embedded Database, and then click Next. The Product Requirements page appears. The wizard checks for the available disk space.

    Select Typical and then click Next.

    1. On the Server Configuration page, in the Choose the Database Type section, select Oracle and then click Next.

    2. Specify the necessary details:

      1. On the Choose Database Initialization Type page, select Primary Server Installation if you want to use a database that is not initialized. Select Secondary Server Installation if you want to use a database that is already initialized. After making the selection, click Next.

      2. On the Enter Your Database Server Information page, type the host name of the Oracle system and the database instance name, and then click Next. For an Oracle Real Application Clusters (RAC) database, specify the host name of one of the nodes in the cluster and the logical instance name of the cluster.

      3. On the Enter the Database User Account Information page, type the user name and password of the Oracle database instance, and then click Next. The Install Checks page appears. The wizard checks for the available disk space.

      4. Go to step 11.

  10. Select Custom, click Next.

    1. On the Feature Selection page, click Next.
    2. On the Server Configuration page, in the Choose the Database Type section, select Oracle, and then click Next.

    3. On the Choose Database Initialization Type page, select one of the following options:

      • Select Primary Server Installation if you want to use a database that is not initialized.
      • Select Secondary Server Installation if you want to use a database that is already initialized.

      After making the selection, click Next.

    4. On the Enter Your Database Server Information page, type the host name, port of the Oracle system and the database instance name. Then click Next. For an Oracle Real Application Clusters (RAC) database, specify the host name of one of the nodes in the cluster and the logical instance name of the cluster.

    5. On the Enter the Database User Account Information page, type the user name and password of the Oracle database instance, and then click Next. The Install Checks page appears. The wizard checks for the available disk space.
  11. After the disk space check is complete, click Next.
  12. On the Pre-Install Summary page, click Install. The installation process begins.

    Note: Select the Force re-installation of already installed component packages check box if you have previously attempted an unsuccessful installation of the NNM iSPI Performance for QA.

  13. Towards the end of the installation process, the QA iSPI Configuration window opens and prompts you to specify the following details:

    NNMi Server: Information Required by QA iSPI QA iSPI Server: Information Required by NNMi
    Web Service Client User Name: Name of the NNMi Web Service client user that you created. QA iSPI HTTP Port: Type the port number that will be used by the NNM iSPI Performance for QA for the HTTP communication (default: 54040).
    Web Service Client Password: Password of the above user QA iSPI HTTPS Port: Type the port number that will be used by the NNM iSPI Performance for QA for the HTTPS communication (default: 54043).
    Retype Password: Retype the password. QA iSPI JNDI Port: Type the port number that will be used by the NNM iSPI Performance for QA as the JNDI port (default: 54046).

    Note: The installer automatically detects the following:
    • NNMi FQDN: The Fully Qualified Domain Name (FQDN) of the NNMi management server.
    • QA iSPI FQDN: The FQDN of the NNMi management server.

  14. If you have configured NNMi to use the HTTPS mode of communication, select the isSecure check box in both the sections (NNMi Server: Information Required by QA iSPI and QA iSPI Server: Information Required by NNMi). Selecting this check box ensures that NNMi and the NNM iSPI Performance for QA always use the secure mode of communication.

    For detailed instructions to change the mode of communication after installing the NNM iSPI Performance for QA, see the NNM iSPI Performance for QA Deployment Reference.

  15. Click OK.
  16. After the installation is complete, a message appears to inform you that the installation process is complete and you can manually start the NNM iSPI Performance for QA processes. Click OK.
  17. Click the Summary tab to check if the installation is successful and click the Details tab to verify if the NNM iSPI Performance for QA packages are successfully installed. (Optional step) Click the View log file link in the window to check the log details and errors, if any.

  18. Click Done. The NNM iSPI Performance for QA installation process is complete.

If you are using an Oracle RAC database, follow these steps after the installation:

  1. Open the server.properties file from the /var/opt/OV/nmsas/qa%NNMDataDir%\nmsas\var directory.
  2. Modify the following parameters:

    • com.hp.ov.nms.oracle.otherHost: Set this property to the FQDN of the secondary Oracle server in the cluster.
    • com.hp.ov.nms.oracle.serviceName: Set this property to the logical instance name of the cluster.
  3. Save the file.
  4. Restart the qajboss process:

    • ovstop -c qajboss
    • ovstart -c qajboss

After you install the NNM iSPI Performance for QA on the standby server in an Application Failover environment, follow these steps:

  1. Run the nnmcluster -halt command on the active NNMi management server.

  2. Edit the following file on the active NNMi management server:

    %NnmDataDir%\shared\nnm\conf\props\nms-cluster.properties
    $NnmDataDir/shared/nnm/conf/props/nms-cluster.properties
  3. Comment out the com.hp.ov.nms.cluster.name option and save the file.
  4. Run the ovstart command on the active NNMi management server. This brings up the NNMi services in the standalone (unclustered) state.

  5. Install the NNM iSPI Performance for QA on the active NNMi server.

  6. Edit the following file on both the active and standby NNMi management servers:

    %NnmDataDir%\shared\nnm\conf\props\nms-cluster.properties
    /var/opt/OV/shared/nnm/conf/props/nms-cluster.properties
  7. Uncomment the com.hp.ov.nms.cluster.name option and save each file.
  8. Run the ovstart command on the active NNMi management server.
  9. Wait for a few minutes for the active NNMi management server to become the first active node in the cluster. Run the nnmcluster -display command on the active NNMi management server and search the displayed results for the term ACTIVE as in ACTIVE_NNM_STARTING or ACTIVE_SomeOtherState. Do not continue with step 11 until you know that the active NNMi management server is the active node.
  10. On the active node, run the following command:

    nnmcluster -dbsync

  11. Run the ovstart command on the standby NNMi management server.

Configuring the NNM iSPI Performance for QA to work in the HA Cluster

After installing the NNM iSPI Performance for QA on the active node, follow these steps:

  1. On the active node, follow these steps:

    1. Modify the following files from the /var/opt/OV/shared/qa/conf%NnmdataDir%\shared\qa\conf to replace the host name with the virtual FQDN for the following parameters:

      File Parameter
      nms-qa.jvm.properties -Dcom.hp.ov.nms.ssl.KEY_ALIAS
      nms-qa.jvm.properties -Djava.rmi.server.hostname
      nnm.extended.properties com.hp.ov.nms.spi.qa.Nnm.hostname
      nnm.extended.properties com.hp.ov.nms.spi.qa.spi.hostname
    2. Modify the server.properties file from the %nnmdatadir%\nmsas\qa/var/opt/OV/nmsas/qa directory to reflect the virtual FQDN of the NNMi management server for the java.rmi.server.hostname and nmsas.server.net.hostname.private parameters.

    3. Modify the login-config.xml file from the %nnminstalldir%\qa\server\conf/opt/OV/qa/server/conf directory to reflect the virtual FQDN of the NNMi management server:

      1. Open the login-config.xml file with a text editor.

      2. Look for the element <module-option name="nnmAuthUrl">.

      3. Modify the string contained within the element to reflect the virtual FQDN of the NNMi management server.

      4. Save the file.
    4. If any of the files listed below are modified, replicate them on each cluster member:

      • %NnmInstallDir%\qa\server\conf\logging.properties
      • %NnmInstallDir%\qa\server\deploy\jboss-logging.xml
      • %NnmDataDir%\nmsas\qa\conf\nms-auth-config.xml
      • %NnmDataDir%\shared\qa\conf\PingPair.conf
      • %NnmDataDir%\shared\qa\conf\discovery.exclude
      • %NnmDataDir%\shared\qa\conf\discovery.include
      • /var/opt/OV/qa/server/conf/logging.properties
      • /var/opt/OV/qa/server/deploy/jboss-logging.xml
      • /var/opt/OV/nmsas/qa/conf/nms-auth-config.xml
      • /var/opt/OV/shared/qa/conf/PingPair.conf
      • /var/opt/OV/shared/qa/conf/discovery.exclude
      • /var/opt/OV/shared/qa/conf/discovery.include

  2. Remove the maintenance file from the active node.
  3. Initiate a failover operation to fail over to the passive node by following these steps:

    1. Run the nnmhastoprg.ovpl nnm <resource group> command on the active node.

    2. Run the nnmhastartrg.ovpl nnm <resource group> command on the passive node.

  4. To make sure that NNMi fails over successfully, follow these steps:

    1. Run the nnmhaclusterinfo.ovpl -group <resource group> -state command. Make sure the result shows the state of the resource group as online.

    2. Run the nnmhaclusterinfo.ovpl -group <resource group> -activeNode command. The result shows the name of the active node.

      Note: Make sure the result shows the name of the node that was passive before performing step 3.

  5. On the current active node, put the NNMi resource group to the HA maintenance mode by placing the maintenance file under the following directory:

    %nnmdatadir%\hacluster\<resource_group>

    /var/opt/OV/hacluster/<resource_group>

  6. Run the ovstatus -c command to make sure that ovjboss is running.

  7. Install the NNM iSPI Performance for QA on the passive node.
  8. On the passive node, follow these steps:

    1. Modify the following files from the /var/opt/OV/shared/qa/conf%NnmdataDir%\shared\qa\conf to replace the host name with the virtual FQDN for the following parameters:

      File Parameter
      nms-qa.jvm.properties -Dcom.hp.ov.nms.ssl.KEY_ALIAS
      nms-qa.jvm.properties -Djava.rmi.server.hostname
      nnm.extended.properties com.hp.ov.nms.spi.qa.Nnm.hostname
      nnm.extended.properties com.hp.ov.nms.spi.qa.spi.hostname
    2. Modify the server.properties file from the %nnmdatadir%\nmsas\qa/var/opt/OV/nmsas/qa directory to reflect the virtual FQDN of the NNMi management server for the java.rmi.server.hostname and nmsas.server.net.hostname.private parameters.

    3. Modify the login-config.xml file from the %nnminstalldir%\qa\server\conf/opt/OV/qa/server/conf directory to reflect the virtual FQDN of the NNMi management server:

      1. Open the login-config.xml file with a text editor.

      2. Look for the element <module-option name="nnmAuthUrl">.

      3. Modify the string contained within the element to reflect the virtual FQDN of the NNMi management server.

      4. Save the file.
    4. If any of the files listed below are modified, replicate them on each cluster member:

      • %NnmInstallDir%\qa\server\conf\logging.properties
      • %NnmInstallDir%\qa\server\deploy\jboss-logging.xml
      • %NnmDataDir%\nmsas\qa\conf\nms-auth-config.xml
      • %NnmDataDir%\shared\qa\conf\PingPair.conf
      • %NnmDataDir%\shared\qa\conf\discovery.exclude
      • %NnmDataDir%\shared\qa\conf\discovery.include
      • /var/opt/OV/qa/server/conf/logging.properties
      • /var/opt/OV/qa/server/deploy/jboss-logging.xml
      • /var/opt/OV/nmsas/qa/conf/nms-auth-config.xml
      • /var/opt/OV/shared/qa/conf/PingPair.conf
      • /var/opt/OV/shared/qa/conf/discovery.exclude
      • /var/opt/OV/shared/qa/conf/discovery.include

  9. Remove the maintenance file from this node.
  10. Fail over to the server that was active while you started this procedure.
  11. Run the following command on the active server first, and then on the passive server:

    %NnmInstallDir%\misc\nnm\ha\nnmhaconfigure.ovpl NNM -addon QASPIHA

    /opt/OV/misc/nnm/ha/nnmhaconfigure.ovpl NNM -addon QASPIHA

  12. Run the following command to verify that the NNM iSPI Performance for QA is successfully registered:

    %nnminstalldir%\misc\nnm\ha\nnmhaclusterinfo.ovpl –config NNM –get NNM_ADD_ON_PRODUCTS

    /opt/OV/ misc/nnm/ha/nnmhaclusterinfo.ovpl –config NNM –get NNM_ADD_ON_PRODUCTS

After installing the NNM iSPI Performance for QA, make sure that the NNM iSPI Performance for QA is installed on both the nodes in the Application Failover cluster.

Make sure that the NNM iSPI Performance for QA process is started

Follow these steps on the active node:

  • If you have chosen all default ports while installing the NNM iSPI Performance for QA:

    1. Check that the NNMi processes are running by using the following command:

      ovstatus -c

      If the processes are not running, start them manually by using the following command:

      ovstart -c

    2. If the qajboss process is not running, run the following command:

      If NNMi is not in an Application Failover environment

      ovstart -c qajboss

      If NNMi is in an Application Failover environment

      nnmcluster -daemon

  • If you have chosen the non-default ports while installing the NNM iSPI Performance for QA:

    1. Run the following command to stop all processes:

      ovstop -c

    2. Run the following command to start all the processes (including the NNM iSPI Performance for QA processes):

      ovstart -c

Post-Installation Steps

Getting started with the NNM iSPI Performance for QA

To start using the NNM iSPI Performance for QA, follow these steps:

  1. Start the NNMi console. For more information about how to access the NNMi console, see Getting Started with NNMi in the HP Network Node Manager i Software Interactive Installation Guide.
  2. In the Workspaces pane, click Quality Assurance.

Accessing the Online Help

The NNM iSPI Performance for QA Help provides the information about how to use this product. The detailed information in the NNM iSPI Performance for QA help is organized into the following sections:

  • Help for Operators
  • Help for Administrators

Follow the steps given below to access the NNM iSPI Performance for QA help:

On the NNMi Console, click Help à Help for NNM iSPIs à iSPI Performance for QA Help for Operators

On the NNMi Console, click Help à Help for NNM iSPIs à iSPI Performance for QA Help for Administrators

The help provides you with comprehensive information about the NNM iSPI Performance for QA views, forms, and troubleshooting.

Note: The NNM iSPI Performance for QA help appears in the NNMi console only if the NNM iSPI Performance for QA installation is successful.

Accessing Log Files

The NNM iSPI Performance for Quality Assurance log files are given below:

  • Temp\HPOvQAiSPI_10.10.000_HPOvInstaller.txt
    tmp/HPOvQAiSPI_10.10.000_HPOvInstaller.txt
  • \Temp\2=>%temp%\preInstall_qa.log
    tmp/preInstall_qa.log
  • \Temp\2=>%temp%\postInstall_qa.log
    tmp/postInstall_qa.log
 

Uninstallation

The uninstallation procedure permanently removes the NMM iSPI Performance for QA from the system.

Note: If you have applied the NNM iSPI Performance for QA patches, remove them before you start the uninstallation process.

Remove from the HA Cluster

To remove the NNM iSPI Performance for QA from the NNMi HA cluster, run the following command on the passive node first, and then on the active node:

%NnmInstallDir%\misc\nnm\ha\nnmhaunconfigure.ovpl NNM -addon QASPIHA

/opt/OV/misc/nnm/ha/nnmhaunconfigure.ovpl NNM -addon QASPIHA

Before uninstalling the NNM iSPI Performance for QA

  1. Make sure that the ovjboss and nmsdbmgr processes are running by using the following command:

    ovstatus -c

  2. Stop the NNM iSPI Performance for QA process by running the following command:

    ovstop -c qajboss

Uninstallation Steps

To uninstall the NNM iSPI Performance for QA from an NNMi management server, follow these steps:

Note: Perform these steps on the active and passive nodes.

  1. Log on to the management server as Administrator.

    Log on to the management server as root.

  2. Go to the following directory and double-click setup.exe:

    %NnmInstallDir%\Uninstall\HPOvQAiSPI\setup.exe

    Alternatively, you can remove the NNM iSPI Performance for QA from the Uninstall a Program window. Select Start à Control Panel à Programs à Uninstall a Program à NNM iSPI Performance for Quality Assurance. Right-click NNM iSPI Performance for Quality Assurance, and select Uninstall. The HP Install wizard to uninstall NNM iSPI Performance for QA opens.

    Run the following command:

    $NnmInstallDir/Uninstall/HPOvQAiSPI/setup.bin

    The default install directory is opt/OV/.

    The HP Software Installer wizard opens.

  3. Select the language you want to use, and click OK. By default, the locale of the NNM iSPI Performance for QA installation is selected.

  4. On the Maintenance Selection page, select Uninstall and then click Next.

  5. On the Pre-Uninstall Summary page, review the list of files that will be removed from the system; then do one of the following:

    - To cancel the uninstallation, click Cancel.

    - To go back, click Previous.

    - To remove the files from the system, click Uninstall.

  6. A message appears to indicate that you can stop the NNMi processes if you do not want them to be running after uninstalling the NNM iSPI Performance for QA. Click OK.

  7. Click the Summary tab to check if the uninstallation is successful, and click the Details tab to verify if the NNM iSPI Performance for QA packages are successfully uninstalled. (Optional step) Click the View Log File link in the window to check the log details and errors, if any.
  8. Click Done.

See the Troubleshooting section to resolve any errors generated during the uninstallation process.

The log files are given below:

  • \Temp\preRemove_qa.log
    /tmp/preRemove_qa.log
  • \Temp\postRemove_qa.log
    /tmp/postRemove_qa.log

Removing the NNM iSPI Performance for QA Reporting Data from NPS

The NNM iSPI Performance for QA uninstallation process does not remove the Extension Packs from NPS. You must run the following commands on the NPS system to manually remove the NNM iSPI Performance for QA Extension Packs:

/opt/OV/NNMPerformanceSPI/bin/uninstallExtensionPack -p Quality_Assurance

/opt/OV/NNMPerformanceSPI/bin/uninstallExtensionPack -p Ping_Latency

/opt/OV/NNMPerformanceSPI/bin/uninstallExtensionPack -p CBQoS

%NnmInstallDir%\NNMPerformanceSPI\bin\uninstallExtensionPack -p Quality_Assurance

%NnmInstallDir%\NNMPerformanceSPI\bin\uninstallExtensionPack -p Ping_Latency

%NnmInstallDir%\NNMPerformanceSPI\bin\uninstallExtensionPack -p CBQoS

Before Upgrading to the NNM iSPI Performance for QA 10.10

Before you upgrade to the NNM iSPI Performance for QA 10.10, make sure that you have the latest NNM iSPI Performance for QA 9.1x patch9.22 or higher installed.

Note: If you have the NNM iSPI Performance for QA 10.00, move to 10.01 before upgrading to 10.10. You cannot upgrade to 10.10 from 10.00 directly.

The configuration details are automatically backed up while you upgrade. However, you can also take a backup of the existing configuration by exporting the configuration details by using these commands:

Note: As a best practice, back up all the data before upgrade.

  • $NnmInstallDir/bin/nmsqasiteconfigutil.ovpl -u <username> -p <password> –export <filename>

    %NnmInstallDir%\bin\nmsqasiteconfigutil.ovpl -u <username> -p <password> –export <filename>

  • $NnmInstallDir/bin/nmsqathresholdconfigutil.ovpl -u <username> -p <password> –export <filename>

    %NnmInstallDir%\bin\nmsqathresholdconfigutil.ovpl -u <username> -p <password> –export <filename>

  • $NnmInstallDir/bin/nmsqadiscofilter.ovpl –u<username>–p<password>-c CBQoS –export <filename>

    %NnmInstallDir%\bin\nmsqadiscofilter.ovpl –u<username>–p<password>-c CBQoS –export<filename>

  • $NnmInstallDir/bin/nmsqadiscofilter.ovpl –u <username> –p <password> -c Probe –export <filename>

    %NnmInstallDir%\bin\nmsqadiscofilter.ovpl –u <username> –p <password> -c Probe –export <filename>

  • $NnmInstallDir/bin/nmsqathresholdconfigutil.ovpl –u <username> –p <password> –export -type cbqos <filename>

    %NnmInstallDir%\bin\nmsqathresholdconfigutil.ovpl –u <username> –p <password> –export -type cbqos <filename>

Note:<username> is the NNMi administrator user name and <password> is the password of that user. -u <username> and -p <password> are optional parameters.

The NNM iSPI Performance for QA 10.10 reporting data in Network Performance Server (NPS) is retained after you upgrade by default .

Upgrade NNMi to Version 10.10

For information about upgrading to the version 10.10, see the steps given in the HP Network Node Manager i Software 10.10 Interactive Installation and Upgrade Guide.

NNMi 10.x supports Red Hat Enterprise Linux 6.4 (and above). You cannot upgrade Red Hat Enterprise Linux 5.x to 6.4 directly. You must move the existing NNMi (and iSPI) to a Red Hat Enterprise Linux 6.4 server to complete the process of upgrading NNMi. For more information, see the Moving NNMi from a RHEL Version Earlier than 6.4 to RHEL 6.4 or Later section in the NNMi 10.10 Interactive Installation and Upgrade Guide.

After moving to a new Linux management server and restoring the NNMi data (which also restores the iSPI data), follow these additional steps to update the DNS host name of the target Linux server at the following location:

Note: Follow these steps after installing the version 9.1x9.2x of the NNM iSPI Performance for Quality Assurance Software on the new management server.

  1. Open the nms-qa.address.properties file (from /var/opt/OV/shared/qa/conf) with a text editor.

    Set the value to the following parameter:

    jboss.nnm.host=<current DNS host name>
  2. Open the nms-qa.jvm.properties file with a text editor.

    Set the value to the following parameters:

    • -Dcom.hp.ov.nms.ssl.KEY_ALIAS=<current DNS host name>
    • -Djava.rmi.server.hostname=<current DNS host name>
  3. Open the nnm.extended.properties file with a text editor.

    Set the value to the following parameters:

    • com.hp.ov.nms.spi.qa.spi.hostname=<current DNS host name>
    • com.hp.ov.nms.spi.qa.Nnm.hostname=<current DNS host name>

    Note: For the changes to take effect, restart qajboss manually.

Verify that NNMi Processes are Up and Running

  • Before upgrading to the NNM iSPI Performance for QA 10.10, make sure the NNMi processes are up and running. You can run the following command to check the status:

    ovstatus -c

  • If the qajboss process is running, stop it manually using the following command:

    ovstop -c qajboss

    Note: Stop the NNM iSPI Performance for QA manually in an application failover environment by running the nnmcluster -disable -shutdown command.

Before upgrading to the NNM iSPI Performance for QA10.10, make sure the NNMi processes are up and running. Run the following command to check the status:

ovstatus -c

Upgrade NPS to Version 10.10

For information about upgrading NPS to the version 10.10, see the HP Network Node Manager iSPI Performance for Metrics 10.10 Interactive Installation Guide.

Upgrade the NNM iSPI Performance for QA

Before you upgrade the NNM iSPI Performance for QA in an Application Failover environment, follow the steps in the Application Failover and Upgrading to NNMi 10.10 in the NNMi Deployment Reference. When the document prompts you to start the iSPI upgrade, follow the upgrade steps provided in the below sections.

Enable the Maintenance Mode on the Active Node

  1. Log on to the active node.
  2. Put the NNMi resource group to the HA maintenance mode by placing the maintenance file under the following directory:

    %nnmdatadir%\hacluster\<resource_group>

    /var/opt/OV/hacluster/<resource_group>

  3. Run the ovstatus -c command to make sure that ovjboss is running.

Upgrade Procedure

Before you upgrade the NNM iSPI Performance for QA in an HA environment, follow the steps in High Availability and Upgrading from NNMi 9.1x or NNMi 9.2x to NNMi 10.10 in the NNMi Upgrade Reference. When the document prompts you to start the iSPI upgrade, follow these steps on the active node:

Note: While you upgrade, you cannot change the database configured for the previous version of the NNM iSPI Performance for QA installed on your management server.

  1. Go to the installation media root directory by following these steps:

    Note: Make sure you are logged on as Administratorroot.

    1. Download the NNM iSPI Performance for QA media .TAR file (QA iSPI 10.10) (QA iSPI 10.10) to the NNMi management server.
    2. Extract the contents of the downloaded .TAR file, and then go to the directory where you extracted the file.

    Alternatively, if you obtained the physical DVD or the ISO image of the NNM iSPI Performance for QA media instead of the .TAR file, do one of the following on the NNMi management server:

    • Insert the DVD into the DVD drive, mount the DVD drive, and then go to the root of the mounted DVD drive.
    • Mount the ISO image of the installation media, and then go to the media root.

  2. Double-click setup.exe available in the root directory.

    Run the following command in the root directory:

    ./setup.bin

    The HP Software Installer wizard for the NNM iSPI Performance for QA opens.

  3. The installation initialization process prompts you to choose the language you want to use and click OK. By default, the installer automatically selects the locale of the NNM iSPI Performance for QA installation.
    The installer configures your system for the upgrade and initializes the upgrade process.

  4. On the Introduction (Upgrade) page, review the overview information, and then click Next.
  5. On the License Agreement page, review the End User License Agreement and select I accept... Then click Next.
  6. On the Select Features page, click Next.
  7. On the Select the Installation Type page, select Typical, and then click Next. The HP Software Installer verifies the free disk space required to complete installation.
  8. On the Install Checks page appear, review the displayed required disk space and available disk space on the system and then click Next.
  9. On the Pre-Install Summary page, review the options, and then click Upgrade.

    The upgrade process begins.

  10. Click OK to proceed with the upgrade when you see the following message:

    HP strongly recommends that you take a complete backup of the iSPI before proceeding with this upgrade.

  11. Click OK when a message appears to inform you that the installer is attempting to start nmsdbmgr for creating the embeddeddatabase and you can stop the NNMi processes after the upgrade is complete.
  12. After the upgrade process is complete, a message appears to inform you that the upgrade process is complete and you can manually start the NNM iSPI Performance for QA processes. Click OK.

    This completes the upgrade process.

  13. Click the Summary tab to check if the upgrade is successful, and click the Details tab to verify if the NNM iSPI Performance for QA packages are successfully installed. (Optional step) Click on the View log file link in the window to check the log details, and errors, if any.

  14. Click Done.

A pop-up message prompts you to restart the system for the configuration change to take effect. Ignore the message and do not click OK. Click Cancel on the pop-up window.

Configuring to Work in the HA Cluster

After upgrading the NNM iSPI Performance for QA on the active node, follow these steps:

  1. On the active node, follow these steps:

    1. Make sure that the following properties in the files in the /var/opt/OV/shared/qa/conf%NnmdataDir%\shared\qa\conf directory indicate the virtual FQDN of the NNMi management server:

      File Parameter
      nms-qa.jvm.properties -Dcom.hp.ov.nms.ssl.KEY_ALIAS
      nms-qa.jvm.properties -Djava.rmi.server.hostname
      nnm.extended.properties com.hp.ov.nms.spi.qa.Nnm.hostname
      nnm.extended.properties com.hp.ov.nms.spi.qa.spi.hostname
    2. Make sure that the server.properties file from the %nnmdatadir%\nmsas\qa/var/opt/OV/nmsas/qa directory reflects the virtual FQDN of the NNMi management server for the java.rmi.server.hostname and nmsas.server.net.hostname.private parameters.

    3. Make sure that the login-config.xml file in the %nnminstalldir%\qa\server\conf/opt/OV/qa/server/conf directory reflects the virtual FQDN of the NNMi management server:

      1. Open the login-config.xml file with a text editor.

      2. Look for the element <module-option name="nnmAuthUrl">.

      3. If necessary, modify the string contained within the element to reflect the virtual FQDN of the NNMi management server.

      4. Save the file.
    4. If any of the files listed below are modified, replicate them on each cluster member:

      • %NnmInstallDir%\qa\server\conf\logging.properties
      • %NnmInstallDir%\qa\server\deploy\jboss-logging.xml
      • %NnmDataDir%\nmsas\qa\conf\nms-auth-config.xml
      • %NnmDataDir%\shared\qa\conf\PingPair.conf
      • %NnmDataDir%\shared\qa\conf\discovery.exclude
      • %NnmDataDir%\shared\qa\conf\discovery.include
      • /var/opt/OV/qa/server/conf/logging.properties
      • /var/opt/OV/qa/server/deploy/jboss-logging.xml
      • /var/opt/OV/nmsas/qa/conf/nms-auth-config.xml
      • /var/opt/OV/shared/qa/conf/PingPair.conf
      • /var/opt/OV/shared/qa/conf/discovery.exclude
      • /var/opt/OV/shared/qa/conf/discovery.include

  2. Start the qajboss process manually on the active node by running the ovstart -c qajboss command.

  3. On the system that is currently passive, put the NNMi resource group to the HA maintenance mode by placing the maintenance file under the following directory:

    %nnmdatadir%\hacluster\<resource_group>

    /var/opt/OV/hacluster/<resource_group>

  4. Run the ovstatus -c command to make sure that ovjboss is running.

  5. Upgrade the NNM iSPI Performance for QA on the standby node.
  6. On the standby node, follow these steps:

    1. Make sure that the following properties in the files in the /var/opt/OV/shared/qa/conf%NnmdataDir%\shared\qa\conf directory indicate the virtual FQDN of the NNMi management server:

      File Parameter
      nms-qa.jvm.properties -Dcom.hp.ov.nms.ssl.KEY_ALIAS
      nms-qa.jvm.properties -Djava.rmi.server.hostname
      nnm.extended.properties com.hp.ov.nms.spi.qa.Nnm.hostname
      nnm.extended.properties com.hp.ov.nms.spi.qa.spi.hostname
    2. Make sure that the server.properties file from the %nnmdatadir%\nmsas\qa/var/opt/OV/nmsas/qa directory reflects the virtual FQDN of the NNMi management server for the java.rmi.server.hostname and nmsas.server.net.hostname.private parameters.

    3. Make sure that the login-config.xml file in the %nnminstalldir%\qa\server\conf/opt/OV/qa/server/conf directory reflects the virtual FQDN of the NNMi management server:

      1. Open the login-config.xml file with a text editor.

      2. Look for the element <module-option name="nnmAuthUrl">.

      3. If necessary, modify the string contained within the element to reflect the virtual FQDN of the NNMi management server.

      4. Save the file.
    4. If any of the files listed below are modified, replicate them on each cluster member:

      • %NnmInstallDir%\qa\server\conf\logging.properties
      • %NnmInstallDir%\qa\server\deploy\jboss-logging.xml
      • %NnmDataDir%\nmsas\qa\conf\nms-auth-config.xml
      • %NnmDataDir%\shared\qa\conf\PingPair.conf
      • %NnmDataDir%\shared\qa\conf\discovery.exclude
      • %NnmDataDir%\shared\qa\conf\discovery.include
      • /var/opt/OV/qa/server/conf/logging.properties
      • /var/opt/OV/qa/server/deploy/jboss-logging.xml
      • /var/opt/OV/nmsas/qa/conf/nms-auth-config.xml
      • /var/opt/OV/shared/qa/conf/PingPair.conf
      • /var/opt/OV/shared/qa/conf/discovery.exclude
      • /var/opt/OV/shared/qa/conf/discovery.include

  7. Remove the maintenance file from all the nodes.
  8. Fail over to the server that was active while you started this procedure.

Start the NNM iSPI Performance for QA Processes

To start the NNM iSPI Performance for QA, follow these steps:

  • If you have chosen all default ports while installing the NNM iSPI Performance for QA:

    1. Check if the NNMi processes are running using the following command:

      ovstatus -c

      If the processes are not running, start them manually using the following command:

      ovstart -c ovjboss

    2. Run the following command to start the NNM iSPI Performance for QA processes:

      ovstart -c qajboss

      You must not run the ovstart commands to start the NNM iSPI Performance for QA processes in an application failover environment. To start the NNM iSPI Performance for QA manually in an application failover environment, run the following command:

      nnmcluster -daemon

  • If you have chosen some non-default ports while installing the NNM iSPI Performance for QA:

    1. Run the following command to stop all processes:

      ovstop -c

    2. Run the following command to start all the processes (including the NNM iSPI Performance for QA processes):

      ovstart -c

Post-Upgrade Task

Discovery

After upgrading to the NNM iSPI Performance for QA 10.10, you can see a set of elements in the NNM iSPI Performance for QA inventories without any tenant details. Tenant details are visible after your network is discovered again by NNMi.

Import Configurations

This is not a mandatory post-upgrade task. The configuration details are restored automatically after you upgrade.

You can retrieve or import the configuration details that you saved as an XML file prior to upgrading to the NNM iSPI Performance for QA 10.10. You can use the configuration user interfaces of the NNM iSPI Performance for QA 10.10 to import the configuration details. Alternatively, you can manually run the these commands to import or restore the configuration details:

  • $NnmInstallDir/bin/nmsqasiteconfigutil.ovpl -u <username> -p <password> –import <filename>

    %NnmInstallDir%\bin\nmsqasiteconfigutil.ovpl -u <username> -p <password> –import <filename>

  • $NnmInstallDir/bin/nmsqathresholdconfigutil.ovpl -u <username> -p <password> –import <filename>

    %NnmInstallDir%\bin\nmsqathresholdconfigutil.ovpl -u <username> -p <password> –import <filename>

  • $NnmInstallDir/bin/nmsqadiscofilter.ovpl –u <username> –p <password> –import <filename>

    %NnmInstallDir%\bin\nmsqadiscofilter.ovpl –u <username> –p <password> –import <filename>

  • $NnmInstallDir/bin/nmsqathresholdconfigutil.ovpl –u <username> –p <password> -type cbqos –export <filename>

    %NnmInstallDir%\bin\nmsqathresholdconfigutil.ovpl –u <username> –p <password> -type cbqos –export <filename>

  • $NnmInstallDir/bin/nmsqadiscofilter.ovpl -u <username> -p <password> -c CBQoS -import <filename>

    %NnmInstallDir%\bin\nmsqadiscofilter.ovpl -u <username> -p <password> -c CBQoS -import <filename>

  • Note: <username> is the NNMi administrator user name and <password> is the password of that user. -u <username> -p <password> are optional parameters.

Enabling Licenses

If you have already enabled an NNMi Premium or Ultimate license key, no additional license keys are required for the NNM iSPI Performance for QA.

For more information about NNMi Premium and Ultimate license keys, see the Licensing section in the NNMi Release Notes.

If you have already enabled an NNMi Premium or Ultimate license key after upgrading NNMi to the version 10.10, no additional license keys are required for the NNM iSPI Performance for QA after upgrade.

Otherwise, after upgrading the NNM iSPI Performance for Quality Assurance Software to the version 10.10, go to the following web site and obtain a new license key:

http://support.openview.hp.com/software_updates.jsp

Troubleshooting

© Copyright 2010-2015 Hewlett-Packard Development Company, L.P.