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.

  11. In the Execute tab, choose to either execute your job now, or schedule to execute the job later.

    Also, select one of the following actions from the On Command Failure list that Citrix ADM should perform if the command fails:

    • Ignore error and continue: Citrix ADM ignores the failed command and executes the remaining commands for the selected instance.

      Note

      This action does not allow you to abort a configuration job that is in progress.

    • Stop further execution: Citrix ADM stops the remaining commands if any command fails during execution.

    • Rollback successful commands: Citrix ADM restores the successfully executed commands if any command fails during execution.

  12. Click Finish.

To send an email and Slack notification for a job:

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

  1. Navigate to Networks>Configuration Jobs.

  2. Select the job that you want to enable email and Slack notification and click Edit.

  3. In the Execute tab, go to the Receive Execution Report Through pane:

    • Select the Email check box and choose the email distribution list to which you want to send the execution report.

      If you want to add an email distribution list, click Add and specify the email server details.

    • Select the Slack check box and choose the slack channel to which you want to send the execution report.

      If you want to add a Slack profile, click Add and specify the Profile Name, Channel Name, and Token of the required Slack channel.

      localized image

  4. Click Finish.

To view execution summary details:

  1. Navigate to Networks > Configuration Jobs.

  2. Select the job that you want to view the execution summary and click Details.

  3. 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