Complete the 3.1 Pre-Installation Requirements
This page describes the pre-installation requirements and other important information to know before you install AnzoGraph. The list below summarizes the requirements and recommendations:
- Make sure that each host server meets the requirements in AnzoGraph Requirements.
- Certain software packages are required to be installed before the AnzoGraph installation. The installer will not run until these prerequisites are installed. See Prerequisite Software for details and instructions.
- Additional dependencies are required to be installed to support extensions like Apache Arrow integration and the Data Science functions that are used for data profiling. However, Cambridge Semantics recommends that you deploy these dependencies after AnzoGraph is installed because the installation includes a
.repo
file that can aid you in the installing the packages. See Post-Installation C++ Dependencies for details. - When the installer is run with elevated privileges (
sudo
mode), the installer can complete the installation as well as some important post-installation configuration so that AnzoGraph is running when the installation is finished. See Installation Modes and User Accounts for details. - If you are installing AnzoGraph in a clustered setup, make note of the IP addresses for each of the servers in the cluster. The installation wizard prompts you to enter the IP addresses during the installation. In addition, choose one server to be the leader server.
Prerequisite Software
The following software must be installed on the host servers before AnzoGraph is installed.
Java 21 Virtual Environment
AnzoGraph requires a Java 21 virtual environment. OpenJDK 21 and GraalVM 21 are supported. For example, you can run the following command to install OpenJDK 21. Install the JVM on all servers in the cluster.
sudo dnf install java-21-openjdk
You do not need to set the $JAVA_HOME
environment variable on the servers. The AnzoGraph system management daemon (azgmgrd) references $JAVA_HOME
, and it is set when systemd services are configured as part of the installation.
GNU C Devel Library
AnzoGraph requires the latest version of the GNU C glibc-devel
library for your operating system. Run the following command to install glibc-devel. Install the library on all servers in the cluster.
sudo dnf install glibc-devel
GNU Binutils Library
AnzoGraph requires the GNU binutils
library. Run the following command to install binutils. Install the library on all servers in the cluster.
sudo dnf install binutils
Post-Installation C++ Dependencies
Additional libraries are required to be installed on all servers to support the C++ extensions that AnzoGraph offers. Though you can install the C++ dependencies before you install AnzoGraph, if you wait until after the installation you can use the included csi-obs-cambridgesemantics-udxcontrib.repo
file to enable the Cambridge Semantics repository and install the C++ dependencies with or without internet access. For more information, see Installing the C++ Dependencies in the post-installation instructions.
Installation Modes and User Accounts
There are two modes in which you can run the installer, root (sudo) or non-root (current user). This section describes both modes and the user account and file ownership implications for each mode.
Mode | Description |
---|---|
Sudo Mode | Running the installer in sudo mode is the preferred method of installation. In sudo mode, the installer prompts you to enter the platform user name. Systemd units for the system management daemon (azgmgrd ) and database (anzograph ) processes are created in /etc/systemd/system . The units start AnzoGraph as the specified user, and file system permissions for the anzograph directory and any files that AnzoGraph writes are based on the same user. The services also configure the appropriate resource limits (ulimits) for AnzoGraph and set $JAVA_HOME for your OpenJDK installation. |
Non-Root Mode | When running the installer as a non-root user, the installer does not create users and file system permissions are based on the user account that performs the installation. If you choose to run the installer in non-root mode, it is important to install and run AnzoGraph with the platform service user account (see Platform Service User Account Requirements). Example systemd units, in the <install_path>/examples directory, are provided as a template for you to configure and enable manually as described in Non-Root Installs: Configuring and Starting the AnzoGraph Services. |
Once the prerequisites are in place, proceed to Install AnzoGraph 3.1 for instructions on installing the software.