• nginx
• node
• postgres + postgis
• shp2pgsql

Clima is composed of several different services. They will all be installed inside the clima-app directory. We also need a dedicated directory for the maps:

mkdir ~/clima-app
mkdir ~/tilemill-files

Clone and install dependencies:

cd ~/clima-app
git clone https://github.com/paulovieira/clima-tilelive
cd clima-tilelive
sudo npm install

Then launch the server

export TILEMILL_FILES_DIR=$HOME/tilemill-files
node index.js -port=8001 --source=$TILEMILL_FILES_DIR/export 

Note: the default port for this service is 8001

Clone and install dependencies:

cd ~/clima-app
git clone https://github.com/paulovieira/tilestream-clima
cd tilestream-clima
sudo npm install

Then launch TileStream:

export TILEMILL_FILES_DIR=$HOME/tilemill-files
./index.js start --tilePort=8001  --tiles=$TILEMILL_FILES_DIR/export 

Note: the default port for this service is 8001

Clone and install dependencies:

cd ~/clima-app
git clone https://github.com/paulovieira/tilemill-clima
cd tilemill-clima
sudo npm install

Then copy-paste and edit the custom clima-settings.json:

cp clima-settings.json.template clima-settings.json
emacs clima-settings.json

Then launch TileMill:

export TILEMILL_HOSTNAME=clima.dev (or clima-madeira.pt)
export TILEMILL_FILES_DIR=$HOME/tilemill-files

node index.js --server=true --files=$TILEMILL_FILES_DIR --coreUrl=$TILEMILL_HOSTNAME --tileUrl=$TILEMILL_HOSTNAME

Note: the default ports for this service are 20008 and 20009.

Clone and install dependencies:

cd ~/clima-app
git clone https://github.com/paulovieira/clima
cd clima
npm install

Define the environment:

export NODE_ENV=production (or dev or dev-no-auth)

Create the corresponding options file for the environment (to be used throughout the application via the config module):

cd ~/clima-app/clima
touch config/$NODE_ENV.js
emacs config/$NODE_ENV.js

Edit the necessary options in the configuration files. In principle only these should be changed for default.js:

• for config/default.js:
  • publicUri
  • publicPort
  • allowedLanguages
• for config/dev.js and config/production.js: copy-paste from the configuration files available in Dropbox.

Create the database and populate with the initial data:

cd ~/clima-app/clima
createdb <database_name>  (used in  `config/dev.js` or  `config/production.js`)
./database/initialize_db.sh <database_name>
node database/populate-initial-data/

cd ~/clima-app/clima
export TILEMILL_FILES_DIR=$HOME/tilemill-files
export NODE_ENV=dev (or dev-no-auth, or production)
node index.js

Make sure pm2 is installed:

pm2 list
sudo npm install pm2 -g

1. Start clima-tilelive (note that we have to pass the arguments after "--"):

cd ~/clima-app/clima-tilelive
export TILEMILL_FILES_DIR=$HOME/tilemill-files

pm2 start index.js --name "clima-tilelive" -- --port=8001 --source=$TILEMILL_FILES_DIR/export

1. OUTDATED Start TileStream (note that we have to pass the arguments after "--"):

cd ~/clima-app/tilestream-clima
export TILEMILL_FILES_DIR=$HOME/tilemill-files

pm2 start index.js --name "tilestream-clima" -- --tiles=$TILEMILL_FILES_DIR/export --tilePort=8001

2. Start TileMill:

cd ~/clima-app/tilemill-clima
export TILEMILL_HOSTNAME=clima-madeira.pt (or clima.dev)
export TILEMILL_FILES_DIR=$HOME/tilemill-files

pm2 start index.js --name "tilemill-clima" -- --server=true --files=$TILEMILL_FILES_DIR --coreUrl=$TILEMILL_HOSTNAME --tileUrl=$TILEMILL_HOSTNAME

3. Start the main app:

cd ~/clima-app/clima
export TILEMILL_FILES_DIR=$HOME/tilemill-files
export NODE_ENV=dev (or production)

pm2 start index.js --name "clima"

# stop the process
pm2 list
pm2 stop N 
(pm2 delete N)

# backup the database
cd ~/clima-app/backups && pg_dump --format=c --file=backup_YYMMDD.sqlc db_name

# delete the hardcoded texts (if necessary)
(psql dbname)
(select id, last_updated from texts order by last_updated desc limit 50;)
(delete from texts where id < 1000;)

# update and restart
git fetch
git merge origin/master
grunt build

(export NODE_ENV=production)
(export TILEMILL_FILES_DIR=~/tilemill-files/)
(./database/initialize_db.sh db_name)
(node ./database/populate-initial-data/)

# regular files in the static folder should have only read permissions...
(find lib/web/client/static -type f -exec chmod 744 {} \;)

# ...but directories need read+execute (so that nginx can access them)
(find lib/web/client/static -type d -exec chmod 755 {} \;)



sudo service nginx restart (to make sure the served static files are the updated version - is it really necessary?)


sudo service nginx restart (to make sure the served static files are the updated version - is it really necessary?)
pm2 start pm2-clima-XXX.json

The client apps use nunjucks as the templating engine templates. Nunjucks should be installed globally. The README.d file in lib/web/client has more details on how to use nunjucks.

Nginx client_max_body_size in the sites-available nginx configuration for clima-madeira.pt, make sure the "server" block has:

client_max_body_size 0;

(right below server_name, for instance)

1. make sure the plugins directory exists:

    mkdir /home/pvieira/.tilemill/node_modules

2. install the plugins manually by cloning the github repos

    cd /home/pvieira/.tilemill/node_modules

    git clone https://github.com/paulovieira/tilemill-easey-clima.git
    git clone https://github.com/paulovieira/tilemill-tablesort-clima.git
    git clone https://github.com/paulovieira/tilemill-lots-clima.git

todo: -update readme with options that the plugin should receive

-install node 4 (first downgrade npm) -o mesmo no vps da fcul (nao é necessario fazer downgrade do npm)

npm install bcrypt@0.8.7 --save npm install pg-promise@1.10 --save

cd ~/clima-app mkdir clima-acores mkdir clima-acores/config mkdir clima-acores/data/uploads/public/images -p mkdir clima-acores/tilemill-files

cp clima-madeira/config/dev.js clima-acores/config cp clima-madeira/config/production.js clima-acores/config ln -s ~/clima-app/clima/config/default.js clima-acores/config/default.js

cp clima-madeira/pm2-clima-madeira-dev.json clima-acores/pm2-clima-acores-dev.json cp clima-madeira/pm2-clima-madeira-production.json clima-acores/pm2-clima-acores-production.json

cp clima-madeira/data/README.md clima-acores/data cp -r clima-madeira/data/__icons clima-acores/data cp -r clima-madeira/data/__textures clima-acores/data cp -r clima-madeira/data/tilemill-default-project clima-acores/data

createdb prac cd ~/clima-app/clima && ./database/initialize_db.sh prac

export NODE_ENV=dev export NODE_CONFIG_DIR=~/clima-app/clima-acores/config node ~/clima-app/clima/database/populate-initial-data/

this is a hapi plugin living along side the directory of the core "clima" module; it is dinamically loaded (the directory of the plugin is set in the configuration)

cd ~/clima-app mkdir clima-acores-views cp -r clima-madeira-views/* clima-acores-views cd clima-acores-views && git init

export NODE_ENV=dev export NODE_CONFIG_DIR=~/clima-app/clima-acores/config node ~/clima-app/clima/index.js

If all is well, start in background mode with pm2

pm2 start pm2-file.json pm2 save

VERIFIFY: -ok upload file, make sure it is in the right directory -ok download file -ok upload shape, create map -ok remove dev.js/prod.js from the core config

--

ajustes finais:

manual update dependencies that cause errors after changing from node4 to node6 (ideally these updates would already be present in thge nmp-shrinkwrap file, but we got a bunch of errors)

npm install bcrypt@0.8.7 --prefix ~/clima-app/clima npm install sqlite3@3.1.8 --prefix ~/clima-app/clima/node_modules/hapi-tilelive/node_modules/mbtiles npm install mapnik@3.5.14 --prefix ~/clima-app/clima/node_modules/hapi-tilemill npm install sqlite3@3.1.8 --prefix ~/clima-app/clima/node_modules/hapi-tilemill npm install srs@1.2.0 --prefix ~/clima-app/clima/node_modules/hapi-tilemill/node_modules/millstone npm install zipfile@0.5.11 --prefix ~/clima-app/clima/node_modules/hapi-tilemill/node_modules/millstone