Skip to end of metadata
Go to start of metadata

By default, ClustrixGUI is included in the installation of ClustrixDB. You can also configure the GUI portion of ClustrixGUI to run on a standalone server. The DBI portion of ClustrixGUI must run on the database server for ClustrixGUI to run. 


Log into the server as the Linux root user or a non-root Linux user with sudo privileges. 

Download the standalone ClustrixGUI installer to the server, then untar and run the installer script using the non-root option

shell> tar xvf clustrix-gui-installer.current_version.tar.bz2
shell> cd clustrix-gui*/
shell> ./ --non-root

The installer will present you with a list of options based on your server specifications. You may use the default values for most options.

 Click to view full list of Installer Options


OptionPromptDescriptionDefault Value
0OS UserThe Operating System User used to run ClustrixGUIclxgui*
1ClxGUI Install PathThe path where the ClxGUI will be installed./opt/clustrix/clxgui
2ClxGUI Data Cache PathThe path for data cached by ClxGUI.


3ClxGUI Listen AddressThe address at which ClxGUI listens.
4ClxGUI Listen TCP PortThe TCP port used for HTTP communication by ClxGUI. If a user other than root is specified for the OS User (Option 10), the default will be 8080.


5ClxGUI Log PathThe path for logs generated by ClxGUI./data/clustrix/log/clxgui
6ClxGUI PID File PathThe location of the process identification number file for the ClxGUI./opt/var/run/clustrix

*denotes default options when running as non-root.

Type Yes to accept the terms of use and proceed with installation.

Logging into ClustrixGUI from a standalone server

Access ClustrixGUI by typing the ip or hostname into a web browser. For non-root installations, the include port 8080. Chrome is recommended. 

If you are logging in for the first time, provide the following temporary credentials:

  • Email: [email protected]
  • Password: clustrix
  • Target: hostname or IP address of any node in your cluster

Once you log in you will be access the front end GUI from the standalone server and visualizing data from the target node's DBI. 

Clustrix strongly recommends that you create a new user and delete the [email protected] user. To create a new user, access the "Manage Users" in the upper right corner of any page by clicking on . For more information see Managing ClustrixGUI Users.

Uninstall ClustrixGUI

To uninstall the Standalone ClustrixGUI, log in as root or a user with sudo access:

shell> /opt/clustrix/clxgui/bin/uninstall

  • No labels