FABRIC Portal is a web based JavaScript application running inside your browser. It communicates with the various back-end systems on user’s behalf. From the Portal the user can manage the information and its visibility in their profile, view available testbed resources, create and manage projects and project membership, create experiments, login to created resources and more.
In this article we will walk you through the different parts of the Portal and explain their functionality.
Homepage
FABRIC resources map and facility updates are shown on the homepage. On the topology map, users can hover on each site to view site status and resource availabilities.
Resources
Users can view the testbed resource summary and site resource availability in both map and table views. By zooming in/ out of the map, users can also view international nodes and links. By clicking the column name of the resource table, sites will be sorted in the ascending or descending order.
Testbed Resources
By clicking the site name on resource map or table, users can open the site detail page with more site details. This page shows site-level and worker-level resource availabilities including Core, Disk, Ram, Component and Model data. There is a time filter toolbar for authenticated users to check future resources prior to future allocation request.
Measuring and Monitoring Tools
Four external tools: Public Metrics, Infrastructure Metrics, Optical Data and Latency Monitor are available on the Resources page -> Measuring and Monitoring Tools.
Experiments
Experiments page provides users with access to their projects, slices, ssh keys and the link to FABRIC Credential Manager app.
Projects & Slices
The first tab of Project & Slices displays a user’s projects and all FABRIC projects. The view will change based on different users’ roles and permissions, including the access to create project, edit project information, modify project owners and members, etc. For more information, please read this article: FABRIC User Roles and Project Permissions.
To create a slice in portal, users need select a project first then click the Slices tab -> Create Slice button as shown below. For more Information, please read the article: Creating your first slice in the Portal.
My Slices
Slices created in the Portal and in JupyterHub will display on the Experiments page -> My Slices tab in a table view. Click on slice name to open Portal Slice Viewer.
Manage Tokens
Users need to click on the button Open FABRIC Credential Manager to manage their tokens. For more information, please read this article: Obtaining and using FABRIC API tokens.
FABRIC Credential Manager provides the GUI to create, refresh and revoke tokens.
Manage SSH Keys
Two SSH key pairs are used in FABRIC: bastion key pair and sliver key pair. On this tab, users can view their stored sliver and bastion keys and download public keys; generate or upload sliver and bastion keys. For more information, please read the articles: Generating SSH Configuration and SSH Keys and Logging into FABRIC VMs.
Knowledge Base
FABRIC Knowledge Base provides rich content to help experimenters to learn about FABRIC testbed and tools, communicate with the community in Forums and create cutting-edge experimentation and research.
JupyterHub
After login to JupyterHub, you can create your private JupyterHub environment here and try a set of FABRIC example notebooks. For more information, please take a look at the articles on using the JupyterHub.
User Profile
To access the User Profile page, users need login first and click the user avatar on the top right navigation bar.
My Profile
FABRIC maintains a limited amount of personal information about the Users. Users can edit personal information and set privacy preferences on the My Profile tab. The checked items will be display on the user’s public profile page and be viewable to all FABRIC users.
My Roles & Projects
Users can check their FABRIC global roles and project roles on this tab.
- Project Lead: can create new projects, designate Project Owner(s) and invite regular members into a project. Faculty or senior staff at universities can request this role.
- Facility Operator: a ‘superuser’ allowed to manipulate any project. This role is reserved for FABRIC staff.
- Active User: A fully enrolled FABRIC Testbed User with all the rights and privileges therein.
- Jupyterhub: Provides access to the Jupyterhub cluster. User must be a member of at least one project to maintain this access.
To learn about managing project members and owners, visit this article.
My SSH Keys
Similar to the Manage SSH Keys tab on Experiments page, you can view all your sliver and bastion keys here. But for generating, uploading and deleting keys, please go to the Experiments -> Manage SSH Keys page.
My Slices
Similar to the My Slices tab on Experiments page, you can view all your slices here.
Contact Us
If you find any issue in using FABRIC testbed, please use the Contact Us page:
- For experiments issues, FABRIC Knowledge Base is the most useful place to find an answer. There are plenty of guides and articles, and you can also post a question in the Forums if no answer could be found in existing content.
- For account issues, you can either use the FABRIC Account Help Portal or send an email.
- FABRIC has also started the beta version of Office Hours for users to set up time with FABRIC team members;
- For teaching classes on FABRIC, please request a FABRIC project for educational use and use educator forum to ask questions and share experiences.