ONELab User Interface

This section provides example usages of the ONELab UI

ONELab Logging in

When initially accessing ONELab IoT, the Explore Boards page is displayed. If not logged in, the user can only see the Explore Board page. Log in is managed by subscription (or company). Once logged in, a user has access to the organization Dashboard and Appliances pages through the hamburger button on the left. The user can also now schedule Conformance Runs and access the Appliances Dropdown

Firmware Upload - Create Release Stream

To be able to to leverage ONELab, you need to have your firmware built to be compatible with ONELab. ONELab accepts files in UEFI Capsules wrapped in a LVFS container.

Upload for .cab firmware file image by clicking on “Firmware Release Streams,” then click on “Add new release stream.” Browse to the .cab file you build in the previous step and upload it.

Connect to the ONELab Cloud Service

After device setup is complete, the next step is connecting the LAA over the cloud to the ONELab cloud infrastructure. This assumes the user already has a ONELab subscription and account.

This step is automated and upon subscription enablement, the LAA will show up in the subscription as “off line.” When the LAA is turned on, it will automatically connect, and within a few minutes, the LAA status will toggle to “one line.”

Note

The ONELab Cloud Service will never initiate access into a corporate infrastructure. The LAA always initiates outbound connections to the ONELab Cloud Server from within any customer location. It will register availabilty to the cloud service and poll the service to check for CI tasks to perform.

Processing the results

Once tests have kicked off and completed, the user is now ready to evaluate results.

ONELab provides an internal dashboard that displays the latest results as shown in the following figure. You can then choose to process the results including downloading test logs, rerunning tests, or making the results public by sending them to the public dashboard. These options are all managed from the Compliance Run private page within the subsciption, as shown below.

In the figure, there are several things to highlight:

• Each row represents a specific interoperability test run for compliance.

• Further actions such as rerunning a test, downloading logs, and promoting a Release Stream test suite to the public Explore Boards page can be selected from the Kebab menu selector (⋮) at the end of each row.

Note

When a compliance run is toggled to “Public,” this enables all tests for the associated Release Stream to public. Only tests that passed will be shown on the public Explore Board, failed tests will be shown as blank.

• A private view of what will be shown on the Explore Boards Page can be seen on the Explore Boards Preview page.

Explore Boards Search

The ONELab Dashboard provides a search bar. It can search based on Board Name or Firmware Name. The search isn’t case sensitive. When you select the items found, it will display them in the results space when clicked. Use the “Clear Filters” selection to return the Dashboard to show all Conformance Runs that your login provides you access to.

The example below describes how to use the search function in the ONELab IoT Dashboard:

ONELab Accessing the Dashboard and Appliances Pages

When a user initially navigates to the ONELab website, they will land on the Explore page. From there the user may log in. Once logged in, a user has access to the Dashboard and Appliances pages for the organization of which they are a member. Access these by clicking on the hamburger button on the upper left portion of the screen.

The Dashboard provides a summary of Assessments, Appliances, and Release Streams

TODO: What’s an Assessment?

CHECK: Release stream versions, Total Versions - can’t see them.

The Appliances Page show all Appliances available within this organization along with there status (offline or online). The user can narrow down the Appliances displayed by selecting a specific platform from the Device Type Dropdown. Selecting the Kebab (three dots) Icon to the right of the Appliance allows the user to Configure an Appliance

ONELab Configuring an Appliance

An Appliance can be configured from the Kebab Icon on the Appliance Page

CHECK: What am I Configuring? I can change a device Type in re-configuring?

ONELab Scheduling a Conformance Run

Creation of a Release Stream

A conformance run requires that a Release Stream has been created. To do this, follow these steps.

Note

Typically, when you schedule a conformance run, you will re-use an existing Release Stream. It is only necessary to add new Release Streams when a new family of firmware is tested for the first time.

Schedule Conformance Runs

To Schedule a conformance run, click the Conformance Run button from either the Dashboard or the Explore Board, upload your firmware image built in compliance with the ONELab Firmware Packaging & Upload section. Per that section, the Release Stream is entered when building the firmware image.

Managing ONELab CI Test Results

TODO: This section will describe how to delete results, download logs, and flip results from private to public