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 new 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 MAS 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 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 follwoing task to create a tempalte on configuration audit module and reuse the same in configuration jobs module.

To create an audit template:

  1. In NetScaler MAS, navigate to Networks 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 above example.

  4. Select the Save as Configuration Template checkbox 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.

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

  5. Click Save and click Next.

    localized image

  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.

    localized image

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

    localized image

To reuse the audit template in configuration jobs:

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

    localized image

    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 execute the job.

  2. In the command that you just 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 MAS 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.

    localized image

  7. Navigate to Audit Templates and click Add.

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

    localized image

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