1.1. Installing for Linux (Production)

Important Note

Commands in this section are root commands and should be preceded with sudo if current user is not root

Overview

A basic HADatAc installation involves the following five steps:

• acquiring required software for installing/running the HADatAc Console

• downloading HADatAc code from this GitHub repository

• deploying HADatAc database dependencies

• deploying HADatAc

• proxy setting

Step 1 : Acquiring Required Software

Before anything, however, we need to verify that the host machine has a git client to retrieve the code, and an sbt utility to run the console. In the command line of your machine, verify that you have a git client installed in your machine:

git

If you do not have git, you need to install one: http://git-scm.com/downloads. Still from the command line, verify that you have sbt applications installed in your machine:

sbt

If not, you need to install one: http://www.scala-sbt.org/.

You will also need:

1. Java JDK 8: http://java.com/en/download/ (or use your distribution's java) (MAKE SURE THE MACHINE IS NOT RUNNING JAVA 9)
2. wget

Step 2: Cloning HADatAc Code

The commands in this section are to be issued by root user

Create both /data and /data/git folders:

  mkdir -p /data/git

Go to git directory :

  cd /data/git

Once your are in your home directory (~ is a shortcut for your home directory), clone HADatAc code by typing the following command:

  git clone https://github.com/paulopinheiro1234/hadatac.git

After cloning HADatAC, you should have a hadatac folder under your home directory. Go into the hadatac directory under your home directory by typing the following:

 cd /data/git/hadatac

Step 3: Deploying HADatAc Database-dependencies

Once you are in /data/git/hadatac (you can check if you are in the right folder by typing pwd), type the following:

  ./production_install_hadatac.sh

Note: use chmod a+x *.sh if the script above cannot be executed

This process will take a while so let it run. It will download and install a SOLR instance, a Blazegraph instance, and initialize the instance.

During the process of executing the script, you will be asked for an installation folder. Use /data/hadatac as installation folder

Open your browser to verify if the SOLR installation was successful

• Open another tab with the url: http://localhost:8983/solr/

Open your browser to verify if the Blazegraph installation was successful

• Open another tab with the url: http://localhost:8080/bigdata/

Once inside Blazegraph's web page (link above), select the 'Namespaces' tab, and verify if the required namespaces store, store_sandbox, and store_users have been created.

Step 4: Deploying HADatAc

Go back to hadatac folder:

 cd /data/git/hadatac

Now type the following:

 ./deploy_hadatac.sh

Browser open hadatac url: http://localhost:9000/hadatac/

Wait for page to open, it will take a while.

Step 5. Setting up proxy configuration

In the instruction below we use apache2 for proxying hadatac from localhost:9000 into (domain)/hadatac

Assuming that apache2 is installed, change to apache2 folder in /etc

 cd etc/apache2

in the /sites-available folder, edit the conf file. Look for

<VirtualHost *:80>

Right before the closing tag </VirtualHost>, add the following content:

 ProxyRequests Off

 <Proxy *>
     Order deny,allow
     Allow from all
 </Proxy>

 ProxyPass /hadatac http://127.0.0.1:9000/hadatac
 ProxyPassReverse /hadatac http://127.0.0.1:9000/hadatac

Save the file.

Go to http://(domain)/hadatac, where (domain) is the name of your domain