Install Greengage DB from a package
This guide explains how to install Greengage DB on Ubuntu 22.04 or 24.04 from the official APT repository.
Starting with version 6.31.0, Greengage DB packages are available through the official APT repository. For earlier versions starting from 6.29.2, .deb packages are available on the GitHub Releases page. Corresponding packages with debugging symbols are also provided.
Prerequisites
Before installing Greengage DB, ensure that the host meets all requirements described in Pre-installation configuration.
Install Greengage DB
-
Make sure you are logged in as a user with
sudoprivileges. -
Import the Greengage DB repository signing key:
$ curl -fsSL https://greengagedb.org/repositories/gpg \ | sudo gpg --dearmor -o /etc/apt/keyrings/greengagedb.gpg -
Add the Greengage DB APT repository:
$ echo 'deb [signed-by=/etc/apt/keyrings/greengagedb.gpg] https://greengagedb.org/repositories/ubuntu/22.04/x86_64 greengagedb main' \ | sudo tee /etc/apt/sources.list.d/greengagedb.list$ echo 'deb [signed-by=/etc/apt/keyrings/greengagedb.gpg] https://greengagedb.org/repositories/ubuntu/24.04/x86_64 greengagedb main' \ | sudo tee /etc/apt/sources.list.d/greengagedb.list -
Update package metadata:
$ sudo apt update -
Install Greengage DB:
$ sudo apt install greengage6 -
Type
Yand pressEnterwhen prompted with the following message:The following additional packages will be installed: libapr1t64 libaprutil1t64 libevent-2.1-7t64 libxerces-c3.2t64 net-tools python-is-python3 sigar unzip zip The following NEW packages will be installed: greengage6 libapr1t64 libaprutil1t64 libevent-2.1-7t64 libxerces-c3.2t64 net-tools python-is-python3 sigar unzip zip 0 upgraded, 10 newly installed, 0 to remove and 14 not upgraded. Need to get 13.5 MB of archives. After this operation, 53.8 MB of additional disk space will be used. Do you want to continue? [Y/n]
Verify the installation
-
Verify that the package has been installed successfully:
$ dpkg -l | grep greengage6The result should look as follows:
ii greengage6 6.31.0 amd64 Greengage MPP database engine
-
Check the installation paths:
$ dpkg -L greengage6The output lists all files installed by the package:
/. /opt /opt/greengagedb /opt/greengagedb/greengage6 /opt/greengagedb/greengage6/bin /opt/greengagedb/greengage6/bin/analyzedb /opt/greengagedb/greengage6/bin/clusterdb /opt/greengagedb/greengage6/bin/createdb /opt/greengagedb/greengage6/bin/createlang /opt/greengagedb/greengage6/bin/createuser ...
Some of the key directories:
-
/opt/greengagedb/greengage6/bin — executable binaries and command-line tools.
-
/opt/greengagedb/greengage6/include — C header files for Greengage DB.
-
/opt/greengagedb/greengage6/lib — Greengage DB and PostgreSQL library files.
-
/opt/greengagedb/greengage6/sbin — supporting and internal scripts and programs.
-
/opt/greengagedb/greengage6/share — shared files.
-
Create a symlink to Python 2 (Ubuntu 22.04)
Create a symbolic link from python2 to /usr/bin/python:
$ sudo ln -s python2 /usr/bin/python
Set the Greengage DB path
-
Switch to the gpadmin user:
$ sudo su - gpadmin -
Set the Greengage DB path and environment variables as follows:
$ source /opt/greengagedb/greengage6/greengage_path.shNOTEAdd the above
sourcecommand to thegpadminuser’s shell startup file (for example, .bashrc). This ensures that the Greengage DB path and environment variables are set each time you log in asgpadmin.
Set up a demo cluster
Once Greengage DB is installed, you can proceed to Set up a Greengage DB demo cluster to create a demo environment for testing and exploring DBMS features.