From 2000bc377561ea275f1dc75ca8fa2fcbffda9053 Mon Sep 17 00:00:00 2001
From: Jonathan Ellis <jbellis@apache.org>
Date: Wed, 1 Jul 2009 18:28:54 +0000
Subject: [PATCH] remove unused options and add comments from the old Setup
 wiki page.

git-svn-id: https://svn.apache.org/repos/asf/incubator/cassandra/trunk@790301 13f79535-47bb-0310-9956-ffa450edef68
---
 conf/storage-conf.xml      | 27 ++++++++++++++++++---------
 test/conf/storage-conf.xml |  3 ---
 2 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/conf/storage-conf.xml b/conf/storage-conf.xml
index dbf146b703..6720ecc12b 100644
--- a/conf/storage-conf.xml
+++ b/conf/storage-conf.xml
@@ -20,6 +20,9 @@
     <!--======================================================================-->
     <!-- Basic Configuration                                                  -->
     <!--======================================================================-->
+
+    <!-- The name of this cluster. This is mainly used to prevent machines in 
+         one logical cluster from joining any other cluster. -->
     <ClusterName>Test Cluster</ClusterName>
 
     <!-- Tables and ColumnFamilies                                            
@@ -65,8 +68,10 @@
          clusters with a small number of nodes. -->
     <InitialToken></InitialToken>
 
-    <!-- RackAware: Setting this to true instructs Cassandra to try and place the replicas in
-         a different rack in the same datacenter and one in a different datacenter
+    <!-- RackAware: Setting this to true instructs Cassandra to try
+         and place one replica in a different datacenter, and the
+         others on different racks in the same one.  If you haven't
+         looked at the code for RackAwareStrategy, leave this off.
     -->
     <RackAware>false</RackAware>
 
@@ -85,30 +90,38 @@
     <StagingFileDirectory>/var/cassandra/staging</StagingFileDirectory>
 
 
-    <!-- Add names of hosts that are deemed contact points. Cassandra nodes use
+    <!-- Addresses of hosts that are deemed contact points. Cassandra nodes use
          this list of hosts to find each other and learn the topology of the ring.
+         You must change this if you are running multiple nodes!
     -->
     <Seeds>
         <Seed>127.0.0.1</Seed>
     </Seeds>
 
     <!-- Miscellaneous -->
+    <!-- time to wait for a reply from other nodes before failing the command -->
     <RpcTimeoutInMillis>5000</RpcTimeoutInMillis>
+    <!-- size to allow commitlog to grow to before creating a new segment -->
     <CommitLogRotationThresholdInMB>128</CommitLogRotationThresholdInMB>
 
     <!-- Hosts and Ports -->
+    <!-- Address to bind to and tell other nodes to connect to.  Leave blank
+         to allow Cassandra to pick one automatically.  You _must_ change this
+         if you want multiple nodes to be able to communicate! -->
     <ListenAddress>localhost</ListenAddress>
+    <!-- TCP port, for commands and data -->
     <StoragePort>7000</StoragePort>
+    <!-- UDP port, for membership communications (gossip) -->
     <ControlPort>7001</ControlPort>
+    <!-- port clients connect to -->
     <ThriftPort>9160</ThriftPort>
-    <HttpPort>7002</HttpPort>
 
 
     <!--======================================================================-->
     <!-- Memory, Disk, and Performance                                        -->
     <!--======================================================================-->
 
-    <!-- Threshold for adding a column index in a row -->
+    <!-- Add column indexes to a row after its contents reach this size -->
     <ColumnIndexSizeInKB>256</ColumnIndexSizeInKB>
 
     <!--
@@ -143,8 +156,4 @@
          Basic features in Cassandra should work fine without configuring this section.
     -->
     <ZookeeperAddress>127.0.0.1</ZookeeperAddress>
-    <MulticastChannel>230.0.0.1</MulticastChannel>
-    <GangliaServers>
-        <GangliaServer>127.0.0.1:12000</GangliaServer>
-    </GangliaServers>
 </Storage>
diff --git a/test/conf/storage-conf.xml b/test/conf/storage-conf.xml
index d3a72d9ee6..6332c22774 100644
--- a/test/conf/storage-conf.xml
+++ b/test/conf/storage-conf.xml
@@ -20,7 +20,6 @@
    <ClusterName>Test Cluster</ClusterName>
    <Partitioner>org.apache.cassandra.dht.OrderPreservingPartitioner</Partitioner>
    <RackAware>false</RackAware>
-   <MulticastChannel>230.0.0.1</MulticastChannel>
    <ReplicationFactor>1</ReplicationFactor>
    <ZookeeperAddress>127.0.0.1</ZookeeperAddress>
    <RpcTimeoutInMillis>5000</RpcTimeoutInMillis>
@@ -29,8 +28,6 @@
    <ControlPort>7001</ControlPort>
    <ThriftPort>9160</ThriftPort>
    <ColumnIndexSizeInKB>4</ColumnIndexSizeInKB>
-   <HttpPort>7002</HttpPort>
-   <MetadataDirectory>build/test/cassandra/system</MetadataDirectory>
    <CommitLogDirectory>build/test/cassandra/commitlog</CommitLogDirectory>
    <CommitLogRotationThresholdInMB>128</CommitLogRotationThresholdInMB>
    <DataFileDirectories>