Upgrading the Database Protocol

A new version of NuoDB database software may introduce a new version of the database protocol. For new releases that introduce a new database protocol version, the database will not be upgraded to the new version until the database protocol version is upgraded.

Changes to the database protocol are sometimes necessary to support new features or fix issues. The version of the database protocol used by the database processes is stored in the NuoDB Archive so that when a new database is started, the processes know which protocol to communicate with.

Upgrading the Database Protocol Instructions

Note: Before the database protocol can be upgraded, all of the database hosts must have the new software version installed. If all of the existing database processes have not been upgraded to the new software version, the show database version command returns only “Available Upgrade Versions: None”.

Running the show database version Command

After upgrading database software, it may be necessary to upgrade the database protocol. To check to see if a new database protocol version is available, run NuoDB Manager's show database version command.

nuodb [test] > show database version database test details false
Database Version: 3.3
Available Upgrade Versions: None
nuodb [test] > show database version database test details false
Database Version: 3.2.2
Available Upgrade Versions: 3.3

Running the upgrade database Command

To upgrade to a new database protocol, run the upgrade database command:

nuodb [test] > upgrade database test version 3.3
Upgrading database test to version 3.3...
Upgrade complete

Note: At this point, although an Upgrade complete message is returned, the upgrade process is not complete until you start a Transaction Engine. You may either start a new TE temporarily then shut it down, or restart a currently-running TE.

The effects of this command will be immediately synchronized to the archive:

nuodb [test] > show database version database test details false
Database Version: 3.3
Available Upgrade Versions: None

Note: After the database protocol version has been upgraded, the NuoDB Archive cannot be used with a previous NuoDB software version that only supports the previous database protocol version. As a result, downgrading after the database protocol version will require restoring a backup of the database. For more information on downgrading, see Downgrading to a Previous Release.