nerc-project · Milstein · May 9, 2025 · May 9, 2025 · May 9, 2025 · May 10, 2025
diff --git a/docs/openshift/index.md b/docs/openshift/index.md
@@ -57,6 +57,18 @@ the list below.
 
 - [Deleting your applications](applications/deleting-applications.md)
 
+## Virtualization on OpenShift
+
+-   [Introduction](virtualization/intro-virtualization-on-openshift.md)
+
+-   [Getting Started](virtualization/getting-started.md)
+
+-   [Running and Managing VMs](virtualization/running-and-managing-vms.md)
+
+-   [Setting up Windows VM](virtualization/windows-vm.md)
+
+-   [Storage](virtualization/storage.md)
+
 ## Decommission OpenShift Resources
 
 - [Decommission OpenShift Resources](decommission/decommission-openshift-resources.md)

diff --git a/docs/openshift/virtualization/getting-started.md b/docs/openshift/virtualization/getting-started.md
@@ -0,0 +1,75 @@
+# Getting Started
+
+## Quick Getting Started Tour
+
+You can start exploring OpenShift Virtualization by taking tours in the OpenShift
+Container Platform web console.
+
+1. Go to the [NERC's OpenShift Web Console](https://console.apps.shift.nerc.mghpcc.org).
+
+2. Click on the **Perspective Switcher** drop-down menu and select **Virtualization**
+as shown below:
+
+    ![Virtualization Perspective](images/virtualization-perspective.png)  
+
+    This short guided tour introduces several key aspects of using OpenShift Virtualization.
+
+    There are **two ways** to start the tour:
+
+    On the **Welcome to OpenShift Virtualization** dialog, click **Start Tour** as
+    shown below:
+
+    ![OpenShift Virtualization Dialog](images/openshift-virtualization-dialog.png)
+
+    **Or,**
+
+    Go to **Virtualization** > **Overview** > **Settings** > **User** >
+    **Getting started resources** and click **Guided tour**.
+
+## Setting Up Your Environment
+
+The `virtctl` client is a command-line utility designed for managing OpenShift
+Virtualization resources. To install the `virtctl` command-line interface (CLI)
+tool, please follow the instructions in [this documentation](https://docs.redhat.com/en/documentation/openshift_container_platform/4.18/html/virtualization/getting-started#installing-virtctl_virt-using-the-cli-tools).
+
+You can utilize `virtctl` information commands to perform various operations, as
+outlined [here](https://docs.redhat.com/en/documentation/openshift_container_platform/4.18/html/virtualization/getting-started#virt-virtctl-commands_virt-using-the-cli-tools).
+
+!!! note "Note"
+
+    The virtual machine (VM) commands also apply to virtual machine instances (VMIs)
+    unless otherwise specified.
+
+## Set Up a Public SSH Key
+
+Before creating a virtual machine, we recommend that you configure the public SSH
+key to your project. It will be saved in the project as a secret. You can configure
+the public SSH key at a later time, but this is the easiest way.
+
+For a Linux-based volume, follow these steps to configure SSH:
+
+i. If you have not already added a public SSH key to your project, click the edit
+icon beside **Authorized SSH key** in the **VirtualMachine details** section.
+
+ii. Select one of the following options:
+
+-   **Use existing**: Select a secret from the secrets list.
+
+-   **Add new**: Follow these steps:
+
+    i. Browse to the public SSH key file or paste the file in the key field.
+
+    ![Configure Public SSH Key](images/configure_SSH.png)
+
+    !!! tips "Creating SSH Key Pair"
+
+        You can generate an SSH key pair by running the `ssh-keygen` command.
+
+    ii. Enter the secret name.
+
+    iii. Optional: Select **Automatically apply this key to any new VirtualMachine
+    you create in this project**.
+
+iii. Click **Save**.
+
+---
diff --git a/docs/openshift/virtualization/images/VM_Actions_List_Stopped.png b/docs/openshift/virtualization/images/VM_Actions_List_Stopped.png
diff --git a/docs/openshift/virtualization/images/actions-icon-bar.png b/docs/openshift/virtualization/images/actions-icon-bar.png
diff --git a/docs/openshift/virtualization/images/add-boot-volume.png b/docs/openshift/virtualization/images/add-boot-volume.png
diff --git a/docs/openshift/virtualization/images/add-disk.png b/docs/openshift/virtualization/images/add-disk.png
diff --git a/docs/openshift/virtualization/images/available-storageclasses.png b/docs/openshift/virtualization/images/available-storageclasses.png
diff --git a/docs/openshift/virtualization/images/bootable-os-pvcs.png b/docs/openshift/virtualization/images/bootable-os-pvcs.png
diff --git a/docs/openshift/virtualization/images/catalog-instancetypes.png b/docs/openshift/virtualization/images/catalog-instancetypes.png
diff --git a/docs/openshift/virtualization/images/clone-vm-dialog.png b/docs/openshift/virtualization/images/clone-vm-dialog.png
diff --git a/docs/openshift/virtualization/images/cloud-init-dialog.png b/docs/openshift/virtualization/images/cloud-init-dialog.png
diff --git a/docs/openshift/virtualization/images/cloud-init-user-data.png b/docs/openshift/virtualization/images/cloud-init-user-data.png
diff --git a/docs/openshift/virtualization/images/configure_SSH.png b/docs/openshift/virtualization/images/configure_SSH.png
diff --git a/docs/openshift/virtualization/images/console-vm-vnc-connect.png b/docs/openshift/virtualization/images/console-vm-vnc-connect.png
diff --git a/docs/openshift/virtualization/images/containerizing-kvm.png b/docs/openshift/virtualization/images/containerizing-kvm.png
diff --git a/docs/openshift/virtualization/images/cpu-and-mem.png b/docs/openshift/virtualization/images/cpu-and-mem.png
diff --git a/docs/openshift/virtualization/images/create-pvc-form.png b/docs/openshift/virtualization/images/create-pvc-form.png
diff --git a/docs/openshift/virtualization/images/create-pvc-with-data-upload-form.png b/docs/openshift/virtualization/images/create-pvc-with-data-upload-form.png
diff --git a/docs/openshift/virtualization/images/create-pvc-with-form.png b/docs/openshift/virtualization/images/create-pvc-with-form.png
diff --git a/docs/openshift/virtualization/images/create-snapshot-actions.png b/docs/openshift/virtualization/images/create-snapshot-actions.png
diff --git a/docs/openshift/virtualization/images/create-vm-instancetype.png b/docs/openshift/virtualization/images/create-vm-instancetype.png
diff --git a/docs/openshift/virtualization/images/create-vm-popup.png b/docs/openshift/virtualization/images/create-vm-popup.png
diff --git a/docs/openshift/virtualization/images/create-vm-with-yaml.png b/docs/openshift/virtualization/images/create-vm-with-yaml.png
diff --git a/docs/openshift/virtualization/images/custom-template-example.png b/docs/openshift/virtualization/images/custom-template-example.png
diff --git a/docs/openshift/virtualization/images/customize-disks-tab.png b/docs/openshift/virtualization/images/customize-disks-tab.png
diff --git a/docs/openshift/virtualization/images/customize-networking-interfaces-tab.png b/docs/openshift/virtualization/images/customize-networking-interfaces-tab.png
diff --git a/docs/openshift/virtualization/images/customize-scheduling-tab.png b/docs/openshift/virtualization/images/customize-scheduling-tab.png
diff --git a/docs/openshift/virtualization/images/customize-scripts-tab.png b/docs/openshift/virtualization/images/customize-scripts-tab.png
diff --git a/docs/openshift/virtualization/images/customize_parameters.png b/docs/openshift/virtualization/images/customize_parameters.png
diff --git a/docs/openshift/virtualization/images/dynamic-ssh-key-injection.png b/docs/openshift/virtualization/images/dynamic-ssh-key-injection.png
diff --git a/docs/openshift/virtualization/images/edit-disk.png b/docs/openshift/virtualization/images/edit-disk.png
diff --git a/docs/openshift/virtualization/images/edit-instancetype.png b/docs/openshift/virtualization/images/edit-instancetype.png
diff --git a/docs/openshift/virtualization/images/edit-labels-and-annotations.png b/docs/openshift/virtualization/images/edit-labels-and-annotations.png
diff --git a/docs/openshift/virtualization/images/edit-network-interface-dialog.png b/docs/openshift/virtualization/images/edit-network-interface-dialog.png
diff --git a/docs/openshift/virtualization/images/edit-network-interfaces.png b/docs/openshift/virtualization/images/edit-network-interfaces.png
diff --git a/docs/openshift/virtualization/images/empty-volume-list.png b/docs/openshift/virtualization/images/empty-volume-list.png
diff --git a/docs/openshift/virtualization/images/ensure-start-vm-after-creation.png b/docs/openshift/virtualization/images/ensure-start-vm-after-creation.png
diff --git a/docs/openshift/virtualization/images/events-tab.png b/docs/openshift/virtualization/images/events-tab.png
diff --git a/docs/openshift/virtualization/images/fedora-pvc.png b/docs/openshift/virtualization/images/fedora-pvc.png
diff --git a/docs/openshift/virtualization/images/from-template.png b/docs/openshift/virtualization/images/from-template.png
diff --git a/docs/openshift/virtualization/images/guest-login-vnc-console.png b/docs/openshift/virtualization/images/guest-login-vnc-console.png
diff --git a/docs/openshift/virtualization/images/ip-interfaces.png b/docs/openshift/virtualization/images/ip-interfaces.png
diff --git a/docs/openshift/virtualization/images/lsblk-command.png b/docs/openshift/virtualization/images/lsblk-command.png
diff --git a/docs/openshift/virtualization/images/metrics-tab.png b/docs/openshift/virtualization/images/metrics-tab.png
diff --git a/docs/openshift/virtualization/images/openshift-virtualization-dialog.png b/docs/openshift/virtualization/images/openshift-virtualization-dialog.png
diff --git a/docs/openshift/virtualization/images/openshift-virtualization.png b/docs/openshift/virtualization/images/openshift-virtualization.png
diff --git a/docs/openshift/virtualization/images/overview-tab.png b/docs/openshift/virtualization/images/overview-tab.png
diff --git a/docs/openshift/virtualization/images/paused-vm.png b/docs/openshift/virtualization/images/paused-vm.png
diff --git a/docs/openshift/virtualization/images/provision_with_custom_template.png b/docs/openshift/virtualization/images/provision_with_custom_template.png
diff --git a/docs/openshift/virtualization/images/remove.png b/docs/openshift/virtualization/images/remove.png
diff --git a/docs/openshift/virtualization/images/remove2.png b/docs/openshift/virtualization/images/remove2.png
diff --git a/docs/openshift/virtualization/images/restore-snapshot-actions.png b/docs/openshift/virtualization/images/restore-snapshot-actions.png
diff --git a/docs/openshift/virtualization/images/restore-snapshot-dialog.png b/docs/openshift/virtualization/images/restore-snapshot-dialog.png
diff --git a/docs/openshift/virtualization/images/restore-snapshot-not-available.png b/docs/openshift/virtualization/images/restore-snapshot-not-available.png
diff --git a/docs/openshift/virtualization/images/restored-vm-from-snapshot.png b/docs/openshift/virtualization/images/restored-vm-from-snapshot.png
diff --git a/docs/openshift/virtualization/images/rh-openshift-virt-storage-stack.png b/docs/openshift/virtualization/images/rh-openshift-virt-storage-stack.png
diff --git a/docs/openshift/virtualization/images/save-snapshot.png b/docs/openshift/virtualization/images/save-snapshot.png
diff --git a/docs/openshift/virtualization/images/select_project.png b/docs/openshift/virtualization/images/select_project.png
diff --git a/docs/openshift/virtualization/images/snapshot-operation-complete.png b/docs/openshift/virtualization/images/snapshot-operation-complete.png
diff --git a/docs/openshift/virtualization/images/source-available-template.png b/docs/openshift/virtualization/images/source-available-template.png
diff --git a/docs/openshift/virtualization/images/start-vm.png b/docs/openshift/virtualization/images/start-vm.png
diff --git a/docs/openshift/virtualization/images/stopped-vm.png b/docs/openshift/virtualization/images/stopped-vm.png
diff --git a/docs/openshift/virtualization/images/storage-managment.png b/docs/openshift/virtualization/images/storage-managment.png
diff --git a/docs/openshift/virtualization/images/sysprep-autoattend-available.png b/docs/openshift/virtualization/images/sysprep-autoattend-available.png
diff --git a/docs/openshift/virtualization/images/sysprep-dialog.png b/docs/openshift/virtualization/images/sysprep-dialog.png
diff --git a/docs/openshift/virtualization/images/take-snapshot-of-vm.png b/docs/openshift/virtualization/images/take-snapshot-of-vm.png
diff --git a/docs/openshift/virtualization/images/take-snapshot-vm-action.png b/docs/openshift/virtualization/images/take-snapshot-vm-action.png
diff --git a/docs/openshift/virtualization/images/template-catalog-boot-source-available.png b/docs/openshift/virtualization/images/template-catalog-boot-source-available.png
diff --git a/docs/openshift/virtualization/images/template-info.png b/docs/openshift/virtualization/images/template-info.png
diff --git a/docs/openshift/virtualization/images/update-vm-configs.png b/docs/openshift/virtualization/images/update-vm-configs.png
diff --git a/docs/openshift/virtualization/images/upload-data-to-pvc-form.png b/docs/openshift/virtualization/images/upload-data-to-pvc-form.png
diff --git a/docs/openshift/virtualization/images/virt-icon.png b/docs/openshift/virtualization/images/virt-icon.png
diff --git a/docs/openshift/virtualization/images/virtualization-perspective.png b/docs/openshift/virtualization/images/virtualization-perspective.png
diff --git a/docs/openshift/virtualization/images/virtualmachines-list.png b/docs/openshift/virtualization/images/virtualmachines-list.png
diff --git a/docs/openshift/virtualization/images/vm-actions.png b/docs/openshift/virtualization/images/vm-actions.png
diff --git a/docs/openshift/virtualization/images/vm-console.png b/docs/openshift/virtualization/images/vm-console.png
diff --git a/docs/openshift/virtualization/images/vm-disks.png b/docs/openshift/virtualization/images/vm-disks.png
diff --git a/docs/openshift/virtualization/images/vm-from-instancetype.png b/docs/openshift/virtualization/images/vm-from-instancetype.png
diff --git a/docs/openshift/virtualization/images/vm-network-default.png b/docs/openshift/virtualization/images/vm-network-default.png
diff --git a/docs/openshift/virtualization/images/vm-restored-running.png b/docs/openshift/virtualization/images/vm-restored-running.png
diff --git a/docs/openshift/virtualization/images/vm-scripts-setup.png b/docs/openshift/virtualization/images/vm-scripts-setup.png
diff --git a/docs/openshift/virtualization/images/vm-state-actions.png b/docs/openshift/virtualization/images/vm-state-actions.png
diff --git a/docs/openshift/virtualization/images/vm-storage-disks.png b/docs/openshift/virtualization/images/vm-storage-disks.png
diff --git a/docs/openshift/virtualization/images/windows-templates.png b/docs/openshift/virtualization/images/windows-templates.png
diff --git a/docs/openshift/virtualization/images/yaml-tab.png b/docs/openshift/virtualization/images/yaml-tab.png
diff --git a/docs/openshift/virtualization/intro-virtualization-on-openshift.md b/docs/openshift/virtualization/intro-virtualization-on-openshift.md
@@ -0,0 +1,116 @@
+# Introduction to Virtualization on OpenShift
+
+This will provide an in-depth overview of OpenShift Virtualization, highlighting
+its benefits and key concepts.
+
+## Overview of OpenShift Virtualization
+
+Red Hat OpenShift Virtualization isn't entirely new - it's built on the upstream
+open source project [KubeVirt](https://kubevirt.io/). It is an add-on to Red Hat
+OpenShift that enables you to run virtualized workloads alongside your existing
+containerized workloads on the same infrastructure. As a built-in feature of the
+platform, OpenShift Virtualization offers a modern solution for organizations to
+run and deploy both new and existing VM workloads efficiently.
+
+While [OpenShift](../get-started/openshift-overview.md) was originally envisioned
+as a pure container and application development platform, it has since been
+extended with additional APIs and technical enhancements in the CoreOS operating
+system to support virtualization.
+
+OpenShift Virtualization is now a unified platform designed to seamlessly accommodate
+both containers and VMs. This allows users to integrate VMs into containerized
+workflows by running a VM within a container. You can manage VMs either exclusively
+or alongside containerized workloads on the same platform.
+
+Users seeking to leverage the [Kubernetes-native benefits](#benefits-of-using-red-hat-openshift-virtualization)
+of OpenShift Virtualization can modernize their infrastructure by migrating workloads
+from traditional servers-based platforms, such as [NERC OpenStack](../../openstack/index.md),
+to modern cloud-native NERC Red Hat OpenShift Virtualization. This transition
+enables organizations to maintain compatibility with existing VM-based workloads
+while benefiting from a unified platform that supports both containerized and VM
+workloads.
+
+This approach enables organizations to benefit from faster time-to-market and
+other advantages of these modern workflows - without needing to first redesign
+virtualized workloads as container-native applications.
+
+## Benefits of Using Red Hat OpenShift Virtualization
+
+By moving VMs from other platforms to Red Hat OpenShift, you can maximize the
+value of your existing virtualization investments while benefiting from cloud-native
+architectures, streamlined operations and management, and modern development approaches.
+
+![Red Hat OpenShift Virtualization](images/openshift-virtualization.png)
+
+- **Unified Platform**: Run and manage both containerized applications and VM
+workloads on a single Kubernetes-native platform.
+
+- **Operational Consistency**: Apply the same DevOps and GitOps practices across
+VMs and containers using familiar OpenShift tools and workflows.
+
+- **Cost Efficiency**: Reduce infrastructure overhead by consolidating workloads
+and eliminating the need for separate virtualization platforms.
+
+- **Seamless Migration**: Import, clone, and migrate existing VMs - including those
+from legacy virtualization environments like VMware - into OpenShift with minimal
+effort.
+
+- **Scalability & Automation**: Leverage Kubernetes-native scaling, scheduling,
+and automation features for VM workloads, just like with containers.
+
+- **Enhanced Developer Experience**: Provide developers with self-service access
+to VMs via OpenShift's UI, CLI, and APIs, integrated into their existing CI/CD
+pipelines.
+
+- **Improved Security and Governance**: Benefit from OpenShift's built-in RBAC,
+SELinux, and policy enforcement to secure both container and VM environments.
+
+- **Live Migration Support**: Migrate running VMs between nodes without downtime,
+improving availability during maintenance or scaling operations.
+
+- **Integrated Monitoring & Logging**: Use OpenShift's observability tools (e.g.,
+Prometheus, Grafana, Loki) to monitor and troubleshoot both VMs and container workloads.
+
+- **Future-Ready Infrastructure**: Modernize applications incrementally by running
+legacy VMs and cloud-native containers side by side, supporting gradual transitions.
+
+Looking for more information on the benefits of Red Hat OpenShift Virtualization?
+[Read this eBook to learn more](https://www.redhat.com/en/engage/15-reasons-adopt-openshift-virtualization-ebook).
+
+## Key Concepts and Terminology
+
+OpenShift Virtualization extends our NERC OpenShift Container Platform (OCP) cluster
+by introducing new objects through **Kubernetes custom resources**. These resources
+enable users to perform a wide range of virtualization tasks, including:
+
+-   Creating and managing Linux and Windows VMs
+
+-   Running pod and VM workloads side by side in the same NERC OCP cluster
+
+-   Connecting to VMs using various console and CLI tools
+
+-   Importing and cloning existing VMs
+
+-   Managing network interface controllers (NICs) and storage disks attached to VMs
+
+-   Performing live migrations of VMs between nodes
+
+!!! info "Note"
+
+    In OpenShift Virtualization, VMs are native Kubernetes objects that you can
+    manage by using the OCP web console or the command line. OpenShift Virtualization
+    is represented by the ![OpenShift Virtualization icon](images/virt-icon.png){ width="25" }
+    icon.
+
+At a high level, the following diagram illustrates the components of Red Hat
+OpenShift Virtualization in comparison to Red Hat Virtualization and Red Hat
+OpenStack Platform:
+
+![Containerizing KVM](images/containerizing-kvm.png)
+
+To learn more about Red Hat OpenShift Virtualization, please refer to the  
+[Red Hat OpenShift Virtualization FAQ](https://www.redhat.com/en/resources/openshift-virtualization-faq),
+the [Red Hat OpenShift Virtualization documentation page](https://docs.redhat.com/en/documentation/openshift_container_platform/4.18/html/virtualization/index),
+and the [Red Hat OpenShift Virtualization product page](https://www.redhat.com/en/technologies/cloud-computing/openshift/virtualization).
+
+---