1. Home
  2. Technical Guides
  3. Portal
  4. Navigating FABRIC Portal

Navigating FABRIC Portal

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.

Experiments page -> Project & Slices

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.

Project Details page -> Slices tab
Portal Slice Builder

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.

Experiments page -> My Slices tab
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.

Experiments page -> Manage Tokens tab

FABRIC Credential Manager provides the GUI to create, refresh and revoke tokens.

FABRIC Credential Manager App

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.

User Profile page -> My Profiles tab
Public User Profile page

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.
Updated on July 23, 2024

Was this article helpful?

Related Articles

Having problems?
Try searching or asking questions in the FABRIC community forums!
Go to Forums

Leave a Comment