VM Details

Overview Tab

VM-overview The user clicks a VM’s name from the list view and is taken to that VM’s Overview tab. The user sees detailed information about the VM’s configuration. VM-overview - Editing a field Editing field will be aligned to the rest of the system. For now, only ‘Description’ and Flavor’ have a pencil icon next to the field name to indicate it is editable. Hitting that pencil will open up a modal.

Editing the CD-ROM

Via the pencil icon the cd can be edited. VM-details edit cd

They will then be presented a modal with a type to select from (or an empty state if no CD-ROM has been added).

Depending on the type selected a new input is revealed. These types would be


This is the empty state. They can remove any CD-ROMs attached via the (-) icon next to each row. VM-details edit cd modal


A text field is provided to paste in the path to the container. container-type

Persistent Volume Claim

A typeahead field is provided to find the desired Persistent volume claim. PVC-type


A text field is provided to paste in the URL to the available CD. URL-type

With each selection a tooltip is provided to describe each type.

Windows drivers

In the case where a Windows operating system has been chosen in the general step a Windows drivers option will be available. VM-details edit cd windows drivers

There is the ability to add more than one CD-ROM if needed (most likely for a Windows VM) VM-details edit cd windows drivers

VM-details cd details


Should be inline with the rest of OpenShift. Can be seen here

Network Interfaces

VM-network intefaces - add NIC This is Network Interfaces tab.

VM - add NIC modal Default modal. The user is notified that activating this upcoming NIC requires a VM restart.

VM - add NIC modal - filled in User can choose between adding NIC only, or add NIC and restart VM to make it active.

VM - new NIC The new NIC should always appear at the top of the list until the user restarts it. The new nic will have a’Pending VM restart’ Link state (as a status).

VM - New NIC - popover Hover on that link state (status) will display more details with a ‘Restart VM action in a popover.

VM - Pending changes notification - view changes Whenever a NIC has been added or modified in a way that requires the VM to be restarted, an inline alert should appear below the tab area reminding the user to do so. This notification should persist across all tab views, including the Overview (shown previously).

VM - Pending changes notification - view changes modal Changes pending VM restart can be viewed in a dedicated modal.

Edit NIC

Editing NIC is equivalent to creating one, with Modal label and actions label changed accordingly.

VM - NIC item action options Edit NIC available in the kebab menu of each NIC list item VM - Edit NIC modal “Save changes” is equivalent to “Add NIC” on creation modal. The VM must be restarted in order for these changes to be applied. VM - Edit NIC saved changes Same notification to restart VM if the user selected to save changes only.


VM - Disks tab - adding disk The flow for disks is similar to NICs, but adding or editing a disk does not require a VM restart.

VM - add disk modal The user clicks “Add Disk”, and is led to an ‘Add Disk’ modal.

VM - disk list item actions The user edits each input and clicks the confirm button to finish. The new disk is added to the list and is sorted alphabetically.

The user can edit or delete a list item from its kebab menu for each list item.


Snapshot designs can be seen here




VM - console tab -default The Consoles tab allows the user to connect to the virtual machine via an in-browser or desktop-based Graphical and/or Serial console. VM - console dropdown options The user can change the console type using the dropdown selector. ‘Graphical (VNC)’ is selected by default. Any currently selected option is disabled in the dropdown.

Two actions are available on the right-hand side. The “Open in new window” action opens a separate browser window dedicated to the console view. The “Expand” action makes the console viewport fill the current window’s full width and height similar to elsewhere in OKD. The “Send Key” dropdown is disabled when disconnected from the console.

The user can start a console session using either the primary ‘Connect’ action button in the content area or the secondary ‘Connect’ button next to the console dropdown selector.

Connecting from a powered off state

VM - Serial (SPICE) If the virtual machine is powered off, the primary action button will allow the user to both start and connect to the virtual machine with one click. If the user wants to power the virtual machine on without connecting a console (an unlikely use case while in this view) they can use the actions dropdown in the top-right as usual.

VM - connecting to VM While the virtual machine is powering on, the console selector dropdown should be disabled to “lock in” the intended console. When the virtual machine finishes powering on, the console will be connected.

Sending keys

VM - Send key dropdown options

The “Send Key” dropdown helps the user send keyboard shortcuts that would ordinarily be captured by the user’s client operating system. The options available will depend on the VM that is running.

Remote connection settings

VM - Remote conection settings

If the user prefers to connect to a VM using their own desktop client or Remote Desktop Viewer, they can find the port and configuration information they need by clicking the “Remote Connection settings” link to reveal a modal.

VM - Remote conection settings modal