Contents

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: Converting 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.

    Icon

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

    Icon

    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 )

Icon

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.

    Icon

    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
    Interactive mode
    Icon

    Select appropriate options for the Interactive Migration.

Adaptavist ThemeBuilder EngineAtlassian Confluence