Global Change Information System

This is the HTML front end and API for the Global Change Information System (GCIS).

This portion of the GCIS is called Tuba.

Prerequisites :

- PostgreSQL
- Perl 5.10 or later
- uuid-dev package
- A recent raptor (<http://librdf.org/raptor>)

On Ubuntu 14.04, they can be installed with:

- sudo apt-get install postgresql-contrib-9.3 libpg-hstore-perl \
  postgresql libuuid1 uuid-dev make openssl libssl-dev libpq-dev \
  graphviz libxml2 raptor2-utils curl perlbrew

Instantiate Perlbrew environment:

perlbrew init
perlbrew install perl-5.20.0
perlbrew install-cpanm
perlbrew install-patchperl
perlbrew switch perl-5.20.0

Install of Perl prerequisites :

cd gcis
cpanm --installdeps .

Customize install_base (optional) :

echo $(dirname $(dirname $(which perl)))
vi Build.PL
# use the ouput of the command above as the value for --install_base below
# or create a file $HOME/.modulebuildrc, that contains :
#       install     --install_base /your/directory/here

Software installation :

perl Build.PL --install_base=(see above)
./Build
./Build test
./Build install

Database configuration :

You may need to add these directives to postgresql.conf, under "CUSTOMIZED OPTIONS" for some versions of postgreSQL :

custom_variable_classes = 'audit'   # list of custom variable class names
audit.username = 'unknown'
audit.note = ''

Database installation :

sudo su - postgres -c "createuser -P -s -e $(whoami)"
./Build dbinstall

Configuration :

cp eg/Tuba.conf.sample Tuba.conf
sudo mkdir /var/local/projects
sudo chown $(whoami):$(whoami) /var/local/projects

Starting :

hypnotoad bin/tuba

Starting in dev mode :

morbo -l http://0.0.0.0:3000 bin/tuba