Cluster Edition Upgrade

Created by Ryan Park (Unlicensed)
Last updated: Nov 09, 2021 by Grey Shim


Coordinator Upgrade

Coordinator / Deployer must be upgraded manually.

Precautions

  • DDL or DELETE must not be in use. (INSERT, APPEND, SELECT do not matter.)
  • You can not issue commands such as adding / starting / terminating / deleting nodes during the upgrade.

Coordinator Shutdown

Coordinator / Deployer does not affect INSERT, APPEND, SELECT in Broker / Warehouse even if it is shut down. 

However, it does not detect that the Broker / Warehouse also shuts down while it is shutting down. (Normally detected after restart)


machcoordinatoradmin --shutdown


Index


Coordinator Backup (Optional)

Back up the dbs/ and conf/ directories located in $MACH_COORDINATOR_HOME.

Coordinator Upgrade

Proceed with full package instead of lightweight package.



tar zxvf machbase-ent-new.official-LINUX-X86-64-release.tgz -C $MACHBASE_COORDINATOR_HOME

Unzip and overwrite the package to $MACH_COORDINATOR_HOME.


Coordinator Startup

machcoordinatoradmin --startup


Deployer Upgrade

This has the same process as the Coordinator.

Precautions

  • You can not issue commands such as adding / starting / terminating / deleting nodes during the upgrade.

Deployer Shutdown

machdeployeradmin --shutdown


Deployer Backup (Optional)

Back up the dbs/ and conf/ directories located in $MACH_DEPLOYER_HOME.

Deployer Upgrade

If you are running MWA or not running Collector on the Host the Deployer is installed, you can proceed with the lightweight package.

tar zxvf machbase-ent-new.official-LINUX-X86-64-release.tgz -C $MACH_DEPLOYER_HOME

Unzip and overwrite the package to $MACH_DEPLOYER_HOME.


Deployer Startup

machdeployeradmin --startup

Package Registration

To upgrade Broker / Warehouse, register the Package in Coordinator and proceed with the upgrade.

It is recommended to register with a lightweight package.

First, move the package to the Host where $MACH_COORDINATOR_HOME is located.

Next, add the package using the following command.

machcoordinatoradmin --add-package=new_package --file-name=./machbase-ent-new.official-LINUX-X86-64-release-lightweight.tgz

Option

Description

--add-package

Specifies the name of the package to add.

--file-name

Specifies the path to the package file to add.

If a package with the same filename is added, you will receive an error, so check the file name.


Broker/Warehouse Upgrade

In the Coordinator, run the following command.

Node Shutdown

machcoordinatoradmin --shutdown-node=localhost:5656


Node Upgrade

machcoordinatoradmin --upgrade-node=localhost:5656 --package-name=new_package

Option

Description

--upgrade-node

Enters the name of the upgrade target Node.

--package-name

Enters the name of the Package to be upgraded.


If you upgrade the Node without shutting down the Node, it will automatically shut down the Node and perform the Node upgrade.

However, for stability, you should explicitly shut down the Node before upgrading.


Node Startup

machcoordinatoradmin --startup-node=localhost:5656