Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Cassandra datasource is used to set up a connection to a Cassandra storage. In WSO2 BAM 2.5.0, you can create a Cassandra data source through the UI as a custom data source. You can create a Cassandra datasource as a custom data source using the BAM management console  as follows.

...

  1. Log in to BAM management console.
  2. Click Datasources in the Configure menu, and then c lick Add Datasource.
  3. Select Custom as the Data Source Type.
  4. Enter CASSANDRA as Custom Data Source Type, and enter a unique name for Name.
  5.  Enter the below Cassandra data source configuration for Configuration.  

    Code Block
    languagexml
    <configuration>
            <hosts>localhost</hosts>
            <port>9160</port>
            <username>admin</username>
            <password>admin</password>
            <keySpace>EVENT_INDEX_KS</keySpace>
            <externalCassandra>false</externalCassandra>
            <replicationFactor>1</replicationFactor>
            <strategyClass>org.apache.cassandra.locator.SimpleStrategy</strategyClass>
            <readConsistencyLevel>QUORUM</readConsistencyLevel>
            <writeConsistencyLevel>QUORUM</writeConsistencyLevel>
            <gcGraceInterval>864000</gcGraceInterval>
    </configuration>

...

ParameterDescription
hosts

The host IP addresses of Cassandra nodes in the clustered mode. Values should be given as comma separated values. For example:

<hosts>node1 IP,node2 IP,node3 IP</hosts>
port

Port of the Cassandra instance. In clustered mode, all ports are required to have the same value. For example: 9160

keySpace

Key space name for Cassandra. The default value is EVENT_KS.

externalCassandra

By default, this is set as false in all Cassandra datasources, to point to the Cassandra instance that is shipped with WSO2 BAM. If there is a port offset applied, Cassandra URL of the respective Cassandra data source will be updated accordingly.


When Cassandra datasource is located in an external Cassandra cluster, set this to true. This will prevent WSO2 BAM from automatically incrementing the port offset (to prevent modifying the Cassandra URL), once a port offset has been introduced to the system.
replicationFactorThe total number of replicas across the cluster. Default value is 1.
strategyClassSets the distribution of the replicas across the nodes in the cluster depending on the cluster's topology. Default value is org.apache.cassandra.locator.SimpleStrategy. For more information on this parameter, go to Apache Cassandra 1.0 Documentation.

readConsistencyLevel

Number of replicas, on which the write must succeed before returning an acknowledgement to the client application.  Default  value is QUORUM. For more information on this parameter, go to Apache Cassandra 1.0 Documentation.

writeConsistencyLevelNumber of replicas, which must respond before a result is returned to the client application. Default  value is QUORUM. For more information on this parameter, go to Apache Cassandra 1.0 Documentation.
gcGraceIntervalTime to wait before garbage collecting tombstones. In Cassandra, the delete operation doesn't just wipe out all traces of the data being removed immediately. Instead of wiping out data on delete, Cassandra replaces it with a special value called a tombstone.  Default values is 864000 seconds. (10 days). For more information on this parameter, go to Cassandra Wiki.