Cassandra Migration

Cassandra Migration is required only while migrating from a version prior to Fiorano 10.4.0.

Fiorano API traffic manager has been upgraded to be compatible with Cassandra version 3.x from 2.x in 10.4.0.

Since there is a major upgrade in the storage technology, replacing of data folder will not work as in earlier versions. Hence data needs to be converted into JSON format and then retrieved back from JSON.

Following sections illustrate the steps for migrating the Cassandra Traffic data.

Step 1: Convert Old Cassandra Server Data into JSON

To convert the data from the older version, before performing the runtimedata migration, perform the following actions:

1. Start  Cassandra Server.
2. Navigate to <NEW FIORANO_HOME>/esb/FioranoMigration/bin and open the RunTimeDataMigration.properties file.
3. Provide the details pertaining to the old Cassandra Server under:
   1. CASSANDRA_IP
   2. CASSANDRA_USERNAME (the default user/password is cassandra/cassandra)
   3. CASSANDRA_PASSWORD
       

4. Perform RunTimeDataMigration.

   

   For details about RunTimeDataMigration, refer to the Runtimedata Migration section.

   

   Migration will not happen if the IP address of Cassandra server is not specified in the RunTimeDataMigration.properties file.

After completing the runtimedata migration, traffic data of Cassandra Server is saved in JSON format at the location <NEW FIORANO HOME>/esb/FioranoMigration/temp.

Step 2: Uninstall the Old Cassandra Server ( 2.x ) and install the New Cassandra Server ( 3.x )

Before uninstalling the old Cassandra, it is recommended to perform the following actions to prevent any instance of data loss:

1. Navigate configuration directory of Cassandra Server.

   

   If installed as service, then the default location (if the location is not changed) will be:

   • Windows:  <C:\Program Files\DataStax Community\conf>
   • Linux: </etc/cassandra/default.conf>
2. Open the cassandra.yaml file and search for "data_file_directories".
3. Navigate to the location mentioned under data_file_directories and take backup of this folder. 

Uninstall the Old Cassandra Server and Install the new one by following the steps mentioned in http://docs.datastax.com/en/cassandra/3.0/cassandra/install/installTOC.html.

Step 3: Retrieve JSON formatted Traffic Data into the New Cassandra Server

1. Start the new Cassandra Server.
2. Navigate to <NEW FIORANO_HOME>/esb/FioranoMigration/bin 
3. Open the RetrieveCassandra.properties file and provide the details of the new Cassandra Server as instructed in the file.

4. Run one of the following scripts:

   Non-interactive mode

   CODE

   migrate.bat/sh -retrievecassandra

   Interactive mode

   CODE

   migrate.bat/sh

   

   Select appropriate options for the Interactive Migration.