Getting the project

Clone the repository locally:

git clone -b develop https://gitlab.gistools.geog.uni-heidelberg.de/waterproofing-data/webportal_server.git wpd_server

Remember that you have to checkout in the develop branch, which is the working branch

Repository workflow good practices

The repository workflow for the project have two main branches:

master (where the stable/production versions are stored)
develop (where the working versions are stored)
feature/my-feature-name (local only branches of a working feature)
fix/my-bug-fixes (local only branches of a working bug fixes)

Development setup

npm install
npm run dev

Production setup

Run postgis docker

docker run --name=pgWpdWiki -d -e POSTGRES_USER=admin -e POSTGRES_PASS=admin -e POSTGRES_DBNAME=wpdWiki -e ALLOW_IP_RANGE=0.0.0.0/0 -p 25432:5432 -v /home/khan/workspace/wpd/server/pg_data:/var/lib/postgresql --restart=always kartoza/postgis:9.6-2.4

Run wikijs docker by supplying postgis credentials

docker run -d -p 8080:3000 --name wiki --restart unless-stopped -e "DB_TYPE=postgres" -e "DB_HOST=172.17.0.1" -e "DB_PORT=25432" -e "DB_USER=admin" -e "DB_PASS=admin" -e "DB_NAME=wpdWiki" requarks/wiki:2

DB_HOST=< docker ip address where db container is running >

open localhost:8080 in browser and do installation steps

Run Geoserver docker

docker run -d -p 8600:8080 --name geoserverWpd -e SAMPLE_DATA=true -e COMMUNITY_EXTENSIONS=ogr-datastore-plugin kartoza/geoserver:2.16.2

Deployment

Login ssh <username>@waterprofing.geog.uni-heidelberg.de
Create back of running server and client

mkdir ~/wpd/backup/server_<date> 
cp -rf ~/wpd/server/* ~/wpd/backup/server_<date>

Get the latest code from git

cd ~/wpd/server
git pull

Start the server as standlone

~~npm run start~~

~~nohup npm run start > output.log &~~

ref: To run server in background https://www.dev2qa.com/how-to-run-node-js-server-in-background/ if gets an error saying port in use can use $pkill -f node and $pkill -f nodejs to kill all node server ref: https://stackoverflow.com/questions/31649267/how-to-kill-a-nodejs-process-in-linux

Using pm2 for running app So that app server restarts when shutsdown unexpectedly

To start app server (required only first time)

cd ~/wpd/server/
pm2 start app/server.js

Use this command to know the status, pid, etc

pm2 status

To stop app in pm2

pm2 stop <id>

Applicaton logs are stored at cat /home/m/mkhan/.pm2/logs/server-out.log

and error logs at cat /home/m/mkhan/.pm2/logs/server-error.log

To see logs

pm2 log

To see monitoring tool with other server details

pm2 monit

OR Run server as Docker container

To Build an image

docker build -t wpd/api-server .

Create container by

docker run -p 9090:8080 -v $PWD:/usr/src/app --name wpd-server -d wpd/api-server

Starting other Docker Container

Start Database docker conatiner

sudo docker start pgWpdWiki2

start wiki server

sudo docker start wiki2

start geoserver

sudo docker start geoserverWpd

ensure that db server was started first, because in wiki's env_variables ip of Db server is given as 172.17.0.2
to check env_variables used while docker run command

docker exec <container_id> bash -c 'echo "$ENV_VAR"'

to check the ips of all containers inside "bridge" connections

sudo docker network inspect bridge

Transfering Shapefiles to Geoserver

Transfer file from your local machine to server by

scp <FilesToSend> mkhan@waterproofing.geog.uni-heidelberg.de:/home/m/mkhan/wpd/spatial_data

Currently we are using /home/m/mkhan/wpd/spatial_data folder to place all our data files

Copy the files into Geoserver container

sudo docker ps -a

Take the Geoserver's Container ID and

sudo docker cp <SourceFileToCopy> <GeoserverContainerID>:<FileLocation>

Get into Geoserver conatiner

sudo docker exec -it geoserverWpd bash

Get the data directory where we are storing the data for Geoserver echo $GEOSERVER_DATA_DIR should return you something like /opt/geoserver/data_dir/data

Step for changing max file size to upload eg: images, videos

Get into wiki conatiner

sudo docker exec -it wiki2 bash

Edit file name config.yml residing at /wiki in wiki container

vi config.yml

// change the file size as required here
uploads:      
  maxFileSize: 20971520
  maxFiles: 10

Further info at https://docs.requarks.io/install/config#upload-limits

Further help

For any bugs or future enhancements open an issue and label it as Bug or Ideas respectively. For any other queries contact Mohammed Rizwan Khan rizwan@uni-heidelberg.de.

mrkhan/WPD-WebServer