Skip to content

Latest commit

 

History

History
215 lines (127 loc) · 5.09 KB

installation.rst

File metadata and controls

215 lines (127 loc) · 5.09 KB
Raw

INSTALLATION

These instructions will install Geotrek on a dedicated server for production. For a developer instance, please follow the dedicated procedure <development-section>.

Requirements

A first estimation on system resources is :

  • 2 Go RAM
  • 10 Go disk space

Installation

Once the OS is installed (basic installation, with OpenSSH server), log in with your linux user (not root). You will also need unzip (sudo apt-get install unzip).

Make sure you are in the user folder :

cd /home/mylinuxuser

Download the latest version of Geotrek-admin with the following commands (X.Y.Z to replace with the latest stable version number : https://github.com/GeotrekCE/Geotrekadmin/releases) :

wget https://github.com/GeotrekCE/Geotrek-admin/archive/X.Y.Z.zip

Unzip the archive of Geotrek-admin

unzip Geotrek-admin-X.Y.Z.zip

You can rename Geotrek-admin-X.Y.Z folder to Geotrek-admin

Go into Geotrek-admin folder and launch its installation

cd Geotrek-admin
./install.sh

You will be prompt for editing the base configuration file (settings.ini), using the default editor.

notes

If you leave localhost for the database host (dbhost value), a Postgresql with PostGis will be installed locally.

In order to use a remote server (recommended), set the appropriate values for the connection. The connection must be operational (it will be tested during install).

To make sure the application runs well after a reboot, try now : sudo reboot. And access the application http://yourserver/.

You will be prompted for login, jump to loading data section <loading data>, to create the admin user and fill the database with your data!

Software update

All versions are published on the Github forge. Download and extract the new version in a separate folder (recommended).

wget https://github.com/GeotrekCE/Geotrek-admin/archive/X.Y.Z.zip
unzip X.Y.Z.zip
cd Geotrek-X.Y.Z/

Before upgrading, READ CAREFULLY the release notes, either from the docs/changelog.rst files or online.

Shutdown previous running version :

# Shutdown previous version
sudo supervisorctl stop all

Copy your old configuration and uploaded files to your new folder.

# Configuration files
cp -aR ../previous-version/etc/ .

# Uploaded files
cp -aR ../previous-version/var/ .

# If you have advanced settings
cp ../previous-version/geotrek/settings/custom.py geotrek/settings/custom.py

# If you have import parsers
cp ../previous-version/bulkimport/parsers.py bulkimport/parsers.py

Deploy the new version :

# Re-run install
./install.sh

# Empty cache
sudo service memcached restart

Check the version on the login page !

note

Shutting down the current instance may not be necessary. But this allows us to keep a generic software update procedure.

If you don't want to interrupt the service, skip the stop step, at your own risk.

Check out the troubleshooting page<troubleshooting-section> for common problems.

Server migration

It is a new installation with an additional backup/restore and a file transfert in between. The commands below are examples to adapt to your actual configuration (server names, database configuration).

Backup settings, media files and database on the old server:

cd Geotrek
sudo -u postgres pg_dump -Fc geotrekdb > geotrekdb.backup
tar cvzf data.tgz geotrekdb.backup var/static/ var/media/paperclip/ var/media/upload/ etc/settings.ini geotrek/settings/custom.py

Get and unzip Geotrek sources on the new server:

wget https://github.com/GeotrekCE/Geotrek-admin/archive/2.0.0.zip
unzip 2.0.0.zip
mv Geotrek-2.0.0 Geotrek
cd Geotrek

Restore files on the new server:

scp old_server:Geotrek/data.tgz .
tar xvzf data.tgz

Then edit etc/settings.ini to update host variable and geotrek/settings/custom.py to update IGN key.

Install Geotrek on the new server:

./install.sh

Restore database on the new server:

sudo supervisorctl stop all
sudo -u postgres psql -c "drop database geotrekdb;"
sudo -u postgres psql -c "create database geotrekdb owner geotrek;"
sudo -u postgres pg_restore -d geotrekdb geotrekdb.backup
make update
sudo supervisorctl start all

Tips and Tricks

  • Use symlinks for uploaded files and cached tiles to avoid duplicating them on disk:
mv var/tiles ~/tiles
ln -s ~/tiles `pwd`/var/tiles

mv var/media ~/media
ln -s ~/media `pwd`/var/media
  • Speed-up upgrades by caching downloads :
mkdir ~/downloads
mkdir  ~/.buildout

Create /home/sentiers/.buildout/default.cfg with :

[buildout]
download-cache = /home/sentiers/downloads