Name

nnmconfigimport.sh — import the nnmconfigexport.sh XML output to the NNMi database.

SYNOPSIS

nnmconfigimport.sh -? | [-u <username> -p <password>] -f <input file or directory> [-x <file prefix>] [-memory <number of megabytes>] [-timeout <time in seconds>] [-sync -f <input file or directory>] [-jndiHost <hostname>] [-jndiPort <port>]

DESCRIPTION

nnmconfigimport.sh is a Perl script that enables you to import the output from the nnmconfigexport.sh script into the NNMi database.

NOTE: When performing an action import, you must restart the NNMi console (sign out, then sign in) for the changes to take effect.

Parameters

The nnmconfigimport.sh script supports the following options:

-?

Displays the usage statement.

-u <username>

Supply the NNMi administrator username to run the script.

-p <password>

Supply the NNMi administrator password to run the script.

-f <input file or directory>

Imports the configuration XML file, or, if you specify a directory, imports all of the files in that directory.

-x <file prefix>

The file prefix used to filter files to be imported when you use the -f option and specify a directory. Any files within the specified directory that are named <file prefix>-* will be imported, then sorted by dependencies.

-memory <number of megabytes>

The amount of memory available for the nnmconfigimport.sh script to perform work. The default is 512 megabytes. Larger import files may require this value be set to 1024 or 2048. This option is not presented in the usage message since it is used by the nnmconfigimport.sh script and not passed to the actual import tool.

-timeout <time in seconds>

The amount of time available for the import of a particular file to complete. Some import types such as incidents might require a larger timeout value based on the amount of data. The default is 3600 (60 minutes). This option is not presented in the usage message since it is used by the nnmconfigimport.sh script, and not passed to the actual import tool.

-sync -f <input file or directory>

Updates the target system to exactly match the contents of the import file(s). This means that objects not listed in the input file will be deleted on the target system.

-jndiHost <hostname>

The server jndi host. Default is localhost.

-jndiPort <port>

The server jndi port. Default port is 1099.

NOTES

For a majority of areas nnmconfigimport.sh appends to the existing configuration. And in a few areas like Discovery, Communication, Monitoring, and Status, the existing configuration settings are replaced. Please see Export/Import Behavior and Dependencies in the Online Help for more information.

In order to add configuration elements, you must run the nnmconfigexport.sh script with a provided author_key.

The nnmconfigimport.sh script automatically detects if you ran the nnmconfigexport.sh script using a provided author_key, and adds configuration entries instead of replacing them.

The Query Password field of a RAMS configuration will only be valid when you import it into the same NNMi installation on the same system. If you import it into a different system, you will need to re-enter the Query Password.

Never edit the nnmconfigexport.sh output files before importing them.

EXAMPLES

nnmconfigimport.sh -u system -p openview -f /tmp/nnmconfig.xml

Imports the customized configuration in the /tmp/nnmconfig.xml file to the NNMi database. (You must provide an NNMi username and password. In this case, the username is system and the password is openview.)

AUTHOR

nnmconfigimport.sh was developed by Hewlett Packard Enterprise.

Send Help Center feedback