10. Cassandra Version Upgrade¶
In this section the method of version upgrade of Cassandra will be introduced.Note
Since several defects (defect such as data is damaged during operation and restart fails) have been corrected on Cassandra1.1.12, it is recommended to upgrade the version if you are already operating with Cassandra1.1.4.We have verified the operations of Cassandra1.1.12 on intra-mart Accel Platform that was released as 2013 Winter(Felicia) or before too.
10.1. Version Upgrade Procedures¶
In case version upgrade is to be made from Cassandra1.1.4 to Cassandra1.1.12, following procedures would be necessary.It is recommended to obtain Snapshot before you execute version upgrade.
Please start Cassandra1.1.4.
Acceptance of write operations on Cassandra1.1.4 should be stopped by the drain of nodetool command.
In case of Windows, please start the Command Prompt, and execute the command below.
%CASSANDRA_HOME%/bin/nodetool drainIn case of Linux, please execute the command below.
# /usr/local/cassandra/bin/nodetool drain[DRAINED] will be displayed on Cassandra under operation, and Cassandra stops.
[data_file_directories] property in the <%CASSANDRA_HOME%/conf/cassandra.yaml> file of Cassandra1.1.12 should be set to the same directory with Cassandra1.1.4.
data_file_directories Setting Example(Windows)
data_file_directories: - C:/cassandra/dataWarning
In case commitlog_directory and saved_caches_directory of Cassandra1.1.12 are made the same as Cassandra1.1.4, data mismatch might occur. Please set another directory for commitlog_directory and saved_caches_directory.Please start Cassandra1.1.12, and rebuild the data by upgradesstables of nodetool command.
In case of Windows, please start the Command Prompt, and execute the command below.
%CASSANDRA_HOME%/bin/nodetool upgradesstablesIn case of Linux, please execute the command below.
# /usr/local/cassandra/bin/nodetool upgradesstablesVersion upgrade procedures are completed if the rebuild of Cassandra has been successfully completed.
Note
- If Cassandra is built as a cluster, please do the rebuild for each node.
- In case Cassandra Connection Authentication Setting and Registration/Deletion to Windows Service are performed on Cassandra1.1.4, it is necessary to do the setting again on Cassandra1.1.12 after the version upgrade was made.