cleanup_plugin_for_backup
A newer version of this documentation is available. Use the version menu above to view the most up-to-date release of the Greenplum 4.x documentation.
cleanup_plugin_for_backup
Plugin command to clean up a storage plugin after backup.
Synopsis
plugin_executable cleanup_plugin_for_backup plugin_config_file local_backup_dir scope
Description
gpbackup invokes the cleanup_plugin_for_backup plugin command when a gpbackup operation completes, both in success and failure cases. The scope argument specifies the execution scope. gpbackup will invoke the command with each of the scope values.
The cleanup_plugin_for_backup command should perform the actions necessary to clean up the remote storage system after a backup. Clean up activities may include removing remote directories or temporary files created during the backup, disconnecting from the backup service, etc.
Arguments
- plugin_config_file
- The absolute path to the plugin configuration YAML file.
- local_backup_dir
- The local directory on the Greenplum Database host (master and segments) to which gpbackup wrote backup files.
- scope
- The execution scope (host and number of times the plugin is executed) for the plugin.
- master - Execute the plugin once on the master host.
- segment_host - Execute the plugin once on each of the segment hosts.
- segment - Execute the plugin once for each active segment instance on the host running the segment instance.
- The Greenplum Database hosts and segment instances are based on the Greenplum Database configuration when the back up was first initiated.
Exit Code
The cleanup_plugin_for_backup command must exit with a value of 0 on success, non-zero if an error occurs. In the case of a non-zero exit code, gpbackup displays the contents of stderr to the user.