Downgrading Tanzu Greenplum Text

Tanzu 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 Tanzu Greenplum Text system installs the older Tanzu Greenplum Text software release on all hosts in the Greenplum cluster, and then downgrades the Tanzu 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 Tanzu Greenplum Text version 3.9.0 or newer to versions 3.6.0 through 3.8.x.

Downgrading a Tanzu Greenplum Text Release

Download the installer for your platform for the Tanzu Greenplum Text version to which you want to downgrade from Tanzu Network.
Extract the release package. For example, if you downloaded Tanzu Greenplum Text version 3.6.0:
```
$ tar xfz greenplum-text-3.6.0-<platform>.tar.gz
```
Verify that ZooKeeper and Tanzu Greenplum Text are running.
```
$ gptext-state
```
Run the Tanzu Greenplum Text installer. For example:
```
$ greenplum-text-3.6.0-<platform>.bin -d $TARGET_GPTEXTHOME 
```
NOTE: You must install old and new Tanzu 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 Tanzu Greenplum Text release directory of the (older) version that you are downgrading to, and run gptext-state healthcheck to verify the Tanzu Greenplum Text system. For example:
```
$ source /usr/local/greenplum-text-3.6.0/greenplum-text_path.sh
$ gptext-state healthcheck
```

Two-Part Tanzu Greenplum Text Downgrade

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

Note: You must perform this two-part downgrade procedure when you downgrade from Tanzu 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 Tanzu Greenplum Text downgrade procedure.

Download the installer for your platform for the Tanzu Greenplum Text version to which you want to downgrade to from Tanzu Network.
Extract and prepare the installer package. For example, if you downloaded Tanzu 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) Tanzu Greenplum Text installation.
Verify that ZooKeeper and Tanzu Greenplum Text are running.
```
$ gptext-state
```
Run the Tanzu 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 Tanzu 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) Tanzu Greenplum Text installation. For example, if you are downgrading from version 3.9.0 and you installed it in the default location:
```
$ source /usr/local/greenplum-text-3.9.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 Tanzu 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) Tanzu Greenplum Text installation, and run gptext-state healthcheck to verify the Tanzu Greenplum Text system. For example:
```
$ source /usr/local/greenplum-text-3.7.0/greenplum-text_path.sh
$ gptext-state healthcheck
```