WebUi

QCG is a web graphical user interface for O² Quality Control.

• Installation
• Local Configuration
  • HTTP
  • CCDB
  • QC
• Run QCG locally
• Enable HTTPS
• Features
  • Canvas Options via MetaData
  • Display a QC non-standard ROOT object in QCG
  • Export a layout as JSON
  • Import a layout from JSON
  • AutoTransitioning Tabs within Layouts
• Continuous Integration Workflows
  • qc.yml
  • release.yml

Installation

1. Install nodeJS >= 16.x
   • CC7: yum install https://rpm.nodesource.com/pub_16.x/el/8/x86_64/nodejs-16.9.1-1nodesource.x86_64.rpm
   • Mac: brew install node@16 ; echo 'export PATH="/usr/local/opt/node@16/bin:$PATH"' >> $HOME/.bash_profile
   • Other: https://nodejs.org/en/download/package-manager
2. Clone the WebUi repository

   git clone https://github.com/AliceO2Group/WebUi.git
   

3. Install QCG

   cd WebUi/QualityControl
   npm ci
   

4. Copy configuration file and update according to your needs (see next section):

   cp config-default.js config.js
   

Local Configuration

In order to customize QCG, you can edit the following configuration file: WebUi/QualityControl/config.js

HTTP

Attribute to define the http endpoint of the application.

Edit the http section to define a custom:

• hostname
• port

CCDB

Attribute to define the Computer Centre DataBase (CCDB) endpoint.

Edit the ccdb section to define a custom:

• protocol = 'http' - protocol to use when querying CCDB via HTTP API.
• hostname = 'localhost' - hostname of the CCDB instance
• port = '8080' - port for accessing CCDB API
• [prefix = ''] - prefix to use for filtering on pathName
• [cachePrefix = 'qc'] - prefix to use for building the cache of object paths from CCDB
• [cacheRefreshRate = 120 * 1000] - interval on which the paths of objects from CCDB should be refreshed

QC

Attribute to define if QCG is to be started as part of a QC integrated environment.

• enabled = false

Run QCG locally

1. Run QCG server

   npm run start
   

2. Open a browser and navigate to http://localhost:8080.

   Ensure that your browser is supported.

Enable HTTPS

• Follow these steps to request a new CERN Grid Host Certificate
• Set up file paths to the generated key and certificate in the http section of config.js file.
• Provide your hostname in the hostname filed of http section of config.js file.

Features

Canvas Options via MetaData

QCG is using CCDB as storage service. When storing an object, the user can also store information on how an object should be plotted via the metadata field in CCDB. QualityControl documentation on how this can be achieved can be found here

• drawOptions: semi-colon separated drawing options; e.g. lcolz;colz
• displayHints: semi-colon separated hints; e.g. AP;APB

Display a QC non-standard ROOT object in QCG

QCG is able to display non-standard ROOT objects with the help of QC. More information can be found here

Export a layout as JSON

In order to facilitate the transition from one environment (e.g. TST) to another (e.g. PROD) while at the same time updating it, an export feature is provided.

1. Open the layout that you wish to export
2. Click on the top right second (from left to right) button which on hover shall display: Export layout skeleton as JSON file
3. Following that, QCG will automatically generate a JSON file and store it in your default download location.

Import a layout from JSON

Once a layout is exported and modified as needed or created from scratch, one can import it into QCG as such:

1. On the left sidebar, click on the small button (icon represented as cloud with arrow up) which is in line with MY LAYOUTS label.
2. A pop-up will open which will allow you to paste your JSON structure.
3. The pop-up will validate that the pasted value is a valid JSON.
4. Click on Import button.
   1. If successful, a new page will be opened with your imported layout in edit mode
   2. If there is an issue, a red line with an error message will be displayed above the Import button
5. Click Save Layout from the top right corner button.

AutoTransitioning Tabs within Layouts

To easily follow the progress of a RUN, layouts can automatically transition through the displayed tabs every few seconds. To configure:

1. Open desired layout
2. Click on the pencil icon button to start editing the layout
3. On the left sidebar, configure the field Tab Auto-Change(sec): 0 (OFF), 10-600 (ON) with the desired numerical value
4. Save

   Continuous Integration Workflows

   QualityControl project makes use of two workflows.

   qc.yml

   • Checks that tests of the project are running successfully on two virtual machines:
     • ubuntu
     • macOS
   • Make sure that the proposed changes are not reducing the current code-coverage percent
   • Sends a code coverage report to CodeCov

release.yml

• Releases a new version of the project to the NPM Registry under the tag @aliceo2/qc
• Builds a tgz file which contains an archive of the project. This can than be used for local repositories installations

This site is open source. Improve this page.