nnmnoderediscover.ovpl — Discover node details after the node has changed
nnmnoderediscover.ovpl
-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]
nnmnoderediscover.ovpl 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.ovpl 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.ovpl 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.
nnmnoderediscover.ovpl 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.ovpl 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. 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.
-jndiHost <serverName>
The server JNDI host; default is
localhost.
-jndiPort <port>
The server JNDI port; default is 1099.
-help
Displays the usage statement.
nnmnoderediscover.ovpl -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.ovpl -u username -p password -rm myRegionalManager
Rediscovers all nodes associated with myRegionalManager. You must supply a valid
NNMi administrator username and password.
nnmnoderediscover.ovpl -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.
nnmnoderediscover.ovpl returns the following exit codes:
0
Operation was successful.
1
An error occurred; see error message for details.