Use the master configuration template

Using a master configuration template is a flexible option for creating and deploying a master configuration on multiple Citrix ADC instances.

As an administrator, you might want to make configuration changes and save licenses, certificates, and other files on a Citrix ADC instance. You can save the new configuration as a master configuration template (.conf file).

To save your master configuration template from a Citrix ADC instance, you can do one of the following:

• At the command prompt, enter save ns config. The configuration is saved in the instance’s FLASH memory in the /nsconfig/ns.conf file.
• From the Citrix ADC instance’s GUI, navigate to Diagnostics > View Configuration. Choose the kind of configuration you’d like to save. For example, if you want to save the saved configuration of your Citrix ADC instance, select Saved configuration.  Click the Save text to a file link to save the ‘ns.conf’ file to your local machine.

When you deploy the master configuration template by using the ‘DeployMasterConfiguration’ configuration template while creating a new job, you can customize it further for each specific Citrix ADC instance by adding additional commands, modifying existing commands, and providing different variable values in the input file.

For example, as an administrator you may want to upload certificate keys to your Citrix ADC instances in addition ns.conf file and deploy the master configuration on them as well.

Important

You cannot execute a configuration job using the DeployMasterConfiguration template on Citrix ADC CPX instances, Citrix ADC instances configured in a cluster, or on partitioned Citrix ADC instances.

To create a configuration job using the Master Config configuration template on Citrix ADM:

1. In Citrix Application Delivery Management (ADM), navigate to Networks > Configuration Jobs, and then click Create Job.

2. On the Create Job page, on the Select Configuration tab, specify the Job Name and select the Instance Type from the drop-down list.

3. Select Master Configuration from the Configuration Source drop-down list. Drag and drop the DeployMasterConfiguration template’s commands to the right pane. You can add, modify, or delete commands in the right pane as well. Click Next.

   Note

   You can add put commands to add input files to your template. In our example, we will need to upload certificate and key files in addition to the configuration template file and variable input files.

   

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

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

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

   

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

   

8. Select the instances on which you want to run the configuration job, and then click Next.

9. On the Specify Variable Values tab, upload the following:

   • Configuration Template File (.conf) - Upload the .conf file that you extracted from a Citrix ADC instance.
   • Upload the Input File (.xml/csv) - Upload the input file with values for the variables you have defined in your commands.

10. Click Next.

    

    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. On the Job Preview tab, you can evaluate and verify the commands to be run on each instance or instance group, and then click Next.

    

12. On the Execute tab, you can choose to execute your job now or schedule it to be executed at a later time. You can also choose what action Citrix ADM should take if the command fails.

    You can also choose to allow authorized users to execute jobs on your managed instances, and you can choose whether to send an email notification regarding the success or failure of the job, along with other details.

    

    After executing your job, you can see the job details by navigating to Networks > Configuration Jobs and select the job you just configured.  Click on Details and then, click on Execution Summary to see the details of your job. Click on the instance to see the Command Logs to see the commands executed on the job.