Name

nnmnoderediscover.sh — Discover node details after the node has changed

SYNOPSIS

nnmnoderediscover.sh -help | -node <hostName> [-tenant <name>] [-fullsync] | -rm <Regional NNMi management server> [-fullsync] | -file <filename> [-tenant <name>] [-fullsync] | -all [-fullsync] [-u <username> -p <password>] [-jndiHost <hostName> Default: localhost] [-jndiPort <port> Default: 1099]

DESCRIPTION

nnmnoderediscover.sh places node(s) into the NNMi discovery queue. The amount of time before the node starts discovery is dependent on how long NNMi takes to get to the node in the queue.

If the node is already in the discovery queue, it is not added again.

Note that when using the NNMi Advanced Global Network Management feature, nodes that are managed by a Regional Manager only go through discovery on the Regional Manager (NNMi management station) and are not rediscovered by the Global Manager.

The -rm option is for the NNMi Advanced Global Network Management feature. It is used when issuing the nnmnoderediscover.sh script on a Global Manager. NNMi requests that the Regional Manager (NNMi management server) send the most recent discovery results to the Global Manager.

The -file option accepts a file with a single entry specified per line. Each line contains a short name, or a fully-qualified DNS domain name, or an IP address. Each line has the following format: HostName # (optional comment to help identify the node) Where: HostName = the short name or DNS name or IP address of the node you want to add.

The -all option causes all nodes managed by the local NNMi management server to be rediscovered. Note that when you use the NNMi Advanced Global Network Management feature and issue the nnmnoderediscover.sh script on a Global Manager, the most recent discovery results are sent from the Regional Manager to the Global Manager.

The -tenant option identifies nodes with non-unique names or IP addresses such as might can the case with overlapping address domains. The name passed with the argument is the quoted tenant name.

The -fullsync option causes resynchronization to the node's states and status following the rediscovery of the node. When run from a Global Manager, the Global Manager's nodes are updated from the Regional Manager's nodes. When run from a Regional Manager, the command does a resynchronization for the regional node(s) and also does a resynchronization on the Global Manager for those nodes that belong to the given Regional Manager. This is an optional flag, which does not affect the algorithm for choosing which nodes are of rediscovered.

Parameters

nnmnoderediscover.sh supports the following options:

-node <hostName>

The hostname of the node to rediscover.

-rm <RegionalManagerName>

When using the NNMi Advanced Global Network Management feature and issuing the nnmnoderediscover.sh script on a Global Manager, the Name attribute value identifies a Regional NNMi management server.

-file <fileName>

Specifies a text file to read the nodes from.

-all

Specifies all nodes are to be rediscovered.

-tenant <name>

Optional parameter that when paired with a node name or IP will identify the node in domains where the name or IP can be non-unique.

-fullsync

Optional parameter that directs NNMi to resynchronize a node's states and status following the rediscovery of each node.

-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.

-help

Displays the usage statement.

EXAMPLES

nnmnoderediscover.sh -u username -p password -node myNode -tenant myTenant

Rediscovers the node myNode that is a member of the tenant myTenant. You must provide a valid administrator username and password.

nnmnoderediscover.sh -u username -p password -rm myRegionalManager

Rediscovers all nodes associated with myRegionalManager. You must supply a valid NNMi administrator username and password.

nnmnoderediscover.sh -u username -p password -file myFile -fullsync

Reads the nodes specified in the myFile file and places them into the NNMi discovery queue. Following the rediscovery of each node, the state and status for the node will be resynchronized. You must provide a valid adminstrator username and password.

Diagnostics

nnmnoderediscover.sh returns the following exit codes:

0

Operation was successful.

1

An error occurred; see error message for details.

AUTHOR

nnmnoderediscover.sh was developed by Hewlett Packard Enterprise.

SEE ALSO

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

Return to Reference Pages Index