ViPR Configuration Recovery App

This app can backup all configured resources on ViPR to any local/NFS export location frequently and also provides functionality for on-demand restoration of all/selected backed up resources.



How this app works



  • Copy the attached .tar.gz file to any linux environment that supports bash/python pre-requisites mentioned below
  • Unzip the file using "tar -zxvf"
  • Move inside the extracted folder 'cd ViPR-ConfigRecovery' and follow below steps



Exports all user created resources to any specified NFS export frequently.


Resources that are backed up:

  • System - configuration properties, license
  • Security - authentication providers, role assignments
  • Tenant - projects, consistency groups
  • Data Services - virtual pools, tenant configuration
  • Physical - storage systems, fabric managers, data protection systems, hosts, vcenters
  • Virtual - varrays, vpools



How to backup

NOTE: Check CLI path in config file and IP that CLI is pointing to(VIPR_HOSTNAME in cli/viprcli.profile).


  • Backup once:
    • "python" - This will backup once to a local directory specified
  • Backup frequently:
    • ./resbackup start
  • Enter ViPR instance ip:
    • ViPR instance ip that needs to be backedup.
  • user:
    • user used by CLI to talk to ViPR
  • password:
    • password for ViPR user
  • The following will appear if SMTP is not configured in ViPR
    • SMTP server IP/FQDN:
      • IP/FQDN of SMTP server.
    • SMTP server user(press enter if no user):
      • SMTP server username. Hit enter if user is not required.
    • SMTP server password(press enter if no password):
      • SMTP server password. Hit enter if user is not required.
  • Frequency (seconds):
    • frequency in which resources should be backedup
  • Where to copy?:
    • 1. Local directory
    • 2. Remote directory
  • Choose one option:
    • 1 - will copy files to local directory/NFS export
    • 2 - will copy files to remote directory/NFS export
  • If 1 is selected, following options will appear:
    • Enter local directory(EX: /tmp/xyz) :
    • Local directory path
  • If 2 is selected, following options will appear:
    • Enter remote directory with IP(Ex: :
  • Remote directory path to which backedup files are saved.
  • Remote username:
    • user to access remote location
  •   Remote password:
    • passowrd for remote location
  • This will start backup process in the background which keeps running in the specified frequency. backup.log can be tailed to read status.
    • ./resbackup stop - will stop the background process


Note: supports only ViPR versions,




  • Restores/imports backed up resources from NFS share. If a resource requires password user will be asked to enter it during restoration process.
  • Also he will have option to do selective restoration.


How to restore

NOTE: Check CLI path in config file and IP that CLI is pointing to(VIPR_HOSTNAME in cli/viprcli.profile).

  • python local backup_dir_name
  • python remote backup_dir_share_location


Ex: python local files_11202013_13001023

python remote

'remote' will ask for share's user and password



  1. Security
  2. Tenant
  3. Data services
  4. Storage systems
  5. Fabric Managers
  6. Data Protection Systems
  7. Hosts
  8. Vcenters
  9. Varrays and Vpools (will wait for physical asset discoveries)


  • Enter 'a' to restore everything or enter the respective numbers for selective restoration.
    • Ex: 4,5,9 - will restore storage systems, fabric mangers and varrays/vpools
  • Before each resource step user will have choice to restore or not
    • Ex:  Restore VMAX-985? y/n:


Note: supports only ViPR version





  • CLI should be running on the same machine where this app is running. CLI location can be configured using config file.
  • Before backup or restore make sure CLI is configured with correct ViPR instance ip.
  • Restore can be done only on deployed ViPR instance with license added.
  • Storage system discoveries during restoration process might add new systems that were not there in backup files.



Known Issues

  • Vpool create: if vpool is not provided in recoverpoint properties, journal size (if provided) will not be added.