Tutorial 06 - Running Airavata Server Locally Using Latest Release in GIT

Running Airavata Server in Local Machine Using Latest Release from GIT

Prerequisites

1. JAVA 8 or above is required

2. Requires RabbitMQ server running in our local machine.

3. Download the RabbitMQ from 

   https://www.rabbitmq.com/download.html

4. Install RabbitMQ as per

   https://www.rabbitmq.com/install-standalone-mac.html

5. Unzip the downloaded RabbitMQ tar file into a folder in your local machine. To unzip use;

   tar -xvf rabbitmq-server-mac-standalone-3.4.1.tar.gz

6. Start the RabbitMQ server in the bin folder using;

   ./sbin/rabbitmq-server start

   (For  detailed information on getting RabbitMQ started, stoped, etc please visit https://www.rabbitmq.com/download.html)

7. Requires maven (java based code building tool)

   http://maven.apache.org/download.cgi

   http://maven.apache.org/download.cgi#Installation

Start Airavata

1. Create a folder in your local machine to get  copy of Airavata (E.g.: mkdir LocalAiravata). Clone the source (If you have not taken a clone prior) code from github (git clone https://github.com/apache/airavata.git) to the above created folder.

2. After the above is completed build the source code by executing following maven command;

mvn clean install

Hint: Use mvn clean install -Dmaven.test.skip=true to avoid tests and is recommended for first timers.

1. Copy the tar file to your local folder created above in step 1

cp airavata/modules/distribution/server/target/apache-airavata-server-0.15-SNAPSHOT-bin.tar.gz ./

OR

cp airavata/modules/distribution/server/target/apache-airavata-server-0.15-SNAPSHOT-bin.zip ./

1. In the new location where the copied tar/zip file exists; unzip either the tar or zip file of Airavata server distribution using

unzip apache-airavata-server-0.14-SNAPSHOT-bin.zip

OR

tar -xvf apache-airavata-server-0.14-SNAPSHOT-bin.tar.gz

1. Navigate to bin folder which contains file airavata-server.properties;

  cd apache-airavata-server-0.14-SNAPSHOT/bin

Hint: For users who downloaded the already built version can directly navigate to this bin folder to start Airavata server.

1. Open the airavata-server.properties (vi airavata-server.properties) file and update relevant necesary proerpties to run Airavata locally.

2. In bin start the Airavata server; This may require JAVA_HOME to be defined. Some configurations such as in  bin/zoo.cfg and bin/airavata-server.properties  may have to be adjusted if some ports are already in use. Ports need to be open as well.

sh airavata-server.sh start (This will run the airavata server in the backgroud in demon mode)

If you are in the target folder use given to start Airavata server;

sh apache-airavata-server-0.14-SNAPSHOT/bin/airavata-server.sh start

1. To monitor the server starting up, view the airavata server log;

tail -f airavata-server.out

For subsequent Airavata copies; in the local Airavata folder where source code is cloned do a git clone https://github.com/apache/airavata.git for the latest trunk.