|
|
| (23 intermediate revisions by 3 users not shown) |
| Line 1: |
Line 1: |
| − | =Installing and Configuring Cassandra= | + | =Installing and configuring Cassandra= |
| − | __TOC__
| |
| − | Cassandra version 1.2 is mandatory for Workspace Web Edition & Web Services and must be installed and configured prior to starting the installation and configuration of Workspace Web Edition & Web Services.
| |
| | | | |
| − | <!-- Available styles: (default)-Important, 2-Tip, 3-Warning -->
| + | Before you start installing and configuring Web Services and Applications, first you have to install and configure Cassandra. Web Services support Cassandra version 1.2 or 2.2. |
| − | <!-- Important: equal signs (=) will not work in a note. Use the equivalent HTML code (=) instead.-->
| |
| − | {{NoteFormat|For more details about Cassandra, refer to the [http://www.datastax.com/documentation/cassandra/1.2/cassandra/features/featuresTOC.html Cassandra documentation for version 1.2].}}
| |
| | | | |
| − | The procedures on this page are intended to serve as a quick guide to installing and configuring Cassandra. | + | For new deployments starting from version 8.5.201.41, we recommend Cassandra 2.2. The procedures below are meant to serve as a quick guide on how to do this. For more detailed information, see the [https://docs.datastax.com/en/archived/cassandra/2.2/index.html Cassandra 2.2 documentation]. |
| | | | |
| − | ==Installing Cassandra==
| + | For general instructions and guidelines, select one of the following links: |
| − | Complete this procedure for each Cassandra node.
| |
| − | | |
| − | '''Prerequisites'''
| |
| − | *You have installed the latest [http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html Java 1.7 JDK 64bit for Linux]. For more information, refer to the [http://docs.oracle.com/javase/7/docs/webnotes/install/linux/linux-jdk.html Java documentation].
| |
| − | | |
| − | '''Start'''<br/>
| |
| − | | |
| − | #[http://cassandra.apache.org/download/ Download the latest 1.2.x version of Cassandra].<br/>
| |
| − | #Copy the Cassandra archive to the installation directory. For example, <tt>/usr/local</tt><br/>
| |
| − | #Use a tar utility to extract the files. For example, <tt>tar -zxvf apache-cassandra-1.2.15-bin.tar.gz</tt><br/>
| |
| − | #Add directories for data, commitlog, and saved_caches. You can create these directories anywhere or in the default locations configured in the <tt>cassandra.yaml</tt>. For example:
| |
| − | #* /var/lib/cassandra/data
| |
| − | #* /var/lib/cassandra/commitlog
| |
| − | #* /var/lib/cassandra/saved_caches
| |
| − | #Add a directory for logging. You can create this directory anywhere, such as <tt>/var/log/cassandra/</tt>.
| |
| − | '''End'''
| |
| − | | |
| − | ==Configuring Cassandra==
| |
| − | This procedure shows you how to configure a three-node Cassandra cluster in a single datacenter.
| |
| − | <!-- Available styles: (default)-Important, 2-Tip, 3-Warning -->
| |
| − | <!-- Important: equal signs (=) will not work in a note. Use the equivalent HTML code (=) instead.-->
| |
| − | {{NoteFormat|The files modified in this procedure are typically found in the <tt>[Cassandra install dir]/conf</tt> directory.}}
| |
| − | | |
| − | '''Start'''<br/>
| |
| − | Complete the following steps for each Cassandra node:
| |
| − | <ol>
| |
| − | <li>Modify the <tt>cassandra.yaml</tt> file:</li>
| |
| − | <ol type="a">
| |
| − | <li>Set the <tt>cluster_name</tt>. It must be the same name on all nodes.</li>
| |
| − | <li>Set the <tt>initial_token</tt> according to the node's place in ring. It must be one of the following: </li>
| |
| − | | |
| − | <nowiki>Node #1: -9223372036854775808
| |
| − | Node #2: -3074457345618258603
| |
| − | Node #3: 3074457345618258602</nowiki>
| |
| − | <!-- Available styles: (default)-Important, 2-Tip, 3-Warning -->
| |
| − | <!-- Important: equal signs (=) will not work in a note. Use the equivalent HTML code (=) instead.-->
| |
| − | {{NoteFormat|The tokens shown here can be used for a three-node Cassandra cluster in a single datacenter. If you are using a different topology or cluster size, [http://www.datastax.com/documentation/cassandra/1.2/cassandra/configuration/configGenTokens_c.html consult the Cassandra documentation].}}
| |
| − | <li>Set <tt>seeds</tt> to the list of host names of all nodes. For example: <tt>-seeds: “node1, node2, node3”</tt></li>
| |
| − | <li>Set <tt>listen_address</tt> and <tt>rpc_address</tt> to the host name.</li>
| |
| − | <li>Set <tt>data_file_directories</tt>, <tt>commitlog_directory</tt>, and <tt>saved_caches_directory</tt> to the directories you created in Step 4 of the [[Prerequisites#Installing_Cassandra|Installing Cassandra]] procedure.</li>
| |
| − | <li>Change <tt>endpoint_snitch</tt> to <tt>PropertyFileSnitch</tt>. </li>
| |
| − | <li>Save your changes and close the file.</li>
| |
| − | </ol>
| |
| − | <li>Open the <tt>log4j-server.properties</tt> file and set the <tt>log4j.appender.R.File</tt> property to the directory you created in Step 5 of the [[Prerequisites#Installing_Cassandra|Installing Cassandra]] procedure.</li>
| |
| − | <li>Save your changes and close the file.</li>
| |
| − | <li>Open the <tt>cassandra-topology.properties</tt> file and update for you cluster topology. For each node in your cluster, add the following line: </li>
| |
| − | <nowiki>[node]=[datacenter]:[rack]</nowiki>
| |
| − | *<tt>[node]</tt> — The IP address of the node
| |
| − | *<tt>[datacenter]</tt> — The name of the datacenter for this node.
| |
| − | *<tt>[rack]</tt> — The name of the rack for this node.
| |
| − | | |
| − | The following is a sample <tt>cassandra-topology.properties</tt> file for a Single Datacenter scenario:
| |
| − | <nowiki>192.0.2.10=datacenter1:rack1
| |
| − | 192.0.2.11=datacenter1:rack1
| |
| − | 192.0.2.12=datacenter1:rack1
| |
| − | </nowiki>
| |
| − | <li>Save your changes and close the file.</li>
| |
| − | </ol>
| |
| − | '''End'''
| |
| − | | |
| − | ==Configuring Cassandra with only one node==
| |
| − | This procedure shows you how to configure a one-node Cassandra. This could be valuable for a lab or a simple test installation.
| |
| − | <!-- Available styles: (default)-Important, 2-Tip, 3-Warning -->
| |
| − | <!-- Important: equal signs (=) will not work in a note. Use the equivalent HTML code (=) instead.-->
| |
| − | {{NoteFormat|The files modified in this procedure are typically found in the <tt>[Cassandra install dir]/conf</tt> directory.}}
| |
| − | | |
| − | '''Start'''<br/>
| |
| − | Complete the following steps for each Cassandra node:
| |
| − | <ol>
| |
| − | <li>Modify the <tt>cassandra.yaml</tt> file:</li>
| |
| − | <ol type="a">
| |
| − | <li>Set the <tt>cluster_name</tt>. It must be the same name on all nodes.</li>
| |
| − | <li>Set <tt>seeds</tt> to the list of host names of all nodes. For example: <tt>-seeds: “127.0.0.1”</tt></li>
| |
| − | <li>Set <tt>listen_address</tt> and <tt>rpc_address</tt> to the host name.</li>
| |
| − | <li>Set <tt>data_file_directories</tt>, <tt>commitlog_directory</tt>, and <tt>saved_caches_directory</tt> to the directories you created in Step 4 of the [[Prerequisites#Installing_Cassandra|Installing Cassandra]] procedure.</li>
| |
| − | <li>Save your changes and close the file.</li>
| |
| − | </ol>
| |
| − | <li>Open the <tt>log4j-server.properties</tt> file and set the <tt>log4j.appender.R.File</tt> property to the directory you created in Step 5 of the [[Prerequisites#Installing_Cassandra|Installing Cassandra]] procedure.</li>
| |
| − | <li>Save your changes and close the file.</li>
| |
| − | | |
| − | <li>Save your changes and close the file.</li>
| |
| − | </ol>
| |
| − | '''End'''
| |
| − | | |
| − | ==Verifying the Cassandra Installation==
| |
| − | '''Start'''<br/>
| |
| − | <ol>
| |
| − | <li>Start all Cassandra nodes using the following command:</li>
| |
| − | <pre>[cassandra install dir]/bin/cassandra</pre>
| |
| − | <li>Use the nodetool utility to verify that all nodes have connected by entering the following command:</li>
| |
| − | <pre>[cassandra install dir]/bin/nodetool -h [cassandra host] ring</pre>
| |
| − | | |
| − | The following is sample output for a Single Datacenter scenario:
| |
| − | | |
| − | <pre>
| |
| − | /genesys/apache-cassandra-1.2/bin$ ./nodetool ring
| |
| − | Address DC Rack Status State Load Owns Token
| |
| − | 192.0.2.10 datacenter1 rack1 Up Normal 14.97 MB 100.00% -9223372036854775808
| |
| − | 192.0.2.11 datacenter1 rack1 Up Normal 14.97 MB 100.00% -3074457345618258603
| |
| − | 192.0.2.12 datacenter1 rack1 Up Normal 14.97 MB 100.00% 3074457345618258602
| |
| − | </pre>
| |
| − | | |
| − | | |
| − | The following is sample output for a Single Node scenario:
| |
| − | <pre>
| |
| − | /genesys/apache-cassandra-1.2/bin$ ./nodetool ring
| |
| − | Address DC Rack Status State Load Effective-Ownership Token
| |
| − | 127.0.0.1 datacenter1 rack1 Up Normal 1.89 MB 100.00% 76880863635469966884037445232169973201
| |
| − | | |
| − | | |
| − | </pre>
| |
| − | </li>
| |
| − | </ol>
| |
| − | '''End'''
| |
| − | | |
| − | ==Next Steps==
| |
| − | *[[InstallationProcedures|Installing Workspace Web Edition & Web Services]]
| |
| | | | |
| | + | * [[InstallCassandra2x|Installing and Deploying Cassandra 2.2]] |
| | + | * [[UpgradingCassandraTo2x|Upgrading to Cassandra 2.2]] |
| | | | |
| | [[Category:V:HTCC:8.5.2DRAFT]] | | [[Category:V:HTCC:8.5.2DRAFT]] |
