×

The Virtualization section of the OpenShift Container Platform web console contains the following pages for managing and monitoring your OpenShift Virtualization environment.

Table 1. Virtualization pages
Page Description

Overview page

Manage and monitor the OpenShift Virtualization environment.

Catalog page

Create VirtualMachines from a catalog of templates.

VirtualMachines page

Configure and monitor VirtualMachines.

Templates page

Create and manage templates.

DataSources page

Create and manage DataSources for VirtualMachine boot sources.

MigrationPolicies page

Create and manage MigrationPolicies for workloads.

Table 2. Key
Icon Description

icon pencil

Edit icon

icon link

Link icon

Overview page

The Overview page displays resources, metrics, migration progress, and cluster-level settings.

Overview page
Element Description

Download virtctl icon link

Download the virtctl command line tool to manage resources.

Overview tab

Resources, usage, alerts, and status

Top consumers tab

Top consumers of CPU, memory, and storage resources

Migrations tab

Status of live migrations

Settings tab

Cluster-wide settings, including live migration limits and user permissions

Overview tab

The Overview tab displays resources, usage, alerts, and status.

Overview tab
Element Description

Getting started resources card

  • Quick Starts tile: Learn how to create, import, and run VirtualMachines with step-by-step instructions and tasks.

  • Feature highlights tile: Read the latest information about key virtualization features.

  • Related operators tile: Install Operators such as the Kubernetes NMState Operator or the OpenShift Data Foundation Operator.

VirtualMachines tile

Number of VirtualMachines, with a chart showing the last 7 days' trend

vCPU usage tile

vCPU usage, with a chart showing the last 7 days' trend

Memory tile

Memory usage, with a chart showing the last 7 days' trend

Storage tile

Storage usage, with a chart showing the last 7 days' trend

Alerts tile

OpenShift Virtualization alerts, grouped by severity

VirtualMachine statuses tile

Number of VirtualMachines, grouped by status

VirtualMachines per template chart

Number of VirtualMachines created from templates, grouped by template name

Top consumers tab

The Top consumers tab displays the top consumers of CPU, memory, and storage.

Top consumers tab
Element Description

View virtualization dashboard icon link

Link to Observe → Dashboards, which displays the top consumers for OpenShift Virtualization

Time period list

Select a time period to filter the results.

Top consumers list

Select the number of top consumers to filter the results.

CPU chart

VirtualMachines with the highest CPU usage

Memory chart

VirtualMachines with the highest memory usage

Memory swap traffic chart

VirtualMachines with the highest memory swap traffic

vCPU wait chart

VirtualMachines with the highest vCPU wait periods

Storage throughput chart

VirtualMachines with the highest storage throughput usage

Storage IOPS chart

VirtualMachines with the highest storage input/output operations per second usage

Migrations tab

The Migrations tab displays the status of VirtualMachineInstance migrations.

Migrations tab
Element Description

Time period list

Select a time period to filter VirtualMachineInstanceMigrations.

VirtualMachineInstanceMigrations table

List of VirtualMachineInstance migrations

Settings tab

The Settings tab displays cluster-wide settings on the following tabs:

Table 3. Tabs on Settings tab
Tab Description

General tab

OpenShift Virtualization version and update status

Live migration tab

Live migration limits and network settings

Templates project tab

Project for Red Hat templates

User permissions tab

Cluster-wide user permissions

General tab

The General tab displays the OpenShift Virtualization version and update status.

General tab
Label Description

Service name

OpenShift Virtualization

Provider

Red Hat

Installed version

4.13.8

Update status

Example: Up to date

Channel

Channel selected for updates

Live migration tab

You can configure live migration on the Live migration tab.

Live migration tab
Element Description

Max. migrations per cluster field

Select the maximum number of live migrations per cluster.

Max. migrations per node field

Select the maximum number of live migrations per node.

Live migration network list

Select a dedicated secondary network for live migration.

Templates project tab

You can select a project for templates on the Templates project tab.

Templates project tab
Element Description

Project list

Select a project in which to store Red Hat templates. The default template project is openshift.

If you want to define multiple template projects, you must clone the templates on the Templates page for each project.

User permissions tab

The User permissions tab displays cluster-wide user permissions for tasks.

User permissions tab
Element Description

User permissions table

List of tasks, such as Share templates, and permissions

Catalog page

You can create a VirtualMachine by selecting a template or boot source on the Catalog page.

Catalog page
Element Description

Template catalog tab

Select a template to create a VirtualMachine from.

Template catalog tab

Details
Element Description

Template project list

Select the project in which your templates are located.

By default, Red Hat templates are stored in the openshift project. You can edit the template project on the Overview → Settings → Template project tab.

All items|Default templates

Click Default templates to display only default templates.

Boot source available checkbox

Select the checkbox to display templates with an available boot source.

Operating system checkboxes

Select checkboxes to display templates with selected operating systems.

Workload checkboxes

Select checkboxes to display templates with selected workloads.

Search field

Search templates by keyword.

Template tiles

Click a template tile to view template details and to create a VirtualMachine.

VirtualMachines page

You can create and manage VirtualMachines on the VirtualMachines page.

VirtualMachines page
Element Description

Create → From template

Create a VirtualMachine on the Catalog page → Template catalog tab.

Create → From YAML

Create a VirtualMachine by editing a YAML configuration file.

Filter field

Filter VirtualMachines by status, template, operating system, or node.

Search field

Search for VirtualMachines by name or by label.

VirtualMachines table

List of VirtualMachines

Click the Options menu kebab beside a VirtualMachine to select Stop, Restart, Pause, Clone, Migrate, Copy SSH command, Edit labels, Edit annotations, or Delete.

Click a VirtualMachine to navigate to the VirtualMachine details page.

VirtualMachine details page

You can configure a VirtualMachine on the VirtualMachine details page.

VirtualMachine details page
Element Description

Actions menu

Click the Actions menu to select Stop, Restart, Pause, Clone, Migrate, Copy SSH command, Edit labels, Edit annotations, or Delete.

Overview tab

Resource usage, alerts, disks, and devices

Details tab

VirtualMachine details and configurations

Metrics tab

Memory, CPU, storage, network, and migration metrics

YAML tab

VirtualMachine YAML configuration file

Configuration tab

Contains the Scheduling, Environment, Network interfaces, Disks, and Scripts tabs

ConfigurationScheduling tab

Scheduling a VirtualMachine to run on specific nodes

ConfigurationEnvironment tab

Config map, secret, and service account management

ConfigurationNetwork interfaces tab

Network interfaces

ConfigurationDisks tab

Disks

ConfigurationScripts tab

Cloud-init settings, SSH key for Linux VirtualMachines, Sysprep answer file for Windows VirtualMachines

Events tab

VirtualMachine event stream

Console tab

Console session management

Snapshots tab

Snapshot management

Diagnostics tab

Status conditions and volume snapshot status

Overview tab

The Overview tab displays resource usage, alerts, and configuration information.

Overview tab
Element Description

Details tile

General VirtualMachine information

Utilization tile

CPU, Memory, Storage, and Network transfer charts. By default, Network transfer displays the sum of all networks. To view the breakdown for a specific network, click Breakdown by network.

Hardware devices tile

GPU and host devices

Alerts tile

OpenShift Virtualization alerts, grouped by severity

Snapshots tile

Take snapshot icon link and Snapshots table

Network interfaces tile

Network interfaces table

Disks tile

Disks table

Details tab

You can view information about the VirtualMachine and edit labels, annotations, and other metadata and on the Details tab.

Details tab
Element Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Name

VirtualMachine name

Namespace

VirtualMachine namespace

Labels

Click the edit icon to edit the labels.

Annotations

Click the edit icon to edit the annotations.

Description

Click the edit icon to enter a description.

Operating system

Operating system name

CPU|Memory

Click the edit icon to edit the CPU|Memory request.

The number of CPUs is calculated by using the following formula: sockets * threads * cores.

Machine type

VirtualMachine machine type

Boot mode

Click the edit icon to edit the boot mode.

Start in pause mode

Click the edit icon to enable this setting.

Template

Name of the template used to create the VirtualMachine

Created at

VirtualMachine creation date

Owner

VirtualMachine owner

Status

VirtualMachine status

Pod

virt-launcher pod name

VirtualMachineInstance

VirtualMachineInstance name

Boot order

Click the edit icon to select a boot source.

IP address

IP address of the VirtualMachine

Hostname

Hostname of the VirtualMachine

Time zone

Time zone of the VirtualMachine

Node

Node on which the VirtualMachine is running

Workload profile

Click the edit icon to edit the workload profile.

SSH using virtctl

Click the copy icon to copy the virtctl ssh command to the clipboard.

SSH service type options

Select SSH over LoadBalancer or SSH over NodePort.

GPU devices

Click the edit icon to add a GPU device.

Host devices

Click the edit icon to add a host device.

Headless mode

Click the edit icon to enable headless mode.

Services section

Displays services if QEMU guest agent is installed.

Active users section

Displays active users if QEMU guest agent is installed.

Metrics tab

The Metrics tab displays memory, CPU, storage, network, and migration usage charts.

Metrics tab
Element Description

Time range list

Select a time range to filter the results.

Virtualization dashboard icon link

Link to the Workloads tab of the current project

Utilization section

Memory and CPU charts

Storage section

Storage total read/write and Storage IOPS total read/write charts

Network section

Network in, Network out, Network bandwidth, and Network interface charts. Select All networks or a specific network from the Network interface dropdown.

Migration section

Migration and KV data transfer rate charts

YAML tab

You can configure the VirtualMachine by editing the YAML file on the YAML tab.

YAML tab
Element Description

Save button

Save changes to the YAML file.

Reload button

Discard your changes and reload the YAML file.

Cancel button

Exit the YAML tab.

Download button

Download the YAML file to your local machine.

Configuration tab

You can configure scheduling, network interfaces, disks, and other options on the Configuration tab.

Tabs on the Configuration tab
Tab Description

Scheduling tab

Scheduling a VirtualMachine to run on specific nodes

Environment tab

Config maps, secrets, and service accounts

Network interfaces tab

Network interfaces

Disks tab

Disks

Scripts tab

Cloud-init settings, SSH key for Linux VirtualMachines, Sysprep answer file for Windows VirtualMachines

Scheduling tab

You can configure VirtualMachines to run on specific nodes on the Scheduling tab.

Scheduling tab
Setting Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Node selector

Click the edit icon to add a label to specify qualifying nodes.

Tolerations

Click the edit icon to add a toleration to specify qualifying nodes.

Affinity rules

Click the edit icon to add an affinity rule.

Descheduler switch

Enable or disable the descheduler. The descheduler evicts a running pod so that the pod can be rescheduled onto a more suitable node.

Dedicated resources

Click the edit icon to select Schedule this workload with dedicated resources (guaranteed policy).

Eviction strategy

Click the edit icon to select LiveMigrate as the VirtualMachineInstance eviction strategy.

Environment tab

You can manage config maps, secrets, and service accounts on the Environment tab.

Environment tab
Element Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Add Config Map, Secret or Service Account icon link

Click the link and select a config map, secret, or service account from the resource list.

Network interfaces tab

You can manage network interfaces on the Network interfaces tab.

Network interfaces tab
Setting Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Add network interface button

Add a network interface to the VirtualMachine.

Filter field

Filter by interface type.

Search field

Search for a network interface by name or by label.

Network interface table

List of network interfaces

Click the Options menu kebab beside a network interface to select Edit or Delete.

Disks tab

You can manage disks on the Disks tab.

Disks tab
Setting Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Add disk button

Add a disk to the VirtualMachine.

Filter field

Filter by disk type.

Search field

Search for a disk by name.

Mount Windows drivers disk checkbox

Select to mount an ephemeral container disk as a CD-ROM.

Disks table

List of VirtualMachine disks

Click the Options menu kebab beside a disk to select Edit, Detach, or Make persistent.

File systems table

List of VirtualMachine file systems if QEMU guest agent is installed

Scripts tab

You can configure cloud-init, add an SSH key for a Linux VirtualMachine, and upload a Sysprep answer file for a Windows VirtualMachine on the Scripts tab.

Scripts tab
Element Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Cloud-init

Click the edit icon to edit the cloud-init settings.

Authorized SSH Key

Click the edit icon to create a new secret or to attach an existing secret.

Sysprep

Click the edit icon to upload an Autounattend.xml or Unattend.xml answer file to automate Windows VirtualMachine setup.

Events tab

The Events tab displays a list of VirtualMachine events.

Console tab

You can open a console session to the VirtualMachine on the Console tab.

Console tab
Element Description

Guest login credentials section

Expand Guest login credentials to view the credentials created with cloud-init. Click the copy icon to copy the credentials to the clipboard.

Console list

Select VNC console or Serial console.

You can select Desktop viewer to connect to Windows VirtualMachines by using Remote Desktop Protocol (RDP). You must install an RDP client on a machine on the same network.

Send key list

Select a key-stroke combination to send to the console.

Disconnect button

Disconnect the console connection.

You must manually disconnect the console connection if you open a new console session. Otherwise, the first console session continues to run in the background.

Paste button

You can paste a string from your client’s clipboard into the guest when using the VNC console.

Snapshots tab

You can create snapshots and restore VirtualMachines from snapshots on the Snapshots tab.

Snapshots tab
Element Description

Take snapshot button

Create a snapshot.

Filter field

Filter snapshots by status.

Search field

Search for snapshots by name or by label.

Snapshot table

List of snapshots

Click the snapshot name to edit the labels or annotations.

Click the Options menu kebab beside a snapshot to select Restore or Delete.

Diagnostics tab

You can view the status conditions and volume snapshot status on the Diagnostics tab.

Diagnostics tab
Element Description

Status conditions table

Display a list of conditions that are reported for all aspects of a VM.

Filter field

Filter status conditions by category and condition.

Search field

Search status conditions by reason.

Manage columns icon

Select columns to display.

Volume snapshot table

List of volumes, their snapshot enablement status, and reason

Templates page

You can create, edit, and clone VirtualMachine templates on the Templates page.

You cannot edit a Red Hat template. You can clone a Red Hat template and edit it to create a custom template.

Templates page
Element Description

Create Template button

Create a template by editing a YAML configuration file.

Filter field

Filter templates by type, boot source, template provider, or operating system.

Search field

Search for templates by name or by label.

Templates table

List of templates

Click the Options menu kebab beside a template to select Edit, Clone, Edit boot source, Edit boot source reference, Edit labels, Edit annotations, or Delete.

Template details page

You can view template settings and edit custom templates on the Template details page.

Template details page
Element Description

Actions menu

Click the Actions menu to select Edit, Clone, Edit boot source, Edit boot source reference, Edit labels, Edit annotations, or Delete.

Details tab

Template settings and configurations

YAML tab

YAML configuration file

Scheduling tab

Scheduling configurations

Network interfaces tab

Network interface management

Disks tab

Disk management

Scripts tab

Cloud-init, SSH key, and Sysprep management

Parameters tab

Parameters

Details tab

You can configure a custom template on the Details tab.

Details tab
Element Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Name

Template name

Namespace

Template namespace

Labels

Click the edit icon to edit the labels.

Annotations

Click the edit icon to edit the annotations.

Display name

Click the edit icon to edit the display name.

Description

Click the edit icon to enter a description.

Operating system

Operating system name

CPU|Memory

Click the edit icon to edit the CPU|Memory request.

The number of CPUs is calculated by using the following formula: sockets * threads * cores.

Machine type

Template machine type

Boot mode

Click the edit icon to edit the boot mode.

Base template

Name of the base template used to create this template

Created at

Template creation date

Owner

Template owner

Boot order

Template boot order

Boot source

Boot source availability

Provider

Template provider

Support

Template support level

GPU devices

Click the edit icon to add a GPU device.

Host devices

Click the edit icon to add a host device.

YAML tab

You can configure a custom template by editing the YAML file on the YAML tab.

YAML tab
Element Description

Save button

Save changes to the YAML file.

Reload button

Discard your changes and reload the YAML file.

Cancel button

Exit the YAML tab.

Download button

Download the YAML file to your local machine.

Scheduling tab

You can configure scheduling on the Scheduling tab.

Scheduling tab
Setting Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Node selector

Click the edit icon to add a label to specify qualifying nodes.

Tolerations

Click the edit icon to add a toleration to specify qualifying nodes.

Affinity rules

Click the edit icon to add an affinity rule.

Descheduler switch

Enable or disable the descheduler. The descheduler evicts a running pod so that the pod can be rescheduled onto a more suitable node.

Dedicated resources

Click the edit icon to select Schedule this workload with dedicated resources (guaranteed policy).

Eviction strategy

Click the edit icon to select LiveMigrate as the VirtualMachineInstance eviction strategy.

Network interfaces tab

You can manage network interfaces on the Network interfaces tab.

Network interfaces tab
Setting Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Add network interface button

Add a network interface to the template.

Filter field

Filter by interface type.

Search field

Search for a network interface by name or by label.

Network interface table

List of network interfaces

Click the Options menu kebab beside a network interface to select Edit or Delete.

Disks tab

You can manage disks on the Disks tab.

Disks tab
Setting Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Add disk button

Add a disk to the template.

Filter field

Filter by disk type.

Search field

Search for a disk by name.

Disks table

List of template disks

Click the Options menu kebab beside a disk to select Edit or Detach.

Scripts tab

You can manage the cloud-init settings, SSH keys, and Sysprep answer files on the Scripts tab.

Scripts tab
Element Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

Cloud-init

Click the edit icon to edit the cloud-init settings.

Authorized SSH Key

Click the edit icon to create a new secret or to attach an existing secret.

Sysprep

Click the edit icon to upload an Autounattend.xml or Unattend.xml answer file to automate Windows VirtualMachine setup.

Parameters tab

You can edit selected template settings on the Parameters tab.

Parameters tab
Element Description

YAML switch

Set to ON to view your live changes in the YAML configuration file.

VM name

Select Generated (expression) for a generated value, Value to set a default value, or None from the Default value type list.

DataSource name

Select Generated (expression) for a generated value, Value to set a default value, or None from the Default value type list.

DataSource namespace

Select Generated (expression) for a generated value, Value to set a default value, or None from the Default value type list.

Cloud user password

Select Generated (expression) for a generated value, Value to set a default value, or None from the Default value type list.

DataSources page

You can create and configure DataSources for VirtualMachine boot sources on the DataSources page.

When you create a DataSource, a DataImportCron resource defines a cron job to poll and import the disk image unless you disable automatic boot source updates.

DataSources page
Element Description

Create DataSource → With form

Create a DataSource by entering the registry URL, disk size, number of revisions, and cron expression in a form.

Create DataSources → With YAML

Create a DataSource by editing a YAML configuration file.

Filter field

Filter DataSources by attributes such as DataImportCron available.

Search field

Search for a DataSource by name or by label.

DataSources table

List of DataSources

Click the Options menu kebab beside a DataSource to select Edit labels, Edit annotations, or Delete.

Click a DataSource to view the DataSource details page.

DataSource details page

You can configure a DataSource on the DataSource details page.

DataSource details page
Element Description

Details tab

Configure a DataSource by editing a form.

YAML tab

Configure a DataSource by editing a YAML configuration file.

Actions menu

Select Edit labels, Edit annotations, Delete, or Manage source.

Name

DataSource name

Namespace

DataSource namespace

DataImportCron

DataSource DataImportCron

Labels

Click the edit icon to edit the labels.

Annotations

Click the edit icon to edit the annotations.

Conditions

Displays the status conditions of the DataSource.

Created at

DataSource creation date

Owner

DataSource owner

MigrationPolicies page

You can manage MigrationPolicies for your workloads on the MigrationPolicies page.

MigrationPolicies page
Element Description

Create MigrationPolicy → With form

Create a MigrationPolicy by entering configurations and labels in a form.

Create MigrationPolicy → With YAML

Create a MigrationPolicy by editing a YAML configuration file.

Name | Label search field

Search for a MigrationPolicy by name or by label.

MigrationPolicies table

List of MigrationPolicies

Click the Options menu kebab beside a MigrationPolicy to select Edit or Delete.

Click a MigrationPolicy to view the MigrationPolicy details page.

MigrationPolicy details page

You can configure a MigrationPolicy on the MigrationPolicy details page.

MigrationPolicy details page
Element Description

Details tab

Configure a MigrationPolicy by editing a form.

YAML tab

Configure a MigrationPolicy by editing a YAML configuration file.

Actions menu

Select Edit or Delete.

Name

MigrationPolicy name

Description

MigrationPolicy description

Configurations

Click the edit icon to update the MigrationPolicy configurations.

Bandwidth per migration

Bandwidth request per migration. For unlimited bandwidth, set the value to 0.

Auto converge

Auto converge policy

Post-copy

Post-copy policy

Completion timeout

Completion timeout value in seconds

Project labels

Click Edit to edit the project labels.

VirtualMachine labels

Click Edit to edit the VirtualMachine labels.