upgrade_storage

upgrade_storage is used to upgrade metadata schemas, when upgrading between major versions.

This page serves as a reference for the options and parameters.

Running upgrade_storage

upgrade_storage can be found in the bin directory of your SQream DB installation.

Command line arguments and options

Parameter

Parameter Type

Description

storage_path

Argument

Full path to a valid storage cluster.

--storage_version

Option

Displays your current storage version.

--check_predicates=0

Option

Allows the upgrade process to proceed even if there are predicates marked for deletion.

Syntax

$ upgrade_storage <storage path> [--check_predicates=0]
$ upgrade_storage <storage path> [--storage_version]

Results and error codes

Result

Message

Description

Success

storage has been upgraded successfully to version 26

Storage has been successfully upgraded

Success

no need to upgrade

Storage doesn’t need an upgrade

Failure: can’t read storage

RocksDB is in use by another application

Check permissions, and ensure no SQream DB workers or metadata_server are running when performing this operation.

Examples

Upgrade SQream DB’s storage cluster

$ ./upgrade_storage /home/rhendricks/raviga_database
get_rocksdb_version path{/home/rhendricks/raviga_database}
current storage version 23
upgrade_v24
upgrade_storage to 24
upgrade_storage to 24 - Done
upgrade_v25
upgrade_storage to 25
upgrade_storage to 25 - Done
upgrade_v26
upgrade_storage to 26
upgrade_storage to 26 - Done
validate_rocksdb
storage has been upgraded successfully to version 26

This message confirms that the cluster has already been upgraded correctly.