Tutorial 02 - Locally installed PGA with Hosted Airavata

PGA Installation Prerequisites 

NOTE: Plese refer documentation in Airavata Documentation: Prerequisites

Installing PGA in Ubuntu OS

Prerequisites

The following guide gives a sample installation starting from a fresh Ubunutu 12.04 installation.

1. Update the ubuntu package manager

   1. sudo apt-get update

   2. sudo apt-get upgrade

      
      

2. Install Apache 

   1. sudo apt-get install apache2

      
      

3. Install PHP 5.4

   1. sudo apt-get install python-software-properties

   2. sudo add-apt-repository ppa:ondrej/php5-oldstable

   3. sudo apt-get update

   4. sudo apt-cache policy php5

   5. sudo apt-get install php5

      
      

4. You can check the installed versions of apache and php using following commands

   1. apache2 -v 

   2. php -v

      
      

5. Install the necessary php extensions

   1. sudo apt-get install unzip

   2. sudo apt-get install curl

   3. sudo apt-get install openssl

   4. sudo apt-get install php5-mcrypt

   5. sudo apt-get install php-soap

      
      

6. Install Composer System Wide

   1. curl -sS https://getcomposer.org/installer | php

   2. sudo mv composer.phar /usr/local/bin/composer

      
      

7. Activate mod_rewrite

   1. sudo a2enmod rewrite

   2. sudo service apache2 restart

      
      

8. Open the default vhost config file:

   1. sudo nano /etc/apache2/sites-available/default.

   2. Now search for “AllowOverride None”  corresponding “DocumentRoot /var/www <Directory /var/www>” (which should be there TWO times) and change both to “AllowOverride All“. Search for these two lines.

   3. Exit and save with CTRL+X, Y, ENTER.
      
      

PGA Installation

1. Download PGA from github to the document root of you web server /var/www. 
2. Use git clone https://github.com/apache/airavata-php-gateway.git or download the zip from the github web page.
3. Go inside the PGA directory (e.g /var/www/airavata-php-gateway)
4. Make sure the storage folder is writable
   1. sudo chmod -R 777 app/storage
5. Go to [PGA_HOME]/app/config/pga_config.php and change the configuration to match your settings
   
6. Now issue composer update command
   1. sudo composer update
7. Restart the web server
   1. sudo service apache2 restart

Installing PGA on Cent OS

Please follow documentation in Airavata Documentation: PGA Installation on Cent OS 7

Installing PGA in MAC OS

Installing Prerequisites

1. To install MCrypt for PHP on MAC please follow the steps in http://coolestguidesontheplanet.com/install-mcrypt-php-mac-osx-10-9-mavericks-development-server/
2. Once above is completed follow the steps given in http://sangatpedas.com/20140219/installing-laravel-osx-mavericks/ for
   1. Configuring Apache
   2. Installing Composer 

Download and Configure PGA

1. cd /Library/WebServer/Documents

2. git clone https://github.com/apache/airavata-php-gateway.git

3. cd /Library/WebServer/Documents/airavata-php-gateway

4. Make sure the storage folder is writable

   1. sudo chmod -R 777 app/storage

5. (optional) Go to [PGA_HOME]/app/config/pga_config.php and change the configuration to match your settings
   
6. Enable Apache extensions (mod_rewrite module and PHP SOAP extension)

   1.  sudo vim /etc/apache2/httpd.conf

      1. uncomment #LoadModule rewrite_module libexec/apache2/mod_rewrite.so

      2. uncomment #LoadModule php5_module libexec/apache2/libphp5.so

7. Now issue composer update command

   1. sudo composer update

8. Restart the web server

   1. sudo apachectl restart

Troubleshooting PGA Installation Issues  

• After following the required steps only the home page is working and some images are not shown properly.

If you are facing this behavior first check whether you have enabled mod_rewrite module in apache webserver. And also check whether you have set AllowOverride All in the Vhost configuration file in apache web server. (e.g file location is /etc/apache2/sites-available/default and there should be two places where you want to change)

 <VirtualHost *:80>

• I get the Error message Permission Denied to app/storage directory

Execute the following command and grant all permissions sudo chmod -R 777 app/storage

• In Ubuntu environment when executing sudo composer update it fails with message Mcrypt PHP extension required.  To fix this install PHP mcrypt extension by following the below steps 

sudo apt-get install php5-mcrypt

use locate mcrypt.so ,to get its locaton

locate mcrypt.ini and open the mcrypt.ini file
sudo pico /etc/php5/mods-available/mcrypt.ini
change the at line a extension=<location of e mcrypt.so file> eg:/usr/lib/php5/20121212/mcrypt.so
save changes.

execute the command:  sudo php5enmod mcrypt

Now restart the apache server again and test PGA web-interface.

• When tried to login or create a new user account an Error is thrown which is similar to PHP Fatal error:  SOAP-ERROR: Parsing WSDL: Couldn't load from...

If you face this kind of an error first check whether you have enabled PHP SOAP and OpenSSL extensions. If even after enabling them the issue is still occurring try updating the PHP OpenSSL extension. (Using command like yum update openssl)