• Feature Overview
• Example Overview
• Compiling and Running the Example

Feature Overview

When you want to configure multiple devices using the same ConfigTask, the devices can be grouped together and associated with the task.  When this is done, the task is executed over a set of devices.

Example Overview

Example Name: MultiTaskConfiguration.java
Location:  <Web NMS Home>/examples/configuration directory.

Compiling and Running the Example

Compiling the Example

If you are doing any modifications to the example, then it has to be compiled using the command

javac -d <Web NMS Home>/classes MultiTaskConfiguration.java

Setting the Classpath

For setting the classpath required to execute this example, execute the file setEnv.sh/bat present in <Web NMS Home>/examples/configuration directory.

Running the Example

The example can be invoked using the command

java com.adventnet.nms.example.config.MultiTaskConfiguration  <parameters>

Here, <parameters> implies the data supplied for the ConfigServer for performing the configuration.

List of Parameters
 

Parameter	Description
-d (optional)	Enables or disables the generation of debugging information.  By default, it is set to "false".
-u (mandatory)	Specifies the name of the user who is configuring the device.
-P (mandatory)	Password of the user who is configuring the device.
-h (optional)	Specifies the host name where the ConfigServer is running. By default, "localhost" is taken.
-p (mandatory)	The port at which the ConfigServer is running. Refer to the file CSPORT.html present in <Web NMS Home>/html directory to know the port number.
-t (mandatory)	The name of the combined task.
-o (optional)	This option is used to specify whether to overwrite the combined task, if already exists.  This will take value "true" or "false".
-s (optional)	Specifies whether the devices have to be configured sequentially or not.  This will take value "true" or "false".
-r (optional)	Specifies whether rollback is required or not.  This will take value "true" or "false".
-st (mandatory)	Specifies the sub task name along with the device list over which it has to be executed.
-S [Snmp Port]	This is the SNMP port that has to be used for performing configuration.

Let us assume a task named "task1" has been created to change the sysName of a particular device and "task2" to change the sysLocation.  Let us assume that the first task has to be executed over two devices, namely "device1" and "device2", and second task over "device3" and "device4".  Then the command should be like:

java com.adventnet.nms.example.config.MultiTaskConfiguration -d -u root -P public -p 9000 -t task3 -o true -r true -st task1 device1 device2 -st task2 device3 device4