LSB Certification System WebUI Intro
This document describes the current prototype of the LSB Certification system deployed at the [https://www.linux-foundation.org/lsb-cert/].
The document you are reading just presents the current status of the system and explains basic steps to test the current prototype. Note: design of the full certification system to finally build in the long run is presented and maintained in a separate document - LSB Certification System Design Proposal. These two documents are to merge at some later stage.
At the topmost level, server side part of the Certification System may be split into three pieces:
- Certification Management.
- Product Directory.
- Problem Reporting.
The current prototype covers the first and the second pieces assuming problem reporting is done via e-mail manually (through the lf_lsbcert mailing list).
Certification Management deals with company management and product certification process. It includes:
- At user level:
- company registration,
- company members management,
- addition/modification of products (apps or distros),
- applying for certification of products on selected architectures,
- transparent executing tests with DTK/ATK Manager [not implemented yet],
- uploading test journals easily from DTK/ATK Manager,
- fee payment [not implemented yet],
- At admin level:
- super rights for editing info about any company and product;
- managing uploaded test journals;
- managing status of certifications;
Product Directory provides different views on the list of LSB certified products (Distributions and Applications). Every user has access to the Product Directory. The views support ordering by date, certification program (LSB version) and by product name. Distributions and applications on each page are separated into different tables. There is also company info for each company with a list of its products.
Integration with Testkit Managers
There are two sides of certification workflow:
- Actions with the central web based certification system (at LF server).
- Actions with the local DTK/ATK Manager (at a company private machine).
After obtaining the test results from the Testkit Manager, you should submit them to the Certification System for audit. DTK Manager (since version 1.4) and ATK Manager (since version 1.1) simplify this operation by providing ability to upload test results in a few clicks. User has no need to seek for the test results package in the file system. Moreover, this automated uploading works as well when the Testkit Manager is running on a remote machine.
Simple Test Scenario
To demonstrate the current cert system prototype, we recommend a test scenario presented in this chapter. This is not the final workflow and feedback is very much appreciated.
Create Account and Log In
Certification system shares accounts with the www.linux-foundation.org site accounts. If you have no account you could create it using the "sign up" link at the top right of the login page.
After you logged in you should be redirected to the certification system.
Become a Company Member
Register your company. To register a new company, you should click on “Register you company” link and then fill in and submit the form. You can change the company details later.
To join an existing company, you should be invited. If one of the company members invites you, you receive a mail with a confirmation link. To accept the invitation, follow this link. To reject the confirmation, follow the other link or just ignore the e-mail.
Note: a person can't be a member of more than one company.
Status page contains an overview of the current situation and advices on what one could do. For example, it suggests you creating an account and logging in at the very start, then register a company and products, then start certification and thereafter guides you through the process stages.
- To see and edit information about the company and company members, follow the Company Details link.
- To invite a member, follow the “Invite to the company” link at the top of the Company Members list. To exclude a member, click on a name and then click on the “exclude” link.
Company products are listed at the Products page.
- To add a new product, click the “Add a product” link.
- To edit or delete a product, click on the product name and then click “Edit” or “Delete” link. Note that you can’t edit or delete a product if certification process is started for it or if the product is already certified for some architectures. You can ask administrator to make changes if necessary.
Note: you can skip steps 1-5 and start with testing your product using a corresponding Testkit Manager (step 6). When you try submit the test results, you will be suggested to go through the skipped steps first.
- To start certification for a product, click on the “Start Certification” link at the Status page or Products page.
- Then choose LSB certification program, and then architectures for certification and type of registration (new product / additional architectures / maintenance release). Click the “Continue” button.
- Read the TMLA and sign it (press the ‘ACCEPT’ button). Fee sum is calculated automatically and is mentioned in the Agreement.
- After that you should wait for a confirmation from the administrator. The administrator will be notified by e-mail to review the signup and confirm that everything is OK. When confirmation is granted, you are ready to apply for certification given you have good test results on your system being certified.
- To test the product, you should use the DTK Manager for distributions and the ATK Manager for applications. If there are errors that are suspected to be a test suite deficiency, you can submit a problem report. LSB engineers will review the report and may grant a waiver (that is official permission to ignore the error).
- Once the product passes the tests, you can submit the results for final audit. To do this, click on the “Apply for audit” link on the Test Results page in the Testkit Manager. If you have skipped one of the previous steps or more, you will be suggested to accomplish them. Finally you should submit the request for audit with the test results attached. The Testkit Manager will automate the uploading of the package with the results. Note: you should do this for each architecture you are certifying.
- After successful audit you are asked to perform the fee payment, which is waived for 2009. After which the product is marked as certified and goes to the list of LSB certified products in the Product Directory. Your organization receives documents, logos, and other access/materials accordingly.
Note: you can see the current status of the certification process at the Status page.
Note: in the prototype version the payment process isn’t integrated with the system. In the future payment will be carried out through the PayPal system.
To enter Administration mode, log into the system under an administrator account.
The Administration mode resembles User mode. There is also Status page, Company Details page and Products page for each company where one can manage company details, products, certifications, members. On the product page, administrator can also manually initialize certification process.
There is also a “Low Level” set of pages for managing database entries at the very low level (for quick fixing of possible DB inconsistencies).
At the “Uploads” page one can manage uploaded files. Note that there is a record in the database for each file uploaded on the server, and this record should be edited carefully to avoid inconsistencies.
User accounts are stored in LDAP, and there are no facilities to administer them, because it is supposed that user accounts will be managed via an external system (Mediawiki, aMember or something else).