Contents 1 Overview 1.1 Creation of images via the tab 'Submit' 1.1.1 Creation of a MIC2 image from a ks file 1.2 Visualization of the MIC2 jobs queue via the tab 'Queue' 1.3 Visualization of IMG Django settings via the tab 'Admin' 1.3.1 The "App" part 1.3.1.1 Image jobs 1.3.1.2 Queues 1.3.2 The "Auth" part 1.3.2.1 Groups 1.3.2.2 Users 1.3.3 The "Sites" part 1.3.3.1 Sites 1.4 Logout from IMG via the tab 'Logout'

Overview

Following a successful identification by a user, the following IMG start view appears:

The start view of IMG

Four tabs appear on this view:

• "Admin",
• "Submit",
• "Queue" and
• "Logout"

The following sections will describe the functions of each of these tabs.

Remark: Alternatively, instead of using the tabs, the user directly choose one of the following actions as appearing on the WI:

• "Create an image" ( equivalent to the "Submit" tab )
• "Look at the image creating job queue" ( equivalent to the "Queue" tab )

Creation of images via the tab 'Submit'

Creation of a MIC2 image from a ks file

The standard way of creating a MIC2 image is to choose the radio button option "Kickstart file" appearing in the submit view of IMG. Via Combo-boxes "Image type" and "Architecture" the user can choose the type of the target image respectively the deployment architecture of the image as shown in the WI view below:

Creation of an image from a ks file

In order to submit the specified image creation job, the user has to click on the "Submit" button in the bottom of the WI.

Remark: The menu on the right provides contextual help and the user is encouraged to consult the related help topics.

Visualization of the MIC2 jobs queue via the tab 'Queue'

Following the click on the "Queue" tab, the user obtains the complete view of the ensemble of MIC2 jobs. After the submission of an image creation job as was described in the previous section, the user will find the submitted job on the IMG queue WI as shown in the picture below:

Visualization of a job queue after the launch of a job

The queue table contains the following fields:

• "ID / queue: The ID of a job together with the name of the associated queue (see also section "Visualization of IMG Django settings via the tab 'Admin'")
• "Submitted": The job submission date and time
• "Length": The totally elapsed time between the submission of a job and its accomplishment
• "User": The name of the user who has submitted the job
• "Arch": The architecture on which the target image will be deployed
• "Type": The image type
• "Status": Current job status which is one of the following: "IN QUEUE", "BUILDING" and "DONE"
• "Results": Contains the links 'Log', 'Files' and 'Image':

The user can access the log of the image creation process in run-time by clicking on the "Log" link.

Visualization of a job queue after the accomplishment of a job

Remark 1: The job queue as appearing on the IMG WI may become too long over time and the files (in particular the target image files) obtained after the accomplishment of an image creation job consume hard disk space. It is therefore necessary to regularly clear the queue both graphically on the WI and physically by deleting the ensemble of related files. Via Django administration interface the user can currently only delete the jobs on the IMG WI as described in the next section. Future IMG release will also allow the physical deletion of the related files.

Remark 2: The user can refresh the image creation queue by pressing either the refresh or the "F5" button.

Visualization of IMG Django settings via the tab 'Admin'

By clicking on the "Admin" tab the user gets access to the ensemble of IMG settings and variables. The "Admin" view is presented below:

Admin view containing information about IMG settings and variables

It contains 3 sections:

• The "App" part which regroups image creation jobs and queue types
  
• The "Auth" part which contains information about users and groups together with their profiles
  
• The "Sites" part

The "App" part

Image jobs

The section "Image jobs" contains detailed information about the image creation jobs as available in the IMG queue view. Following the click on the "Image jobs" tab in the "Admin" view the user obtains the list of jobs with "Image id" as primary key. By checking the box to the left of "Image id" of a job the user can select the job for an action as available in the combo-box "Action" above. By choosing the combo-box action "Delete selected image jobs" the user can delete the job from the queue, i.e. the job together with the ensemble of related characteristics and files will not anymore visible on the queue WI of IMG.

Queues

The user can add or delete a queue or change the characteristics of an existing queue. The default queues are "requests", "api" and "web".

The "Auth" part

Groups

The user can add or delete a group or change the charcteristics of an existing group.

Users

The user can add or delete a user or change the charcteristics of an existing user.

The "Sites" part

Sites

Logout from IMG via the tab 'Logout'

IMG allows several users to work on the same IMG server. The user can log out from the current session by clicking on the "Logout" tab. Following the logout, the user will obtain a view as below:

IMG login view

The user can now log in to IMG by providing a specified login/password for his new session.

Remark: An IMG release typically proposes "imager"/"imager" as default login/password.