Name

nnmsetiospeed.sh — Set the input or output speed on interfaces

SYNOPSIS

nnmsetiospeed.sh { -? [ -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 ]

DESCRIPTION

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

Parameters

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

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

Syntax of Comma-Separated File

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

EXAMPLES

To set the speed of all the interfaces on a node with the name example-node to 10 MB

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

RETURN VALUE

nnmsetiospeed.sh exits with the status 0 (zero) if no errors were encountered, 1 otherwise.

AUTHOR

nnmsetiospeed.sh was developed by Hewlett Packard Enterprise.

FILES

$NMS_BIN/nnmsetiospeed.sh

Return to Reference Pages Index