GeoNode System Dependencies

Overview

The following steps will guide you through a fresh setup of GeoNode.

All guides will first install and configure the system to run in DEBUG mode (also known as DEVELOPMENT mode) and then, by configuring an HTTPD server, to serve GeoNode through the standard HTTP (80) port.

Warning

These guides are not meant to be used on a production system. There will be dedicated chapters that will show you some hints on how to optimize GeoNode for a production-ready machine. In any case, we strongly suggest tasking an experienced DevOp or System Administrator with checking everything before exposing your server to the WEB.

Ubuntu 22.04.2LTS

This part of the documentation describes the complete setup process for GeoNode in a clean Ubuntu 22.04.2LTS 64-bit environment (Desktop or Server).

All examples use shell commands that you must enter on a local terminal or a remote shell.

• If you have a graphical desktop environment you can open the terminal application after login;

• If you are working on a remote server, the provider or sysadmin should have given you access through an ssh client.

Hint

You can download and install a Virtual Machine with Ubuntu 22.04.2LTS set up from the link below. GeoSolutions GeoNode Ubuntu Training VM

1. Install the dependencies

In this section, we are going to install all the basic packages and tools required for a complete GeoNode installation.

Warning

To follow this guide, basic knowledge of Ubuntu Server configuration and working with a shell is required.

Note

This guide uses vim as the editor. Feel free to use nano, gedit, or any other editor.

Upgrade system packages

Check that your system is already up-to-date with the repository by running the following commands:

sudo apt update -y; sudo apt upgrade -y; sudo apt autoremove --purge;

Packages Installation

Note

You don’t need to install the system packages if you want to run the project using Docker

We will use example.org as a fictitious Domain Name.

First, we are going to install all the system packages needed for the GeoNode setup. Log in to the target machine and execute the following commands:

# Install packages from GeoNode core
sudo apt install -y --allow-downgrades build-essential \
  python3-gdal=3.4.1+dfsg-1build4 gdal-bin=3.4.1+dfsg-1build4 libgdal-dev=3.4.1+dfsg-1build4 \
  python3-all-dev python3.10-dev python3.10-venv virtualenvwrapper \
  libxml2 libxml2-dev gettext libmemcached-dev zlib1g-dev \
  libxslt1-dev libjpeg-dev libpng-dev libpq-dev \
  software-properties-common build-essential \
  git unzip gcc zlib1g-dev libgeos-dev libproj-dev \
  sqlite3 spatialite-bin libsqlite3-mod-spatialite libsqlite3-dev

# Install Openjdk
sudo apt install openjdk-11-jdk-headless default-jdk-headless -y

# Verify GDAL version
gdalinfo --version
$> GDAL 3.4.1, released 2021/12/27

# Verify Python version
python3.10 --version
$> Python 3.10.12

which python3.10
$> /usr/bin/python3.10

# Verify Java version
java -version
$> openjdk version "11.0.22" 2024-01-16
$> OpenJDK Runtime Environment (build 11.0.22+7-post-Ubuntu-0ubuntu222.04.1)
$> OpenJDK 64-Bit Server VM (build 11.0.22+7-post-Ubuntu-0ubuntu222.04.1, mixed mode, sharing)

# Install VIM
sudo apt install -y vim

# Cleanup the packages
sudo apt update -y; sudo apt autoremove --purge

Warning

GeoNode 4.x is not compatible with Python < 3.9