Upgrading Greenplum Command Center

Upgrading Greenplum Command Center

This section provides steps for upgrading Pivotal Greenplum Command Center to a new version.

Upgrading Greenplum Command Center requires stopping the Command Center instance, installing the new distribution, and then recreating Command Center instances.

A new Greenplum Command Center software release may be installed in the same parent directory as the current release, by default /usr/local. The installer updates the symbolic link greenplum-cc-web to point to the new release directory and leaves the old release directory in place. After the software is installed, run the gpcmdr --setup command to recreate your Command Center instances.

Install the New Software Release

  1. Log in as the gpadmin user.
  2. Source the greenplum_path.sh and gpcc_path.sh files from the current release:
    $ source /usr/local/greenplum-db/greenplum_path.sh
    $ source /usr/local/greenplum-cc-web/gpcc_path.sh
  3. Stop the Greenplum Command Center service:
    $ gpcmdr --stop
  4. Download the latest Command Center release from Pivotal Network. Installer files are available for the Red Hat 64-bit platform, and have a name in the format:
    greenplum-cc-web-versionx.x-PLATFORM.zip
  5. Unzip the installer file. For example:
    # unzip greenplum-cc-web-versionx.x-PLATFORM.zip
  6. Launch the installer for the new release with the bash shell:
    $ /bin/bash greenplum-cc-web-versionx.x-PLATFORM.bin
    Note: The installer requires write permission in the installation directory (/usr/local, by default). If the gpadmin user does not have write permission in the installation directory, run the installation as root. You will need to change file ownership and permissions after the software is installed.
  7. Read through the license agreement. When you reach the bottom, type yes to accept the license agreement.
  8. The installer prompts you to provide an installation path. Enter a full path or press ENTER to accept the default. Choose the parent directory of the current Command Center release, /usr/local by default. You must have write permission in the directory you specify.
  9. If you ran the installation as root or any user other than gpadmin, change the ownership and permissions of the installation directory:
    # chown -R gpadmin:gpadmin /usr/local/greenplum-cc-web-versionx.x
    # chmod -R 755 /usr/local/greenplum-cc-web-versionx.x
    Change to the gpadmin user before you continue to the next step:
    # su - gpadmin
  10. Update the GPPERFMONHOME environment variable in your user startup shell profile (for example ~/.bashrc) to point to the newly installed Command Center version:
    GPPERFMONHOME=/usr/local/greenplum-cc-web-versionx.x
    source $GPPERFMONHOME/gpcc_path.sh
  11. Source the updated .bashrc file:
    $ source ~/.bashrc
  12. Create a host file listing all of the other hostnames participating in the Greenplum Database cluster, including the Standby Master host. Hostnames must be resolvable in DNS.
  13. As gpadmin, run the gpccinstall utility to install the new Command Center files on all hosts listed in the host file you created:
    $ gpccinstall -f hostfilename
    where hostfilename is the name of the host file you created.

Recreate Command Center Instances

After the new Command Center software is installed, recreate your instances by running the gpcmdr --setup command once for each existing Command Center instance.

See Set up a Greenplum Command Center Instance for instructions to run gpcmdr --setup.