===== VMINFO =====

Base VM created. Specs of this are as follows

  * Name: centosbase
  * 1 vCPU
  * 1GB vRAM
  * 10GB vHDD
  * IPSET Used for install is 78.129.208.29

This machine is the base os to clone to other VMs. This when running can be accessed via the console when connected to HAL. I have created 3 users. These are darren, dave, and wayne. Auth keys copied from Skype, and other sources to allow them all to connect to this machine when turned on or copied to another target. No confirguration of the clined VMs due to ssh and user configuration completed on this machine.

To clone the above. Log in to vms it will take you to the default vms user directory. the following code will need to be run uder this user keeping the paths the same.

<code>
virt-clone --original centosbase -n (Insert New Name) -f /var/lib/libvirt/vms/images/(name of image).qcow2

</code>

==== Connecting To the VM Through The Host ====

The following code has been activated on the Host. This must not be removed or stopped.

<code>
sudo systemctl enable serial-getty@ttyS0.servicesudo systemctl enable serial-getty@ttyS0.service

</code>

There are a number of ways to connect to each VM either via the use of an external program like Putty directly or via the Hosts command Line interface using virsh. In order to do this via the command line. We first need to get the name of the box we would like to connect to.

So first login as vms user and change to its home directory. Next we will run the following command to get a list of VMs avaliable.

<code>
virsh list

</code>

This will give the following output showing each VM available.

<code>
Id    Name   State
----------------------------------------------------
 7     base-v2                        paused
 8     base-v3                        running

</code>

We will then need to connect to the VM required. Note: You can only connect to VMs that are in the running state.

<code>
virsh console (Name Goes Here), eg virsh console base-v3

</code>

==== Quick Reference ====

virsh command quick reference taken from the following page. [[https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/5/html/virtualization/chap-virtualization-managing_guests_with_virsh|https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/5/html/virtualization/chap-virtualization-managing_guests_with_virsh]]

The following tables provide a quick reference for all virsh command line options.

Guest management commands

^Command^Description|
|help|Prints basic help information.|
|list|Lists all guests.|
|dumpxml|Outputs the XML configuration file for the guest.|
|create|Creates a guest from an XML configuration file and starts the new guest.|
|start|Starts an inactive guest.|
|destroy|Forces a guest to stop.|
|define|Outputs an XML configuration file for a guest.|
|domid|Displays the guest's ID.|
|domuuid|Displays the guest's UUID.|
|dominfo|Displays guest information.|
|domname|Displays the guest's name.|
|domstate|Displays the state of a guest.|
|quit|Quits the interactive terminal.|
|reboot|Reboots a guest.|
|restore|Restores a previously saved guest stored in a file.|
|resume|Resumes a paused guest.|
|save|Save the present state of a guest to a file.|
|shutdown|Gracefully shuts down a guest.|
|suspend|Pauses a guest.|
|undefine|Deletes all files associated with a guest.|
|migrate|Migrates a guest to another host.|

The following virsh command options manage guest and hypervisor management options

^Command^Description|
|setmem|Sets the allocated memory for a guest.|
|setmaxmem|Sets maximum memory limit for the hypervisor.|
|setvcpus|Changes number of virtual CPUs assigned to a guest. Note that this feature is unsupported in Red Hat Enterprise Linux 5.|
|vcpuinfo|Displays virtual CPU information about a guest.|
|vcpupin|Controls the virtual CPU affinity of a guest.|
|domblkstat|Displays block device statistics for a running guest.|
|domifstat|Displays network interface statistics for a running guest.|
|attach-device|Attach a device to a guest, using a device definition in an XML file.|
|attach-disk|Attaches a new disk device to a guest.|
|attach-interface|Attaches a new network interface to a guest.|
|detach-device|Detach a device from a guest, takes the same kind of XML descriptions as command attach-device.|
|detach-disk|Detach a disk device from a guest.|
|detach-interface|Detach a network interface from a guest.|
|domxml-from-native|Convert from native guest configuration format to domain XML format. See the virsh man page for more details.|
|domxml-to-native|Convert from domain XML format to native guest configuration format. See the virsh man page for more details.|

These are miscellaneous virsh options

^Command^Description|
|version|Displays the version of virsh|
|nodeinfo|Outputs information about the hypervisor|

Connecting to the hypervisorConnect to a hypervisor session with virsh:
<code>

# virsh connect ''{hostname OR URL}''

</code>

Where <name> is the machine name of the hypervisor. To initiate a read-only connection, append the above command with -readonly.Creating a virtual machine XML dump (configuration file)Output a guest's XML configuration file with virsh:

<code>
# virsh dumpxml ''{domain-id, domain-name or domain-uuid}''

</code>

This command outputs the guest's XML configuration file to standard out (stdout). You can save the data by piping the output to a file. An example of piping the output to a file called //guest.xml//:

<code>
# virsh dumpxml ''GuestID''> ''guest.xml''

</code>

This file guest.xml can recreate the guest . You can edit this XML configuration file to configure additional devices or to deploy additional guests. An example of virsh dumpxml output:

<code>
# virsh dumpxml r5b2-mySQL01
 <domain type='xen' id='13'>
 <name>r5b2-mySQL01</name>
    <uuid>4a4c59a7ee3fc78196e4288f2862f011</uuid>
    <bootloader>/usr/bin/pygrub</bootloader>
    <os>
   <type>linux</type>
         <kernel>/var/lib/libvirt/vmlinuz.2dgnU_</kernel>
         <initrd>/var/lib/libvirt/initrd.UQafMw</initrd>
         <cmdline>ro root=/dev/VolGroup00/LogVol00 rhgb quiet</cmdline>
     </os>
     <memory>512000</memory>
     <vcpu>1</vcpu>
     <on_poweroff>destroy</on_poweroff>
     <on_reboot>restart</on_reboot>
     <on_crash>restart</on_crash>
     <devices>
        <interface type='bridge'>
             <source bridge='xenbr0'/>
             <mac address='00:16:3[e:49:1d:11'/ e:49:1d:11'/]>
             <script path='vif-bridge'/>
         </interface>
     <graphics type='vnc' port='5900'/>
     <console tty='/dev/pts/4'/>
  </devices>
</domain>

</code>

<blockquote>

Creating a guest from a configuration fileGuests can be created from XML configuration files. You can copy existing XML from previously created guests or use the dumpxml option. To create a guest with virsh from an XML file:

</blockquote>

<code>
# virsh create configuration_file.xml


</file>

Editing a guest's configuration fileInstead of using the dumpxml option, guests can be edited either while they run or while they are offline. The virsh edit command provides this functionality. For example, to edit the guest named //baseos-v3//:

<code># virsh edit baseos-v3

</code>

This opens a text editor. The default text editor is the $EDITOR shell parameter (set to vi by default).Suspending a guestSuspend a guest with virsh:

<code>
# virsh suspend {domain-id, domain-name or domain-uuid}

</code>

When a guest is in a suspended state, it consumes system RAM but not processor resources. Disk and network I/O does not occur while the guest is suspended. This operation is immediate and the guest can be restarted with the resume option.Resuming a guestRestore a suspended guest with virsh using the resume option:

<code>
# virsh resume {domain-id, domain-name or domain-uuid}

</code>

This operation is immediate and the guest parameters are preserved for suspend and resume operations.Save a guestSave the current state of a guest to a file using the virsh command:

<code>
# virsh save {domain-name, domain-id or domain-uuid} filename


</file>

This stops the guest you specify and saves the data to a file, which may take some time given the amount of memory in use by your guest. Save is similar to pause, instead of just pausing a guest the present state of the guest is saved.Restore a guestRestore a guest previously saved with the virsh save command using virsh:

<code># virsh restore filename


</file>

This restarts the saved guest, which may take some time. The guest's name and UUID are preserved but are allocated for a new id.Shut down a guestShut down a guest using the virsh command:

<code># virsh shutdown {domain-id, domain-name or domain-uuid}

</code>

You can control the behavior of the rebooting guest by modifying the on_shutdown parameter in the guest's configuration file.Rebooting a guestReboot a guest using virsh command:

<code>
#virsh reboot {domain-id, domain-name or domain-uuid}

</code>

You can control the behavior of the rebooting guest by modifying the on_reboot element in the guest's configuration file.Forcing a guest to stopForce a guest to stop with the virsh command:

<code>
# virsh destroy {domain-id, domain-name or domain-uuid}

</code>

This command does an immediate ungraceful shutdown and stops the specified guest. Using virsh destroy can corrupt guest file systems . Use the destroy option only when the guest is unresponsive. For para-virtualized guests, use the shutdown option([[https://trac.x0blr.com/#data-tracwysiwyg-link=https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/5/html/virtualization/chap-Virtualization-Managing_guests_with_virsh#form-Virtualization-Managing_guests_with_virsh-Shut_down_a_guest|Shut down a guest]]) instead.Getting the domain ID of a guestTo get the domain ID of a guest:
<code>

# virsh domid {domain-name or domain-uuid}

</code>

Getting the domain name of a guestTo get the domain name of a guest:

<code>
# virsh domname {domain-id or domain-uuid}

</code>

Getting the UUID of a guestTo get the Universally Unique Identifier (UUID) for a guest:

<code>
# virsh domuuid {domain-id or domain-name}'

</code>

An example of virsh domuuid output:

<code>
# virsh domuuid r5b2-mySQL01 4a4c59a7-ee3f-c781-96e4-288f2862f011

</code>

Displaying guest [[https://trac.x0blr.com/#data-tracwysiwyg-link=wiki:InformationUsing|Information Using]] virsh with the guest's domain ID, domain name or UUID you can display information on the specified guest:
<code>

# virsh dominfo {domain-id, domain-name or domain-uuid}

</code>

This is an example of virsh dominfo output:} Displaying host informationTo display information about the host:

<code>
# virsh nodeinfo

</code>

An example of virsh nodeinfo output:} This displays the node information and the machines that support the virtualization process.Displaying the guestsTo display the guest list and their current states with virsh:

<code>
# virsh list

</code>

Other options available [[https://trac.x0blr.com/#data-tracwysiwyg-link=include:the|include:the]] –inactive option to list inactive guests (that is, guests that have been defined but are not currently active), andthe –all option lists all guests. For example:
<code>

# virsh list --all
 Id Name   State
----------------------------------
  0 Domain-0             running
  1 Domain202            paused
  2 Domain010            inactive
  3 Domain9600           crashed

</code>

The output from virsh list is categorized as one of the six states (listed below). * The running state refers to guests which are currently active on a CPU.

  * Guests listed as blocked are blocked, and are not running or runnable. This is caused by a guest waiting on I/O (a traditional wait state) or guests in a sleep mode.
  * The paused state lists domains that are paused. This occurs if an administrator uses the pause button in virt-manager, xm pause or virsh suspend. When a guest is paused it consumes memory and other resources but it is ineligible for scheduling and CPU resources from the hypervisor.
  * The shutdown state is for guests in the process of shutting down. The guest is sent a shutdown signal and should be in the process of stopping its operations gracefully. This may not work with all guest operating systems; some operating systems do not respond to these signals.
  * Domains in the dying state are in is in process of dying, which is a state where the domain has not completely shut-down or crashed.
  * crashed guests have failed while running and are no longer running. This state can only occur if the guest has been configured not to restart on crash.

Displaying virtual CPU informationTo display virtual CPU information from a guest with virsh:

<code>
# virsh vcpuinfo {domain-id, domain-name or domain-uuid}

</code>

An example of virsh vcpuinfo output:

<code>
# virsh vcpuinfo r5b2-mySQL01 VCPU:   0 CPU:            0 State:          blocked CPU time:       0.0s CPU Affinity:   yy

</code>

<blockquote>

Configuring virtual CPU affinityTo configure the affinity of virtual CPUs with physical CPUs:

</blockquote>

<code>
# virsh vcpupin domain-id vcpu cpulist

</code>

The domain-id parameter is the guest's ID number or name.The vcpu parameter denotes the number of virtualized CPUs allocated to the guest.The vcpu parameter must be provided.The cpulist parameter is a list of physical CPU identifier numbers separated by commas. The cpulist parameter determines which physical CPUs the VCPUs can run on.Configuring virtual CPU countTo modify the number of CPUs assigned to a guest with virsh:

<code>
# virsh setvcpus {domain-name, domain-id or domain-uuid} count

</code>

The new //count//  value cannot exceed the count above the amount specified when the guest was created.Important

This feature is unsupported and known not to work in Red Hat Enterprise Linux 5.Configuring memory allocationTo modify a guest's memory allocation with virsh :

<code>
# virsh setmem {domain-id or domain-name} count

</code>

You must specify the //count//  in kilobytes. The new count value cannot exceed the amount you specified when you created the guest. Values lower than 64 MB are unlikely to work with most guest operating systems. A higher maximum memory value does not affect an active guests. If the new value is lower the available memory will shrink and the guest may crash.Displaying guest block device informationUse virsh domblkstat to display block device statistics for a running guest.

<code>
# virsh domblkstat GuestName block-device

</code>

Displaying guest network device informationUse virsh domifstat to display network interface statistics for a running guest.

<code>
# virsh domifstat GuestName interface-device

</code>

Migrating guests with virshA guest can be migrated to another host with virsh. Migrate domain to another host. Add –live for live migration. The migrate command accepts parameters in the following format:

<code>
# virsh migrate --live GuestName DestinationURL

</code>

The //–live//  parameter is optional. Add the //–live//  parameter for live migrations.The //GuestName//  parameter represents the name of the guest which you want to migrate.The //DestinationURL//  parameter is the URL or hostname of the destination system. The destination system requires: * the same version of Red Hat Enterprise Linux,

  * the same hypervisor (KVM or Xen), and
  * the libvirt service must be started.

Once the command is entered you will be prompted for the root password of the destination system.Managing virtual networksThis section covers managing virtual networks with the virsh command. To list virtual networks:

<code>
# virsh net-list

</code>

This command generates output similar to:{{{ # virsh net-list Name State Autostart

----

default active yes vnet1 active yes vnet2 active yes

To view network information for a specific virtual network:

'''# virsh net-dumpxml ''NetworkName'''

This displays information about a specified virtual network in XML format:{{{ # virsh net-dumpxml vnet1 <network>

<code>
<name>vnet1</name> <uuid>98361b46-1581-acb7-1643-85a412626e70</uuid> <forward dev='eth0'/> <bridge name='vnet0' stp='on' forwardDelay='0' /> <ip address='192.168.100.1' netmask='255.255.255.0'>
    <dhcp>
   <range start='192.168.100.128' end='192.168.100.254' />
    </dhcp>
  </ip>

</network>

</code>

Other virsh commands used in managing virtual networks are: * virsh net-autostart //network-name//  — Autostart a network specified as //network-name//.

  * virsh net-create //XMLfile//  — generates and starts a new network using an existing XML file.
  * virsh net-define //XMLfile//  — generates a new network device from an existing XML file without starting it.
  * virsh net-destroy //network-name//  — destroy a network specified as //network-name//.
  * virsh net-name //networkUUID//  — convert a specified //networkUUID//  to a network name.
  * virsh net-uuid //network-name//  — convert a specified //network-name//  to a network UUID.
  * virsh net-start //nameOfInactiveNetwork//  — starts an inactive network.
  * virsh net-undefine //nameOfInactiveNetwork//  — removes the definition of an inactive network.