...

Cassandra DB Server needs to be installed as Fiorano API  Management uses Cassandra as the data store for all information that is looked up while a request is being processed such as the subscriptions, clients, and distributed quotas. Cassandra Database is an open source database that provides linear scalability and high availability with proven fault-tolerance in storing details that need to be looked up on-the-fly.

Installing Cassandra

1. Download Cassandra Version 3.x from the link https://academy.datastax.com/planet-cassandra/cassandra
2. Install Cassandra by referring to the directions provided at http://cassandra.apache.org/doc/latest/getting_started/index.html.
3. Make the changes mentioned in the subsections below if it is applicable to you; else move to the Running the Cassandra server section.Run

Cassandra in a Windows environment

Before starting Cassandra 3.

...

Linux: Open Command prompt from CASSANDRA_HOME and run the following command:

bin/cassandra -R -f

Windows: Start Cassandra from Windows Services:

...

8 or 3.9 in Windows environment as a service, perform the following actions to enable the database:

1. Go to <CASSANDRA_HOME>/conf.
2. Open the cassandra.yaml file.
3. Find the cdc_raw_directory parameter.

4. Un-comment the property and rename the value as below:

   Code Block
   <CASSANDRA_HOME>/data/cdc_raw

   Info
   title Example
   cdc_raw_directory: "C:/Program Files/DataStax-DDC/data/cdc_raw"

Enabling Connection to a Remote Cassandra Server

If Cassandra Server is running on a different system, the two steps below need to be performed:

Step 1: Enabling Remote Access to Cassandra Server

Since Cassandra server will be hosted in the local system alone by default, cassandra cannot be accessed from any other systems. To enable remote access, perform the following actions:

1. Go to the location <CASSANDRA_HOME>/conf.
2. Open the cassandra.yaml file.
3. Replace the value of the following parameters with the IP address of the system where Cassandra DB would be running:
   
   1. rpc_address
   2. listen_address

Step 2: Configuring AGS and AMS Profiles

Fiorano API Management server profiles are preconfigured to run Cassandra in the local system with default values of Cassandra Data Store URL and Keyspaces as below:

...

Cassandra

...

Before starting Cassandra 3.8 or 3.9 in Windows environment as a service, perform the following actions to enable the database:

1. Go to <CASSANDRA_HOME>.
2. Open the cassandra.yaml file.
3. Find the cdc_raw_directory parameter.

4. Un-comment the property and rename the value as below:

   Code Block
   <CASSANDRA_HOME>/data/cdc_raw

   Info
   title Example
   cdc_raw_directory: "C:/Program Files/DataStax-DDC/data/cdc_raw"

Cassandra as a Cluster

...

as a Cluster

Running the Cassandra server

1. Linux: Open Command prompt from CASSANDRA_HOME and run the following command:

   Code Block
   bin/cassandra -R -f

2. Windows: Start Cassandra from Windows Services:

   Tip
   In the Windows Component Services panel, Cassandra server will be displayed as "DataStax DDC Server <VersionNumber>".

Anchor
_Toc396220941 _Toc396220941

Setting up

...