Repository: airavata-docs Updated Branches: refs/heads/master cf71d75a4 -> e3d77b64e
Added ansible instructions. Removed PGA 0.16 instructions Project: http://git-wip-us.apache.org/repos/asf/airavata-docs/repo Commit: http://git-wip-us.apache.org/repos/asf/airavata-docs/commit/e3d77b64 Tree: http://git-wip-us.apache.org/repos/asf/airavata-docs/tree/e3d77b64 Diff: http://git-wip-us.apache.org/repos/asf/airavata-docs/diff/e3d77b64 Branch: refs/heads/master Commit: e3d77b64e33aa4f3d5266dca7db6d730491af3ea Parents: cf71d75 Author: Eroma Abeysinghe <[email protected]> Authored: Mon Jun 12 22:42:20 2017 -0400 Committer: Eroma Abeysinghe <[email protected]> Committed: Mon Jun 12 22:42:20 2017 -0400 ---------------------------------------------------------------------- PGA-Installation.md | 207 ++--------------------------------------------- 1 file changed, 8 insertions(+), 199 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/airavata-docs/blob/e3d77b64/PGA-Installation.md ---------------------------------------------------------------------- diff --git a/PGA-Installation.md b/PGA-Installation.md index 25e602c..d84d8e6 100644 --- a/PGA-Installation.md +++ b/PGA-Installation.md @@ -1,9 +1,11 @@ ## PGA Installation -<b>NOTE</b><br> -- These step by step instructions are for PGA with airavata 0.16 (previous) release.<br> -- For the latest PGA installation, please use ansible playbooks.<br> -- Here is link [1] to the playbook file on the âmasterâ branch. This playbook consist of two roles, env_setup [2] and pga [3] and you can look at those roles for further details. + +### PGA 0.17 Installation Steps +- Uses Ansible playbooks.<br> +- Link [1] to the playbook file on the âmasterâ branch. +- This playbook consist of two roles, env_setup [2] and pga [3] and you can look at those roles for further details. - But first read [4] +- Only for Cent OS 7 [1] <a href="https://github.com/apache/airavata/blob/master/dev-tools/ansible/pga.yml"; target="_blank"> PGA Ansible Playbooks</a> <br> [2] <a href="https://github.com/apache/airavata/tree/master/dev-tools/ansible/roles/env_setup/tasks"; target="_blank">Env_setup</a> <br> @@ -11,198 +13,5 @@ [4] <a href="https://github.com/apache/airavata/blob/master/dev-tools/ansible/README.md"; target="_blank">READ ME</a> <br> -<b>Pick your OS...</b></br/> -[<button type="button" style="color:#f2f2f2;text-align:center;font-weight:lighter;background-color:#2481b9;width:160px;border: 2px solid #2481b9;border-radius:4px">Cent OS</button>](#headPGACENTOS) -[<button type="button" style="color:#f2f2f2;text-align:center;font-weight:lighter;background-color:#2481b9;width:160px;border: 2px solid #2481b9;border-radius:4px">MAC OS</button>](#headPGAMAC) -[<button type="button" style="color:#f2f2f2;text-align:center;font-weight:lighter;background-color:#2481b9;width:160px;border: 2px solid #2481b9;border-radius:4px">Ubuntu OS</button>](#headPGAUB) - -### <a name="head1234">General Prerequisites</a> -1. A Unix or Unix like operating system. -2. A web server (e.g apache web server) with PHP 5.4 or higher. Make sure to have enabled mod_rewrite module in httpd.conf file and enable PHP SOAP extension. -3. Composer -4. MYSQL database (Required if the user is hosting Airavata on his own. To communicate with hosted Airavata 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. - - <a href="http://www.dev-metal.com/install-laravel-4-ubuntu-12-04-lts/"; target="_blank"> Ubunutu prerequisites</a> - - <a href="https://www.digitalocean.com/community/tutorials/how-to-install-laravel-4-on-a-centos-6-vps"; target="_blank"> Cent OS prerequisites</a> - - <a href="http://sangatpedas.com/20140219/installing-laravel-osx-mavericks/"; target="_blank"> MAC prerequisites</a> -8. Important: Do not need to install Laravel. You can skip the steps given on the links -9. WSO2 IS server - -### <a name="headPGACENTOS">PGA Installation on CentOS 7</a> -#### Pre-Installations -1. Install apache -<pre><code>Yum install httpd</code></pre> -2. module_rewrite is auto enabled in apache version in centos7. Its in /etc/httpd/conf.modules.d/00-base.conf file and the line is LoadModule rewrite_module modules/mod_rewrite.so -3. Enable php using <pre><code>yum install php-soap</code></pre> Could be be it is already enabled in CentOS7 -4. Install php using  <pre><code>yum install php</code></pre> -5. Configure Selinux to allow outbound connection from web server; -<pre><code>setsebool -P httpd_can_network_connect 1</code></pre> -5. install composer -<pre><code>yum install composer</code></pre> -6. Install php-mcrypt <pre><code>yum install php-mcrypt</code></pre> - -#### PGA Installation -1. As the document root (var/www/html) take the git clone https://github.com/apache/airavata-php-gateway.git -2. Change the cloned folder name to your desired folder name(e.g.: airavata-php-gateway). This will carry sub folders for the gateway -<pre><code>cp - R airavata-php-gateway /* .</code></pre> -3. In the gateway folder do a <pre><code>composer update</code></pre> -4. Create a directory in var/www/ for user data (E.g.:gateway-user-data). -5. Make this user data directory writeable by Apache httpd by making the following -SELinux update as root: - - chcon -R -t httpd_sys_rw_content_t /path/to/gateway-user-data - -6. Copy ./app/config/pga_config.php.template to ./app/config/pga_config.php -7. In pga_config.php change airavata server, change; - - Airavata Client Configurations - - 'airavata-server' => 'localhostâ, - - 'gateway-id' => 'php_reference_gateway', - - 'experiment-data-absolute-path' => '/var/www/gateway-user-data',(Here user has to create the experimentData folder in var/www) - - 'gateway-data-store-resource-id' => '' (This is the ID of the gateway preferred storage resource) - - Portal Related Configurations - - 'super-admin-portal' => false, (User has one gateway and need to use it to configure the compute resources, storage resources, etc...) - - 'admin-emails' => ['[email protected]'], - - 'portal-email-username' => '[email protected]', - - 'portal-email-password' => '&airavaxxxxxx', - - WSO2 Identity Server Related Configurations - - 'tenant-domain' => 'prod.airavata', (Provided by the Gateway Admin to WSO2 IS at tenant creation) - - 'admin-username' => 'Gateway-Admin', (Provided by the Gateway Admin to WSO2 IS at tenant creation) - - 'admin-password' => 'Gateway-Admin-Password', (Provided by the Gateway Admin to WSO2 IS at tenant creation) - - 'oauth-client-key' => 'G1khg0I0Xf444rereggrteret', (Generated by WSO2 IS at tenant creation) - - 'oauth-client-secret' => 'G1khg0I0Xf444rere', (Generated by WSO2 IS at tenant creation) - - 'verify-peer' => true, (Set this to false if trusted server certificates are not used. Refer <a href='http://wso2.com/library/knowledge-base/2011/08/adding-ca-certificate-authority-signed-certificate-wso2-products/' target ='_blank'>Adding CA Signed Certificate</a> on adding trusted certificates.) -8. Give writing permission chmod -R g+rwx app/storage/ -9. Make sure SElinux comparability of airavata_php_gateway folder. For that give -<pre><code>chcon -Rv --type=httpd_sys_content_t airavata-php-gateway/</code></pre> -This is to make sure the gateway folder is readable by http -10. ls - lZ shows the SELinux context. After the above chcon command do the same for storage folder as well -<pre><code>su -c "chcon -R -h -t httpd_sys_script_rw_t [fullpath]/app/storageâ</code></pre> -This is to make sure the storage folder is writable. -11. Configure firewall to allow http and https - - Check existing configurations using <pre><code>firewall-cmd --zone=public --list-services</code></pre> - - To open access for http <pre><code>firewall-cmd --zone=public --permanent --add-service=http</code></pre> - - To open access for https <pre><code>firewall-cmd --zone=public --permanent --add-service=https</code></pre> - - To get above rules applied <pre><code>firewall-cmd âreload - refresh</code></pre> -12. Locate httpd.conf file in location /etc/httpd/conf/ -<br> Make sure below 'Allow Override' has 'All' option. -<pre><code> - # - # AllowOverride controls what directives may be placed in .htaccess files. - # It can be "All", "None", or any combination of the keywords: - # Options FileInfo AuthConfig Limit - # - AllowOverride All -</code></pre> - - - -### <a name="headPGAMAC">PGA Installation on MAC Yosemite OS</a> -#### Pre-Installation -1. Follow instructions in <a href="http://coolestguidesontheplanet.com/install-mcrypt-php-mac-osx-10-10-yosemite-development-server/."; target="_blank">MCrypt Installation</a> for PHP on MAC -2. First check whether your MAC has Apache installed. To check availability; -<pre><code>apache ctrl start</code></pre> -3. To stop running Apache use; -<pre><code>apache ctl stop</code></pre> -4. Once above is completed follow the <a href="https://web.archive.org/web/20150507101703/http://sangatpedas.com/20140219/installing-laravel-osx-mavericks"; target="_blank"> Installation Steps</a> given for - - Configuring Apache - - Installing Composer (Use sudo commands as and when required for installation) -5. To install Composer use -<pre><code>curl -sS https://getcomposer.org/installer | php</code></pre> -6. Then move Composer using -<pre><code>mv composer.phar /usr/local/bin/composer</code></pre> - -#### PGA Installation -1. Go to cd /Library/WebServer/Documents -2. Take a copy from GIT using -<pre><code>git clone https://github.com/apache/airavata-php-gateway.git</code></pre> -3. Navigate to PGA folder -<pre><code>cd /Library/WebServer/Documents/airavata-php-gateway</code></pre> -4. Make sure the storage folder is writable by all users -<pre><code>sudo chmod -R 777 app/storage</code></pre> -5. Move out of app folder and give; -<pre><code>sudo composer update</code></pre> -This will take few minutes -6. You might get an error like this -<pre><code> -Mcrypt PHP extension required. -Script php artisan clear-compiled handling the post-update-cmd event returned with an error -[RuntimeException] -Error Output: -</code></pre> -7. Install mcrypt installation -<a href="http://coolestguidesontheplanet.com/install-mcrypt-php-mac-osx-10-10-yosemite-development-server/"; target="_blank">MCrypt Installation</a> -8. (Optional) Go to [PGA_HOME]/app/config/pga_config.php and change the configuration to match your settings -9. Enable Apache extensions (mod_rewrite module and PHP SOAP extension) -<pre><code>sudo vim /etc/apache2/httpd.conf</code></pre> - uncomment #LoadModule rewrite_module libexec/apache2/mod_rewrite.so - uncomment #LoadModule php5_module libexec/apache2/libphp5.so -10. Now issue composer update command -<pre><code>sudo composer update</code></pre> -11. Restart the web server -<pre><code>sudo apachectl restart</code></pre> - -#### Link Airavata and PGA -1. Once the PGA and Airavata are downloaded and locally running; in PGA app/config folder locate the file called pga_config.php.template -2. Copy the located file and name it as pga_config.php -3. In the newly copied file find two configurations for - - Airavata host - - Port -4. Change above configurations - - Airavata host = localhost - - Port = 9930 -5. You are all set to run your own PGA! -6. For steps to register resources, applications, etc⦠use <Link to admin guide> -7. For steps to create projects, experiments and monitor them use <Link to end user guide> -IMPORTANT: In places where the hosted PGA link is used please replace by your locally running PGA URL. - - -### <a name="headPGAUB">PGA Installation on Ubuntu OS</a> -#### Pre-Installation -1. To install dependencies use commands in <a href="http://www.dev-metal.com/install-laravel-4-ubuntu-12-04-lts/"; target="_blank">Ubuntu Installation</a> -<br>In the command avoid installing mysql and mariaDB. -2. Enable the appropriate extensions: navigate to php.ini - <pre><code>sudo vi /etc/php.ini</code></pre> - - Uncomment the following extensions: mcrypt.so, openssl.so, and soap.so. If they do not exists add them as extensions. - <pre><code>extension=mcrypt.so</code></pre> - <pre><code>extension=openssl.so</code></pre> - <pre><code>extension=soap.so</code></pre> -3. Locate httpd.conf file -<pre><code>sudo vi /etc/httpd/conf/httpd.conf</code></pre> - - Find 'AllowOverride None' and change to 'AllowOverride All' (Two places to change) - -#### PGA Installation -1. The following guide give a sample installation starting from a fresh Ubunutu 12.04 installation. Similar instructions should be used in other operating systems. -2. Update the ubuntu package manager -<pre><code>sudo apt-get update</pre></code> -<pre><code>sudo apt-get upgrade </pre></code> -3. Install Apache -</pre></code>sudo apt-get install apache2</pre></code> -4. Install PHP 5.4 -<pre><code>sudo apt-get install python-software-properties</pre></code> -<pre><code>sudo add-apt-repository ppa:ondrej/php5-oldstable</pre></code> -<pre><code>sudo apt-get update</pre></code> -<pre><code>sudo apt-cache policy php5</pre></code> -<pre><code>sudo apt-get install php5</pre></code> -5. You can check the installed versions of apache and php using <pre><code>apache2 -v</pre></code> and <pre><code>php -v commands</pre></code> -6. Install the necessary php extensions -<pre><code>sudo apt-get install unzip</pre></code> -<pre><code>sudo apt-get install curl</pre></code> -<pre><code>sudo apt-get install openssl</pre></code> -<pre><code>sudo apt-get install php5-mcrypt</pre></code> -<pre><code>sudo apt-get install php-soap</pre></code> -7. Install Composer System Wide -<pre><code>curl -sS https://getcomposer.org/installer | php</pre></code> -<pre><code>sudo mv composer.phar /usr/local/bin/composer</pre></code> -8. Activate mod_rewrite -<pre><code>sudo a2enmod rewrite</pre></code> -<pre><code>sudo service apache2 restart</pre></code> -9. Open the default vhost config file: - <pre><code>sudo nano /etc/apache2/sites-available/default. </pre></code> -10. Now search for âAllowOverride Noneâ corresponding âDocumentRoot /var/www <Directory /var/www>â -<br>(which should be there TWO times) and change both to âAllowOverride Allâ. Search for these two lines.</br> -<br> -11. Exit and save with CTRL+X, Y, ENTER. - -Go to <a href="Airavata-Installation" target="_blank">Airavata Installation on CentOS 7</a> \ No newline at end of file +<b>Previous PGA version:</b> <a href="http://airavata.readthedocs.io/en/0.16/PGA-Installation/"; target="_blank">PGA 0.16 Installation Steps</a></br> +NOTE: For gateway developers who prefers to install latest version using step by step instruction, can use the 0.16 instructions as a guide. \ No newline at end of file
