Installing AnzoGraph on a Single Server

Follow the instructions below to install AnzoGraph as a single server setup.

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.

If you want to set up an AnzoGraph cluster, see Installing AnzoGraph on a Cluster for instructions.

Make sure that the AnzoGraph host server meets the requirements in Prerequisite Server Configuration.
Copy the AnzoGraph installation script to the server, and then run the following command to make the script executable:
```
chmod +x install_script_file_name
```
Run the following command to start the installation wizard:
```
./install_script_file_name
```
The wizard unpacks the JRE and then waits for input before starting the installation.
Press Enter to proceed with the installation.
Specify the directory to install AnzoGraph. Press Enter to accept the default installation directory or type an alternate path and then press Enter.
Indicate whether this installation is for use with Anzo. Answering yes configures AnzoGraph to use the settings that are optimal for Anzo. Answering no configures the settings that are optimal for AnzoGraph standalone use.
Specify the communication protocol(s) to enable:
1. For the Anzo protocol (grpc) prompt, accept the default selection (yes) and press Enter. The Anzo protocol is the secure gRPC-based protocol that is used for communication between the Anzo server and AnzoGraph.
2. For the SPARQL HTTP protocol prompt, Cambridge Semantics recommends that you accept the default selection (no). Enabling the SPARQL HTTP protocol opens the standard SPARQL-compliant HTTP endpoint. Unlike the Anzo protocol endpoint, the SPARQL HTTP endpoint is not secured. If you enable this option, the installation wizard prompts you to acknowledge that the setup is insecure. If you answer yes, later in the installation the wizard prompts you to specify whether you want to install NGINX as an SSL authentication proxy.
  If you want to connect additional applications to AnzoGraph, enable the SPARQL HTTP protocol for communication with those applications.
At the server installation type prompt, accept the default option 1 (Standalone) and press Enter.
To set up the Anzo protocol gRPC server, type a username to use for authentication. Anzo will use this username to connect to AnzoGraph. Then press Enter.
Type a password for the Anzo username and press Enter. Note: Some special characters, such as $ and *, are treated as parameters in bash. When typing a password, avoid or escape special characters to remove their special meaning to the command line. For more information, see Quoting in the Bash Reference Manual.
If you enabled the SPARQL HTTP protocol, the installation wizard prompts you to configure the SPARQL server:
1. Specify the port to use for SPARQL applications. Press Enter to accept the default port, 7070, or type an alternate port and then press Enter.
2. Specify whether to use NGINX SSL authentication for the SPARQL port:
  - If you do not want to use SSL authentication between Anzo and AnzoGraph, accept the default value n (no) at the Setup Nginx SSL Authentication Proxy prompt and press Enter.
  - If you do want to use SSL authentication, type y (yes) and press Enter, then follow these instructions:
    1. Specify the secure network port to use and press Enter.
    2. Specify the username for the HTTP user and press Enter.
    3. Type the password to use for the HTTP user, and then press Enter.
Configure any additional AnzoGraph settings. If Cambridge Semantics Support provided custom settings to use for your configuration, type the supplied values and then press Enter. Separate multiple settings with the new line escape sequence, \n. For example, the following entry sets two custom settings: truncate_clob=true\npersistence_directory=/data/.
Note: If you are installing AnzoGraph as the root user, add the following value to this prompt:
```
enable_root_user=true
```
The wizard extracts the AnzoGraph files and completes the installation. If you installed NGINX, run the following command to start the NGINX server:
```
./installation_path/AnzoGraph_root_dir/bin/nginxStart
```
If you did not previously make the Linux kernel configuration changes required by AnzoGraph (as described in Prerequisite Server Configuration), run the following command to execute the system configuration utility and make the necessary kernel changes:
```
sudo ./installation_path/AnzoGraph_root_dir/bin/azg_system_config
```
Note: If the kernel configuration changes were not implemented prior to the installation and you do not have sudo permissions to run azg_system_config, follow the instructions in Changing AnzoGraph Configuration Settings to add allow_alternate_vm_config_against_recommendations=true to the AnzoGraph settings file. This setting enables AnzoGraph to start with non-optimal Linux configurations.
Start the AnzoGraph system management daemon by running the following command:
```
./installation_path/AnzoGraph_root_dir/bin/azgmgrd
```
Note: If you run the command as the root user and did not enable root user access during the installation, the system manager displays the following error message:
```
azgctl Exiting: 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 AnzoGraph Configuration Settings to add enable_root_user=true to the AnzoGraph settings file and enable root user access. Then repeat this step.

Run the following command to start the database:

./installation_path/AnzoGraph_root_dir/bin/azgctl -start

For instructions on configuring the connection to AnzoGraph in the Anzo console, see Configuring an AnzoGraph Connection.

Installing AnzoGraph on a Single Server

Related Topics