Setting up a Cluster

Follow the instructions below to install AnzoGraph on a cluster.

Important

Cambridge Semantics recommends that you do not install or run AnzoGraph as the root user. Because AnzoGraph offers features such as user-defined extensions, it is not secure software certified.

Make sure that all AnzoGraph host servers meet the requirements in Server and Cluster Requirements.
Note the IP addresses of each server, and pick one server to act as the leader node. Typically users choose the lowest IP address to become the leader. After the installation, you will configure the cluster by listing the IP addresses in a configuration file.
Go to the AnzoGraph Download page, which lists the AnzoGraph releases that are available to download. The page offers direct download for downloading the tarball to your computer or a cURL command that you can run from the AnzoGraph host server to download the tarball onto the server. Place the azg.tgz tarball on each of the host servers in the cluster, and then proceed to the next step.
Unpack the tarball and install AnzoGraph on each server. Install AnzoGraph in the same file system location on each server. To unpack the tarball, change directories to the location where you want to install AnzoGraph, such as your home directory. Do not choose a root-owned location. Then run the following command to unpack the tarball and install AnzoGraph in that location:
```
tar -zxf /path_to_tarball/azg.tgz
```
The tarball unpacks the AnzoGraph files into a directory named azg.
On each server in the cluster, open the install_path/azg/config/ip_addrs.conf file in a text editor. In ip_addrs.conf, type a list of the IP addresses for each server in the cluster. Include each address on a new line. Type the leader server IP address on the first line, followed by each compute IP address. Then save and close the file. For example, on a cluster with 4 servers where 192.168.2.1 is the leader server:
```
192.168.2.1
192.168.2.2
192.168.2.3
192.168.2.4
```
Important: Make sure that ip_addrs.conf is exactly the same, with IP addresses in the same order, on each server.
On each server in the cluster, run the following command to start the system manager daemon. The system manager daemon is a lightweight program that runs at all times and manages the communication between AnzoGraph servers:
```
./install_path/azg/bin/azgmgrd
```
Note: If you run the command as the root user, the system manager displays the following error message:
```
Error - Cannot execute as user 'root'.
To override this security protection, set 'enable_root_user=true':
Invalid user id
```
To resolve the issue, follow the instructions in Changing System Settings to add enable_root_user=true to the AnzoGraph settings file and enable root user access. Then repeat this step.
On the leader node, run the following command to start the database on the cluster:
```
./install_path/azg/bin/azgctl -start
```
The software prompts you to review and accept the license agreement. Review the AnzoGraph license and type y and press Enter to agree to the license and start the database, or type n and press Enter to disagree and discontinue the startup.

For next steps, see Getting Started with the Command Line Interface, a brief tutorial designed to introduce you to the AnzoGraph command line interface and provide instructions for loading and querying a sample data set as well as your own data.

Setting up a Cluster

Related Topics