xCAT/xcat-core
2
0
Fork 0
mirror of https://github.com/xcat2/xcat-core.git synced 2025-05-22 11:42:05 +00:00
Code Issues Releases Wiki Activity

Fix spelling and formatting in manage_vm doc

Browse Source
This commit is contained in:
Mark Gurevich 2019-08-29 09:48:27 -04:00
parent 46e181fdd0
commit 910261fb62
1 changed files with 12 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/source/guides/admin-guides/manage_clusters/common/kvm/manage_vm.rst
View File

@ -1,5 +1,5 @@
Manage Virtual Machine (VM)
============================
===========================
Now the PowerKVM hypervisor "kvmhost1" is ready, this section introduces the VM management in xCAT, including examples on how to create, remove and clone VMs.
@ -41,8 +41,6 @@ After the VM object is created, several key attributes need to be specified with
chdef vm1 vmmemory=2048
**Note**: For diskless node, the **vmmemory** should be at least 2048 MB, otherwise the node cannot boot up.
5. Define the virtual network card, it should be set to the bridge "br0" which has been created in the hypervisor. If no bridge is specified, no network device will be created for the VM node "vm1": ::
chdef vm1 vmnics=br0
@ -62,27 +60,27 @@ After the VM object is created, several key attributes need to be specified with
B. Create storage on a device of hypervisor
The format is 'phy:/dev/sdb1': ::
The format is ``phy:/dev/sdb1``: ::
chdef vm1 vmstorage=phy:/dev/sdb1
C. Create storage on a directory of hypervisor
The format is 'dir:///var/lib/libvirt/images': ::
The format is ``dir:///var/lib/libvirt/images``: ::
chdef vm1 vmstorage=dir:///var/lib/libvirt/images
**Note**: The attribute **vmstorage** is only valid for diskful VM node.
.. note:: The attribute **vmstorage** is only valid for diskful VM node.
8. Define the **console** attributes for VM: ::
chdef vm1 serialport=0 serialspeed=115200
9. (optional)For monitoring and access the VM with vnc client, set **vidpassword** value: ::
9. (Optional) For monitoring and access the VM with vnc client, set **vidpassword** value: ::
chtab node=vm1 vm.vidpassword=abc123
10. (optional)For assigning PCI devices to the VM, set **othersettings** value: ::
10. (Optional) For assigning PCI devices to the VM, set **othersettings** value: ::
chtab node=vm1 vm.othersettings="devpassthrough:0000:01:00.2"
@ -133,7 +131,7 @@ When "vm1" is created successfully, a VM hard disk file with a name like "vm1.sd
lsdef vm1 -i mac
Now a VM "vm1" is created, it can be provisioned like any other nodes in xCAT. The VM node can be powered on by: ::
Once a VM "vm1" is created, it can be provisioned like any other node in xCAT. The VM node can be powered on by: ::
rpower vm1 on
@ -164,9 +162,9 @@ When the VM has been created and powered on, choose one of the following methods
makegocons vm1
rcons vm1
* Connect to virtual machine through vnc console
* Connect to virtual machine through ``vnc`` console
In order to connect the virtual machine's vnc server, a new set of credentials need to be generated by running: ::
In order to connect the virtual machine's ``vnc`` server, a new set of credentials need to be generated by running: ::
xcatclient getrvidparms vm1
vm1: method: kvm
@ -176,10 +174,10 @@ When the VM has been created and powered on, choose one of the following methods
vm1: server: kvmhost1
vm1: vidport: 5900
**Note**: Now just pick a favorite vnc client to connect the hypervisor, with the password generated by ``getrvidparms``. If the vnc client complains "the password is not valid", the reason might be that the hypervisor and headnode clocks are out of sync! Please try to sync them by running ``ntpdate <ntp server>`` on both the hypervisor and the headnode.
.. note:: Now just pick a favorite ``vnc`` client to connect the hypervisor, with the password generated by ``getrvidparms``. If the ``vnc`` client complains "the password is not valid", the reason might be that the hypervisor and headnode clocks are out of sync! Please try to sync them by running ``ntpdate <ntp server>`` on both the hypervisor and the headnode.
* Use wvid on management node
* Use ``wvid`` on management node
Make sure **firewalld** service is stopped, disable it if not: ::
@ -214,7 +212,7 @@ Clone the virtual machine
**Clone** is an operation that creating a VM from an existed one by inheriting most of its attributes and data.
The general step of **clone** a VM is like this: first creating a **VM master** , then creating a VM with the newly created **VM master** in **attaching** or **detaching** mode.
Steps to **clone** a VM: first create a **VM master** , then create a VM with the newly created **VM master** in **attaching** or **detaching** mode.
**In attaching mode**