Modify a Template and View its Snapshot

To modify a template and view its snapshot:

1. In Director view, select the Workflows tab in the top menu bar.
2. Select Templates > Device Templates.
3. Select the template you want to modify.
4. Make the desired changes to the template.
5. Click Recreate. The Diff and Merge window displays. This window shows the differences between the current template and the newly generated template.
   
   
6. Merge the template changes into the Newly Generated template. To do this automatically, select Automerged in the drop-down menu on the right side of the window. This is the recommended method. You can also merge the changes automatically.
7. Click Deploy. When you do so, a snapshot is created of the state of the previous version template.
8. In the top menu bar, select the Configuration tab, and then in the left menu bar, select Templates > Device Templates.
9. Select the template you deployed in Step 7.
10. In the left menu bar, select Others > Config Snapshots. The window displays the snapshots that have been created for the template.

Compare the Current Template with a Previous Template

To compare the current template with a previous version of the template using the snapshot of an old template:

1. In Director view, select the Configuration tab in the top menu bar.
2. Select Templates > Device Templates.
3. Click the template whose snapshots you want to view. The Appliance view displays.
   
   
4. In the left menu bar, select Others > Config Snapshots. The dashboard displays all the snapshots for the template.
   
   
5. Select the template snapshot that you want to compare with the current template and click the Compare icon.
   
   
   The Compare Details window opens and displays the difference between the two templates.
   
   
   If you recreated a template without changing any configuration parameters, a comparison of two templates shows that no changes were made.
   
   

Restore a Previous Template from a Snapshot

To restore a previous version of a template from its snapshot:

1. In Director view, select the Configuration tab in the top menu bar.
2. Select Templates > Device Templates.
3. Click the template you want to replace with a previous template version.
4. Select Others > Config Snapshots in the left menu bar. The dashboard displays all the snapshots for the template.
5. Select the snapshot that you want to replace the current template and click the Restore icon.
   
   

Lock a Template or Device

Resource locking allows you to prevent other users from making changes to the configuration of a resource until the completion of certain activities. The resource is unlocked and recovered for other users only after completion of the activity.

Versa Director allows resource locking at the device and template level. An owner is a user who has locked the resource.

A resource lock consists of two modes:

• All users are locked including the owner—The resource is locked and no change is allowed on the resource. Not even by the owner. This is mostly used when you do not want any change in the system until a critical situation is addressed.
• All users except the owner are locked—You (the resource owner) can make changes but not the others. This is used when you are in the process of making a critical change and do not want other users to make changes that interfere with the resource configuration.

Any attempt to apply a template on the device is rejected on a locked device. You cannot modify the contents of the template when it is locked but you can always re-apply the template to a device. This allows the reuse of the template for an application and prevent any changes to the original template.

To lock a device or template:

1. Go to the Configuration tab and select the template/device for which you have created a snapshot.
   
   
2. Selecting the template enables the lock, unlock, and a few other options.
   
   
3. Select the template and click on the Lock icon to lock the snapshot and prevent other users from making changes to it. This opens the Lock Template window that prompts you to select an option to lock the template.
   
   
4. Select the desired locking mode and click OK to lock the template/device.

Apply Template or Service Template Changes to VOS Devices

If you make changes to a template or service template on a Versa Operating System^TM (VOS^TM) device, you can push these changes to VOS device using the Commit Template option.

To apply template or service template changes to a VOS device:

1. In Director view, click Commit Template.
   
   
2. In the Commit popup window, enter information for the following fields.
   
   
    

   Field	Description
   Organization	Select the organization.
   Select Template	Select the template associated with the organization.
   Template	Select to apply a template. This is the default.
   Service Template	Select to apply a service template
   Auto Merge	Attempt to automatically merge the new configuration from the template or service template with the existing VOS device configuration. If existing configuration changes were made directly in the VOS device, the VOS device configuration is preserved.
   Overwrite	Use the new configuration in the template or service template to overwrite the current VOS device configuration. If existing configuration changes were made directly in the VOS device, they are not preserved.
   Reboot	After the template or service template changes are applied on the VOS device, select this option to reboot the device.

3. To apply the modified service template to the devices:
   1. Select the organization and template.
   2. Select either Auto Merge or Overwrite.
   3. Click Reboot.
   4. Click OK.
      
      
       
4. Ensure that the Appliance State is IN_SYNC with the Director node. If it is synchronized, the template modification is complete. If it is not, the Out of Sync Appliances popup window displays. To fix the issue, continue with Steps 5 and 6.
   
   
5. In the Appliances page, click the Sync Config to Appliance icon or the Sync Config from Appliance for the out-of-sync VOS device.
   
   
6. Click the Diff icon. If there are no differences between the template and appliance, the Template State changes to IN_SYNC, which means VOS device's template has been modified successfully.
   
   

Supported Software Information

Releases 20.2 and later support all content described in this article.