19.4.3 Configuring NNMi for HA (Windows)
This subsection explains how to configure NNMi for HA in a Windows environment.
In HA configuration for NNMi, you create a new resource group for NNMi. Therefore, you must begin the configuration procedure when there is no resource group to be configured.
The script (nnmhaconfigure.ovpl) used to configure NNMi for HA internally creates a resource group and individual resources for the cluster software. When the configuration procedure is completed, the following resource group has been configured.
Resource name |
Resource type |
Description |
---|---|---|
virtual-host-name |
Network name |
Controls virtual host names. |
resource_group-IP |
IP address |
Controls virtual IP addresses. |
resource_group-mount |
Physical disk |
Controls the shared disk. |
resource-group-APP |
General-purpose script |
Controls the start, stop, and monitoring of NNMi. |
In WSFC, nnmhaconfigure.ovpl configures the above resources by internally executing commands such as cluster.exe.
resource-group is replaced with the HA resource group name.
Set the resource dependency so that the general-purpose script resource resource-group-APP requires IP-address-resource, disk-resource, and network-name-resource.
- Organization of this subsection
(1) Example of settings for each resource in WSFC
This subsection provides an example of the settings for each resource in WSFC when the configuration is completed. Replace resource-group with the actual HA resource group name.
Item |
Details |
---|---|
General |
|
Dependencies |
IP-address-resource |
Policies |
|
Advanced Policies |
|
Item |
Details |
---|---|
General |
|
Dependencies |
No dependencies |
Policies |
|
Advanced Policies |
|
#: DHCP is not enabled.
Item |
Details |
---|---|
General |
|
Dependencies |
No dependencies |
Policies |
|
Advanced Policies |
|
Item |
Details |
---|---|
General |
|
Dependencies |
network-name-resource, IP-address-resource, and disk-resource |
Policies |
|
Advanced Policies |
|
- #
-
For the script path, the full path with the environment variable expanded is set.
Example:
C:/ProgramData/Hitachi/Cm2NNMi/hacluster/jp1ha1/hamscs.vbs
(2) Configuring NNMi on the primary cluster node
Complete the procedure described below on the primary cluster node.
(a) Preparations
To start with the preparations:
If you have not already done so, complete the procedure described in 19.2 Verifying the prerequisites to configuring NNMi for HA.
If you have not already done so, install NNMi, and then verify that NNMi is working correctly.
Use the following command to back up all NNMi settings and data:
- Example:
nnmbackup.ovpl -scope all -target nnmi_backups
For details about this command, see 20. NNMi Backup and Restore Tools.
In the initial status of NNMi cluster environment configuration, the data in the primary cluster node must exactly match the data in the secondary cluster node. Therefore, restore the backup data obtained here during the secondary cluster node configuration procedure.
(b) Copying data to the shared disk
Next, copy data to the shared disk.
Provide a shared disk for the NNMi HA resource group.
Use Windows Explorer and the Disk Management tool to assign a drive letter.
- Important
Verify that the provided shared disk satisfies the following conditions:
Use the Disk Management tool to make sure that the shared disk displays online. If reserved is displayed, it indicates that WSFC has control of the shared disk. Use the Delete action from the WSFC user interface to remove the shared disk from WSFC control. Also use the Disk Management tool to confirm that the reserve flag has changed to online.
It has already been formatted.
It has enough free space.
It is not being used by any other resource group.
A user with administrator permissions has the Full Control permission, and a built-in Local Service user (Users group) has the Read & execute permissions.
Stop NNMi:
%NnmInstallDir%bin\ovstop -c net stop NnmTrapReceiver
Copy the NNMi files to the shared disk:
%NnmInstallDir%misc\nnm\ha\nnmhadisk.ovpl NNM -to HA-mount-point
- Important
Specify for HA-mount-point the drive of the shared disk or any directory under the shared disk drive (example: Y: or Y:\JP1).
The directory name cannot contain any spaces.
The directory NNM is created immediately below the specified path (example: Y:\NNM or Y:\JP1\NNM).
The storage directory cannot be renamed.
(c) Configuring NNMi for HA
Next, run NNMi's HA configuration.
-
Create an NNMi HA resource group:
%NnmInstallDir%misc\nnm\ha\nnmhaconfigure.ovpl NNM
For details about the configuration items for this command, see 19.9.2 NNMi-provided HA configuration scripts.
Make sure that you specify disk, not none, for the shared disk type. Specify for the shared disk the path specified in step 3 in subsection (b).
- Configuration example
-
The HA configuration items are listed below in the order they are entered interactively to nnmhaconfigure.ovpl. Enter appropriate values based on the information provided in Table 19‒3: NNMi HA primary cluster node configuration information in 19.4.2 Configuring NNMi for HA.
HA configuration item
Example setting
HA resource group name
jp1ha1
Virtual host name
lhost1
Network interface of the virtual host
Local area connection
Type of shared file system
disk (make sure that you specify disk)
Directory to be mounted
Y drive
- Important
-
Before you execute the configuration command, check the following notes:
-
If a value specified in nnmhaconfigure.ovpl is already in use by another resource group or resource, a resource creation error occurs. Before you execute nnmhaconfigure.ovpl, verify that the specified values are not already in use.
-
If a specified resource group name, IP address, or disk is already in use, the cluster software command executed to create resources results in an error. If an error occurs, nnmhaconfigure.ovpl terminates abnormally at that point, in which case the resource group and resources that had been created up to that point remain. Delete those remaining resources before you resolve the error and re-execute nnmhaconfigure.ovpl.
-
For the network interface for which a virtual address is set, verify the following:
-
In Networks in the Failover Cluster Management console, verify the resources that include a network address of logical IP address.
-
- Execution example
-
The following shows an example screen display in which the example configuration values are specified, where each input item follows a question mark (?).
C:\Program Files (x86)\Hitachi\Cm2NNMi\misc\nnm\ha>nnmhaconfigure.ovpl NNM QUESTION: Enter the name of HA resource group: ? jp1ha1 A primary node configuration has been discovered. QUESTION: Enter a valid virtual host name: ? lhost1 Available network interface: Network subnet mask Network interface 255.255.255.0 Cluster network 3 255.255.255.0 Cluster network 1 Available value: 1: Cluster network 3 2: Cluster network 1 QUESTION: Enter the type of shared file system: ? 2 Available value: 1: disk 2: none QUESTION: Enter the type of shared file system (disk, none): ? 1 QUESTION: Enter the directory to mount disk: ? Y: Creating a resource group. Creating the resource group 'jp1ha1'... Group Node Status -------------------- --------------- ------ jp1ha1 NNMX64-33 Offline Creating the resource group 'lhost1'... Resource Group Node Status ----------------------------------------------------------- lhost1 jp1ha1 NNMX64-33 Offline Making the resource 'lhost1' dependent on the resource 'jp1ha1-IP'... Configuring the HA value C:/ProgramData/Hitachi/Cm2NNMi/shared/nnm/conf/ov.conf. Disabling the automatic startup of HP OpenView Process Manager service. [SC] ChangeServiceConfig SUCCESS Note: Updating NNMi FQDN to match the specified virtual host name. Configuring fqdn to lhost1.xxx.xxx. Configuring the domain to xxx.xxx. Microsoft (R) Windows Script Host Version 5.7 Copyright (C) Microsoft Corporation 1996-2001. All rights reserved. Generating a new SSL certificate. Generating a key store certificate of lhost1.xxx.xxx.selfsigned. [Completed successfully] Exporting the generated certificate to the trust store. The certificate has been saved in temporary.cert. The certificate has been added to the key store. C:\Program Files (x86)\ Hitachi\Cm2NNMi\misc\nnm\ha
-
Configure resource-group in such a manner that failover occurs in the event of a monitoring process error.
Open the properties of resource-group-APP, and then click the Policies tab.
Verify that If restart is unsuccessful, fail over all resources in this service or application is selected, and then set Maximum restarts in the specified period to 0.
If it is selected, clear the check box If all the restart attempts fail, begin restarting again after the specified period (hh:mm).
- Important
-
Configuration of resource-group and the resources registered to resource_group is used to specify actions such as error handling. For details about the role of each configuration item, see the cluster service Help.
-
On the primary cluster node, disable the NNMTrapReceiver service automatic start feature.
From the Start menu, select Administrative Tools > Services, and select NNM Trap Receiver and NNM Trap Receiver Manager, and then set Startup type to Manual.
-
By restarting, the specified configuration settings are applied and the NNMi environment variables are loaded. You can start and stop the service by executing the net start ClusSvc and net stop ClusSvc commands, respectively.
- Important
-
If you use HTTPS communications to access the NNMi server, you must configure the cluster to use an appropriate certificate. For details, see 10.3.6 Working with Certificates in High-Availability Environments.
(d) Verifying the startup
Lastly, verify the startup.
Start the NNMi HA resource group.
Execute the start command on the primary cluster node.
Execute the following start command:
%NnmInstallDir%misc\nnm\ha\nnmhastartrg.ovpl NNM resource-group
Verify that resource-group has started.
If NNMi does not start successfully, see 19.8 Troubleshooting the HA Configuration.
NNMi is now running under HA.
- Important
Do not use the ovstart and ovstop commands for normal NNMi operation in the HA configuration. Use these commands only when instructed to do so for HA maintenance purposes. To start and stop NNMi in the HA configuration, start or stop the HA resource group by using the cluster software.
(3) Configuring NNMi on the secondary cluster node
(a) Preparations
Start with the preparations:
If you have not already done so, complete the procedure described in 19.2 Verifying the prerequisites to configuring NNMi for HA
If you have not already done so, install NNMi, and then verify that NNMi is working correctly.
Restore the backup data.
Restore onto the secondary cluster node the backup data obtained in step 3 in subsection (a) in (2) Configuring NNMi on the primary cluster node.
%NnmInstallDir%bin\nnmrestore.ovpl -force -partial -source backup-data
For details about this command, see 20. NNMi Backup and Restore Tools.
(b) Configuring NNMi for HA
Next, run NNMi's HA configuration.
Stop NNMi.
%NnmInstallDir%bin\ovstop -c net stop NnmTrapReceiver
Configure the NNMi HA resource group:
%NnmInstallDir%misc\nnm\ha\nnmhaconfigure.ovpl NNM
Specify the HA resource group name when prompted by the command.
Execution example
C:\Program Files (x86)\Hitachi\Cm2NNMi\misc\nnm\ha>nnmhaconfigure.ovpl NNM QUESTION: Enter the name of HA resource group: ? jp1ha1 a secondary node configuration has been discovered. Disabling the automatic startup of HP OpenView Process Manager service. [SC] ChangeServiceConfig SUCCESS Note: Updating NNMi FQDN to match the specified virtual host name. Configuring fqdn to lhost1.xxx.xxx. Configuring the domain to xxx.xxx. Microsoft (R) Windows Script Host Version 5.7 Copyright (C) Microsoft Corporation 1996-2001. All rights reserved. Generating a new SSL certificate. C:\Program Files (x86)\ Hitachi\Cm2NNMi\misc\nnm\ha
On the secondary cluster node, disable the NNMTrapReceiver service automatic start feature.
From the Start menu, select Administrative Tools > Services, and select NNM Trap Receiver and NNM Trap Receiver Manager, and then set Startup type to Manual.
Verify that configuration was successful:
%NnmInstallDir%misc\nnm\ha\nnmhaclusterinfo.ovpl -group resource-group -nodes
This command outputs a list of all nodes that are in the specified HA resource group.
On the secondary cluster node, restart the cluster service.
By restarting, the specified configuration settings are applied and the NNMi environment variables are loaded. You can start and stop the service by executing the net start ClusSvc and net stop ClusSvc commands, respectively.
Optionally, test the configuration by taking the HA resource group on the primary node offline and then bringing the HA resource group on the secondary node online.
- Important
Problems might occur in the created resource group, such as the service no longer starts successfully if the NNMi default values for resource group and resource configuration are changed.
Special care is needed if the following configuration item is changed to a value that is smaller than its default value:
Length of period during which the cluster service waits until it restarts a resource
- WSFC standard installation:
Period on the Policies tab for the resource-group-APP properties (default value: 30:00 minutes)
DeadlockTimeout value for the resource-group-APP properties (default value: 2,700,000 milliseconds)