
Commvault Backup and Restore Utility for Greenplum Database

GENERAL DESCRIPTION:

        Commvault Backup and Restore Utility for Greenplum Database is a command line utility to  perform
		table level restores, list backup timestamps from database backups. Greenplum Database backups are performed
		using CommCell GUI schedules.

		This utility should run from gpadmin user login session.

		This utility assumes $GPHOME env is set in gpadmin user environment.

		This utility assumes gpadmin user as member of Commvault install group

		This utility uses Python home available in Greenplum environment.

HOW TO RUN:
		
		1. Login to gpadmin user session 
			
			su - gpadmin 
		  
		2. Change directory to <Commvault install base location>/CVGreenplumBkpRstUtility

			cd /opt/commvault/Base/CVGreenplumBkpRstUtility

		3. Provide execute permissions for the files in the above directory
        
		4. Run the below command to see the list of options supported. 
	
			./CVMain.sh -h

		5. Run below commands to restore tables "public.book_words" and "public.book_punct" from database "books"

			./CVMain.sh  -s dbgreenplum -i dbgp -r "-T public.book_words,public.book_punct --truncate -s books --noanalyze"

			where -s "dbgreenplum" and -i "dbgp" represent Commvault source client and instance name configured in CommCell Console
            where -r "options" are options passed directly to gpdbrestore command

		6. By default log file is generated at  /tmp/CVGreenplumBkpRstUtility.log. You can specify -f <cvlogfilepath>

SUPPORTED PLATFORMS:
        The utility is currently supported on Linux x86 platform

ENHANCEMENTS:
        Support for Greenplum backups using this command line utility

USAGE:
        ./CVMain.sh [-h] [-s cvSrcClientName]  [-i cvSrcInstanceName] [-p cvProxyHostName] [-n cvProxyPort]
        [-f cvEnableDebug] [ -g cvlogfilepath ]
        [-b gpcrondumpOptionsString] [-r gpdbrestoreOptionsString] [-u gpAdminUser]


         -h                               : print this help screen
         -s <cvSourceClientName>          : Commvault source client name
         -i <cvSourceInstanceName>        : Commvault source instance name representing Greenplum database
         -p <cvProxyHostName>             : Commvault proxy full host name or ip. Default is "localhost"
         -n <cvProxyPort>                 : Commvault proxy host CVD service listening port number. Default is "8400"
         -f <cvLogFilePath>               : Commvault utility log file path. Default is "/tmp/CVGreenplumBkpRstUtility.log"
         -g <cvDebulLevel>                : Commvault logging is enabled with debug information. Default is "0"
         -c <cvStorageCopyPrec>           : Commvault storage copy precedence. Default is "0"
         -b <gpcrondumpOptions>           : Greenplum gpcrondump options
         -r <gpdbrestoreOptions>          : Greenplum gpdbrestore options
         -u <gpAdminUserName>             : Greenplum database admin user. Default is "gpadmin"


