Installs Greenplum Database extensions in
.gppkg format, such as PL/Java, PL/R, PostGIS, and MADlib, along with their dependencies, across an entire cluster.
gppkg [-i <package> | -u <package> | -r <name>-<version> | -c] [-d <master_data_directory>] [-a] [-v] gppkg --migrate <GPHOME_old> <GPHOME_new> [-a] [-v] gppkg [-q | --query] <query_option> gppkg -? | --help | -h gppkg --version
The Greenplum Package Manager (
gppkg) utility installs Greenplum Database extensions, along with any dependencies, on all hosts across a cluster. It will also automatically install extensions on new hosts in the case of system expansion and segment recovery.
After a major upgrade to Greenplum Database, you must download and install all
Examples of database extensions and packages software that are delivered using the Greenplum Package Manager are:
$MASTER_DATA_DIRECTORYwill be used.
$GPHOME. Carries over packages from one version of Greenplum Database to another.
gppkg --migrate /usr/local/greenplum-db-<old-version> /usr/local/greenplum-db-<new-version>
In general, it is best to avoid using the
--migrateoption, and packages should be reinstalled, not migrated. See Upgrading from 6.x to a Newer 6.x Release.
When migrating packages, these requirements must be met.
gppkgcommand start the Greenplum Database master with the command
gppkgutility from the GPHOME_new installation. The migration destination installation directory.
query_optionabout the installed packages. Only one
query_optioncan be specified at a time. The following table lists the possible values for query_option.
<package_file>is the name of a package.
||Whether the specified package is installed.|
||The name, version, and other information about the specified package.|
||The file contents of the specified package.|
||List of all installed packages.|
Warning: The process of updating a package includes removing all previous versions of the system objects related to the package. For example, previous versions of shared libraries are removed. After the update process, a database function will fail when it is called if the function references a package file that has been removed.
–version (show utility version)