Product Documentation

Create a configuration job

May 24, 2018

A job is a set of configuration commands that you can create and run on one or more multiple managed instances. You can create jobs to make configuration changes across instances, replicate configurations on multiple instances on your network, and record-and-play configuration tasks using the NetScaler MAS GUI and convert it into CLI commands.

You can use the Configuration Jobs feature of NetScaler MAS to create a configuration job, send email notifications, and check execution logs of the jobs created.

To create a configuration job on NetScaler MAS

  1. Navigate to the Networks > Configuration Jobs.
  2. Click Add to create a job.
  3. On the Create Job page, under the Select Configuration tab, specify the Job Name and select the Instance Type from the drop-down list.
  4. In the Configuration Source drop-down list, select the configuration job template that you want to create. Add the commands for the selected template. You can either enter the commands or import the existing commands from the saved configuration templates. You can also add multiple templates of different types in the Configuration editor while creating a job in the Configuration Jobs. From the Configuration Source drop-down list, select the different templates and then drag and drop the templates in the configuration editor. The template types can be Configuration Template, Inbuilt Template, Master Configuration, Record and Play, Instance and File. Note: If you add the Deploy Master Configuration Job template for the first time and then add a template of different type, then the whole job template will be of Master Configuration type.
  5. You can also rearrange and reorder the commands in the configuration editor. You can move the command from one line to another by dragging and dropping the command line. You can also move or rearrange the command line from one line to any target line by simply changing the command line number in the text box. You can also rearrange and reorder the command line at a later time while editing the configuration job.
  6. You can define variables that enable you to assign different values for these parameters or execute a job across multiple instances. You can review all the variables that you have defined while creating or editing a configuration job in a single consolidated view. 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.
  7. Select the target instances on which you want to run the configuration job, and then click Next.
  8. You can evaluate and verify the commands to be run on each instance on the Job Preview tab.
  9. In the Execute tab, choose to either execute your job now or schedule to execute the job at a later time. Also, you must also select what action NetScaler MAS should take if the command fails.

To send email notification for a job

An email notification is now sent every time a job is executed or scheduled. The notification will cover details such as the success or failure of the job along with the relevant details.

After creating a job, in the Execute tab, select the Email checkbox under the Receive Execution Report Through section. Choose an email distribution list from the drop-down list. You can also create an email distribution list by clicking the + icon and specifying email server details.

localized image

To view execution summary details

Navigate to Networks > Configuration Jobs. Select a job and click Details. Click Execution Summary to see the status of the instance on that executed the job, the commands executed on the job, the start and end time of the job, and the instance user’s name.

localized image