In Versa Director, workflow templates help automate and manage configuration changes across devices. Options like Clean & Recreate and Re-Deploy serve different purposes for maintaining and updating configurations.
1. Clean & Recreate
The Clean & Recreate option essentially removes existing configurations tied to a template and applies a fresh configuration. Here's what happens:
Purpose:
- Used when you want to reset the configuration on a device and start fresh.
- Removes any old configuration artifacts that might interfere with the new setup.
Process:
- The device's configuration tied to the template is wiped clean.
- The configuration in the template is recreated and applied to the device.
- All template-associated settings (e.g., system, routing, policies) are re-pushed.
When to Use:
- If the configuration has become corrupt or inconsistent.
- When transitioning to a completely new template setup.
- When troubleshooting issues caused by lingering old configurations.
2. Re-Deploy
The Re-Deploy option simply re-applies the existing template configuration to the device. Here's what happens:
Purpose:
- Used to refresh or force the application of the template configuration without removing it first.
- Ensures that all settings from the template are properly pushed to the device.
Process:
- The configuration in the template is validated.
- The settings are re-pushed to the device to ensure they are correctly applied.
- Existing configuration settings not part of the template remain unchanged.
When to Use:
- If a device configuration seems out of sync with the template.
- After making minor changes to a template.
- For troubleshooting and ensuring consistency between the template and the device.
Key Differences
Feature | Clean & Recreate | Re-Deploy |
---|---|---|
Action | Wipes existing template configuration and applies it fresh. | Re-applies existing template configuration. |
Impact | More disruptive; removes and recreates all associated settings. | Less disruptive; ensures configuration sync without deletion. |
Use Cases | Major configuration issues or full template reset needed. | Minor template updates or configuration refresh needed. |
Considerations
- Clean & Recreate is more aggressive and can cause downtime if not used carefully.
- Re-Deploy is safer for minor fixes and ensuring configuration alignment.
- Always back up configurations before performing Clean & Recreate.
Here’s a step-by-step guide to perform Clean & Recreate or Re-Deploy in Versa Director:
Performing Clean & Recreate or Re-Deploy in Versa Director
Prerequisites:
Backup the Current Configuration:
- Before making any changes, ensure that the current configuration is backed up.
- You can export the running configuration from the device to keep a fallback option in case something goes wrong.
Access to Versa Director:
- Log in with appropriate administrative privileges.
Device Grouping:
- Ensure the device is assigned to a template. Both actions will impact devices tied to the template.
Steps for Clean & Recreate
Log in to Versa Director:
- Navigate to the Workflows > Templates section.
Select the Template:
- Locate the template associated with the device(s) you want to reset.
Choose the "Clean & Recreate" Option:
- In the template management menu, find and select the Clean & Recreate option.
- This action will remove all configurations tied to this template on the device and then push a new configuration based on the template.
Confirm the Action:
- A warning will appear about potential disruption since this action erases and recreates the configuration. Review carefully and confirm.
Monitor the Deployment:
- Go to Monitor > Tasks to track the progress of the Clean & Recreate process.
- Ensure that the device successfully receives and applies the new configuration.
Validate the Configuration:
- Use the CLI or GUI to verify that the intended configuration has been applied correctly to the device.
Steps for Re-Deploy
Log in to Versa Director:
- Navigate to Workflows > Templates.
Select the Template:
- Locate the template associated with the device(s) you want to re-deploy.
Choose the "Re-Deploy" Option:
- From the menu, select the Re-Deploy option.
- This will push the existing template configuration back to the device without erasing the existing settings.
Confirm the Action:
- Review the summary and confirm the action to begin re-deployment.
Monitor the Progress:
- Check the progress in Monitor > Tasks to ensure the re-deploy operation completes successfully.
Validate the Configuration:
- Confirm that all configurations from the template have been applied properly.
- Check for discrepancies in the Device View in Versa Director.
Best Practices
- Use Clean & Recreate during major troubleshooting or when resetting devices to a new configuration baseline.
- Use Re-Deploy for refreshing the existing configuration after minor template updates or to correct sync issues.
- Always inform stakeholders if downtime is expected due to configuration changes.
- Test changes in a staging environment before applying them to production devices.