You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airavata.apache.org by er...@apache.org on 2016/05/13 20:35:49 UTC
airavata-docs git commit: Modifications to gateway configuration steps
Repository: airavata-docs
Updated Branches:
refs/heads/master df4e840c3 -> 223e5dacf
Modifications to gateway configuration steps
Project: http://git-wip-us.apache.org/repos/asf/airavata-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/airavata-docs/commit/223e5dac
Tree: http://git-wip-us.apache.org/repos/asf/airavata-docs/tree/223e5dac
Diff: http://git-wip-us.apache.org/repos/asf/airavata-docs/diff/223e5dac
Branch: refs/heads/master
Commit: 223e5dacf67cfc72d8fb17c44420f9ba5bcbca87
Parents: df4e840
Author: Eroma Abeysinghe <er...@gmail.com>
Authored: Fri May 13 16:35:45 2016 -0400
Committer: Eroma Abeysinghe <er...@gmail.com>
Committed: Fri May 13 16:35:45 2016 -0400
----------------------------------------------------------------------
Gateway-Configurations.md | 77 ++++++++++++++++++++----------------------
1 file changed, 36 insertions(+), 41 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/airavata-docs/blob/223e5dac/Gateway-Configurations.md
----------------------------------------------------------------------
diff --git a/Gateway-Configurations.md b/Gateway-Configurations.md
index c187cdd..698033a 100644
--- a/Gateway-Configurations.md
+++ b/Gateway-Configurations.md
@@ -1,8 +1,8 @@
## PGA Configurations
### You Need to Have
-1. Airavata & PGA installed and running
-2. Tenant created in WSO2 IS hosted by you or SGG
-3. Administrator privileges to the gateway with username and password
+1. Airavata & PGA installed and running.
+2. Tenant created in WSO2 IS hosted by you or Airavata team.
+3. Administrator privileges to the gateway.
<br>
<br>
### Apache Airavata Component Configuration
@@ -17,49 +17,46 @@
- Application Deployment<br>
- <a href= "#Credentials">Credential Store</a>
- Generate Credential Store Token + SSH Key.
- - Add these to authorized key files and into preferences.
+ - Add these to authorized key files and into resource preferences.
<br>
<br>
###<h3 id="CompResource">Compute Resources</h3>
-1. Navigate to Admin Dashboard --> Compute Resources --> Register
+1. Navigate to Admin Dashboard ⇒ Compute Resources ⇒ Register
2. Add Host Name, Description and create the resource.
-3. Then add data storage information in
+3. Then keep adding information on rest of the appeared tabs.
+ - Queues (Queue name is uniqie and cannot be updated. Can delete and create new if required)
+ - File Systems (This is only for information capturing for future use. Currently this information is not used)
+ - Job Submission Interfaces
- Data Movement Interfaces
-4. And Save.
-5. Similarly you can add multiple storage resources in to your gateway by selecting 'Register' from the left-hand-side menu.
-6. To view the added resources navigate to Admin Dashboard --> Storage Resources --> Browse
-7. All the resources will be listed. Gateway admin can view, edit, delete them.
-NOTE: Currently enabling and disabling storage resources is not an active feature.
+5. Similarly you can add multiple compute resources in to your gateway by selecting 'Register' from the left-hand-side menu.
+6. To view the added compute resources navigate to Admin Dashboard ⇒ Compute Resource ⇒ Browse
+7. All the resources will be listed. Gateway admin can view, edit, delete and enable and disable them.
<br>
<br>
###<h3 id="StoreResource">Storage Resources</h3>
-1. Navigate to Admin Dashboard --> Storage Resources --> Register
+1. Navigate to Admin Dashboard ⇒ Storage Resources ⇒ Register
2. Add Storage Name, Description and create the resource.
-3. Then keep adding information on rest of the tabs appeared.
- - Queues
- - File Systems (Not required at the moment)
- - Job Submission Interfaces
+3. Then add data storage information in
- Data Movement Interfaces
-4. And Save.
-5. Similarly you can add multiple compute resources in to your gateway by selecting 'Register' from the left-hand-side menu.
-6. To view the added compute resources navigate to Admin Dashboard --> Compute Resource --> Browse
-7. All the resources will be listed. Gateway admin can view, edit, delete and enable and disable them.
+5. Similarly you can add multiple storage resources in to your gateway by selecting 'Register' from the left-hand-side menu.
+6. To view the added resources navigate to Admin Dashboard ⇒ Storage Resources ⇒ Browse
+7. All the resources will be listed. Gateway admin can view, edit, delete them.
<br>
<br>
###<h3 id="Preference">GatewayPreferences for Resources</h3>
-1. Navigate Admin Dashboard --> Gateway Preferences
+1. Navigate Admin Dashboard ⇒ Gateway Profile
2. Both compute resource and storage resource specific preferences are defined here.
-3. To add compute resource related preferences click "Add a Compute Resource Preferences" and select the resource from the drop-down list.
-4. Add/select preferred options and click "Set preferences". Repeat this for all the resources used within the gateway.
-<br>Repeat this for every active enabled compute resource in the gateway.
-4. For each compute resource, gateway admin need to;
- - whether the preferences can be overridden by Airavata - Yes/No
+3. To add compute resource related preferences click "Add a Compute Resource Preference" and select the resource from the drop-down list.
+4. Add/select preferred options and click "Set preferences".
+<br>Repeat this for all the resources used within the gateway.
+4. For each compute resource, gateway admin need to specify;
+ - Preferences can be overridden by Airavata - Yes/No?
- Resource login name
- Preferred job submission and data movement protocols
- Preferred queue
- Scratch location
- Project allocation number
- - Resource specific credential store token
+ - Resource specific credential store token (When added Base Credential Store Token is not valid for the specific resource)
5. For adding storage resource preference click "Add a Storage Resource Preferences", and rest is similar to adding a compute resource preference.
6. For a gateway currently when a storage resource is selected, that resource ID need to be added in to the pga_config.php file in config folder of the hosted gateway.
7. For storage resource preference, gateway admin need to add;
@@ -74,32 +71,30 @@ NOTE: Currently enabling and disabling storage resources is not an active featur
2. Admin need to add application module, interface and deployment information in order to launch specific application jobs on compute resources.
3. What each step means?
- <b class="blue">Application Module</b>
- - Navigation: Admin Dashboard --> App Catalog --> Module
+ - Navigation: Admin Dashboard ⇒ App Catalog ⇒ Module
- This is the simple introduction of the application; Name, Version and Description.
- - Click on 'Create a New Application Module' and provide information.
- - Click Create.
- - All available modules are also listed; admin has the option of searching for a particular module by providing the name in the search.
+ - Click 'Create a New Application Module', provide information and create. On creation Application Module ID will be generated for the module.
+ - All existing modules are listed; Search by name is available for a particular module.
- Gateway admin can edit, delete existing modules.
- Deleting a module will be restricted if it has application interfaces and deployments linked.
- <b class="blue">Application interface</b>
- - Navigation: Admin Dashboard --> App Catalog --> Interface
- - Application interface defines the required inputs, output produced and their characteristics.
- - Click on 'Create a New Application Interface' and provide information.
- - Click Create.
+ - Navigation: Admin Dashboard ⇒ App Catalog ⇒ Interface
+ - Application interface defines the required inputs, outputs produced and their characteristics.
+ - Click on 'Create a New Application Interface', provide information and create. On creation Application Interface ID will be generated for the module.
- All available interfaces are also listed; admin has the option of searching for a particular interface by providing the name in the search.
- Gateway admin can edit, delete existing interfaces.
- Gateway admin cal also clone an existing interface in order to create a new similar interface with slight changes.
- <b class="blue">Application deployment</b>
- - Navigation: Admin Dashboard --> App Catalog --> Deployment
+ - Navigation: Admin Dashboard ⇒ App Catalog ⇒ Deployment
- Application deployment describes application deployment details on a specific resource.
- For an application for each resource there is a separate deployment.
<br>
<br>
### <h3 id="Credentials">Credential Store</h3>
-1. Navigation: Admin Dashboard --> Credential Store
+1. Navigation: Admin Dashboard ⇒ Credential Store
2. This interface is used to generate SSH key + token pairs.
3. These generated keys can be added in to the authorized key files in each resource for SSH key based communication.
-4. When generated key can be either assigned at gateway level; one key + token pair for all the resources OR have separate keys for each resource.
+4. Generated key can be either assigned at gateway level; one key + token pair for all the resources OR have separate keys for each resource.
5. SSH keys are used for communication with compute resources and storage resources.
### <h3 id="Preference">WSO2 IS Configuration</h3>
@@ -110,12 +105,12 @@ NOTE: Currently enabling and disabling storage resources is not an active featur
5. Extract the downloaded IS binary archive to a location <IS_HOME>.
6. Set JAVA_HOME variable and add jdk bin directory to the PATH variable.
7. Open <IS_HOME>/repository/conf/carbon.xml and change the following property to false
-<HideAdminServiceWSDLs>false</HideAdminServiceWSDLs>
+<HideAdminServiceWSDLs>false</HideAdminServiceWSDLs>
8. Execute the following command to run the server
sh <IS_HOME>/bin/wso2server.sh
You should be able to login to the Identity Server Web App using your browser with url http://localhost:9443/carbon . Default admin credentials are username: admin, password: admin
-9. For more information regarding WSO2 Identity Server refer this https://docs.wso2.org/display/IS460/Deploying+in+Production
-Gateway admin will be provided with
+9. For more information regarding WSO2 Identity Server refer <a href="https://docs.wso2.org/display/IS460/Deploying+in+Production" target="_blank">WSO2 IS Server</a>
+<br>Gateway admin will be provided with;
- Domain URL for the Gateway
- Admin User name