Name

nnmloadseeds.sh — load discovery node seed information

SYNOPSIS

nnmloadseeds.sh -f seedFile [-t tenant] | -n seeds [-t tenant] | -list [-format LIST|TEXT|CSV|XML] [-fields name,tenant,results,modified,notes] [-u <username> -p <password>] [-jndiHost <hostName> Default: localhost] [-jndiPort <port> Default: 1099]

DESCRIPTION

nnmloadseeds.sh allows discovery seeds to be loaded using command line arguments (-n option) or from a text file (-f option) or listed (-list option). A seed is a device that you want NNM to use as a starting point for the spiral discovery process. Seed values are either IP addresses or host names. When using the -n option the seeds are entered on the command line, separated by white space. Seeds are always added to NNM even if they do not support SNMP.

The -f option accepts a file with a single entry specified per line. Each line has the following format:

IPAddress|HostName, "Optional Tenant Name or UUID" # (optional comment to help identify the node, if desired)

Where:

IPAddress = the IP address of the node you wish to add.

HostName = the host name of the node you wish to add.

Tenants can be optionally specified using either the tenant name or tenant UUID. The tenant specification must be contained within quotation marks. The node discovered from the seed will be assigned to the specified tenant. If no tenant is specified, the node will be assigned to the default tenant.

Comments can be deliminated with a # character. Additionally, you can use INCLUDE-FILE filename to include other seedfiles.

If you specify the -t option, the tenant you specify will be used for all nodes passed in via the -n option, or all nodes in the seed file specified with the -f option. If you use -t and -f and your seed file contains seeds with tenants specified, all seeds with specified tenants will be rejected as invalid seeds.

Note that you should set up the SNMP configuration for the devices being loaded before running this command.

Parameters

The nnmloadseeds.sh command recognizes the following parameters and options:

-f seedFile

Specify a text file to read the seeds from.

Note: The directory and filename of the seed file must be accessible for non-root users.

-n seeds

Specify seeds to load directly from the command line, with each seed separated by a space.

-list

Lists all seeds loaded by NNMi for discovery. The utility uses the standard formats defined for other NNMi tools: TEXT, CSV, XML, or LIST. The fields for the seed data can be limited by specifying: name, tenant, results, modified, and/or notes. These are pseudonyms for the column headers shown in the NNMi UI.

-t tenant name or UUID

Specify the tenant to be used for all seeds being loaded.

-u <username>

Supply the NNMi administrator username to run the script.

-p <password>

Supply the NNMi administrator password to run the script.

-jndiHost <serverName>

The server JNDI host; default is localhost.

-jndiPort <port>

The server JNDI port; default is 1099.

EXAMPLES

Load a list of devices as seeds:

 nnmloadseeds.sh -n mimcisco8540 15.2.112.22

Load seed for a node using its fully qualified name with username and password:

 nnmloadseeds.sh -u username -p password -n mimcisco8540.superpoller3.mim

Load seeds from a file name that is named seeds_to_load.txt:

 nnmloadseeds.sh -f /tmp/seeds_to_load.txt

Load seed for a node using its fully qualified name and specific tenant assignment:

 nnmloadseeds.sh -n mimcisco8540.superpoller3.mim -t Customer1

Load seeds from a file name that is named seeds_to_load.txt and assign all seeds to a given tenant:

 nnmloadseeds.sh -f /tmp/seeds_to_load.txt -t Customer2

List all loaded seeds in CSV format showing name and results of the seed discovery:

 nnmloadseeds.sh -list -format CSV -fields name,results

AUTHOR

nnmloadseeds.sh was developed by Hewlett Packard Enterprise.

FILES

$NMS_BIN/nnmloadseeds.sh

SEE ALSO

nnmseeddelete.sh(1M), nnmnodedelete.sh(1M).

Return to Reference Pages Index