= Guest Editing SOP

Various virsh commands

== Contents

* <<_contact_information>>
* <<_how_to_do_it>>
** <<_add_cpu>>
** <<_resize_memory>>


== Contact Information

Owner:::
  Fedora Infrastructure Team
Contact:::
  #fedora-admin, sysadmin-main
Location:::
  PHX, Tummy, ibiblio, Telia, OSUOSL
Servers:::
  All xen servers, kvm/libvirt servers.
Purpose:::
  Resize guest disks

== How to do it

=== Add cpu

[arabic]
. SSH to the virthost server
. Calculate the number of CPUs the system needs
. `sudo virsh setvcpus  <guest> <num_of_cpus> --config` - ie:
+
....
sudo virsh setvcpus bapp01 16 --config
....
. Shutdown the virtual system
. Start the virtual system
+
[NOTE]
====
Note that using _virsh reboot_ is insufficient. You have to
actually stop the domain and start it with `virsh destroy <guest>` and
`virsh start <guest>` for the change to take effect.
====
. Login and check that cpu count matches
. *Remember to update the group_vars in ansible* to match the new value
you set, if appropriate.

=== Resize memory

[arabic]
. SSH to the virthost server
. Calculate the amount of memory the system needs in kb
. `sudo virsh setmem <guest> <num_in_kilobytes> --config` - ie:
+
....
sudo virsh setmem bapp01 16777216 --config
....
. Shutdown the virtual system
. Start the virtual system
+
[NOTE]
====
Note that using _virsh reboot_ is insufficient. You have to
actually stop the domain and start it with `virsh destroy <guest>` and
`virsh start <guest>` for the change to take effect.
====
. Login and check that memory matches
. *Remember to update the group_vars in ansible* to match the new value
you set, if appropriate.
