Product Documentation

Create configuration jobs for NetScaler SD-WAN WO instances

May 24, 2018

A job is a set of configuration commands that you can create and schedule on one or more managed instances. For NetScaler SD-WAN WAN optimization (WO) instances, you can use the following options to create jobs:

  • Configuration Template: You can use the configuration editor to type in CLI commands, save the configuration as a template, and use it to configure jobs.
  • Inbuilt Template: You can choose from a list of configuration templates. These templates provide the syntaxes of the CLI commands and allow you to specify values for the variables. The inbuilt templates are listed, with their descriptions in the table below.
  • File: You can upload a configuration file from your local machine and create jobs.

Once a job is created, you can choose to execute the job immediately or schedule the job to be executed later. You can also set the execution frequency

Inbuilt Template Description

EnableCloudBridgeWANOpt

Enables traffic through the NetScaler SD-WAN WO appliance.

DisableCloudBridgeWANOpt

Disables the traffic through NetScaler SD-WAN WO appliance.

RestartCloudBridgeWANOpt

Restarts NetScaler SD-WAN WO appliance.

RestoreConfig

Restores the configuration of NetScaler SD-WAN WO appliance.

AddLink

Creating or defining links enable the SD-WAN WO appliance to prevent congestion and loss on the links and to perform traffic shaping. You can define the maximum bandwidth sent or received over the link and also specify it is LAN side or WAN side traffic.

ConfigureBandwidth

Sets the bandwidth limits and other bandwidth management settings.

AddUser

Adds a new user, for whom you can assign privileges.

AddUserAdvancedPlatform

Adds a new user enables you to assign privileges not available in the AddUser template.  

AddService-class

Creates a service class for NetScaler SD-WAN WO appliance with one or more service class filters and enables it.

SetApplication

Sets the application classifier definition.

AddorRemoveVideoCachingPorts

Adds or removes the port number at which the video source can send or receive data. The default port is 80.

RemoveVideoCachingSource

Removes one or more video caching source. Specify the video source IP address or domain name. 

RemoveAllVideoCaching

Removes all the available video caching sources.

VideoCachingState

Enables or disables the video caching feature on NetScaler SD-WAN WO appliances.

ClearVideoCaching

Clears either the video cache or the video caching statistics.

SetVideoCaching

Sets the maximum size for cached objects. An object larger than this limit is not cached. By default, the maximum caching object size is 100 MB.

AddVideoCachingSource

Adds the IP address or the domain name of the video source. Includes options to enable or disable video caching for that source.

ConfigureRemoteLicenseServer

Configures the centralized license server. Specify the license server model, IP address and port number.

ConfigureLocalLicenseServer

Sets the license server location as local.

InstallCACert

Installs CA certificates on NetScaler SD-WAN WO appliance. Specify the certificate name, file name and the keystore password.

InstallCombinedCerKey

Installs a combined SSL certificate-key pair file.

InstallSeperateCertKey

Installs SSL certificate and key as separate files.

EnableWCCP

Enables WCCP deployment mode.

AddWCCPServiceGroup

Adds a new WCCP service-group definition  for NetScaler SD-WAN WO appliance.

DisableWCCP

Disables the WCCP deployment mode.

AddTrafficShapingPolicy

Creates a traffic shaping policy for the NetScaler SD-WAN appliance. The policy controls the network bandwidth. 

SetTrafficShapingPolicy

Modifies the traffic shaping policy for NetScaler SD-WAN WO appliance.  The policy controls the network bandwidth. 

AddVideoPrePopulation

Creates a video pre-population entry, which enables you to download and cache a video in advance. You can also specify when to cache a video.

UpdateVideoPrePopulation

Modifies a video prepopulation entry, which specifies when to cache a video.

AddVideoPrePopulationNow

Configures video prepopulation, enabling you to download and cache a video immediately. You can control how you want to download and cache  videos from the URL(s).

VideoPrePopulationState

Changes, starts, updates, or removes video pre-population.

ConfigureSyslogServer

Sets the IP address and the port number of the syslog server.

ConfigureAlert

Configures alert level.

To create a configuration job for NetScaler SD-WAN WO instances:  

  1. In NetScaler MAS, navigate to Networks > Configuration Jobs, and then click Create Job.
  2. On the Create Job page, under the Select Configuration tab, specify the Job Name.
  3. In the Instance Type field, select NetScaler SD-WAN WO.
  4. In the Configuration Source drop-down list, select an option to create a job.

Note

Select Save as Configuration Template and specify a name to save the configuration as a template and reuse it.

localized image

5. You can review all the variables that you have defined while creating or editing a configuration job in a single consolidated view.

6. Do one of the following to view all the variables in a single consolidated view:

  • While creating a configuration job, navigate to Networks > Configuration Jobs, select Create Job. On the Create Job page, you can review all the variables that you have added while creating the configuration job.     
  • While editing a configuration job, navigate to Network > Configuration Jobs, select the Job Name and click Edit. On the Configure Job page, you can review all the variables that were added while creating the configuration job. 

7. You can then click on the Preview Variables tab to preview the variables in a single consolidated view that you have defined while creating or editing a configuration job.

localized image

8. A new pop-up window appears and displays all the parameters of variables such as Name, Display Name, Type, and default value in a tabular format. You can also edit and modify these parameters. Click the Done button after you have edited or modified any of the parameters.

localized image

9. Click Next, and then on the Select Instances tab, click Add Instances. Select the instances on which you want to run the job, and then click OK.

10. Click Next, and then on the Specify Variable Values tab, select one of the following options to specify variables for your instances:

          *  Upload input file for variables values: Click Download Input Key File to download an input file. In the input file, enter values for the variables that you have defined in your commands, and then upload the file to the NetScaler MAS server.

           *  Common variable values for all instances:  Enter values for the variables. The variables vary depending on the selected template.

localized image

The input files containing the variables values are persisted (with the same file name) in the configuration jobs. You can view and edit these input files that you have used and uploaded earlier while creating or editing the configuration jobs.

To view the executed configuration jobs while creating a configuration job, navigate to Network > Configuration Jobs, and click Create Job. In the Create Job page. On the Specify Variable Values tab, select the Common Variable Values for all Instances option to view the uploaded files. To edit the input files, download the input file and then edit and upload the files (keeping the same file name).

To view the already executed configuration jobs while editing a configuration job, navigate to Network > Configuration Jobs, select the Job Name and click Edit. In the Configure Job page, on the Specify Variable Values tab, select the Common Variable Values for all Instances option to view the uploaded files. To edit the input files, download the input file and then edit and upload the files (keeping the same file name)

11.  Click Next, on the Job Preview tab, you can evaluate and verify the commands to be executed as a job.

12. Click Next, on the Execute tab, set the following conditions:

          *  On Command Failure: What to do if a command fails: ignore the errors and continue the job, or stop further execution of the job. Choose an action from the drop-down list.

          *  Execution Mode: Execute the job immediately, or schedule execution for a later time. If you schedule execution for a later time, you must specify the execution frequency settings for the job. Choose the schedule you want the job to follow from the Execution Frequency drop-down list.

localized image

13. Under Execution Settings, select to execute the job sequentially (one after the other), or in parallel (at the same time).

14. To have a job execution report emailed to a list of recipients, select the Email checkbox in the Receive Execution Report Through section. From the drop-down list that appears, choose an email distribution list. To create an email distribution list, click the + icon and enter the email addresses of the recipients, and email server details.

15. Click Finish.