Installing GET-IT from scratch

Before starting installation read the Server requirements page.

If you just want to install GET-IT, it is recommended to use Ubuntu 16.04

Prerequisites of virtual machine:

RAM - 16 GB

Disk space - 50 GB

Core - 4

Install Docker CE on Ubuntu

Docker CE is supported on Ubuntu on x86_64 , armhf , s390x (IBM Z), and ppc64le (IBM Power) architectures.

Warning

Make sure to check the OS version as one among supported ones

Show your OS details running:

uname -a

Uninstall old docker versions

if old versions of Docker binary were installed then uninstall them:

sudo apt-get remove docker docker-engine docker.io

Install docker

The package of Docker CE is now called docker-ce. Before doing the installation steps please make sure that the apt package index has been updated:

sudo apt-get update

Add packages to allow the use of secure http channel:

sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    software-properties-common

Add the official GPG key from Docker:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

Run the following command to setup the stable repository:

sudo add-apt-repository \
    "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
    $(lsb_release -cs) \
    stable"

Update the package index:

sudo apt-get update

Install the latest version of the binary or a specific version with the command:

sudo apt-get install docker-ce  # latest

or:

sudo apt-get install docker-ce=<VERSION>  # specific

The docker daemon will start automatically.

Add your user to the docker group if you want to run docker command without sudo privileges:

sudo usermod -aG docker $USER
source $HOME/.bashrc

Verify the health of your installation by running the sample hello-world image:

sudo docker run hello-world

The following message has to be displayed if everything is working properly:

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
1. The Docker client contacted the Docker daemon.
2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
$ docker run -it ubuntu bash

Install Docker Compose on Ubuntu

Download the latest version of docker-compose binary:

sudo curl -L \
https://github.com/docker/compose/releases/download/1.19.0/docker-compose-`uname -s`-`uname -m` \
-o /usr/local/bin/docker-compose

Adjust executable permissions to the binary:

sudo chmod +x /usr/local/bin/docker-compose

Verify the installation:

docker-compose --version

Running GET-IT stack

Clone the repository:

git clone https://github.com/SP7-Ritmare/starterkit.git

Modify configuration files:

cd starterkit/scripts/docker/env/production/

change GEONODE_LB_HOST_IP variable value with address IP or DNS of the GET-IT in your server in the sos.env, django.env, geoserver.env, celery.env

Build and launch the starterkit image

This is useful when any change to the source code has been developed, totally useless when you want just to run the stack. In this case please follow the next paragraph.

Launch the stack with the build of GeoNode so any changes you did will be immediately available:

cd ~/starterkit/
sudo docker-compose up --build -d

If the network where you want install the GET-IT is protected by proxy, follow this:

cd ~/starterkit/ sudo docker-compose build –build-arg HTTPS_PROXY=http://proxy.uns.ac.rs:8080 sudo -E docker-compose up -d

Run the stack

Run the following command to bootstrap the containerized stack:

sudo docker-compose up

The GET-IT is installed correctly! GET-IT will be available at the ip address of the eth0 interface. Check IP address with:

ifconfig -a