gpupgrade command supports
revert. The overall upgrade process includes five phases: pre-upgrade, initialize, execute, finalize, and post-upgrade. This topic summarizes each phase and directs you to the detailed pages for further explanations.
The pre-upgrade and post-upgrade phases are user tasks that need to be completed before and after you use the
To quickly try the gpupgrade process, see the Quick Start Guide.
NOTE: In this documentation the existing Greenplum Database cluster is referred to as the source cluster, and the new Greenplum Database cluster is referred to as the target cluster.
The following diagram shows the upgrade flow for the entire process.
WARNING The upgrade window requires planned downtime. The source cluster will be stopped during the upgrade process.
Follow the pre-upgrade preparatory steps a few weeks before the upgrade date. For detailed steps in this phase, see gpupgrade pre-upgrade.
gpadminaccess to all Greenplum Database hosts.
gpupgrademodes, copy or link.
In this phase, you continue preparing the source cluster, and initialize the target cluster. For information about this phase, see gpupgrade initialize. During this phase, ensure that you are in a scheduled maintenance window, that can accommodate cluster downtime.
gpupgrade-migration-sql-generator.bashscript before you begin the upgrade. The script checks for catalog inconsistencies between source and target cluster, and generates SQL scripts to fix certain issues.
initializecompletes successfully, continue with
gpupgrade revertwhich removes the artifacts the
This step stops the source Greenplum cluster. Ensure that you are within your downtime window. For information about this phase, see gpupgrade execute.
gpupgrade executelogs for any issues.
gpupgrade revertto abandon the upgrade if you choose not to finalize. Once you begin the finalize phase,
gpupgradecannot restore the original Greenplum Cluster.
For information about this phase, see gpupgrade finalize.
gpupgrade finalizeto upgrade standby master and mirror segments.
For information about this phase, see gpupgrade post-upgrade.
gpadminto the target Greenplum cluster.