...
PGA Installation Prerequisites
NOTE: Plese refer documentation in Airavata Documentation: Prerequisites
Installing PGA in Ubuntu OS
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
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 755 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 install update command; sudo composer installupdate
- Restart the web server; sudo service apache2 restart
Troubleshooting for Ubantu OS:
...
Installing PGA on Cent OS
Please follow documentation in Airavata Documentation: PGA Installation on Cent OS 7
Installing PGA in MAC OS
Prerequisites
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+lfs/mcrypt.so
save changes.
provide permission to storage by
sudo chmod -R 777 app/storage
Now restart the apache server again and test PGA web-interface.
User Hosted PGA with SciGaP on Arch Linux
- Install the necessary dependencies:
$ sudo pacman -S polkit apache php php-mcrypt php-composer mariadb
- Enable the appropriate extensions:
$ sudo vim /etc/php/php.ini
Uncomment the following extensions: mcrypt.so, openssl.so, pdo_mysql.so, and soap.so
$ sudo vim /etc/httpd/conf/httpd.conf
Uncomment the following extension: modules/mod_rewrite.so
- Create necessary MySQL config:
$ sudo mysql_install_db --user=mysql --basedir=/usr --datadir=/var/lib/mysql
- Start and enable the Apache and MySQL daemons:
$ sudo systemctl start polkit
$ sudo systemctl start httpd
$ sudo systemctl enable httpd
$ sudo systemctl start mysqld
$ sudo systemctl enable mysqld
- Complete the MySQL installation:
$ sudo mysql_secure_installation
- Add a MySQL user:
$ mysql -u root -p
> CREATE USER 'forge'@'localhost';
> GRANT ALL PRIVILEGES ON * . * TO 'forge'@'localhost';
> CREATE DATABASE 'forge';
> FLUSH PRIVILEGES;
> exit
- Clone the PGA git repository:
$ git clone https://github.com/apache/airavata-php-gateway.git
- Symlink the PGA repository:
$ sudo ln -s $PWD/airavata-php-gateway /srv/http/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
- Configure the PGA storage permissions:
$ chmod -R 755 app/storage
- Install using Composer:
$ sudo composer install
- To be continued...
User Hosted PGA with SciGaP in MAC OS
Installations
- 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 Apachehow-to-install-php-mysql-apache-on-os-x-10-6/
- Installing Composer
Download and Configure PGA
- : 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 755 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 install update command; sudo composer installupdate
- Restart the web serverserver sudo apachectl restartrestart
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