Name

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

SYNOPSIS

nnmconfigimport.ovpl -? | [-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.ovpl is a Perl script that enables you to import the output from the nnmconfigexport.ovpl 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.ovpl script supports the following options:

-?

Displays the usage statement.

-u <username>

Supply the NNMi administrator username to run the script. This script requires the NNMi administrator username unless you use an nnm.properties file. See the nnm.properties.4 reference page for more information.

-p <password>

Supply the NNMi administrator password to run the script. This script requires the NNMi administrator password unless you use an nnm.properties file. See the nnm.properties.4 reference page for more information.

-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 <memory in megabytes>

The amount of memory available for the nnmconfigimport.ovpl 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.ovpl 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.ovpl 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.ovpl 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.ovpl script with a provided author_key.

The nnmconfigimport.ovpl script automatically detects if you ran the nnmconfigexport.ovpl 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.ovpl output files before importing them.

EXAMPLES

nnmconfigimport.ovpl -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.ovpl was developed by Hewlett Packard Enterprise.

SEE ALSO

nnmconfigexport.ovpl(1M), nnm.properties(4).

Return to Reference Pages Index