vsxexport.sh - Export VSX settings and configuration files

[RickHoppe]

Imagine a Life Cycle Management project where you have to upgrade a VSX gateway with new hardware. Imagine a crashed VSX gateway you need to reinstall whether it is on the same or RMA hardware. Imagine you are upgrading a VSX gateway and need to log a baseline with current BGP peering and all routes of all Virtual Systems. Are you in control and do you know which configuration files were added or modified in VS0 or all other Virtual Systems so you can easily add them back?

vsxexport.sh is my attempt to make it all easier. It reached version 1.0 so it was time to release it to the community.

This script will do the following for you:

• Detect CoreXL status
• Detect Hyper-Threading status
• Log current settings of SecureXL affinity
• Log current settings of CoreXL affinity
• Log current settings of Multi-Queue
• VS0: Export Clish configuration
• VS0: Search and backup configuration files (see sk101515):
  • fwkern.conf
  • vpnkern.conf
  • simkern.conf
  • sim_aff.conf
  • fwaffinity.conf (is it customized or default version?)
  • fwauthd.conf
  • local.arp
  • discntd.if
  • cpha_bond_ls_config.conf (is it customized or default version?)
  • resctr
  • vsaffinity_exception.conf (is it customized or default version?)
  • qos_policy.C
  • trac_client_1.ttm (is it customized or default version?)
  • ipassignment.conf
• Other VS's: Export Clish configuration (only settings that have to be set with Clish instead of SmartConsole)
  • set router-id
  • set as
  • set bgp
  • set routemap
  • set igmp
  • set pim
  • set ospf
  • set prefix-list
  • set prefix-tree
  • set bootp
• Other VS's: Log BGP peers
• Other VS's: Log OSPF neighbors
• Other VS's: Log current routes
• Other VS's: Log route summary
• Other VS's: Search and backup configuration files
  • local.arp
  • cpha_bond_ls_config.conf
• Create the file VS-all.config with all Clish parameters of all other VS's which can be used to restore those settings instantly on all VS's after reconfiguring a VSX gateway.
• Create a tarball of all files which you can store offline (useful for restore)

GitHub repository: https://github.com/Rick-Hoppe/vsxexport 

Changelog

0.1 Initial script
0.2 Display status on screen
0.3 Implemented new method to find Virtual System IDs
0.4 Extra Clish commands added to Clish script and added Affinity + Multi-Queue settings
0.5 Modified output format (splitted conf and log files)
0.6 Rewritten backup of VSes other than VS0
0.7 Fix: -i option added to Clish batch command to ignore failures
0.8 Fix: Cleanup temporary files and added "set virtual-system" to export of Clish config per Virtual System
0.8.1 Export Clish config of all Virtual Systems (other than VS0) to VS-all.config
0.9 Added support for 3.10 kernel
0.9.1 Implemented some "QA" fixes before 1.0 release of this script
1.0 Public release 1.0
1.0.1 Output of other Virtual Systems now have same style as output of VS0
1.0.2 Added commands starting with "set prefix-" to export of Clish config per Virtual System
1.0.3 Added commands starting with "set bootp" to export of Clish config per Virtual System

[Danny]

Thanks! I always prefer to have a recent CPInfo file available to be able to view all important files, command outputs and other details of a VSX system in DiagnosticsView.

[RickHoppe]

CPInfo contains so much information that for me it's like finding a needle in haystack, which costs more time in the end. I've used the vsxexport script several times when reconfiguring VSX gateways and it saved me a lot of time while preparing for those maintenance windows.

[Danny]

CPInfo indexes all files and command outputs to allow quick searches.

Also it has customizable layouts so you don't have to find the need in a haystack once you customized it for VSX.

[_Val_]

Nice one, Rick!

[YuriyAnoshyn]

Great Work! 

PS

please correct me. in case using bootp ( dhcp relaying ) - with yours's script  information per vs regarding relaying dhcp settings will be missed .

[RickHoppe]

Hi @YuriyAnoshyn,

Thanks for the feedback. You are referring to the 'set bootp' commands right? I will include them in the next version. If you know more commands that are not included yet, please do let me know.

[YuriyAnoshyn]

yes.  exactly about "set bootp"

[RickHoppe]

vsxexport.sh has been updated to v1.0.3 so 'set bootp' is included now. Thanks again!

[Kris_Pellens]

Thank you Rick. This is an excellent tool!