...
PGA Installation Prerequisites
- Requires a Unix or Unix like operating system
- 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
- Install Composer
- MYSQL database installation (Required if the user is hosting Airavata on his own. To communicate with SciGaP this step is not relevant)
- MCrypt PHP extension
- Enable OpenSSL PHP extension
- Follow instructions given in links to install the prerequisites based on the OS ;
- On Ubunutu: http://www.dev-metal.com/install-laravel-4-ubuntu-12-04-lts/
- On Centos: https://www.digitalocean.com/community/tutorials/how-to-install-laravel-4-on-a-centos-6-vps
- On MAC OS: http://sangatpedas.com/20140219/installing-laravel-osx-mavericks/
- Important: Do not need to install Laravel. You can skip the steps given on the links
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.
- Update the ubuntu package manager
sudo apt-get update
sudo apt-get upgrade
Install Apache
sudo apt-get install apache2
Install PHP 5.4
sudo apt-get install python-software-properties
sudo add-apt-repository ppa:ondrej/php5-oldstable
sudo apt-get update
sudo apt-cache policy php5
sudo apt-get install php5
You can check the installed versions of apache and php using following commands
apache2 -v
php -v
Install the necessary php extensions
sudo apt-get install unzip
sudo apt-get install curl
sudo apt-get install openssl
sudo apt-get install php5-mcrypt
sudo apt-get install php-soap
Install Composer System Wide
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
Activate mod_rewrite
sudo a2enmod rewrite
sudo service apache2 restart
Open the default vhost config file:
sudo nano /etc/apache2/sites-available/default
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.
- Exit and save with CTRL+X, Y, ENTER.
PGA Installation
...
- Download PGA from github to the document root of you web server /var/www.
- Use git clone https://github.com/apache/airavata-php-gateway.git or download the zip from the github web page.
- Go inside the PGA directory (e.g /var/www/airavata-php-gateway)
- Make sure the storage folder is writable; sudo chmod -R 777 app/storage
- Go to [PGA_HOME]/app/config/pga_config.php and change the configuration to match your settings. More instruction on pga_config.php follow step 6 in Airavata Documentation: pga_config.php configurations
- Now issue composer update command; sudo composer update
- Restart the web server; sudo service apache2 restart
Installing PGA on
...
Cent OS
Please follow documentation in Airavata Documentation: PGA Installation on Cent OS 7
...
- Install the necessary dependencies:
$ sudo pacman -S polkit apache php php-apache php-mcrypt php-composer
- Enable the appropriate extensions:
$ sudo vim /etc/php/php.ini
Uncomment the following extensions: mcrypt.so
, openssl.so
, and soap.so
$ sudo vim /etc/httpd/conf/httpd.conf
Uncomment the following extension: rewrite_module modules/mod_rewrite.so
Replace the mpm_event_module modules/mod_mpm_event.so
with mpm_prefork_module modules/mod_mpm_prefork.so
Add the following line: LoadModule php5_module modules/libphp5.so
Add the following line: Include conf/extra/php5_module.conf
- Start and enable the Apache and MySQL daemons:
$ sudo systemctl start polkit
$ sudo systemctl start httpd
$ sudo systemctl enable httpd
Note: you may need to reboot to start polkit
- Clone the PGA git repository:
$ cd /srv/http
$ sudo git clone https://github.com/apache/airavata-php-gateway.git
$ sudo chown -R $USER airavata-php-gateway
- Configure the PGA:
$ cd airavata-php-gateway
$ cp app/config/pga_config.php.example app/config/pga_config.php
$ vim app/config/pga_config.php
- Note: make sure to make the directory pointed to by
'experiment-data-root'
in pga_config.php
and chmod 777
it. By default, this is /srv/http/experimentData
- Configure the PGA storage permissions:
$ chmod -R 777 app/storage
- Update using Composer:
$ sudo composer update
Installing PGA in MAC OS
...
Prerequisites
- 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/
- Once above is completed follow the steps given in httpin folowing links;
- Configuring Apache: https://
sangatpedas- coolestguidesontheplanet.com/
20140219/installing-laravel-osx-mavericks/ for- Configuring Apache
- Installing Composer
Download and Configure PGA
- how-to-install-php-mysql-apache-on-os-x-10-6/
- Installing Composer: https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx
PGA Installation
Navigate to directory; cd
cd /Library/WebServer/Documents
git
clone https://github.com/apache/airavata-php-gateway.git
- cd
After cloning is completed navigate to gateway directory: cd /Library/WebServer/Documents/airavata-php-gateway
- Make sure the storage folder is writablewritable sudo chmod -R 777 app/storage
- (optional) Go to [PGA_HOME]/app/config/pga_config.php and change the configuration to match your settings. More instruction on pga_config.php follow step 6 in Airavata Documentation: pga_config.php configurations
- Enable Apache extensions (mod_rewrite module and PHP SOAP extension)
sudo
vim
/etc/apache2/httpd.conf
uncomment
#LoadModule
rewrite_module
libexec/apache2/mod_rewrite.so
uncomment
#LoadModule
php5_module
libexec/apache2/libphp5.so
- Now issue composer update command; sudo composer update
- Restart the web serverserver 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)
<VirtualHost *:80>
DocumentRoot /var/www/html/portal/public
<Directory "/var/www/html/portal/public">
AllowOverride all
</Directory>
ErrorLog logs/pga_error_log
CustomLog logs/pga--access_log common
</VirtualHost>
- 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
Link the Local PGA with Hosted Airavata
- Once the PGA is installed you will have to link with hosted Airavata.
- Contact Airavat hosting team (probably apache Airavata team) and obtain information required in section 'Airavata Client Configurations' of pga_config.php file in directory [PGA_HOME]/app/config
Troubleshooting PGA Installation Issues
Having an issue with installation? Maybe someone earlier faced and the answer could be in FAQs. Please try: Airavata Documentation: FAQ
Comments, clarifications most welcomed. Subscribe and contact us through http://airavata.apache.org/community/mailing-lists.html
...