Customized output from:
Document Release Date: February 2018 Software Release Date: February 2018 |
|
The only warranties for Seattle SpinCo, Inc and its subsidiaries (“Seattle”) 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. Seattle 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. Except as specifically indicated, valid license from Seattle 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.
(missing or bad snippet)© 1999-2018 Hewlett Packard Enterprise Development LP
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.


The manual, interactive installation method uses an easy-to-use installation wizard.
The silent installation method uses a properties file to provide all installation-specific settings to the NNMi installer.
NNMi 10.50 supports the following operating systems:
Choose whether NNMi has to be installed in an Application Failover or HA cluster.
NNMi 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.
Ports
Verify that all of the following ports are free before installing NNMi:
Before installing NNMi, make sure that the firewall on your NNMi management server and other antivirus software applications do not block any of the above ports.
FQDN Configuration
Before you install NNMi on the management server, complete the following actions:
Determine the official fully-qualified domain name (FQDN) of the NNMi management server. You will need this information during installation. The official FQDN must meet the following requirements:
HA Cluster Requirements
Before installing NNMi in an HA cluster, you must make sure that the HA software is correctly installed on all the systems in the cluster. Also, see the Support Matrix to make sure NNMi supports the HA software that you are going to use.
(Optional) Proxy Server Timeout
If the network you plan to manage uses a proxy server to act as an intermediary for NNMi requests, ensure that its timeout value is at least five minutes.
XServer
You can install NNMi from the console by using an XServer with the $DISPLAY variable set appropriately. Make sure that the XServer application is installed on the server and the $DISPLAY variable is correctly set.
Public Key
You must import the necessary public key into the Linux RPM database before installing NNMi.
To import the public keys:
Download the following file on the system where you plan to install the product:
https://softwaresupport.softwaregrp.com/documents/10180/0/MF_public_keys.tar.gz
MF_public_keys.tar.gz file into a local directory.Go to the directory where the contents of the file are extracted, and then run the following command:
rpm --import *.asc
rpm --import *.pub
The command imports all the key files that were present in the MF_public_keys.tar.gz file.
Install Libraries
Before installingupgrading NNMi, make sure the following libraries are installed:
| Linux Version | Package | Library |
|---|---|---|
| glibc | /lib64/libc-2.12.so |
| libaio | /lib64/libaio.so.1 | |
| libXtst | /usr/lib64/libXtst.so.6 | |
| libXi | /usr/lib64/libXi.so.6 | |
| liberation-fonts-common | ||
| liberation-sans-fonts | ||
| glibc | /lib64/libc-2.17.so |
| libaio | /lib64/libaio.so.1 | |
| libXtst | /usr/lib64/libXtst.so.6 | |
| libXi | /usr/lib64/libXi.so.6 | |
| liberation-fonts-common | ||
| liberation-sans-fonts | ||
| SUSE Linux Enterprise Server 11 | glibc | /lib64/libc-2.11.3.so |
| libaio | /lib64/libaio.so.1 | |
| xorg-x11-libs | /usr/lib64/libXtst.so.6 /usr/lib64/libXi.so.6 | |
| liberation-fonts-common | ||
| liberation-sans-fonts | ||
| SUSE Linux Enterprise Server 12 | glibc | /lib64/libc-2.19.so |
| libaio | /lib64/libaio.so.1 | |
| libXtst6 | /usr/lib64/libXtst.so.6 | |
| libXi6 | /usr/lib64/libXi.so.6 | |
| liberation-fonts-common | ||
| liberation-sans-fonts |
Configure Swap Space
Configure the swap space of the system to at least one and a half times physical memory.
Disk partition recommendation
If you partition your disk, you should ensure that the file systems containing the directories listed in the following table have at least the specified disk space available for NNMi. If you use all-in-root partitioning, you should ensure that the total required disk space is available.
It is recommended that you keep at least 1 GB free space in the /tmp directory.
Tune Linux Kernel
Tune the Linux kernel parameters listed in the table below.
| Kernel Parameter | Description | Steps |
|---|---|---|
| UDP Receive Buffer | NNMi requires sufficient amount of memory for User Datagram Protocol (UDP) buffering. Set the UDP buffer properties to the following values:
|
|
| UDP Send Buffer | ||
Shared Memory | NNMi requires you to set the Shared Memory to at least 12 GB (recommended: 64 GB). |
|
| Number of open files per process | This parameter should be set to at least 16384. |
|
Disable Anti-Virus Software
To improve installation performance, turn off the anti-virus software on the target system by following these steps:
(Optional) Install the BSM Connector
On Red Hat Enterprise Linux 7.x only. If you need to install the BSM Connector 10.01 on this system for the NNMi-OMi integration, make sure to install the BSM Connector before beginning to install NNMi.
Prerequisites for the Oracle Database
To improve performance and to avoid a port conflict with NNMi, Oracle must be installed on a separate server from the NNMi management server.
An Oracle database administrator creates the NNMi Oracle database. To install an Oracle database instance for NNMi, complete the following tasks:
Assign a tablespace size depending on the number of nodes in your installation. For example, for an 18,000 node network, set your beginning tablespace size for 12 gigabytes (GB). Set the option for unlimited tablespace extensions in increments of 12 GB.
The database requirement grows as NNMi discovers additional nodes, so watch this growth carefully and expand your configured tablespace size when necessary.
It is important to assign a large enough tablespace quota to a user. If the tablespace is not large enough, NNMi will be installed, but will be unable to create the tables. This causes problems after the installation. To prevent this, set the quota to unlimited, but no smaller than 1MB before installing NNMi.
Create an Oracle user and assign the user to the newly created tablespace. The user should have the following permissions:
SELECT ANY DICTIONARY
You can opt to not grant the SELECT ANY DICTIONARY permission to the user. If you do not grant the SELECT ANY DICTIONARY permission, NNMi does not show any information in the Health tab (under the Help > System Information menu).
For Oracle 12.1.0.1.0 only. The SELECT ANY DICTIONARY permission, however, is required for the NNMi installation if you use Oracle 12.1.0.1.0. You can revoke the SELECT ANY DICTIONARY permission after the installation is complete.
Oracle provides the high-availability solution Oracle Real Application Cluster (RAC). The RAC solution uses two physical Oracle database servers. If the first server malfunctions or the administrator invokes a failover (for example, to complete maintenance on the first server), the second server automatically takes over, and NNMi begins using the second server. There is a short time window of data loss that might occur after the failover occurs. The amount of data loss increases with the size of the managed network and the rate of traps and incidents being evaluated. To configure RAC, work with your Oracle database administrator to install an Oracle database according to the instructions provided by Oracle.
Preparation for Application Failover
To create an NNMi Application Failover cluster, you must identify two servers, install NNMi on each of them, and then configure one server to be the active server while the other server remains in the standby mode. Both the servers must have unrestricted network access to each other.
Double-click the setup.exe file from the media root. The installation process prompts you for the language you want to use, and allows you to pick from the languages you configured your system to support. Then the software checks to make sure you are ready to proceed with the installation.
Run the following command:
./setup.bin
The installation process prompts you for the language you want to use, and allows you to pick from the languages you configured your system to support. Then the software checks to make sure you are ready to proceed with the installation.
Note: If a dialog box appears during the NNMi installation stating that the code signing key could not be found, do the following:
Download the following file on the system where you plan to install the product:
https://softwaresupport.softwaregrp.com/documents/10180/0/MF_public_keys.tar.gz
Extract the contents of the MF_public_keys.tar.gz file into a local directory.
Go to the directory where the contents of the file are extracted, and then run the following command:
rpm --import *.asc
rpm --import *.pub
The command imports all the key files that were present in the MF_public_keys.tar.gz file.
If you are performing these steps from a remote server by using an XServer, and if the DISPLAY variable is not set correctly, the following message may appear:
Choose locale....
------------------------
-
-
CHOOSE LOCALE BY NUMBER:
If you see this message, do not continue with the installation. Stop the installation by pressing Ctrl+C, make sure that the DISPLAY variable is set correctly, and then run the setup file again.
On the Setup Type page, select Typical; then click Next.
On the Choose the folders page, accept the default location for the application and data folders, or browse to a different location; then click Next.
This dialog box does not appear if you have previously installed other Micro Focus Software applications on this server.
Do not use any of the following locations for the data folder: C:\Window, C:\Program Files, or C:\Program Files(x86). Micro Focus recommends using the default data directory, C:\ProgramData. You can choose other locations, such as drive:\data or drive:\yourdirectorychoice\data.
Because NNMi is a 64-bit application that also installs 32-bit binaries, you must install NNMi in any folder other than drive:\Program Files (the 64-bit folder). The recommended folder is: drive:\Program files(x86).
Installing NNMi using Server Message Block (SMB)/Common Internet File System (CIFS) networking protocol (Samba) is not certified. Do not attempt to install NNMi onto a mapped network drive.
On the Enter your database server information page:
Type the Host Name of the Oracle database system.
If you are using Oracle RAC, type the physical host name of one of the Oracle servers.
Oracle provides the high-availability solution Oracle Real Application Cluster (RAC). The RAC solution uses two physical Oracle database servers. If the first server malfunctions or the administrator invokes a failover (for example, to complete maintenance on the first server), the second server automatically takes over, and NNMi begins using the second server. There is a short time window of data loss that might occur after the failover occurs. The amount of data loss increases with the size of the managed network and the rate of traps and incidents being evaluated. To configure RAC, work with your Oracle database administrator to install an Oracle database according to the instructions provided by Oracle.
The Product Requirements: Install Checks page displays progress as the installer checks for additional NNMi installation requirements. After the check completes, click Next.
On the installer page, click Install.
The Choose Java JDK dialog box opens.
NNMi requires that Java Development Kit (JDK) 1.8.x be available on the system. This version of the NNMi installer contains OpenJDK 1.8. You can select the Install NNMi-bundled OpenJDK option to install OpenJDK 1.8 that is embedded with the NNMi media.
Alternatively, if another version of JDK 1.8.x is already available on the system, you can select the Use Already-Installed JDK option, and then click Browse to select the path to the JDK.
On Linux, it is recommended that you use the JDK 1.8.x provided by your operating system vendor (Red Hat or SUSE).
For example:
To install Red Hat OpenJDK 1.8.x on Red Hat Enterprise Linux, run the following command:
yum install java-1.8.0-openjdk-devel.x86_64
To install SUSE OpenJDK 1.8.x on SUSE Linux, run the following command:
zypper install java-1_8_0-openjdk
To find out the directory where OpenJDK is installed, run one of the following commands:
whereis java
which java
If you manually installed JDK 1.8, be sure to check that the JDK installation directory is accessible to all users. To grant all users access to the JDK installation directory, run the following command:
chmod -R 755 <JDK_path>
In this instance, <JDK_path> is the complete path to the JDK's bin directory.
On Windows, it is recommended that you install the Oracle JDK 1.8.x.
Tip: Click Validate to check that the specified path is valid.
After making a selection, click Continue.
On the Pre-Install Summary page, review your installation choices; then do one of the following actions:
The installation process installs NNMi and performs some initial configuration; this process normally takes between ten and thirty minutes to complete.
As part of the installation process, NNMi performs additional checks to ensure that all installation requirements are met. If you do not meet one or more installation requirements, NNMi displays the appropriate error, warning, or informational dialog boxes to assist you in rectifying the problem. Take each of the required actions so that the NNMi installation can continue.
On the Pre-Install Summary page, review your installation choices; then do one of the following actions:
To change any of the settings, click Previous.
To start the installation process, click Install.
The installation process installs NNMi and performs some initial configuration; this process normally takes between ten and thirty minutes to complete.
As part of the installation process, NNMi performs additional checks to ensure that all installation requirements are met. If you do not meet one or more installation requirements, NNMi displays the appropriate error, warning, or informational dialog boxes to assist you in rectifying the problem. Take each of the required actions so that the NNMi installation can continue.
The installation process searches for an official fully-qualified domain name (FQDN) for the NNMi management server. If the dialog box contains an incomplete or unresolvable FQDN, modify the name; then click OK.
This entry is used as the official FQDN to provide users with access to the NNMi management server. It is also used to enable Single Sign-On (SSO) for NNM iSPIs. For SSO to work, URL access to NNMi and NNM iSPIs must share a common domain. If you do not have a FQDN for the NNMi management server, you can substitute the NNMi management server’s IP address; however, this will make the single sign-on for NNM iSPIs unusable.
To use the silent installation method with the help of the sample properties file:
ovinstallparams.ini file from the support directory of the NNMi installation media to the /tmp directory if you are using Linux NNMi management servers.ovinstallparams.ini file from the support directory of the NNMi installation media to the %TEMP% directory.Modify the ovinstallparams.ini file as shown below:
The following entries set the silent installation script to use the embedded database. Configure these settings as shown below:[obs.install]db.embedded=Solid
The following entry sets the HTTP port number for accessing NNMi. A common approach is to use port 8004 (the existing port number) if you are installing NNMi on a Windows operating system:[nonOV.jboss]
httpport=8004
Under the [installer.properties] section, add the following parameter to choose a non-default Java Development Kit (JDK) installation.
Note: NNMi 10.50 installer, by default, installs OpenJDK 1.8. If you have already installed an instance of OpenJDK 1.8 or Oracle JDK 1.8 on the system, use this parameter to specify the home directory of the already installed JDK.
com.hp.ov.nms.jdk.dir=
Set the parameter to the home directory of a JDK 1.8 instance that has already been installed.
Do not add the parameter if you want to use the embedded OpenJDK 1.8.
Modify the ovinstallparams.ini file as shown below:
The following entries set the silent installation script to use the embedded database. Configure these settings as shown below:[obs.install]db.embedded=Solid
The following entry sets the HTTP port number for accessing NNMi. A common approach is to modify the port to 80 if you are installing NNMi on a Linux operating system.
[nonOV.jboss]
httpport=80
Under the [installer.properties] section, add the following parameter to choose a non-default Java Development Kit (JDK) installation.
Note: NNMi 10.50 installer, by default, installs OpenJDK 1.8. If you have already installed an instance of OpenJDK 1.8 or Oracle JDK 1.8 on the system, use this parameter to specify the home directory of the already installed JDK.
On Linux, it is recommended that you use the JDK 1.8.x provided by your operating system vendor (Red Hat or SUSE).
For example:
To install Red Hat OpenJDK 1.8.x on Red Hat Enterprise Linux, run the following command:
yum install java-1.8.0-openjdk-devel.x86_64
To install SUSE OpenJDK 1.8.x on SUSE Linux, run the following command:
zypper install java-1_8_0-openjdk
To find out the directory where OpenJDK is installed, run one of the following commands:
whereis java
which java
If you manually installed JDK 1.8, be sure to check that the JDK installation directory is accessible to all users. To grant all users access to the JDK installation directory, run the following command:
chmod -R 755 <JDK_path>
In this instance, <JDK_path> is the complete path to the JDK's bin directory.
On Windows, it is recommended that you install the Oracle JDK 1.8.x.
com.hp.ov.nms.jdk.dir=
Set the parameter to the home directory of a JDK 1.8 instance that has already been installed.
Do not add the parameter if you want to use the embedded OpenJDK 1.8.
db.instance parameter.cd command to change to the media root../setup.bin -i silentovstatus -covstop -c command.nnmchangesyspw.ovpl script to set the system password. You will need this new system password to run the Quick Start Configuration Wizard.nnmchangesyspw.ovpl script to set the system password. You will need this new system password to run the Quick Start Configuration Wizard.ovstart -c command.%NnmDataDir%\log\nnm\ /var/opt/OV/log/nnm/The most important log file is the following file:
nnm-install-config.log: Contains a record of the most recent installation, including the processes that have been initialized. The installation is successful if you see the following message in the nnm-install-config.log file:
Installation was successful.
Configure the nnm-server.properties file for Oracle RAC
Skip this section if you do not use Oracle RAC.
Oracle RAC requires a secondary Oracle RAC server. To configure that information, after NNMi installation, do the following:
Open the following file in a text editor:
%NnmDataDir%\shared\nnm\conf\props\nnm-server.properties
/var/opt/OV/shared/nnm/conf/props/nnm-server.properties
Locate the following line:
com.hp.ov.nms.oracle.otherHost=<SAME_AS_FIRST_HOST>
Run the following commands to restart NNMi:
Install iSPIs
For NNMi Ultimate or Premium. If you want to use NNMi with iSPIs, follow this sequence of installation:
Make sure that NNMi is successfully installed.
Install the NNM iSPI Performance for Metrics with Network Performance Server (available with the NNM iSPI Performance for Metrics media).
See the NNM iSPI Performance for Metrics Interactive Installation and Upgrade Guide for more information.
Configure the HA cluster
Complete the installation procedure on both the nodes in the HA cluster, and then follow the instructions in the Configure high availability cluster section in NNMi help center.
Configure the application failover cluster
Complete the installation procedure on both the nodes in the HA cluster, and then follow the instructions in the Configure application failover section in NNMi help center.
Perform initial configuration tasks
Micro Focus recommends that you use the Quick Start Configuration Wizard for initial setup.
If you plan to manage areas in your network that contain overlapping IP addresses resulting from using Network Address Translation (NAT), choose one address domain for the Quick Start Wizard to discover (no duplicate addresses). Then, see additional discovery information in Overlapping Addresses in NAT Environments in the NNMi help center.
After initial configuration, you can use the NNMi console for additional configuration tasks, such as adding nodes to the network topology and configuring monitoring.
To use the Quick Start Configuration Wizard:
Add Community Strings page, enter a community string for one of the nodes in the discovery range; then click Add. Repeat this step until the SNMP Community Strings list includes the community strings for all nodes in the discovery range; then click Next.Configure Auto Discovery page, add the IP address range for the quickstart rule; then click Next. Add Discovery Seeds page, add discovery seed information for your network; then click Next. Test Seeds page, review the results of the communication tests. If any of the seed nodes cannot be reached with the community strings that you identified earlier, click Previous to navigate to the Configure Community Strings page. Correct the community strings; then click Next.CreateAdministrator Account page, enter a User Name, set the Password for a new account for administering the NNMi software, then click Next.Summary page, review the information that you specified; then do one of the following actions:
Wizard is complete page indicates that you have successfully configured NNMi to discover a portion of your network. Click Previous to make changes or click Launch UI.You cannot use the Quick Start Configuration Wizard to complete SNMP Version 3 (SNMPv3) configuration. If you have devices that you prefer to monitor using SNMPv3, do the following:
The NNMi installer includes a temporary Instant-On license key that is valid for 60 days after you install NNMi. This temporary Instant-On license key enables you to use NNMi Ultimate features. You should obtain and install a permanent license key as soon as possible.
The following information discusses some possible installation problems and solutions:
Inadequate Disk Space During Installation on Linux
NNMi installs all application binaries in the /opt/OV directory and all data files in the /var/opt/OV directory.
See the Network Node Manager i Software Support Matrix for the disk space requirements for your server. If you do not have enough disk space in either /opt/OV or /var/opt/OV, use the following workaround to address the problem:
Create symbolic links from the install targets to larger partitions that have enough available disk space to install the binaries and store the data files. The syntax to create the symbolic links is as follows:
Failure to Open the Installation Wizard on Linux
If the installation wizard fails to open and the No protocol specified message appears in the console, verify that you logged on to the system as root.
Inability to Locate MEDIA Images
When the installation wizard stops during initialization and shows the locate MEDIA images pane with a message to manually select the media, you can conclude the NNMi installation media is not correctly downloaded on the server.
To resolve this problem, download the media again and start the installation.
© 1999-2018 Micro Focus or one of its affiliates