Skip to content

Commit af669d6

Browse files
lmandavilmandavi
committed
This is a combination of 3 commits.
This is a combination of 3 commits. This is a combination of 13 commits. CNV-3703 modules CNV-3703 topic map CNV-3703-VMIS modules CNV-3703-VMIS about module CNV-3703-VMIS modules CNV-3703 SME review CNV-3703 delete unused content QE review inputs QE review input QE review input UI and QE review edit labels Peer Review peer review peer review peer review input peer review
1 parent 94c49e4 commit af669d6

12 files changed

+144
-63
lines changed

‎_topic_map.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1514,8 +1514,8 @@ Topics:
15141514
File: virt-edit-boot-order
15151515
- Name: Deleting virtual machines
15161516
File: virt-delete-vms
1517-
- Name: Deleting virtual machine instances
1518-
File: virt-deleting-vmis
1517+
- Name: Managing virtual machine instances
1518+
File: virt-manage-vmis
15191519
- Name: Controlling virtual machines states
15201520
File: virt-controlling-vm-states
15211521
- 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)