Downgrading VMware Greenplum Text

VMware Greenplum Text versions 3.7.0 and newer support downgrading to a previous version of Greenplum Text, down to version 3.6.0 at the oldest.

Downgrading a VMware Greenplum Text system installs the older VMware Greenplum Text software release on all hosts in the Greenplum cluster, and then downgrades the VMware Greenplum Text system.

There are single and two-part variants of the downgrade procedure.

Note: You must perform the two-part downgrade procedure when you downgrade from VMware Greenplum Text version 3.9.0 or newer to versions 3.6.0 through 3.8.x.

Downgrading a VMware Greenplum Text Release

Download the installer for your platform for the VMware Greenplum Text version to which you want to downgrade from VMware Network.
Extract the release package. For example, if you downloaded VMware Greenplum Text version 3.6.0:
```
$ tar xfz greenplum-text-3.6.0-<platform>.tar.gz
```
Verify that ZooKeeper and VMware Greenplum Text are running.
```
$ gptext-state
```
Run the VMware Greenplum Text installer. For example:
```
$ greenplum-text-3.6.0-<platform>.bin -d $TARGET_GPTEXTHOME 
```
NOTE: You must install old and new VMware Greenplum Text versions under the same parent directory.
The installer prompts you to accept the license agreement and to choose and create the installation directory.
The installer verifies the environment to ensure that prerequisites are present, such as Python and Java. If any problems are discovered, the installer outputs an error message and stops. Correct the problem identified by the error message and then follow the instructions in the message to continue downgrading.
After the downgrade has completed, source the greenplum-text_path.sh in the VMware Greenplum Text release directory of the (older) version that you are downgrading to, and run gptext-state healthcheck to verify the VMware Greenplum Text system. For example:
```
$ source /usr/local/greenplum-text-3.6.0/greenplum-text_path.sh
$ gptext-state healthcheck
```

Two-Part VMware Greenplum Text Downgrade

The VMware Greenplum Text two-part downgrade installs and downgrades the VMware Greenplum Text software in separate steps.

Note: You must perform this two-part downgrade procedure when you downgrade from VMware Greenplum Text version 3.9.0 or newer to versions 3.6.0 through 3.8.x.

Follow the steps in this section to perform the two-part VMware Greenplum Text downgrade procedure.

Download the installer for your platform for the VMware Greenplum Text version to which you want to downgrade to from VMware Network.
Extract and prepare the installer package. For example, if you downloaded VMware Greenplum Text version 3.7.0:
```
$ tar xzf greenplum-text-3.7.0-<platform>.tar.gz
$ chmod +x greenplum-text-3.7.0-<platform>.bin
```
Identify the install location ($GPTXTHOME) of the current (newer) VMware Greenplum Text installation.
Verify that ZooKeeper and VMware Greenplum Text are running.
```
$ gptext-state
```
Run the VMware Greenplum Text installer in two-part mode. For example, if you downloaded the version 3.7.0 installer:
```
$ greenplum-text-3.7.0-<platform>.bin -b
```
NOTE: You must install this VMware Greenplum Text software in the same parent directory that you installed the current (newer) version.
Source the greenplum-text_path.sh in the current (newer) VMware Greenplum Text installation. For example, if you are downgrading from version 3.10.0 and you installed it in the default location:
```
$ source /usr/local/greenplum-text-3.10.0/greenplum-text_path.sh
```
Invoke the gptext downgrade utility. You must specify the install directory of the (older) version to which you are downgrading in the destination path. For example, if you are downgrading to VMware Greenplum Text version 3.7.0 that you installed in the default location:
```
$ gptext-downgrade -d /usr/local/greenplum-text-3.7.0
```
After the downgrade completes, source the greenplum-text_path.sh in the new (older) VMware Greenplum Text installation, and run gptext-state healthcheck to verify the VMware Greenplum Text system. For example:
```
$ source /usr/local/greenplum-text-3.7.0/greenplum-text_path.sh
$ gptext-state healthcheck
```