Product Documentation

Managing Built-in Tasks

May 27, 2015

Built-in tasks are a set of predefined configuration tasks that you can execute on one or more managed devices. These tasks help you address the most commonly used configuration changes of the discovered devices. Command Center supports built-in tasks for both NetScaler and CloudBridge devices.

You can execute the built-in tasks instantly or schedule them for execution at a later time. You can view the execution log to check the task status and view the list of tasks scheduled for execution. You can also export a built-in task as an XML file. Note that you cannot modify or delete built-in tasks.

Use the following procedures for managing built-in tasks:

Upgrading NetScaler with Built-in Tasks

The built-in upgrade tasks that you can execute on NetScaler devices are:

  • SoftwareUpgrade-9.xto10.x: Upgrade one or more devices from the 9.x release to any version of the 10.x release of NetScaler.
  • SoftwareUpgrade-Within10.x: Upgrade one or more devices from the 10.x release to a newer 10.x version.
  • SoftwareUpgrade-Within9.x: Upgrade one or more devices from the 9.0 release to 9.1 or 9.2 releases of NetScaler, or from any version of 9.1 or 9.2 release to a newer version of 9.1 or 9.2. release. To execute this task, you must have the upgrade file present on the Command Center server or your local system, and you must specify the correct image file.
  • SoftwareUpgrade-8.xto9.x: Upgrade one or more devices from the 8.x release to any version of the 9.1 or 9.2 release of NetScaler . You must specify the upgrade file and/or the 9.x license file, and you must have these files present on the Command Center server or your local system. Note that image and license files are not prepackaged with Command Center, and you must copy these files from an appropriate location. When the user input screen prompts you, select the correct image and license files for the upgrade.
  • SoftwareUpgrade-8.xto9.0: Upgrade one or more devices from the 8.x release to any version of the 9.0 release of NetScaler, or from the 9.0 release to a newer version of 9.0.
  • SoftwareUpgrade-Within8.x: Upgrade one or more devices from the 8.0 release to a newer 8.x version. To execute this task, you must have the upgrade file present on the Command Center server or your local system, and you must specify the correct image file.

Configuring NetScaler with Built-in Tasks

The built-in configuration tasks that you can execute on NetScaler devices are:

  • ConfigureCompression Policy: Configure compression policies on NetScaler devices.
  • InstallSSLCert: Upload and install SSL certificates from the Command Center server to the discovered NetScaler devices.
  • ConfigureFilterPolicy: Configure filter policies on NetScaler devices.
  • NSConfigureSyslogServer: Configure syslog server settings on NetScaler devices.

Importing Application Templates with Built-in Tasks

You can import an application template to multiple NetScaler appliances using the Command Center built-in configuration task ImportApplicationTemplate.

Consider that you have an application template with configuration for optimizing traffic for an application. You want to import this template to ten other NetScaler devices that require a similar AppExpert application configuration. You can import the application template to the ten NetScaler devices simultaneously using the ImportApplicationTemplate built-in task.

Note: This feature works only with NetScaler release 9.3 application templates.

Upgrading CloudBridge with Built-in Tasks

The built-in upgrade task that you can execute on a CloudBridge device is:

  • Software Upgrade: Use this task to upgrade one or more CloudBridge devices to a newer release of the CloudBridge software by specifying the path to the installation file of the software version to which you want to upgrade.
Note: This task is supported only on CloudBridge VPX, CloudBridge 600, Repeater 8500 and Repeater 8800 appliances.

Configuring CloudBridge with Built-in Tasks

The built-in configuration tasks that you can execute on CloudBridge devices are:

  • EnableCloudBridge: Enable traffic through CloudBridge devices.
  • DisableCloudBridge: Disable traffic through CloudBridge devices.
  • Configure Alert: Configure an alert (alert name and level) on CloudBridge devices.
  • Configure Sys Log Server: Configure a new system log server for CloudBridge devices.
  • Add User: Set up a new user account on selected devices and assign privileges.
  • ConfigureBandwidth-5.xandearlier: Configure the bandwidth parameters of CloudBridge devices of version 5.x and earlier.
  • ConfigureBandwidth-6.xandlater: Configure the bandwidth parameters of CloudBridge devices of version 6.x and later.
  • RestoreConfig: Restore the configuration on a CloudBridge device from any configuration file.
  • ConfigureRemoteLicenseServer: Configure multiple CloudBridge VPX devices to use a centralized licensing server. You can configure parameters, such as IP address, port of the licensing server, and the license model.
  • ConfigureLocalLicenseServer: Configure multiple CloudBridge VPX devices to use local licensing server.
  • RestartCloudBridge: Restart the CloudBridge devices.
  • InstallCACert : Install CA certificates for CloudBridge devices.
  • InstallCombinedCertKey: Install combined certificate key for CloudBridge devices.
  • InstallSeparateCertKey: Install separate certificate key for CloudBridge devices.
  • SoftwareUpgrade: Software Upgrade for CloudBridge devices.
  • AddUser: Add a new user and assign the privileges.

To execute the built-in tasks

On the Configuration tab, navigate to Configuration > Built-in Tasks, and in the right-pane, click CloudBridge tab.

Viewing Built-in Tasks

You can view the built-in tasks by device family and category. The NetScaler device family also includes NetScaler VPX and NetScaler Gateway Enterprise devices.

To view built-in tasks by device family and category

  1. On the Configuration tab, in the left pane, under Configuration, click Built-in Tasks.
  2. In the right pane, under Built-in Tasks, you can view the built-in tasks.

Executing Built-in Tasks

You can execute a built-in task on multiple devices at the same time. You can either select devices individually or select a device list for the tasks. You can execute the same task several times on different devices or device lists. You can also preview a task (the commands and rollback commands) before executing it.

To execute built-in tasks

  1. On the Configuration tab, in the left pane, under Configuration, click Built-in Tasks.
  2. In the right pane, under Built-in Tasks, click the task you want to execute, click Execute, and then follow the wizard instructions. Alternately, right-click the task, click Execute, and then follow the wizard instructions.

Viewing the Execution Log for Specific Built-in Tasks

After executing a task, you can view the execution details of that task instantly or at a later time.

To view the execution log for built-in tasks

  1. On the Configuration tab, in the left pane, under Configuration, click Built-in Tasks.
  2. In the right pane, under Built-in Tasks, select the task whose execution details you want to view, click Execution Log, and then follow the wizard instructions. Alternately, right-click the task, click Execution Log, and then follow the wizard instructions.
  3. Under Execution Log, you can view the following:
    • Task Name: Specifies the task name.
    • Device Name: Specifies the IP address of the device on which the task is executed.
    • Start Time: Specifies the time when the task started.
    • End Time: Specifies the time when the task ended.
    • Executed By: Specifies the NetScaler or CloudBridge user who started the task.
    • Status: Specifies the completion status of the task, such as Success, Failed, and Queued.
    • Annotation: Specifies a message that is annotated when executing the task.

Note: You can also view an execution log for all executed tasks, including custom tasks, by clicking Execution Log under Configuration in the left pane.

Scheduling Built-in Tasks

You can schedule built-in tasks to execute at a later period or recur at regular intervals. For example, you can schedule tasks to be executed at specific hours daily, at specific hours on specific days of the week, and at specific hours on specific days of the month.

You can also view the details of all the built-in tasks that you have scheduled.

To schedule built-in tasks

  1. On the Configuration tab, in the left pane, under Configuration, click Built-in Tasks.

Note: To view scheduled built-in tasks, in the right pane, under Built-in Tasks, on the bottom bar, click Scheduled Tasks. You can stop, resume, or remove a scheduled built-in task.

Exporting Built-in Tasks

You can save the built-in tasks in XML format on the Command Center server. This XML file, also known as task file, can be used to create a new custom task in the existing server or can be copied to another Command Center server.

Note: The location of the exported file is CC_Home\provisioningtemplates\exportedtemplates.

To export built-in tasks

  1. On the Configuration tab, in the left pane, under Configuration, click Built-in Tasks.
  2. In the right pane, under Built-in Tasks, select the task you want to export, and then click Export. Alternately, right-click the task, and then click Export.
  3. Under Export Task, in Name, type a name for the task file, and then click OK. A message appears confirming that the selected task is successfully exported.