Skip to content

Commit bfa6c56

Browse files
ousleypousleyp
authored
Merge pull request #22367 from lmandavi/CNV-3703-VMIS
CNV-3703 Virtual Machine Instances 4.5 Release
2 parents 1f53d6f + af669d6 commit bfa6c56

12 files changed

+144
-63
lines changed

‎_topic_map.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1517,8 +1517,8 @@ Topics:
15171517
File: virt-edit-boot-order
15181518
- Name: Deleting virtual machines
15191519
File: virt-delete-vms
1520-
- Name: Deleting virtual machine instances
1521-
File: virt-deleting-vmis
1520+
- Name: Managing virtual machine instances
1521+
File: virt-manage-vmis
15221522
- Name: Controlling virtual machines states
15231523
File: virt-controlling-vm-states
15241524
- Name: Accessing virtual machine consoles

‎modules/virt-about-vmis.adoc‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
// Module included in the following assembly:
2+
//
3+
// * virt/virtual_machines/virt-manage-vmis.adoc
4+
//
5+
6+
[id="virt-about-vmis_{context}"]
7+
= About virtual machine instances
8+
9+
A virtual machine instance (VMI) is a representation of a running virtual machine (VM). When a VMI is owned by a VM or by another object, you manage it through its owner in the web console or by using the `oc` command-line interface (CLI).
10+
11+
A standalone VMI is created and started independently with a script, through automation, or by using other methods in the CLI. In your environment, you might have standalone VMIs that were developed and started outside of the {VirtProductName} environment. You can continue to manage those standalone VMIs by using the CLI. You can also use the web console for specific tasks associated with standalone VMIs:
12+
13+
* List standalone VMIs and their details.
14+
15+
* Edit labels and annotations for a standalone VMI.
16+
17+
* Delete a standalone VMI.
18+
19+
When you delete a VM, the associated VMI is automatically deleted. You delete a standalone VMI directly because it is not owned by VMs or other objects.
20+
21+
[NOTE]
22+
====
23+
Before you uninstall {VirtProductName}, list and view the standalone VMIs by using the CLI or the web console. Then, delete any outstanding VMIs.
24+
====

‎modules/virt-deleting-vmi.adoc‎

Lines changed: 0 additions & 28 deletions
This file was deleted.

‎modules/virt-deleting-vmis-cli.adoc‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * virt/virtual_machines/virt-deleting-vmis-cli.adoc
4+
5+
[id="virt-deleting-vmis-cli_{context}"]
6+
7+
= Deleting a standalone virtual machine instance using the CLI
8+
9+
You can delete a standalone virtual machine instance (VMI) by using the `oc` command-line interface (CLI).
10+
11+
.Prerequisites
12+
13+
* Identify the name of the VMI that you want to delete.
14+
15+
.Procedure
16+
17+
* Delete the VMI by running the following command:
18+
+
19+
----
20+
$ oc delete vmi <vmi_name>
21+
----
22+
+

‎modules/virt-deleting-vmis-web.adoc‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * virt/virtual_machines/virt-manage-vmis.adoc
4+
5+
[id="virt-deleting-vmis-web_{context}"]
6+
= Deleting a standalone virtual machine instance using the web console
7+
8+
Delete a standalone virtual machine instance (VMI) from the web console.
9+
10+
.Procedure
11+
12+
. In the {product-title} web console, click *Workloads* -> *Virtualization* from the side menu.
13+
14+
. Click the &#8942; button of the standalone virtual machine instance (VMI) that you want to delete and select *Delete Virtual Machine Instance*.
15+
16+
** Alternatively, click the name of the standalone VMI. The *Virtual Machine Instance Overview* page displays.
17+
18+
. Select *Actions* -> *Delete Virtual Machine Instance*.
19+
20+
. In the confirmation pop-up window, click *Delete* to permanently delete the standalone VMI.

‎modules/virt-editing-vmis-web.adoc‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * virt/virtual_machines/virt-manage-vmis.adoc
4+
5+
[id="virt-editing-vmis-web_{context}"]
6+
= Editing a standalone virtual machine instance using the web console
7+
8+
You can edit annotations and labels for a standalone virtual machine instance (VMI) using the web console. Other items displayed in the *Details* page for a standalone VMI are not editable.
9+
10+
.Procedure
11+
12+
. Click *Workloads* -> *Virtualization* from the side menu. A list of virtual machines (VMs) and standalone VMIs displays.
13+
14+
. Click the name of a standalone VMI to open the *Virtual Machine Instance Overview* screen.
15+
16+
. Click the *Details* tab.
17+
18+
. Click the pencil icon that is located on the right side of *Annotations*.
19+
20+
. Make the relevant changes and click *Save*.
21+
22+
[NOTE]
23+
====
24+
To edit labels for a standalone VMI, click *Actions* and select *Edit Labels.* Make the relevant changes and click *Save*.
25+
====

‎modules/virt-listing-vmis-cli.adoc‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
2+
// Module included in the following assemblies:
3+
//
4+
// * virt/virtual_machines/virt-manage-vmis.adoc
5+
6+
[id="virt-listing-vmis-cli_{context}"]
7+
= Listing all virtual machine instances using the CLI
8+
9+
You can list all virtual machine instances (VMIs) in your cluster, including standalone VMIs and those owned by virtual machines, by using the `oc` command-line interface (CLI).
10+
11+
.Procedure
12+
13+
* List all VMIs by running the following command:
14+
+
15+
----
16+
$ oc get vmis
17+
----

‎modules/virt-listing-vmis-web.adoc‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
2+
// Module included in the following assemblies:
3+
//
4+
// * virt/virtual_machines/virt-manage-vmis-web.adoc
5+
6+
[id="virt-listing-vmis-web_{context}"]
7+
= Listing standalone virtual machine instances using the web console
8+
9+
Using the web console, you can list and view standalone virtual machine instances (VMIs) in your cluster that are not owned by virtual machines (VMs).
10+
11+
[NOTE]
12+
====
13+
VMIs that are owned by VMs or other objects are not displayed in the web console. The web console displays only standalone VMIs. If you want to list all VMIs in your cluster, you must use the CLI.
14+
====
15+
16+
17+
.Procedure
18+
19+
* Click *Workloads -> Virtualization* from the side menu. A list of VMs and standalone VMIs displays. You can identify standalone VMIs by the dark colored badges that display next to the virtual machine instance names.

‎modules/virt-listing-vmis.adoc‎

Lines changed: 0 additions & 18 deletions
This file was deleted.

‎virt/install/uninstalling-virt.adoc‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ xref:../../web_console/web-console.adoc#web-console-overview_web-console[web con
1111

1212
* You must have {VirtProductName} {VirtVersion} installed.
1313
* You must delete all xref:../../virt/virtual_machines/virt-delete-vms.adoc#virt-delete-vm-web_virt-delete-vms[virtual machines],
14-
xref:../../virt/virtual_machines/virt-deleting-vmis.adoc#virt-deleting-vmi_virt-deleting-vmis[virtual machine instances],
14+
xref:../../virt/virtual_machines/virt-manage-vmis.adoc#virt-deleting-vmis-cli_virt-manage-vmis[virtual machine instances],
1515
and xref:../../virt/virtual_machines/virtual_disks/virt-deleting-datavolumes.adoc#virt-deleting-dvs_virt-deleting-datavolumes[DataVolumes].
1616
+
1717
[IMPORTANT]

0 commit comments

Comments
 (0)