Update running-a-cluster.md (#228)

* Update running-a-cluster.md

* Update running-a-cluster.md

Author: pjaclark

content/riak/kv/3.2.0/using/running-a-cluster.md

@@ -283,54 +283,102 @@ To run multiple nodes, make copies of the `riak` directory.
 Presuming that you copied `./rel/riak` into `./rel/riak1`, `./rel/riak2`,
 `./rel/riak3`, and so on, you need to make two changes:
 
-1. Set your handoff port and your Protocol Buffers or HTTP port
-(depending on which interface you are using) to different values on each
-node. For example:
+1. Change the ports used by each Riak node to be unique on your host.
+   Specifically, you need to set to different values on each node:
+   - the handoff port (in either `riak.conf`)
+   - the Cluster Manager port (in `advanced.conf`)
+   - either your Protocol Buffers listener port or your HTTP listener port or both (depending on which interface you are using) (in `riak.conf`)
+
+    For example, on node 1 one could use these ports:
 
     ```riakconf
-    # For Protocol Buffers:
+    # For Protocol Buffers change from:
+    # listener.protobuf.internal = 127.0.0.1:8097
+    # To something like this:
     listener.protobuf.internal = 127.0.0.1:8187
 
-    # For HTTP:
+    # For HTTP change from:
+    # listener.http.internal = 127.0.0.1:8098
+    # To something like this:
     listener.http.internal = 127.0.0.1:8198
 
-    # For either interface:
+    # For either interface set the handoff from:
+    # handoff.port = 8099
+    # To something like this:
     handoff.port = 8199
     ```
 
-    ```appconfig
-    %% In the pb section of riak_core:
-    {"127.0.0.1", 8187 }
+    ```advancedconf
+    {riak_core,
+    [
+      {cluster_mgr, {"127.0.0.1", 9180 } },
+      %% more riak_core configs
+    ]}
+    ```
+
+    And therefore on node 2, use slightly different ports:
 
-    %% In the http section of riak_core:
-    {"127.0.0.1", 8198}
+    ```riakconf
+    # For Protocol Buffers change from:
+    # listener.protobuf.internal = 127.0.0.1:8097
+    # To something like this:
+    listener.protobuf.internal = 127.0.0.1:8287
+
+    # For HTTP change from:
+    # listener.http.internal = 127.0.0.1:8098
+    # To something like this:
+    listener.http.internal = 127.0.0.1:8298
+
+    # For either interface set the handoff from:
+    # handoff.port = 8099
+    # To something like this:
+    handoff.port = 8299
     ```
 
-2. Change the name of each node to a unique name. Now, start the nodes,
-changing path names and nodes as appropriate:
+    ```advancedconf
+    {riak_core,
+    [
+      {cluster_mgr, {"127.0.0.1", 9280 } },
+      %% more riak_core configs
+    ]}
+    ```
 
-```bash
-./rel/riak1/bin/riak start
-./rel/riak2/bin/riak start
-./rel/riak3/bin/riak start
+    Continue for all nodes on the host.
 
-# etc
-```
+3. Change the name of each node to a unique name.
+
+    ```riakconf
+    # Change from this:
+    # nodename = [email protected]
+    # To something like this:
+    nodename = [email protected]
+    ```
 
-Next, join the nodes into a cluster:
+4. Now, start the nodes, changing path names and nodes as appropriate:
 
-```bash
-./rel/riak2/bin/riak admin cluster join [email protected]
-./rel/riak3/bin/riak admin cluster join [email protected]
-./rel/riak2/bin/riak admin cluster plan
-./rel/riak2/bin/riak admin cluster commit
-```
+    ```bash
+    ./rel/riak1/bin/riak start
+    ./rel/riak2/bin/riak start
+    ./rel/riak3/bin/riak start
+    
+    # etc
+    ```
+
+5. Next, join the nodes into a cluster:
+
+    ```bash
+    ./rel/riak2/bin/riak admin cluster join [email protected]
+    ./rel/riak3/bin/riak admin cluster join [email protected]
+    ./rel/riak2/bin/riak admin cluster plan
+    ./rel/riak2/bin/riak admin cluster commit
+    ```
 
 ## Multiple Clusters on One Host
 
 Using the above technique, it is possible to run multiple clusters on
 one computer. If a node hasn’t joined an existing cluster, it will
 behave just as a cluster would. Running multiple clusters on one
 computer is simply a matter of having two or more distinct nodes or
-groups of clustered nodes.
+groups of clustered nodes. Please note that each cluster should have a 
+different value for `distributed_cookie`.