Clara Holoscan Deploy 0.8.1 EA
0.8.1

14.3. Clara Management Console

The Clara Management Console allows you to view Clara Platform features from web browser. Currently, it supports the Pipelines view, Jobs view and the Viewer: The Pipelines view shows all created Clara pipelines with their current statuses, the Jobs view displays details of all created Clara jobs and the Viewer is for visualization of payloads.

You must use Chrome web browser to access the web interface using IP where Clara Management Console is deployed on port 32002 (e.g., http://<HOST IP or DNS>:32002).

14.3.1.1.Minimum Requirement

  • Google Chrome - Version 80.0.3987.149 (Official Build) (64-bit)

14.3.1.2.Starting the Service

Clara Management Console is comprised of two different containers that work together to provide the web application:

  • Clara Management Console Backend: web application backend that communicates with clara platform API server using clara platform API and provides this information to new clara management console frontend over RESTful API whenever requested.

  • Clara Management Console Frontend: web application which contains all the frontend logic to display clara management console. All the views are updated periodically to reflect the current status.

You can get Clara Management Console by using command below:

Copy
Copied!
            

clara pull console

You can start these two containers by using the command below:

Copy
Copied!
            

clara console start

To stop the service:

Copy
Copied!
            

clara console stop

To restart the service:

Copy
Copied!
            

clara console restart

14.3.2.1.User Basic Authentication

When the main URL is loaded, browser shows the landing page with sign in form. The user can sign in with the valid credentials provided for Clara Management Console. Once the user is authenticated, user is redirected to the pipelines view page.

clara-ux-landing-page.png

When the main URL is loaded, and the user signs in, browser shows the page with navigation bar at the top. There are currently three views supported, Pipelines view which can be loaded by clicking on <b><i>PIPELINES</i></b> icons, Jobs view which can be loaded by clicking on <b><i>JOBS</i></b> icon and the Viewer which can be opened by clicking on <b><i>VIEWER</i></b> icon.

14.3.2.3.Pipelines View

Pipelines view lists all the created clara pipelines. This view can be accessed by clicking <b><i>PIPELINES</i></b> icon on navigation bar. Each pipeline is shown on separate cards. Each pipelines card also shows the number of jobs currently in queue and the timestamp for last executed job for that pipeline. This tab is updated periodically to update the pipelines list and all associated information whenever there is an update. By clicking on any pipeline card, navigation is made to jobs tab with filter applied on clicked pipeline card so that only jobs of that pipeline are shown.

Pipelines can also be searched by entering pipeline name in the search box displayed on the right top of the pipelines view.

clara-ux-pipelines-view.png

Jobs view lists all created clara jobs. This view can be accessed by clicking on ‘JOBS’ button on navigation bar. For every job, it lists the current status, priority, job id, pipeline name, start time and duration. This view is also dynamically updated to reflect the current status of all jobs. Jobs can also be sorted on priority and filtering is supported for all columns.

For each job, input and output payload can be downloaded by clicking on ‘Download’ link in ‘Input’ and ‘Output’ column for a job respectively. Clicking on ‘Download’ link will get the payload files, archive them in a ZIP file and download it in browser’s download folder. Ouput palyload link for a job will be shown once a job is finished. Input payload represents initial input for a job and output payload represents output payload of all the operators for a job. After clicking on ‘Download’ link, a progress bar indicating current download progress is shown at the bottom of the page.

clara-ux-jobs-view.png

The Viewer can be opened by clicking on ‘VIEWER’ icon in navigation menu.

clara-ux-render-server.png

Job Details View for a job can be opened by clicking on a row for that job in Jobs View. It shows additional information about each job such as the list of all the operators with their current status and duration. The output payload for an operator can be downloaded by clicking on a ‘Download’ link in output column. The output payload ‘Download’ link for an operator is shown when the operator is executed. If the operator results are registered with the Clara Render Server for rendering, the ‘Output Payload’ column for an operator also shows ‘Render’ option when the operator is executed. If the operator results are not registered with the Clara Render Server for rendering, the ‘Output Payload’ column for an operator instead shows ‘Import’ option when the operator is executed.

clara-ux-job-details-view.png

Clicking on ‘Render’ option in ‘Output Payload’ column of an operator will open the Viewer in separate Console tab and it will render the output of an operator.

clara-ux-render-output.png

The right side Settings panel of the Viewer can be toggled by clicking on the Settings icon at the right top.

clara-ux-render-output-toggle-settings.png

Whenever the value of ‘Selected Camera’ option in the Settings panel is other than ‘Cinematic’, the Viewer will also show measurement buttons at the top right.

clara-ux-render-measure-buttons.png

Clicking on ‘Import’ option in ‘Output Payload’ column of an operator will open the Viewer in separate Console tab and it will open payload import dialog inside the Viewer.

clara-ux-render-payload-import.png

Select the appropriate renderer type (volume or 2d), drag & drop volume files (mhd, nifti, nrrd) or images (png, jpg, tif) on right side of the dialog, give the dataset a name.

clara-ux-render-payload-import-2.png

Click ‘OK’ on import dialog to visualize selected file.

clara-ux-render-payload-import-visualize.png

Job Details view also shows operator logs whenever available. The logs for an operator can be accessed by clicking ‘link’ in ‘Logs’ column of an operator.

clara-ux-log-viewer.png

Job Details view also has an option to render visual representation of a job DAG. It can be toggled ON/OFF by clicking on ‘DAG View’ option in the Job Details view.

clara-ux-horizontal-dag.png

A job DAG is rendered in horizontal orientation from left to right by default. The vertical orientation of a job DAG can be toggled ON/OFF by clicking on ‘Vertical orientation’ option in the Job DAG view.

clara-ux-vertical-dag.png

Clara Management Console provides default credentials which should be changed after installation. Default credentials are

Username: admin Password: console

Follow below steps to change default credentials:

  1. Open .htaccess file on the node where Clara Management Console is installed. File is located at path /clara/console/data/.htaccess

Copy
Copied!
            

vim /clara/console/data/.htaccess

  1. Edit default credentials, more than one username:password entry can be added to the .htaccess file, each entry on a separate line and in format username:password.

  2. Restart Clara Management Console

Copy
Copied!
            

clara console restart

The user can then open Clara Management Console in web browser and sign in with one of the provided credentials from .htaccess file.

It is recommended to sign out of Clara Management Console once done using it, close the tab and sign in again next time.

Clara Management Console allows admins to disable payloads download feature for one or more users. The users having payloads download feature disabled will not see links to download payloads from Jobs View and Job Details View.

Follow below steps to disable payloads download feature for a particular user:

  1. Open .features file on the node where Clara Management Console is installed. The file is mapped to the host and located at path /clara/console/data/.features.

Copy
Copied!
            

vim /clara/console/data/.features

  1. Find out the features entry for the given user and change value of enabled under payloads_download section from true to false. Example:

    Copy
    Copied!
                

    To disable payloads download feature for user `user1`, change the below entry of .features file From:

    Copy
    Copied!
                

    { "name": "user1", "features": { "payloads_download": { "enabled": true } } },

    Copy
    Copied!
                

    To:

    ```bash

    Copy
    Copied!
                

    { "name": "user1", "features": { "payloads_download": { "enabled": false } } },

Copy
Copied!
            

3. Restart Clara Management Console ```bash clara console restart

To again enable payloads download for a user, change value of enabled under payloads_download section from false to true and restart Clara Management Console.

© Copyright 2018-2020, NVIDIA Corporation. All rights reserved.. Last updated on Feb 1, 2023.