Ubuntu specific quick installation guide (needs to be merged into gawati docs)

[kohsah]

Gawati Setup

Pre-requestites

• Install OpenJDK8

  $ sudo apt-get install openjdk-8-jre
  $ sudo apt-get install openjdk-8-jdk

• Install NVM for parallel NodeJS versions

  $ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.8/install.sh | bash

• Install NodeJS LTS 8.9.x

  $ nvm install --lts

• Set the node env

  $ nvm use 8.9.4

• Download eXist-db
• Install eXistdb

  $ java -jar eXist-db-setup-<version>.jar

• Download Ant
• Install Ant. See Ant-How-To

  $ tar -xf apache-ant-xxx.tar.xz -C <directory>

• Set ENV variables in ~/.bashrc

  export ANT_HOME=<path-to-ant>/ant
  export PATH=${ANT_HOME}/bin:${PATH}

• Install Apache

  $ sudo apt-get install apache2

• Enable necessary modules

  $ sudo a2enmod alias
  $ sudo a2enmod rewrite
  $ sudo a2enmod proxy
  $ sudo a2enmod proxy_http
  $ service apache2 restart

  Create /var/www/html/.htaccess with the following line: 'RewriteEngine on'

Datasets

• Download & Set up the data sets
  Assuming files are extracted to /home/data/akn_xxx
  1. PDF data set

     $ unzip akn_pdf_sample-1.2.zip -d /home/data/akn_pdf

     Add the following apache config for binary data in /etc/apache2/apache2.conf

      Alias /akn "/home/data/akn_pdf"
     <Directory "/home/data/akn_pdf">
         Require all granted
         Options Includes FollowSymLinks
         AllowOverride All
         Order allow,deny
         Allow from all
     </Directory>

  2. XML data set

     $ unzip akn_xml_sample-1.2.zip -d /home/data/akn_pdf

     Change password for user 'gwdata' via user manager in eXist-db dashboard. Upload the data (Run from eXistdb folder):

     ./bin/client.sh -u gwdata -P <gwdata_password> -d -m /db/apps/gw-data/akn -p /home/data/akn_xml/akn

  Verify that your services are accessible: [http://localhost/gw/service/recent/expressions/summary]

Portal

• Gawati Portal UI
  No change in instructions.
• Gawati Portal Server
  No change in instructions.
  Start the portal server from it's directory

  $ node ./bin/www

  Restart apache server & verify it's running

  $ sudo service apache2 restart
  $ sudo service apache2 status

  Verify that [http://localhost/gw/service/short-filter-cache/] returns some JSON data