Page History

...

1. Requires a Unix or Unix like operating system
2. Requires a web server (e.g apache web server) with PHP 5.4 or higher. Make sure have enabled mod_rewrite module in httpd.conf file and enable PHP SOAP extension
3. Install Composer
4. MYSQL database installation (Required if the user is hosting Airavata on his own. To communicate with SciGaP this step is not relevant)
5. MCrypt PHP extension
6. Enable OpenSSL PHP extension
7. Follow instructions given in links to install the prerequisites based on the OS ;
   1. On Ubunutu: http://www.dev-metal.com/install-laravel-4-ubuntu-12-04-lts/
   2. On Centos: https://www.digitalocean.com/community/tutorials/how-to-install-laravel-4-on-a-centos-6-vps
   3. On MAC OS: http://sangatpedas.com/20140219/installing-laravel-osx-mavericks/
8. Important: Do not need to install Laravel. You can skip the steps given on the links

Installing PGA in Ubuntu OS

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 755 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

 Troubleshooting for Ubantu OS:

...

...

...

execute the command:  sudo php5enmod mcrypt

provide permission to storage by
sudo chmod -R 777 app/storage
Now restart the apache server again and test PGA web-interface.

Installing PGA on Arch Linux

...

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 755777 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 

If you are facing issues and not able to open the user interface even after doing the necessary steps, please troubleshot with below steps
below command may not work which is specified in the installation page for the Ubuntu :

• 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)
    

• 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
• When executing sudo composer install it asks for Mcrypt PHP extension required, then install mcrypt 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 fil> 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.