This is a guide for installing and running ClustrixDB on any system running CentOS 6.X.
To obtain the link to the current version of the ClustrixDB installer along with a license key, please contact Clustrix Sales. If you encounter any problems or issues while using these instructions, please contact Clustrix Support.
Before beginning, please verify that your hardware meets the minimum Recommended Hardware Configurations.
Copy the installer to a node, extract, and run as shown below.
The installation process can take several minutes. Please be patient.
Enter Yes to accept the installation parameters recommended and install ClustrixDB on the first node. Refer to the ClustrixDB Installation Options for guidance in modifying these parameter values.
ClustrixDB requires a number of ports for access by external applications and for internode communication.
The recommended method for allowing communication between nodes is to allow access between all nodes on all ports within a secure environment.
You can also open the specific ports required by ClustrixDB as shown below.
If using network security such as firewalls or security groups, the following network traffic must be allowed.
These network ports are required for communication between ClustrixDB nodes. They must each be accessible by other nodes within the cluster.
|TCP||22||SSH||Administration and upgrade|
|TCP, UDP||2048||Control Port||ClustrixDB specialized administrative tool|
|TCP, UDP||2424||Nanny Port||nanny - Clustrix process manager|
|TCP||7888||clxdbi||Database interface for ClustrixGUI|
|TCP, UDP||24378 - 24410||Multiport||ClustrixDB internode communication|
These network ports are used to access ClustrixDB externally from your applications and for cluster administration.
|TCP||22||SSH||Remote management and cluster access|
|TCP||3581||Health Check||Heartbeat monitor for cluster|
For instructions for specific cloud environments, please see Installing ClustrixDB at a cloud provider.
Run flex_clone from a command prompt of the first configured node to install identical versions of ClustrixDB on additional nodes. You will need to run this once for each node of your cluster.
You can now connect to your new database to configure your cluster. ClustrixDB uses your existing mysql client to access the ClustrixDB database. First, execute the following from a command line prompt.
Follow this syntax from the resulting mysql prompt to provide the license number and configure your cluster. Be sure to include the curly brackets that surround your license key. (If you do not already have a license key, please contact Clustrix Sales.)
For example, this adds three nodes to the cluster.
This test will only succeed once all nodes have been successfully added to your cluster using the previous step.
To verify that the clocks are synchronized between all nodes of the cluster, run the following from a command line prompt:
See Setting Up NTP for ClustrixDB on CentOS if this step identifies issues.
Execute the following from a command line prompt to access the “test” database created during installation:
You should now be able to access the ClustrixGUI Administration UI to monitor and manage your cluster. Provide the IP or hostname of one of the nodes of your cluster in the address bar of a browser and press Enter. (Clustrix recommends Chrome.)
Please contact Clustrix Support if you experience any problems during installation.