Reuse configuration audit templates in configuration jobs

As an admin, you can now save configuration commands as a set of reusable configuration templates when you create a job and also when you run a configuration audit. The configuration template created and saved in Configuration Jobs module is available in Configuration Audit to create an audit template that can be applied to specific NetScaler instances. Similarly, the audit template created in Configuration Audit module is available in Configuration Jobs so that you can run the template as a configuration job. Any change made in the template is now visible in both Configuration Jobs and Configuration Audit modules.

Earlier the configuration job and configuration audit templates had to be created separately for the same configuration and saved as different files. This caused a duplication of effort in creating and maintaining the templates.

NetScaler ADM allows you to save this template in the system so that the audit template is available in Configuration Jobs also. Now the audit templates can be used to create configuration jobs. This way the templates can be used interchangeably between the configuration jobs and configuration audits.

For example, consider a basic load balancing configuration for which you add a load balancing virtual server, add two services, and bind the services to the virtual server.

This example uses the following commands:

add lb vserver servername HTTP ipaddress portnumber

add service servicename1 ipaddress1 HTTP 80

add service servicename2 ipaddress2 HTTP 80

bind lb vserver servername servicename1

bind lb vserver servername servicename2

Creating a Template in Configuration Audits and Reusing it in Configuration Jobs

Perform the following task to create a template on the configuration audit module and reuse the same in the configuration jobs module.

To create an audit template:

  1. In NetScaler ADM, navigate to Infrastructure > Configuration > Configuration Audit > Audit Template, and click Add.

  2. On the Create Template page, specify the template name. You can also add more information about the template in the Description field.

  3. In the Commands pane, enter commands such as those in the preceding example.

  4. Select the Save as Configuration Template check box and specify a name for your template, for example, you can name this template as “LBVariablesTemplate.” You can choose to overwrite other templates that exist with the same name.


    The audit template name can be the same as the configuration template name.

  5. Click Save and click Next.

    Save a configuration template

  6. Click Next.

  7. In Select Instances tab, select the NetScaler instances on which you want to run these configuration commands and click Finish. The new template is now visible in the list of audit templates.

    Select instances

  8. When you want to run these configuration commands, navigate to Infrastructure > Configuration > Configuration Jobs, and click Create Job. The audit template that you created earlier is listed as a configuration template.

    Create a job

To reuse the audit template in configuration jobs:

  1. Enter a name for the job and select the instance type, and drag the template to the commands pane.

    Reuse an audit template

    While creating the configuration job, you can convert the local and remote file name parameters into variables. This lets you assign different files to these parameters for the same set of NetScaler instances every time you run the job.

  2. In the command that you entered, select the file name that you want to convert to a variable, and then click Convert to Variable.

  3. In Select Instances tab, select the instances on which you want to run these commands.

  4. If you have specified any variables in the commands, in Specify Variable Values tab, select one of the following options to specify variables for your instances:

    • Variable values from an input file - Download an input file to enter values for the variables that you have defined in your commands, and then upload the file to the NetScaler ADM server.
    • Common variable values for all instances – Specify the syslog server IP address and port.
  5. In the Job Preview tab, you can evaluate and verify the commands to be run on each instance or instance group and click Next.

  6. In the Execute tab, click Finish to run the configuration job.

    Now if you want to add another service to this load balancing server and bind the service to the server, you can edit the commands in the command page and save them.

    Rerun configuration job

  7. Navigate to Audit Templates and click Add.

  8. Drag the “LBVariablesTemplate” template to the commands pane. You can see that the template has been updated with the new commands.

    Update a template

    The audit template appears in the Audit Templates list and is run every 12 hours against the configurations of the specified instances. You can now create templates and reuse them between configuration jobs and configuration audit modules.

Reuse configuration audit templates in configuration jobs