Upgrading Tanzu Greenplum Text

Upgrading a Tanzu Greenplum Text system to a new Tanzu Greenplum Text release installs the new Tanzu Greenplum Text software release on all hosts in the Greenplum cluster and then upgrades the Tanzu Greenplum Text system.

Upgrading Tanzu Greenplum Text and Greenplum Database at the Same Time

If you are upgrading to new releases of Greenplum Database and Tanzu Greenplum Text at the same time, follow these steps:

Complete the Greenplum Database upgrade first and ensure the database is operational.
Source the greenplum_path.sh file in the new Greenplum Database installation directory.
Source the greenplum-text_path.sh file in the older Tanzu Greenplum Text installation directory.
```
$ source /usr/local/greenplum-text-<version>/greenplum-text_path.sh
```
Make sure the gpadmin user has write permission in the $GPHOME/lib/postgres directory. The gptext-migrator utility installs the Tanzu Greenplum Text library into this directory.
Run the Tanzu Greenplum Text gptext-migrator utility to migrate your current Tanzu Greenplum Text system to the newly upgraded Greenplum Database system.
Ensure that the current version of Tanzu Greenplum Text works with the new Greenplum Database version.
Proceed with the Tanzu Greenplum Text upgrade.

Upgrading a Tanzu Greenplum Text Release

Upgrading a Tanzu Greenplum Text release is a two-part process: install the new software release on the Greenplum cluster hosts and then upgrade the existing Tanzu Greenplum Text system. The Tanzu Greenplum Text installer performs the first part, installing the new software. The gptext-upgrade utility performs the second part, upgrading the current Tanzu Greenplum Text system to the new version.

The Tanzu Greenplum Text installer detects an existing Tanzu Greenplum Text system and, after installing the new software release, offers to run the gptext-upgrade utility for you. If you choose to upgrade the Tanzu Greenplum Text system later, you can run the gptext-upgrade utility yourself.

All upgrade tasks are executed on the Greenplum master host as the gpadmin user. The gpadmin user must have write permission in the directory where the new Tanzu Greenplum Text release is to be installed, /usr/local/greenplum-text-<release>-<version> by default.

The Greenplum Database, ZooKeeper, and Tanzu Greenplum Text clusters must be running. The procedure stops and restarts Tanzu Greenplum Text during the upgrade.

Follow these steps:

Download the new Tanzu Greenplum Text release for your platform from Tanzu Network.

Extract the release package.

$ tar xfz greenplum-text-<version>-<platform>.tar.gz

Make sure that ZooKeeper and Tanzu Greenplum Text are running.
```
$ gptext-state
```
Run the Tanzu Greenplum Text installer.
```
$ ./greenplum-text-<version>-<platform>.bin
```
Note: When upgrading Tanzu Greenplum Text, you do not specify an installation configuration file as you do for the initial Tanzu Greenplum Text installation.
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 message and run the installer again.
After the new software has been installed on the Greenplum cluster, the installer looks for an existing Tanzu Greenplum Text installation. If an existing Tanzu Greenplum Text system is found, the installer asks if you wish to upgrade Tanzu Greenplum Text directly.
- If you answer yes, the installer runs the gptext-upgrade script. The gptext-upgrade utility validates the environment to ensure it can complete the upgrade, then executes the upgrade and restarts the Tanzu Greenplum Text system. If any problems are discovered, gptext-upgrade outputs a message and quits. Fix the indicated problems and run the gptext-upgrade utility (at <NEW_GPTEXTHOME>/bin/gptext-upgrade) to complete the Tanzu Greenplum Text system upgrade.
- If you answer no, you must run the gptext-upgrade script after the installer completes. See the gptext-upgrade utility reference for instructions.
Important: If you answer no or if the gptext-upgrade quits without upgrading your software, follow these steps to re-run gptext-upgrade at a later time:
1. Source the greenplum-text_path.sh script in the old Tanzu Greenplum Text installation directory. For example:
```
$ source /usr/local/greenplum-text-<old-version>/greenplum-text_path.sh
```
2. Run the gptext-upgrade command from the
  new Tanzu Greenplum Text installation directory:
```
$ /usr/local/greenplum-text-<new-version>/bin/gptext-upgrade
```
After the upgrade has completed, source the greenplum-text_path.sh in the new Tanzu Greenplum Text release directory and run gptext-state healthcheck to verify the Tanzu Greenplum Text system:
```
$ source /usr/local/greenplum-text-<version>/greenplum-text_path.sh
$ gptext-state healthcheck
```