Product Documentation

Create a configuration job

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 Citrix Application Delivery Management (ADM) GUI and convert it into CLI commands.

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

To create a configuration job on Citrix ADM:

  1. Navigate to the Networks > Configuration Jobs.

  2. Click Create 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. In the Select Instances tab, select the instances you want to run the configuration audit on and click Next.

  8. In the Specify Variable Values tab, you have two options:

    1. Download the input file to enter the values for the variables that you have defined in your commands, and then upload the file to the Citrix ADM server.

    2. Enter common values for the variables that you have defined for all instances

  9. Click Next.

  10. You can evaluate and verify the commands to be run on each instance on the Job Preview tab. To evaluate rollback commands, select the Preview Rollback Commands checkbox

  11. 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 Citrix ADM 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

Create a configuration job

In this article