= Guest Editing SOP

Various virsh commands

== Contents

[arabic]
. Contact Information
. How to do it
+
____
[arabic]
.. add/remove cpus
.. 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
====
Note that using [.title-ref]#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.
====
[arabic, start=6]
. 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
====
Note that using [.title-ref]#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.
====
[arabic, start=6]
. Login and check that memory matches
. *Remember to update the group_vars in ansible* to match the new value
you set, if appropriate.