Child pages
  • Best Practices for Platform Configuration of ClustrixDB Software Installations

This is documentation for a previous version of ClustrixDB. Documentation for the latest version can be found here

Skip to end of metadata
Go to start of metadata

This section describes best practices for the following subjects:


This page is a list of Best Practices for when setting up and installing the ClustrixDB software. See Getting Started on ClustrixDB Software to complete the initial installation and general configuration instructions. 

Network Configuration

IP addressing and Hostnames

When setting up a new cluster it is best to maintain consistent ordering and numbering with IP address, hostnames, and node numbers.

For example:

  • IP Address x.x.x.11 = hostname1 = node 1. 
  • IP Address x.x.x.12 = hostname2 = node 2. 
  • IP Address x.x.x.13 = hostname3 = node 3. 

Currently to achieve this, you have to add nodes one at a time to the cluster using the Cluster Management page on the Clustrix Insight webui, otherwise the node number is random as the numbers are assigned in the order that the nodes respond to the addition request.

This is only relevant for on-premises installations, as you don't typically have that much control over IP address allocation in cloud/hosted environments.

Multi-homed Network Configuration

While ClustrixDB runs fine on nodes with a single network connection, the recommended network topology is a setup with at least two ethernet connections; the front-end and back-end. The front-end ethernet is for external traffic to communicate with the cluster while the back-end ethernet should be used for internode communication only.

  • By default, the database will listen on all address and so no additional settings will be needed for the front-end ethernet.
  • The IP of the Back-end ethernet will need to be set during the initial software setup wizard and is listed as "8 - Private (Back-End) IP: x.x.x.x".

For more information on setting up the network please see Network Security with ClustrixDB.


When adding nodes to a cluster in a cloud environment such as AWS or Rackspace it is important to use the internal IP address as using the external address can cause cluster creation to fail.

Network Security

The 3 main approaches to security are as follows:

  • You are in a secured/trusted environment, so iptables is not needed. ( Recommended )
  • You are in a hosted cloud environment such as AWS, where Security Group or similar mechanisms provide IP security by limiting access to ports (thus iptables on each node would be redundant).
  • Neither of the above, use iptables properly secure the cluster.

There are 9 ports that are used for communication between ClustrixDB nodes and must be open to allow proper cluster operation. With the exception of 22 and 80, these ports should be restricted so they are only accessible by the other nodes in the cluster.

  1. TCP port 22 (SSH)
  2. TCP port 80 (HTTP)
  3. TCP port 2048
  4. TCP port 2424
  5. TCP port 24378
  6. TCP port 3306
  7. UDP port 24378
  8. UDP port 2424
  9. UDP port 2048

There are 4 TCP network ports that are used to access your ClustrixDB from your database application and for day-to-day administration: 

  1. TCP port 22 (SSH)
  2. TCP port 80 (HTTP)
  3. TCP port 3306 (SQL)
  4. TCP port 3581 (Health Check)

In a typical secure configuration, you will limit access to TCP Ports 80 and 22 to the network CIDR range that maps to the public IPs for your administrative clients (typically exposed through your firewall), and you will limit access to TCP Port 3306 to your administrative client CIDR range and also to the range of IPs used by your application servers (if they are outside your firewall).

For complete details on how to set up security please see Network Security with ClustrixDB.

Front-end Load Balancing

ClustrixDB has been designed to take full advantage of a front-end load balancer. We recommend HAProxy if you are using ClustrixDB software and the Amazon Elastic Load Balancer if you are running in AWS. For more detailed information on setting up HAProxy or the AWS ELB please see the following links:

Load Balancing ClustrixDB with HAProxy

Configure EC2 Elastic Load Balancer for ClustrixDB AWS


NTP should be running so that the nodes' clocks don't get out of sync; otherwise, you may get inconsistent timestamps when using now() , and this also makes log analysis much more difficult. See Setting Up NTP for ClustrixDB on CentOS.

Managing Internode SSH Access

There are three methods of internode SSH access, listed here in order of administrative simplicity:

  1. Host Based Authentication. The ClustrixDB installer will set up host based authentication if you allow it under option #11. (Recommended)
  2. Key Pair Authentication. For information on configuring key pair authentication, see Internode Administrative Connectivity via Ethernet.
  3. Password.

If you use password-based authentication then the CLX Command Line Tool will require a password for most commands.

For ease of use, we suggest having the same password for each node.


Databases are not typically network-bound (as compared to a file server), however, a clustered database system does rely upon low latency links between nodes.

  • Cluster nodes should always be on the same subnet, with no intermediate routers between. As mentioned above, a dedicated backend connection is ideal.

To learn more about how network latency can affect nodes in a cluster please see Recognizing Platform Limits.

Storage Configuration


  • As with MySQL, disk seeks can be a huge performance bottleneck, and as such we highly recommend running ClustrixDB on SSD rather than spinning disk.
  • To efficiently use your SSDs, and also avoid log build-up filling your data directory, it is suggested that a single large spinning disk be allocated for the log files. The path for the logs folder is "/data/clustrix/log/".
  • To learn more about disk I/O and SSD vs spinning disk please visit the section: Memory and Disk I/O.


Below are some general best practices on RAID configuration for ClustrixDB:

  • RAID 0: For best performance it is recommended to use RAID 0 and in the case of a failed disk rely on node level redundancy.
  • RAID 5: We do not recommend RAID 5. The performance hit for running RAID 5 is quite severe and as such RAID 5 should be avoided.
  • RAID 10: A good choice for maximum performance and redundancy, but it can become expensive as you're keeping two copies of everything at the storage layer when ClustrixDB is already keeping two copies of everything, so you have 4x disk capacity usage. RAID 10 offers the performance of RAID 0 but with more resiliency. 

For more information about the various RAID level please see Wikipedia: RAID.

File System

For optimal performance use the ext4 format for your filesystem. 

ClustrixDB will work when using an ext3 formatted volume, but it will generate warnings during startup and space allocation. Growing the device file will also take longer than with other volume formats. However, the performance hit from this should be minimal as ClustrixDB proactively grows the device file.

You can see which format your filesystem is with the following:

[[email protected] ~]# df -T
Filesystem    Type   1K-blocks      Used Available Use% Mounted on
/dev/md1      ext3    14446128   2253276  11459028  17% /
tmpfs        tmpfs    16440012    131076  16308936   1% /dev/shm
/dev/md0      ext3      253807     27521    213182  12% /boot
/dev/md3      ext4   1060589952 993662712  13052376  99% /data/clustrix
/dev/sdh1     ext3   484535504   9458888 450657416   3% /data/clustrix/log

In the above example, we have most of the partitions running ext3 and the main /data partition running ext4.

Operating System Concerns


Below are the general operating system best practices and concerns for running the ClustrixDB software. 

  • ClustrixDB was designed and tested using Centos/RHEL 6.3+. While ClustrixDB will run on other Linux-based operating systems only Centos and RHEL 6.3+ are officially supported.
  • You should always avoid running 3rd party software on a node that is running ClustrixDB as the database expects to be able to use the majority of the system resources. Running 3rd party software can cause a node to behave in unexpected ways and is not officially supported. Running 3rd party software that makes heavy use of CPU can result in "slow kernel scheduling" warning messages, and if severe enough, can lead to group changes.
  • It is recommended to add the following path to your user PATH: "/opt/clustrix/bin". This will allow you run to the CLX Command Line Tool with ease.
  • There are several useful commands in the CLX Command Line Tool which can make administering a cluster much easier.


Do not configure swap. Having the database process going to swap, even on SSD, will degrade performance.


  • Shared CPU/Core architecture should be avoided if possible as the database is quite sensitive to wait time when attempting to access a core. Dedicated CPU/Cores are high recommended.
  • VMs on the same physical box may result in I/O contention especially if they're all trying to do bulk inserts.


  • No labels