# How Does One Setup Clustering **URL:** \ **Category:** Operations\ **Created:** [June 9, 2015, 12:05am UTC](https://discuss.aerospike.com/t/how-does-one-setup-clustering/1350 "2015-06-09T00:05:03Z")\ **Posts on this page:** 6\ **Page:** 1
**Author:** ![Nicholas\_Manning](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.aerospike.com/nicholas_manning/32/247_2.png) [@Nicholas\_Manning](https://discuss.aerospike.com/u/Nicholas_Manning)\ **Post date:** [June 9, 2015, 12:05am UTC](https://discuss.aerospike.com/t/how-does-one-setup-clustering/1350/1 "2015-06-09T00:05:03Z")
Hello, I’m trying to set up clustering (multiple nodes) in order to ensure more resiliency and reliability (replication). Beyond the clustering docs I have found, I can’t seem to find any step by step guide to setting up multiple nodes. Thanks ---
**Author:** ![jerry](https://avatars.discourse-cdn.com/v4/letter/j/5daacb/32.png) [@jerry](https://discuss.aerospike.com/u/jerry)\ **Post date:** [June 9, 2015, 1:17am UTC](https://discuss.aerospike.com/t/how-does-one-setup-clustering/1350/2 "2015-06-09T01:17:30Z")
Hi Nicholas, Glad to hear that your trying to setup multiple nodes. But to answer your question, It depends if your using Multicast or Mesh? 1. **Multicast** in this case, multicast IP: PORT is used to broadcast the heartbeat message 2. **Mesh** in this case, the address of one Aerospike server is used to join cluster. **Multicast Example** All nodes have to have the same multicast IP address and port to form the cluster. Node 1: ``` heartbeat { mode multicast address 239.1.99.222 port 9918 interval 150 timeout 10 ... ``` Node 2: ``` heartbeat { mode multicast address 239.1.99.222 port 9918 interval 150 timeout 10 ... ``` Node 3: ``` heartbeat { mode multicast address 239.1.99.222 port 9918 interval 150 timeout 10 ... ``` **Mesh Example** Set `address` to the IP of the local interface intended for intracluster communication. This setting also controls the interface fabric will use. Set `mesh-seed-address-port` to be the IP address and heartbeat port of a node in the cluster Node 1: ``` heartbeat { mode mesh port 3002 address 192.168.1.10 mesh-seed-address-port 192.168.1.10 3002 # OK to have local node mesh-seed-address-port 192.168.1.11 3002 mesh-seed-address-port 192.168.1.12 3002 interval 150 timeout 10 ... ``` Node 2: ``` heartbeat { mode mesh port 3002 address 192.168.1.11 mesh-seed-address-port 192.168.1.10 3002 mesh-seed-address-port 192.168.1.11 3002 mesh-seed-address-port 192.168.1.12 3002 interval 150 timeout 10 ... ``` Node 3: ``` heartbeat { mode mesh port 3002 address 192.168.1.12 mesh-seed-address-port 192.168.1.10 3002 mesh-seed-address-port 192.168.1.11 3002 mesh-seed-address-port 192.168.1.12 3002 interval 150 timeout 10 ``` … With the default settings, a node will be aware of another node leaving the cluster within 1.5 seconds (interval 150 \* timeout 10 = 1500 ms convert 1.5 seconds). Clustering: [https://www.aerospike.com/docs/architecture/clustering.html#heartbeat](https://www.aerospike.com/docs/architecture/clustering.html#heartbeat) Network Heartbeat Configuration: [https://www.aerospike.com/docs/operations/configure/network/heartbeat/#network-heartbeat-configuration](https://www.aerospike.com/docs/operations/configure/network/heartbeat/#network-heartbeat-configuration) Let me know if that helps! ---
**Author:** ![Nicholas\_Manning](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.aerospike.com/nicholas_manning/32/247_2.png) [@Nicholas\_Manning](https://discuss.aerospike.com/u/Nicholas_Manning)\ **Post date:** [June 9, 2015, 1:18pm UTC](https://discuss.aerospike.com/t/how-does-one-setup-clustering/1350/3 "2015-06-09T13:18:31Z")
Ah! Thanks. After reading, a few recommendations and questions (please excuse ahead of time, I haven’t set up clustering before for anything): 1. I recommend adding a link to the [config document](https://www.aerospike.com/docs/operations/configure/network/heartbeat/#network-heartbeat-configuration) from the [architecture page](https://www.aerospike.com/docs/architecture/clustering.html#heartbeat) so people can read more. 2. The configuration document was hard to find as it is titled “Heartbeat Configuration”. It may be easier for people if you simply call it “Cluster Configuration” maybe. Just a thought. 3. Why is multicast more recommended? It seems more difficult to set up. For example, I’m using Rackspace hosting and [they recommend](https://community.rackspace.com/products/f/25/t/3946) configuring things like /etc/sysctl.conf etc 4. I’m setting this up in order to have some redundancy in case a node goes down, to lower hosting costs, will 2 nodes suffice or must it be at least 3? 5. So in your example, you show three nodes - just to be completely sure, I simply point my app to just any one of those nodes and the rest is taken care of? 6. How would I theoretically be able to balance load across the cluster? For example, send all writes to one node and all reads to the rest? Thanks for your help. ---
**Author:** ![kporter](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.aerospike.com/kporter/32/515_2.png) [@kporter](https://discuss.aerospike.com/u/kporter)\ **Post date:** [June 9, 2015, 4:53pm UTC](https://discuss.aerospike.com/t/how-does-one-setup-clustering/1350/4 "2015-06-09T16:53:36Z")
> [@Nicholas\_Manning](#): > > Why is multicast more recommended? It seems more difficult to set up. For example, I’m using Rackspace hosting and they recommend configuring things like /etc/sysctl.conf etc For non-cloud environment, multicast is normally the easiest to set up. Since most of our customers run with multicast, it is the most hardened option. That said, it has been some time since I was aware of a stability issue with mesh. Mesh improved significantly since [3.3.26](http://www.aerospike.com/download/server/notes.html#3.3.26) so at this time I am comfortable recommending either. Also for many cloud environments, short of deploying your own network overlay, mesh is the only option. Our docs haven’t caught up with mesh no longer being treated as a second class citizen. > [@Nicholas\_Manning](#): > > I’m setting this up in order to have some redundancy in case a node goes down, to lower hosting costs, will 2 nodes suffice or must it be at least 3? You can run with 1, 2, or more nodes, depends on your needs. > [@Nicholas\_Manning](#): > > So in your example, you show three nodes - just to be completely sure, I simply point my app to just any one of those nodes and the rest is taken care of? It is optional, but recommend, to supply your client with a list of all of the host in the cluster. Doing so would mean if the seed node provided to the client were to fail and the client were restarted then it wouldn’t be able to discover the cluster since the single node it bootstraps from is down. > [@Nicholas\_Manning](#): > > How would I theoretically be able to balance load across the cluster? For example, send all writes to one node and all reads to the rest? The client takes care of the load balance for you. The cluster create a partition table and shares that information with the client. The client determines which node a write should go to by inspecting the partition table for the node who is master for a given partition and then sends the write to that node. By default the policy is the same for reads, but some of our clients support reading from the replica, aka prole, node. If using the option to read from replicas, the client will read from the master or any replica for a given partition in a round-robin fashion. ---
**Author:** ![Nicholas\_Manning](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.aerospike.com/nicholas_manning/32/247_2.png) [@Nicholas\_Manning](https://discuss.aerospike.com/u/Nicholas_Manning)\ **Post date:** [June 9, 2015, 6:47pm UTC](https://discuss.aerospike.com/t/how-does-one-setup-clustering/1350/5 "2015-06-09T18:47:10Z")
> [@kporter](#): > > The client takes care of the load balance for you. The cluster create a partition table and shares that information with the client. The client determines which node a write should go to by inspecting the partition table for the node who is master for a given partition and then sends the write to that node. By default the policy is the same for reads, but some of our clients support reading from the replica, aka prole, node. If using the option to read from replicas, the client will read from the master or any replica for a given partition in a round-robin fashion. Got it. So I just config my client via `NewClientWithPolicyAndHost`. Ok, so I understand now that the client will load balance for me. But you mentioned some detail about the the use of partitions. Are you just elaborating on how the data is replicated across nodes or are you saying I have some additional configuration options to consider? To be clear on my use case, I simply want additional nodes for redundancy (if one goes down, all other nodes have the same full copy of all my data). ---
**Author:** ![kporter](https://sea1.discourse-cdn.com/flex019/user_avatar/discuss.aerospike.com/kporter/32/515_2.png) [@kporter](https://discuss.aerospike.com/u/kporter)\ **Post date:** [June 10, 2015, 7:31pm UTC](https://discuss.aerospike.com/t/how-does-one-setup-clustering/1350/6 "2015-06-10T19:31:31Z")
> [@Nicholas\_Manning](#): > > Are you just elaborating on how the data is replicated across nodes or are you saying I have some additional configuration options to consider? I was just elaborating.