Docker Installation and Configuration Requirements
This topic lists the AnzoGraph DB and Docker requirements and recommendations and provides references to the Docker downloads and installation instructions. It also includes information about configuring Docker to meet the AnzoGraph DB requirements.
Docker Requirements and Recommendations
| Component | Guidelines |
|---|---|
| Docker Version | Docker Engine - Community version 18 or later is required. |
| Operating Systems | MacOS, Linux, Windows 10 Professional or Enterprise edition.
|
| Available RAM | Minimum: 8 GB; Recommended: 16 GB. AnzoGraph DB needs enough RAM to store data, intermediate query results, and run the server processes. Cambridge Semantics recommends that you allocate 3 to 4 times as much RAM as the planned data size. For guidance on sizing AnzoGraph DB servers, see Sizing Guidelines for In-Memory Storage. |
| Available Disk Space | AnzoGraph DB requires 10 GB for internal requirements. The amount of additional disk space required for load file staging, persistence, or backups depends on the size of the data to be loaded. For persistence, Cambridge Semantics recommends that you have twice as much disk space available as RAM on the server. |
| CPU Count | Minimum: 2; Recommended 8+. Intel processors are preferred, but AnzoGraph DB is supported on newer Epyc AMD processors. AnzoGraph DB does not run on older AMD processors. |
Installing and Configuring Docker
This section provides references to Docker downloads for your operating system as well as installation instructions. It also includes instructions for configuring Docker resources to meet the AnzoGraph DB requirements.
Docker Desktop for Mac
Go to the Docker Desktop for Mac page here and follow the instructions to download, install, and run Docker.
Adjusting Docker Resources
After installing Docker, you must increase the available resources so that Docker is able to launch the AnzoGraph DB image. AnzoGraph DB requires at least 10 GB of available disk space and 8 GiB of available RAM to start the database. Cambridge Semantics recommends that you make at least 16 GiB memory available to Docker.
To adjust the available resources, click the Docker icon in the menu bar and select Preferences. On the Settings screen, select Resources. For example:
Increase the CPUs, Memory, and Disk image size as needed to meet the AnzoGraph DB requirements. Then click Apply & Restart to apply the changes and restart Docker. For instructions on deploying AnzoGraph DB, see Deploying AnzoGraph on Docker Desktop for Mac.
Docker for Linux
Go to the Docker CE hub for Linux editions page here and select the appropriate edition for your version of Linux. Follow the instructions in the Docker documentation to download, install, and run Docker.
You might also want to follow the steps in Post-installation steps for Linux to make sure that a non-root user can run Docker commands and to configure Docker to start automatically on boot. On Linux, Docker does not impose container resource constraints, and you do not need to increase Docker resources as long as the host server meets the AnzoGraph DB requirements.
See Deploying AnzoGraph on Docker for Linux for instructions on deploying AnzoGraph DB.
Docker Desktop for Windows
Go to the Docker Desktop for Windows page here and follow the instructions to download, install, and run Docker. During the installation, make sure that you configure Docker to use Linux containers. Do not choose to use Windows containers.
Adjusting Docker Resources
After installing Docker, you must increase the available resources so that Docker is able to launch the AnzoGraph DB image. AnzoGraph DB requires at least 10 GB of available disk space and 8 GiB of available RAM to start the database. Cambridge Semantics recommends that you make at least 16 GiB memory available to Docker.
The Resources tab allows you to configure CPU, memory, disk, proxies, network, and other resources. Different settings are available for configuration depending on whether you are using Linux containers in WSL 2 mode, Linux containers in Hyper-V mode, or Windows containers.
The Advanced tab is only available in Hyper-V mode because, in WSL 2 and Windows container modes, these resources are directly managed by Windows. In WSL 2 mode, you can configure limits on the memory, CPU, and swap size allocated to the WSL 2 utility VM.
To adjust the available resources, right-click the Docker icon in the Windows task bar and select Settings. On the Settings screen, select Resources > Advanced if that option is available for your specific WSL configuration. For example:
Increase the CPUs, Memory, and Disk image size as necessary to meet the AnzoGraph DB requirements. Then click Apply & Restart to apply the changes and restart Docker. For instructions on deploying AnzoGraph DB, see Deploying AnzoGraph on Docker Desktop for Windows.