Resilience Academy documentation

This is a documentation on how to install our Climate Risk Database (CRD) to your own servers. This documentation is based on the step by step procedures which was used to create the CRD

The CRD is one of the Resilience Academy service that was established to facilitate access of spatial and non spatial data from the Resilience Academy innitiatives. The data in the CRD involves the geospatial data (vector data and raster data) and the reports that have been produced from the Tanzania Urban Resilience Progra (TURP). More information about TURP can be accessed here

License

ProjectSend is licensed under CC BY 4.0

Authors

Resilience Academy Experts - Cooperation between University partners

Contact us

If you would like to contact us, send an email throught: resilienceacademytz@gmail.com

Setup
Build
Customize

GeoNode-Project Template for resilienceacademy

Setup

Clone the git repository.

cd /opt
git clone https://github.com/geosolutions-it/resilienceacademy.git

Move to repo folder.
```
cd /opt/resilienceacademy
```

Customize the environment.

a) django.env

  nano scripts/docker/env/production/django.env

  --- a/scripts/docker/env/production/django.env
  +++ b/scripts/docker/env/production/django.env
  @@ -3,20 +3,20 @@ GEONODE_INSTANCE_NAME=geonode
  DOCKER_ENV=production
  UWSGI_CMD=uwsgi --ini /usr/src/resilienceacademy/uwsgi.ini

  -SITEURL=https://geonode-06.utu.fi/
  +SITEURL=https://<public host>/
  ALLOWED_HOSTS=['django', '*']

  -GEONODE_LB_HOST_IP=geonode-06.utu.fi
  +GEONODE_LB_HOST_IP=<public host>
  # port where the server can be reached on HTTP
  # GEONODE_LB_PORT=80
  # port where the server can be reached on HTTPS
  GEONODE_LB_PORT=443

  -ADMIN_PASSWORD=admin
  +ADMIN_PASSWORD=<your admin pwd>
  -ADMIN_EMAIL=admin@geonode-06.utu.fi
  +ADMIN_EMAIL=<your admin email>

  -GEOSERVER_WEB_UI_LOCATION=https://geonode-06.utu.fi/geoserver/
  -GEOSERVER_PUBLIC_LOCATION=https://geonode-06.utu.fi/geoserver/
  +GEOSERVER_WEB_UI_LOCATION=https://<public host>/geoserver/
  +GEOSERVER_PUBLIC_LOCATION=https://<public host>/geoserver/
  GEOSERVER_LOCATION=http://geoserver:8080/geoserver/

  @@ -39,7 +39,7 @@ MOSAIC_ENABLED=False
  BROKER_URL=amqp://guest:guest@rabbitmq:5672/
  MONITORING_ENABLED=True
  MODIFY_TOPICCATEGORY=True
  -
  +AVATAR_GRAVATAR_SSL=True
  EXIF_ENABLED=False
  CREATE_LAYER=False
  FAVORITE_ENABLED=False

b) geoserver.env

  nano scripts/docker/env/production/geoserver.env

  --- a/scripts/docker/env/production/geoserver.env
  +++ b/scripts/docker/env/production/geoserver.env
  @@ -1,6 +1,6 @@
  DOCKER_HOST_IP

  -GEONODE_LB_HOST_IP=geonode-06.utu.fi
  +GEONODE_LB_HOST_IP=<public host>
  # port where the server can be reached on HTTP
  # GEONODE_LB_PORT=80
  # port where the server can be reached on HTTPS

c) nginx.env

  nano scripts/docker/env/production/nginx.env

  --- a/scripts/docker/env/production/nginx.env
  +++ b/scripts/docker/env/production/nginx.env
  @@ -1,12 +1,12 @@

  -ADMIN_EMAIL=admin@geonode-06.utu.fi
  +ADMIN_EMAIL=<your admin email>

  # IP or domain name and port where the server can be reached on HTTP (leave HOST empty if you want to use HTTPS only)
  HTTP_HOST=
  HTTP_PORT=80

  # IP or domain name and port where the server can be reached on HTTPS (leave HOST empty if you want to use HTTP only)
  -HTTPS_HOST=geonode-06.utu.fi
  +HTTPS_HOST=<public host>
  HTTPS_PORT=443

  # Let's Encrypt certificates for https encryption. You must have a domain name as HTTPS_HOST (doesn't work
  @@ -15,6 +15,6 @@ HTTPS_PORT=443
  # staging : we get staging certificates (are invalid, but allow to test the process completely and have much higher limit rates)
  # production : we get a normal certificate (default)
  #LETSENCRYPT_MODE=disabled
  -LETSENCRYPT_MODE=staging
  +LETSENCRYPT_MODE=production

  RESOLVER=127.0.0.11

Build

Double check docker-compose.yml and docker-compose.override.yml are correctly configured.

Run the docker compose build.

cd /opt/resilienceacademy
./docker-build-sh

Follow the logs in order to be sure the container started up correctly.

docker-compose logs -f django

Wait until you see:

...
django4resilienceacademy | got command ${cmd}
django4resilienceacademy | [uWSGI] getting INI configuration from /usr/src/resilienceacademy/uwsgi.ini

Check the GeoNode has correctly started up.
```
# Browse to
https://<public host>/
```

Customize

Clone the git repository.

cd /opt
git clone https://github.com/geosolutions-it/geonode-customisation.git

Move to repo folder.
```
cd /opt/geonode-customisation
```
Make .sh files executable.
```
chmod u+x *.sh
```
Execute update.sh.
```
./update.sh
```

update.sh will always pull latest version from git before updating files. All files will be backed up before updating. Process halts on error.

resilienceacademy / resilience-academy-geonode

readme