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.
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.
greenplum_path.shfile in the new Greenplum Database installation directory.
greenplum-text_path.shfile 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
gptext-migratorutility installs the Tanzu Greenplum Text library into this directory.
Run the Tanzu Greenplum Text
gptext-migratorutility 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 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.
Run the Tanzu Greenplum Text installer.
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-upgradeutility 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-upgradeoutputs 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-upgradescript after the installer completes. See the gptext-upgrade utility reference for instructions.
- Source the
greenplum-text_path.shscript in the old Tanzu Greenplum Text installation directory. For example:
$ source /usr/local/greenplum-text-<old-version>/greenplum-text_path.sh
- Run the
gptext-upgradecommand from the new Tanzu Greenplum Text installation directory:
- If you answer yes, the installer runs the
After the upgrade has completed, source the
greenplum-text_path.shin the new Tanzu Greenplum Text release directory and run
gptext-state healthcheckto verify the Tanzu Greenplum Text system:
$ source /usr/local/greenplum-text-<version>/greenplum-text_path.sh $ gptext-state healthcheck