Setup your local Airavata Development Environment

Local environment setup for  Airavata server and Django portal

1. Install the following

• Docker installed with 'docker-compose' utility
• Maven
• Git
• python3
• npm 

1. Clone the airavata repository using 

• git clone https://github.com/apache/airavata

1. Checkout the develop branch

•  git checkout develop

1. Add a host entry to /etc/hosts file in local machine 

• 127.0.0.1 airavata.host

1. Navigate the project directory and go to the folder containing docker-compose.yml 

• cd airavata/modules/ide-integration/src/main/resources/

1. Start the services docker-compose up -d
2. Check the status of the services. Make sure all are in status “Up”   docker-compose ps
3. Start the airavata server

• Build the project using mvn clean install -DskipTests. You can also open the project in intellij and use the intellij maven plugins to build the clean build install the project 
• cd airavata/modules/ide-integration/src/main/java/org/apache/airavata/ide/integration
• Open APIServerStarter.java in intellij 
• Run the main class and make sure the server is successfully started

1. To start the django portal clone the project

• git clone https://github.com/apache/airavata-django-portal

1. Go to airavata-django-portal directory
2. Create a virtual environment 

• python3 -m venv venv

1. Activate the environment 

• source venv/bin/activate

1. Install all the libraries required by the portal 

• pip install -r requirements.txt

1. Copy django_airavata/settings_local.py.ide to django_airavata/settings_local.py. Make sure services url are pointing to localhost ports where your airavata services are running
2. Run django migrations 

• python3 manage.py migrate

1. Build the JavaScript sources

• ./build_js.sh

1. Load the default Wagtail CMS page

•  python3 manage.py load_default_gateway

1.  Start the server

•  python3 manage.py runserver 

1. Django server should be started on port 8000. 
2.  Make sure you are able to login to  http://localhost:8000/auth/login using uername : default-admin and password : 123456

Once the development environment is setup you can look into some of the open bugs. Merge requests are always welcomed.

1. https://issues.apache.org/jira/browse/AIRAVATA-2873
2. https://issues.apache.org/jira/browse/AIRAVATA-2809
3. https://issues.apache.org/jira/browse/AIRAVATA-2985
4. https://issues.apache.org/jira/browse/AIRAVATA-2887
5. https://issues.apache.org/jira/browse/AIRAVATA-3053