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

 

Installing

  • 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

 

Backup

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 backupnow.py" - 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: 10.247.100.1:/home/usr/xyz) :
  • 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 1.0.0.8.103, 1.1.0.0.425

 

 

Restore

  • 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 restore.py local backup_dir_name
  • python restore.py remote backup_dir_share_location

 

Ex: python restore.py local files_11202013_13001023

python restore.py remote 10.247.100.00:/mnt/backupfiles/files_11202013_13001023

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

 

Restore:

  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 1.1.0.0.425

 

Prerequisites/Assumptions

 

Note:

  • 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.