Clustrix Development Kit

The Clustrix Development Kit (DevKit) consists of a binary which simulates a Clustrix database instance (devnode) and a command line utility for managing a simulated cluster of such instances (devnodectl). At Clustrix, we use this facility for feature development and functionality testing.

Because Clustrix ships as an appliance, the database software on the appliance expects a certain hardware environment for full performance and reliability. The version of the database software shipped in the development kit simulates these hardware components. Therefore, although the development kit offers nearly full product functionality, it comes at the expense of performance and fault tolerance in case of power failures.

Note: We do not license nor recommend the DevKit for production environments.

Minimum System Requirements

Redhat Enterprise Linux 6.0 / x86_64
Minimum of 4GB System RAM (for a 3 node cluster)

Download

Please review the DevKit software license terms before downloading.

“Part of the reason we purchased the Clustrix solution was the fact that Clustrix is MySQL compatible, and does not require changes to existing architecture, database schemas or applications.”

-Robert Zotter, Lead Engineer, iOffer

“We extensively tested Clustrix’s solution for performance, availability and overall MySQL compatibility. Clustrix passed all the tests we threw at it with flying colors.”

-Graham Hobson, CTO, Photobox

Quick Start

Install

[command prompt ~]$ sudo rpm -ivh clustrix-common-v3.2-493.x86_64.rpm clustrix-devnode-v3.2-7369.x86_64.rpm
Preparing...          ########################################### [100%]
  1:clustrix-common   ########################################### [100%]
  2:clustrix-devnode  ########################################### [100%]

Create the Data Directory

[command prompt ~]$ sudo mkdir -p /data/clustrix
[command prompt ~]$ sudo chown -R  /data/clustrix/

Initialize and Start a 3 Node Cluster

[command prompt ~]$ /opt/clustrix/bin/devnodectl --init --nodes 3 start
[exec]  /opt/clustrix/bin/devnode -clusterpath /data/clustrix -cluster sergei -setpnid 1
        -anyport -unix -glue -noautostart -nclean 4 -vdev-size 256
[exec]  /opt/clustrix/bin/devnode -clusterpath /data/clustrix -cluster sergei -setpnid 2
        -anyport -unix -noautostart -nclean 4 -vdev-size 256
[exec]  /opt/clustrix/bin/devnode -clusterpath /data/clustrix -cluster sergei -setpnid 3
        -anyport -unix -noautostart -nclean 4 -vdev-size 256
Waiting for node 1 to enter quorum.
done.
Node 1 [RUNNING]: /data/clustrix/p1
   mysql: 49307    control: 53006    healthmon:38582
   mysql socket: /data/clustrix/p1/mysql.sock
Node 2 [RUNNING]: /data/clustrix/p2
   mysql: 51712    control: 48452    healthmon:41219
   mysql socket: /data/clustrix/p2/mysql.sock
Node 3 [RUNNING]: /data/clustrix/p3
   mysql: 50668    control: 48927    healthmon:3581
   mysql socket: /data/clustrix/p3/mysql.sock
Example command to access your cluster:
   mysql -u root -S /data/clustrix/p3/mysql.sock

Enjoy your Simulated Cluster!

Here are some examples to get you started:

[command prompt ~]$ mysql -u root -S /data/clustrix/p3/mysql.sock
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 2050
Server version: 5.0.45
Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql> select * from system.membership;
+-----+--------+----------+
| nid | status | instance |
+-----+--------+----------+
|   1 | quorum |        1 |
|   2 | quorum |        1 |
|   3 | quorum |        1 |
+-----+--------+----------+
3 rows in set (0.00 sec)

Documentation

The Clustrix System Administrator Guide contains much of the Clustrix database documentation. Because Clustrix supports the MySQL interface, we mostly document features which are unique to Clustrix and instances where Clustrix differs from MySQL.

Support

Paying customers should contact the standard Clustrix support channel for help with the Development Kit. Free support is available at our public support forum.