Customized output from:
Document Release Date: November 2015 Software Release Date: November 2015 |
|
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.
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 2010-2015 Hewlett-Packard Development Company, L.P.
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.
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.
The NNM iSPI Performance for QA supports the following upgrade paths:
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.
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.
The NNM iSPI Performance for QA provides two database options:
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.
The following steps are customized according to your selections:
Check that your selections are correct. If any selections are not correct, click Change.
Before you begin the installation process, read the following documents to better prepare for this NNM iSPI Performance for QA installation:
HP Network Node Manager i Software Ultimate Edition Release Notes
or
HP Network Node Manager i Software Premium Edition Release Notes
HP Network Node Manager i Software Ultimate Edition Support Matrix
or
HP Network Node Manager i Software Premium Edition Support Matrix
HP Network Node Manager iSPI Performance for Quality Assurance Software Deployment Reference
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:
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:
During installation, you must also configure ports for the following:
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.
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.
Before you install the NNM iSPI Performance for QA in an Application Failover environment, follow these steps:
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.
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.
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
com.hp.ov.nms.cluster.name
option and save the file.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
Run the ovstart command on the standby NNMi management server. This brings up the NNMi services in the standalone (unclustered) state.
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:
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>
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:
Go to the installation media root directory by following these steps:
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:
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
Choose the language you want to use and click OK. The installer configures your system for the installation and initializes the installation process.
On the Product Customization page, select Typical, and then click Next.
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.
On the Server Configuration page, in the Choose the Database Type section, select Oracle and then click Next.
Specify the necessary details:
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.
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.
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.
Go to step 11.
On the Server Configuration page, in the Choose the Database Type section, select Oracle, and then click Next.
On the Choose Database Initialization Type page, select one of the following options:
After making the selection, click Next.
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.
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.
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). |
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.
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.
If you are using an Oracle RAC database, follow these steps after the installation:
server.properties
file from the /var/opt/OV/nmsas/qa
%NNMDataDir%\nmsas\var
directory.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.Restart the qajboss
process:
After you install the NNM iSPI Performance for QA on the standby server in an Application Failover environment, follow these steps:
Run the nnmcluster -halt command on the active NNMi management server.
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
com.hp.ov.nms.cluster.name
option and save the file.Run the ovstart command on the active NNMi management server. This brings up the NNMi services in the standalone (unclustered) state.
Install the NNM iSPI Performance for QA on the active NNMi server.
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
com.hp.ov.nms.cluster.name
option and save each file.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.On the active node, run the following command:
nnmcluster -dbsync
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:
On the active node, follow these steps:
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 |
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.
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:
Open the login-config.xml
file with a text editor.
Look for the element <module-option name="nnmAuthUrl">
.
Modify the string contained within the element to reflect the virtual FQDN of the NNMi management server.
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
maintenance
file from the active node.Initiate a failover operation to fail over to the passive node by following these steps:
Run the nnmhastoprg.ovpl nnm <resource group> command on the active node.
Run the nnmhastartrg.ovpl nnm <resource group> command on the passive node.
To make sure that NNMi fails over successfully, follow these steps:
Run the nnmhaclusterinfo.ovpl -group <resource group> -state command. Make sure the result shows the state of the resource group as online
.
Run the nnmhaclusterinfo.ovpl -group <resource group> -activeNode command. The result shows the name of the active node.
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>
Run the ovstatus -c command to make sure that ovjboss
is running.
On the passive node, follow these steps:
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 |
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.
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:
Open the login-config.xml
file with a text editor.
Look for the element <module-option name="nnmAuthUrl">
.
Modify the string contained within the element to reflect the virtual FQDN of the NNMi management server.
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
maintenance
file from this node.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
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:
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
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:
Run the following command to stop all processes:
ovstop -c
Run the following command to start all the processes (including the NNM iSPI Performance for QA processes):
ovstart -c
Getting started with the NNM iSPI Performance for QA
To start using the NNM iSPI Performance for QA, follow these steps:
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:
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.
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
The uninstallation procedure permanently removes the NMM iSPI Performance for QA from the system.
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
Make sure that the ovjboss
and nmsdbmgr
processes are running by using the following command:
ovstatus -c
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.
Log on to the management server as Administrator.
Log on to the management server as root.
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.
Select the language you want to use, and click OK. By default, the locale of the NNM iSPI Performance for QA installation is selected.
On the Maintenance Selection page, select Uninstall and then click Next.
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.
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.
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 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.
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:
$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>
<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 .
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.
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>
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>
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>
qajboss
manually.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
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.
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
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>
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.
Go to the installation media root directory by following these steps:
Note: Make sure you are logged on as Administratorroot.
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:
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.
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.
On the Pre-Install Summary page, review the options, and then click Upgrade.
The upgrade process begins.
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
.
nmsdbmgr
for creating the embeddeddatabase and you can stop the NNMi processes after the upgrade is complete. 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.
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.
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:
On the active node, follow these steps:
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 |
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.
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:
Open the login-config.xml
file with a text editor.
Look for the element <module-option name="nnmAuthUrl">
.
If necessary, modify the string contained within the element to reflect the virtual FQDN of the NNMi management server.
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
Start the qajboss
process manually on the active node by running the ovstart -c qajboss command.
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>
Run the ovstatus -c command to make sure that ovjboss
is running.
On the standby node, follow these steps:
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 |
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.
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:
Open the login-config.xml
file with a text editor.
Look for the element <module-option name="nnmAuthUrl">
.
If necessary, modify the string contained within the element to reflect the virtual FQDN of the NNMi management server.
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
maintenance
file from all the nodes.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:
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
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:
Run the following command to stop all processes:
ovstop -c
Run the following command to start all the processes (including the NNM iSPI Performance for QA processes):
ovstart -c
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.
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:
© Copyright 2010-2015 Hewlett-Packard Development Company, L.P.