nnmsetiospeed.ovpl — Set the input or output speed on interfaces
nnmsetiospeed.ovpl { -? [ -node
<node ID>
| -interface
<interface ID list>
| -input
<input speed>
| -output
<output speed>
] [ -file
<CSV file>
]} [-verbosity
command verbosity
] [-failfast
fail-fast behavior
] [-jdniHost
hostname
] [-jdniPort
port
] [-u
username
-p
password
]
nnmsetiospeed.ovpl
sets the input or output speed of the specified interfaces on the specified nodes. Speeds are suffixed
by the units desired, e.g. 10mb is equivalent to 10000kb. If fail-fast behavior is desired, the command
will not make any modifications if any errors are encountered during execution.
nnmsetiospeed.ovpl
supports the following options:
-file <file path>
A file containing a comma-delineated list of commands to process
-node <node name, long name, UUID, or IP address (v4 or
v6)>
-interface <interface ID list>
Change the input or output speed of the specified interfaces on the indicated node.
The
$ALL
option will process all the interfaces on the indicated node.
Nodes may be identified by short name, long name, UUID, or IP address. The $ALL macro may be used in batch
mode as well.
The list
of interface identifiers should be enclosed in quotation marks to prevent the shell or console from
prematurely terminating the command.
Optionally, the following parameters can be specified; only the specified attribute will be printed:
-failfast
Ensures that no changes will be made if an error is encountered.
-verbosity <verbosity level>
Sets the verbosity of the command. Levels include "silent", "verbose", or "normal". When verbosity is set to "silent," no output is provided. When verbosity is set to "verbose," every error and status message is displayed. Normal (the default value) provides output somewhere between "silent" and "verbose".
-?
Prints 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.
-jndiHost <serverName>
The server JNDI host; default is localhost.
-jndiPort <port>
The server JNDI port; default is 1099.
The CSV file you supply must have the following syntax:
Required. Column 1. You must provide a value for the node identifier
Required. Column 2. You must provide a value for interface identifiers
Required. One of Column 2 or Column 3 (input/output speed)
You can omit an input or output speed by inserting nothing at the position in question.
Column 1(A) : Node Identifier
Required. The short name, long name, UUID, or IP address of the node on which to set the speed of interfaces
Column 2(B) : Interface Identifier List
Required. A semicolon-delineated list of interface identifiers or $ALL macro. Interface IDs may be one of the following: interface index, alias, name, or description of the interface. The list of interface identifiers should be enclosed in quotation marks to prevent the shell or console from prematurely terminating the command.
Column 3(C) : Input speed
Optional (if output speed is specified). The input speed of the interfaces to set
Column 3(C) : Output speed
Optional (if input speed is specified). The output speed of the interfaces to set
To set the speed of all the interfaces on a node with the name example-node to 10 MB
nnmsetiospeed.ovpl -node example-node -interface $ALL -input 10mb -output 10mb
To set the speed of individual interfaces specified by ifname, ifdescr, ifalias, and index of 10 MB
nnmsetiospeed.ovpl -node example-node -interface "ifname;ifdescr;ifalias;10" -input 10mb -output 1gb
CSV file to change the input and output speed of a single interface named FA0/3 to 7 GB:
example-node,Fa0/3,7gb,7gb
CSV file to change the input and output speed of a single interface with index 50 to 4 GB:
example-node,50,4gb,4gb
CSV file to change the input and output speed of interfaces named H1, A1, D1, F1, F2, and F3 to 5 GB:
example-node,H1;A1;D1;F1;F2;F3,5gb,5gb