Administer > Administer the NNM iSPI Performance for QA > Maintain the NNM iSPI Performance for QA

Maintain the NNM iSPI Performance for QA

This topic includes the following sections:

Update the Security Mode (HTTP to HTTPS)

After installing NNMi and the NNM iSPI Performance for QA, if you want to modify the security mode from HTTPS to HTTP or from HTTP to HTTPS without reinstalling NNMi and the NNM iSPI Performance for QA:

  1. On the management server, open the nnm.extended.properties file from the %NnmDataDir%\shared\qa\conf directory with a text editor.

    On the management server, open the nnm.extended.properties file from the $NnmDataDir/shared/qa/conf directory with a text editor.

  2. Update the values to true or false from the following:

    com.hp.ov.nms.spi.qa.Nnm.isSecure=false: To modify the mode of communication used by the NNM iSPI Performance for QA to communicate with NNMi.

    com.hp.ov.nms.spi.qa.spi.isSecure=false: To modify the mode of communication used by NNMi to communicate with the NNM iSPI Performance for QA.

    The value TRUE represents HTTPS mode of communication and the value FALSE represents HTTP mode of communication.

    Always select the same mode of transmission for NNMi and the NNM iSPI Performance for QA.

  3. Restart the NNM iSPI Performance for QA with the following commands:

    ovstop -c qajboss

    ovstart -c qajboss

Configure the NNM iSPI Performance for QA to Use the Modified NNMi Ports

After installing the NNM iSPI Performance for QA, you can modify the following configuration parameters:

NNMi HTTP port and HTTPS port

You can configure the NNM iSPI Performance for QA to use the modified NNMi ports by:

  1. Open the nms-local.properties file available in the following directory:

    %NnmDataDir%\conf\nnm\props\nms-local.properties

    $NnmDataDir/conf/nnm/props/nms-local.properties

  2. Obtain the values of the following properties: nmsas.server.port.web.http and nmsas.server.port.web.https

  3. Open the nnm.extended.properties file from the %NnmDataDir%\shared\qa\conf directory with a text editor.

    Open the nnm.extended.properties file from the $NnmDataDir/shared/qa/conf directory with a text editor.

  4. If you changed the NNMi HTTP port, replace the value for com.hp.ov.nms.spi.qa.Nnm.port property with the value of nmsas.server.port.web.http obtained in step 2.

  5. If you changed the NNMi HTTPS port, replace the value for com.hp.ov.nms.spi.qa.Nnm.secureport property with the value of nmsas.server.port.web.https obtained in step 2.

  6. Restart the NNM iSPI Performance for QA processes:

    ovstop -c qajboss

    ovstart -c qajboss

Configure the NNM iSPI Performance for QA to Use the Modified NNMi Web Services Client User Name, Password

If you have changed the password for the NNMi Web Services client user specified during the installation of the NNM iSPI Performance for QA:

  1. Log on to the NNMi Management Server as an administrator or root user.

  2. Run the following commands:

    • To encrypt new password, run the following command:

      nmsqaencryptpassword.ovpl -e qa <new password>

    • To copy nms-users.properties from NNM jboss to SPI jboss, run the following command:

      nmsqaencryptpassword.ovpl -c qa

  3. Restart the NNM iSPI Performance for QA with the following commands:

    ovstop -c qajboss

    ovstart -c qajboss

If you want to configure the NNM iSPI Performance for QA to use an NNMi Web Service Client user name that is different from the user name specified during the installation of the NNM iSPI Performance for QA, do as follows:

  1. Open the nnm.extended.properties file available in the following directory:

    • Windows: %NnmDataDir%\shared\qa\conf\
    • Linux: $NnmDataDir/shared/qa/conf/

  2. Edit the value of the following property:

    com.hp.ov.nms.spi.qa.Nnm.username

  3. Run the following commands:

    To encrypt password for the new user run the following command

    nmsqaencryptpassword.ovpl -e qa <password for the new user>

    To copy nms-users.properties from NNM jboss to SPI jboss, run the following command:

    nmsqaencryptpassword.ovpl -c qa

  4. Restart the NNM iSPI Performance for QA with the following commands:

    ovstop -c qajboss

    ovstart -c qajboss

Modify the NNM iSPI Performance for QA Ports

The NNM iSPI Performance for QA uses a set of ports for its operation. These ports are configured at the time of installation by the installer and the installer offers you the option to choose non-default values for the HTTP and HTTPS ports. The server.properties file provides a list of those ports. The file is available under the following directory:

  • Windows: %NnmDataDir%\nmsas\qa
  • Linux: /var/opt/OV/nmsas/qa

After installation, you can configure the NNM iSPI Performance for QA to use different ports (different from what was configured at the time of installation).

If you want to configure the NNM iSPI Performance for QA to use non-default ports:

  1. Log on to the NNMi Management Server as an administrator user.

    Log on to the NNMi Management Server as a root user.

  2. Open the server.properties file with a text editor.

  3. To resolve the port conflict created by another application on the system:

    1. Identify the port number in the file.

    2. Replace the port number with a new port number; make sure that the new port is not used by any other applications on the system.

  4. To use a new HTTPS port, replace the value of the nmsas.server.port.web.https property with the new HTTPS port.

  5. To use a new HTTP port, replace the value of the nmsas.server.port.web.http property with the new HTTP port.

  6. To use a new JNDI port, replace the value of the nmsas.server.port.naming.port property with the new JNDI port.

  7. To use a new port for the embedded database, replace the value of the com.hp.ov.nms.postgres.port property with the new port.

    Before you change this value, make sure that NNMi is configured to use the new port for the embedded database. For information on modifying the embedded database port for NNMi, see the NNMi Deployment Reference.

  8. Restart the NNMi services by using the following commands:

    ovstop -c ovjboss

    ovstart -c ovjboss

Update the NNM iSPI Performance for QA Configuration when the FQDN for the NNMi Management Server Changes

Any change in the host name on the NNMi server after deploying the NNM iSPI Performance for QA stops the NNM iSPI Performance for QA from working. Update the new FQDN in the NNM iSPI Performance for QA configuration for the NNM iSPI Performance for QA to continue working.

To update the new FQDN in the NNM iSPI Performance for QA configuration:

  1. Run the nnmofficialfqdn.ovpl command to find the FQDN of the new NNMi server.

  2. Edit the following parameter in the nms-qa.jvm.properties file to reflect the new FQDN:

    • Djava.rmi.server.hostname

    On Windows : %NnmdataDir%\shared\qa\conf\nms-qa.jvm.properties

    On Unix : /var/opt/OV/shared/qa/conf/nms-qa.jvm.properties

  3. Edit the following two parameters in the nnm.extended.properties file to reflect the new FQDN:

    • com.hp.ov.nms.spi.qa.Nnm.hostname
    • com.hp.ov.nms.spi.qa.spi.hostname

    On Windows : %NnmdataDir%\shared\qa\conf\nnm.extended.properties

    On Unix : /var/opt/OV/shared/qa/conf/nnm.extended.properties

  4. Edit the following two parameters in the server.properties file to reflect the new FQDN:

    • java.rmi.server.hostname
    • nmsas.server.net.hostname.private

    On Windows : %nnmdatadir%\nmsas\qa\server.properties

    On Unix : /var/opt/OV/nmsas/qa/server.properties

  5. Edit the login-config.xml file for the 'module-option' element, to reflect the virtual FQDN of the NNMi management server:

    On Windows : %nnminstalldir%\qa\server\conf\login-config.xml

    On Unix : /opt/OV/qa/server/conf/login-config.xml

    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.

  6. Edit the following parameters in the server.properties file to reflect the new FQDN:

    On Windows : %nnminstalldir%\qa\server\server.properties

    On Unix : /opt/OV/qa/server/server.properties

    1. java.rmi.server.hostname
    2. nmsas.server.net.hostname.private
    3. jboss.host.name

    4. jboss.node.name

    5. jboss.qualified.host.name
    6. nmsas.server.net.hostname
    7. nmsas.server.net.hostname.http

  7. Restart the NNMi services:

    ovstop –c

    ovstart -c

Send Help Center feedback