After you create a client for the Cassandra cluster and run the first backup, the Cassandra nodes are auto discovered. The node properties, such as, the Cassandra data directory, the Java path directory, and the location of the configuration file (cassandra.yaml) are also configured.
You can explicitly run a discover operation before running the first backup.
If you need to replace a dead node in Cassandra cluster, add a placeholder node, and then perform the replacement restore operation.
If you have replaced a dead node or added a new node to the cluster, the next backup auto discovers and updates the node information.
Note
-
To ensure that Cassandra backup jobs do not fail, configure the Cassandra config file path in the instance properties or set the sCassandraiConfigFilePath additional setting.
-
If you plan to upgrade the Cassandra agent, you must add the sCassandraiConfigFilePath additional setting before you start the upgrade operation.
Before You Begin
To auto discover the node properties, create the sCassandraiConfigFilePath additional setting.
-
To the coordinator node, add the additional setting as shown in the following table.
For instructions on how to add additional settings from the CommCell Console, see Adding or Modifying Additional Settings from the CommCell Console.
Property |
Value |
---|---|
Name |
sCassandraiConfigFilePath |
Category |
Cassandra |
Type |
String |
Value |
path to the configuration file |
Procedure
-
From the CommCell Browser, right-click Client Computers > Client> Big Data Apps.
-
Right-click the instance, and then click Properties.
The Instance Properties dialog box appears.
-
On the Details tab, click Discover.
The software discovers the Cassandra nodes that are part of the cluster, and then displays the following node details:
-
The client computer name
-
The Cassandra node name
-
The data center that the Cassandra node belongs to
-
The Cassandra node IP address
-
-
Configure the nodes.
-
Option
Steps
Configure a single node
Note
Use this option when you add a new Cassandra node.
-
Right-click on the node, and then click Configure.
Note: If you replaced a dead node, then select the new node.
The Configure dialog box appears.
In the Client Name box, select the client.
-
In the Java Path box, type the full path to the Cassandra gateway node Java installation path, for example, /opt/java/jreXX.xx/bin.
-
In the Cassandra Configuration File Path, type the full path to the location of the configuration file (cassandra.yaml) or (scylla.yaml).
You do not need to enter the file, just the path to the file, for example, /etc/cassandra/conf or /etc/scylla.
-
In the Data Directory, type the full path to the location where the data is stored, for example, /var/lib/cassandra/data or /var/lib/scylla/data.
Note
When you specify the Java path, and the data directory, do not end the path with the "/".
If you have multiple data paths, specify the paths and separate them by a semi-colon (;). For example, /var/lib/cassandra/data;/home/cassandra_data.
-
Click OK.
Configure all nodes
-
Click Configure All.
The Configure dialog box appears.
-
In the Java Path box, type the full path to the Java installation path, for example, /opt/java/jreXX.xx/bin.
-
In the Cassandra Configuration File Path, type the full path to the location of the configuration file (cassandra.yaml) or (scylla.yaml).
You do not need to enter the file, just the path to the file, for example, /etc/cassandra/conf or /etc/scylla.
-
In the Data Directory, type the full path to the location where the data is stored, for example, /var/lib/cassandra/data or /var/lib/scylla/data.
Note
When you specify the Java path, and the data directory, do not end the path with the "/".
If you have multiple data paths, specify the paths and separate them by a semi-colon (;). For example, /var/lib/cassandra/data;/home/cassandra_data.
-
Click OK.
Add a placeholder node
A placeholder node is the new node that replaces a dead node in the Cassandra cluster.
-
Click Add Placeholder Node.
The Configure dialog box appears.
-
In the Client Name box, select the client.
-
In the Java Path box, type the full path to the Java installation path, for example, /opt/java/jreXX.xx/bin.
-
In the Cassandra Configuration File Path, type the full path to the location of the configuration file (cassandra.yaml) or (scylla.yaml).
You do not need to enter the file, just the path to the file, for example, /etc/cassandra/conf or /etc/scylla.
-
In the Data Directory, type the full path to the location where the data is stored, for example, /var/lib/cassandra/data or /var/lib/scylla/data.
Note
When you specify the Java path, and the data directory, do not end the path with the "/".
If you have multiple data paths, specify the paths and separate them by a semi-colon (;). For example, /var/lib/cassandra/data;/home/cassandra_data.
-
Click OK.
-
-
For SSL-enabled docker deployments, to run restores with sstableloader, complete the following steps:
-
Copy Cassandra.yaml file to any other directory, and then change the keystore and truststore paths to the paths relative to the host.
-
On the Details tab, type the path to the Cassandra configuration file in the following syntax:
<path to actual Cassandra.yaml file>:<path where Cassandra.yaml is copied and edited with paths relative to host>
For example,
/home/actual:/home/cluster_1
where,
path to actual Cassandra.yaml file is /home/actual/
path where Cassandra.yaml is copied and edited with paths relative to host is /home/cluster_1
-
-
Click OK.