cleanup_plugin_for_restore

A newer version of this documentation is available. Click here to view the most up-to-date release of the Greenplum 4.x documentation.

cleanup_plugin_for_restore

Plugin command to clean up a storage plugin after restore.

Synopsis

plugin_executable cleanup_plugin_for_restore plugin_config_file local_backup_dir scope

Description

gprestore invokes the cleanup_plugin_for_restore plugin command when a gprestore operation completes, both in success and failure cases. The scope argument specifies the execution scope. gprestore will invoke the command with each of the scope values.

The cleanup_plugin_for_restore implementation should perform the actions necessary to clean up the remote storage system after a restore. Clean up activities may include removing remote directories or temporary files created during the restore, 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) from which gprestore reads 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_restore 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, gprestore displays the contents of stderr to the user.