...
Gateway user registration and account verification steps
How to create and modify use projects
How to create, execute and monitor experiments.
How to share experiments and projects
How to set up own cluster accounts for job submissions.
How to seek assistance, submit issues and provide user feedback.
...
- Once the account is created successfully; log in to the gateway using the created account.
- Gateway login screen link
- https://testdrive.airavata.org/login
Image II I - Login
Password Recovery
- Gateway user can recover the forgotten password using '(Forgot Password? Click here)' link in the login page.
- The user needs to provide the username then will receive an URL to add the new password.
Tutorial II -
...
Using Projects
Create Project
- A Project is simply a grouping for experiments. Every user will have a 'Default Project' which exists when the user logs into the gateway for the first time.
- To create Projects navigate to ‘Project --> Create’ from the main menu. Enter Project Name (Mandatory) & Project Description (Optional) and save.
- Project creation screen
Image II - Create Project - Upon successful creation, the user is directed to Project Summary page.
...
- Navigation 'Project --> Browse' from the main menu.
- Search keys are;
- Project Name
- Project Description
- Browse Project page;
Image III - Browse Project - The user can search for projects by using (*) as a wild character. The * can be used when searching either option; Project name or description.
- When projects are listed by clicking ‘View’ at the end of the row user can navigate to ‘Project Summary’ page.
- In 'Project Summary' all experiments created under the project will be listed along with the list of shared users.
Image Modified
Image IV - Project Summary - The user can click on the experiment ‘Name’ and navigate to ‘Experiment Summary’ page.
...
Image V - Experiment Summary
Share Projects
- Projects are also used to share with other gateway users. e.g.: Sharing a project with another user will give him access to all his experiments in the project.
When sharing projects, the project owner can share with 'write' or 'read' access.
Once a project is shared with other users, they will be listed on the project summary page. Refer Image Image IV - Project Summary
Sharing with 'read' access will enable the users to view the project and experiment in the project. Only the owner can modify the project details and sharing.
Sharing with 'write' access will enable the users to view the project and experiment in the project, modify the project and create new experiments using this project. Still, only the owner can modify the project sharing.
The project owner can remove, modify sharing of existing users and share with new users at any given time.
...
- Navigate to User Settings (This is under gateway username in the menu on the righthand side.
Image VI V - User Settings Navigation - User Settings screen
Image VII VI - User Settings - Select 'Compute Resources' from above to add allocation details.
- Click 'Add a Compute Resource Account'
- Select the resource from the drop-down list.
- Provide the required information. NOTE: You may not have allocation project, QOS or Reservation. The minimum requirement is the login username and the scratch location and SSH key.
- When assigning SSH key by default the default SSH key will be assigned. If the user prefers, can generate a new key and assign here.
...
- For individual users to generate new SSH key navigate to User Settings → Credential Store
- In Credential store you will have the default key displayed and it can be copied to add to your account's 'authorized_keys' file.
- To generate a new key provide a description and add.
Image VIII VII - User Settings → Credential Store - User can delete keys and also tag any key as the 'default' SSH key.
...
- Navigation to experiment creation page Main Menu --> Experiment --> Create Experiment
- Create Experiment Page - Experiment Information
Image VI VIII - Create Experiment
- First enter/select given fields;
- Experiment Name (Mandatory)
- Experiment Description (Optional)
- Project (Select from the available LOV. Latest will be on top; auto selected)
- Application (Select from the available LOV)
and click ‘Continue’. At this point, the user can clear any entered fields by clicking ‘Reset Values’ before continuing. - Then continue entering Application configuration information.
- Experiment application input (Mandatory) - Application input can be in the form of entering data or uploading required input files.
NOTE: Uploading file validity is not checked by the gateway. User has the responsibility of uploading correct files. - Compute Resource (select from the available LOV. If the application is existing in a single resource, it will be the default value)
- Queue (a default value will be taken if not changed by the user)
- Node Count (If not entered default value will be taken as the input)
- Total Core Count (If not entered default value will be taken as the input)
- Wall Time Limit (If not entered default value will be taken as the input)
- Total Physical Memory (If not entered default value 0 will be taken as the input)
- Notifications: Add email address if required to receive job starting and completing notifications from compute resource itself.
NOTE: For some compute resources, above default values will not be correct. User needs to change the node count in such cases.
- Create Experiment - Application Configuration Part
Image VII IX - Create Experiment Contd..
- While entering application configurations user can start over from the beginning using ‘Start Over’ button.
- Once saved or saved and launched user will be directed to ‘Experiment Summary’ page; from summary page can monitor experiment status changes.
- Experiment Summary Page
Image VIII X - Experiment Summary
Launch Experiment
...
- User can search for experiment created by him/her through
- Experiments → Browse
OR - Browse Projects → View Project → View Experiment (by clicking on the status of the experiment) - Please refer Search Projects in "Tutorial II" above.
In Browe Experiments search keys are;
Experiment Name
Experiment Description
Application
Creation Time - User can provide 'From Date' and 'To Date'
Image IX XI - Browse Experiments
All the experiments of the user will be listed; latest on top. The user can also search using provided keys with partial values, complete values, (*) wildcard. Above search can be narrowed by combining with experiment status as well.
By clicking on the 'Status' user will be navigated to ‘Experiment Summary’ screen of each experiment.
Experiment summary can be used to;
Launch experiment - Explained in above Tutorial III
Cancel experiment
Clone experiment
Edit experiment
View experiment data files (Inputs, outputs, archived files)
...
- Modify experiment by clicking on the edit icon (pencil) next to experiment name (In Browse Experiment, Project Summary) OR by clicking on ‘Edit’ button in Experiment Summary Page.
- User can modify all available fields except experiment status, project, application & experiment ID of experiments only in CREATED state.
Image X XII - Edit Experiment
Cancel Experiment
...
Tutorial VII - User Assistance
Report Issue
Gateway user can report issues faced within the gateway through this page.
Page navigation: Help → Report Issue
Raise a Bug Page
Image Removed
Image XII - Raise a Bug
Request Feature
Gateway allows users to provide feedback as well as request for new applications via Request Feature Page.
Page Navigation; Help → Request Feature
Got Feedback? Page
Image Removed
...
'Contact Us' in home page provides communication with the gateway admin via email. Gateway users can use this for all gateway related communications such as
- Report an issue
- Request for a feature
- Feature clarification