Product Documentation

Customizing Built-in and Custom Tasks

Dec 18, 2015
You can customize built-in tasks to create custom tasks from them. When you customize a built-in task, the commands and variables are imported and you can define the name, category, and description of the task according to your requirements. You can also customize custom tasks to create new custom tasks.
Note: The customize option is not available for the following built-in tasks:
  • AddWCCPServiceGroup
  • EnableWCCP
  • DisableWCCP
  • SetApplication
  • SetTrafficShapingPolicy
  • AddTrafficShappingPolicy
  • AddService

To customize tasks

  1. On the Configuration tab, in the left pane, under Configuration, click Built-in Tasks or Custom Tasks.
  2. In the right pane, under Built-in Tasks or Custom Tasks, select the task you want to customize, and from the Action drop-down list, click Customize.
  3. Under Customize Task, in Task Name, type a name for the task, and in Description, type a description for the task.
  4. In Category, select the type of task you want to create. The available values are: General and Software Upgrade. Click the + (plus) sign to type a new category name.
  5. In Device Family, select the device family.
  6. Select one or more of the following check boxes:
    • Execute Sequentially : Specifies whether to execute the task on the devices in a sequential manner.
    • Execute on Inaccessible system(s) also : Specifies whether to execute the task on inaccessible devices also.
    • Enable RBA : Specifies whether the user should provide user credentials before task execution.
    • Enable Auto Rollback : Specifies whether rollback commands are generated implicitly during runtime. When you enable this check box, you do not need to manually type rollback commands when adding actual commands in step 8.
    • Save configuration on success : Specifies whether the custom task is saved implicitly by Command Center on the NetScaler and CloudBridge devices. If you select this option, you do not have to explicitly add the "save config" command when creating a custom task.
  7. To add more commands, click Add Command.
  8. In the Command dialog box, in Command, type the command you want to execute. This must be the actual command that you need to execute on the managed device. The commands you define here may use the task variables. For example, to run the command, add filter policy <name> -rule <expression> (-reqAction <string> | -resAction <string>), enclose the task variables within the $ symbol as shown in the following example:

    The following is a sample command for creating and binding a filter policy:

    add filter policy $policyname$ -rule $expression$ -$actionType$ $actionname$ bind filter global $policyname$
  9. In the Protocol list, select the protocol you want to associate with the command.
  10. In the Rollback text box, type the rollback command to use if the actual command fails, and then click OK.
    Note: If you have selected the Enable Auto Rollback option in step 6, you do not need to type the rollback command here.
  11. To add variables, click Add Task Variable.
  12. Under Variable, specify the variable information, and then click OK.