mirror of
https://pagure.io/fedora-docs/quick-docs.git
synced 2024-10-19 17:45:43 +00:00
103 lines
3.3 KiB
Text
103 lines
3.3 KiB
Text
[id='ref_managing-virtual-machines']
|
|
= Managing virtual machines
|
|
|
|
When the installation of the guest operating system is complete, it can be managed using the `virt-manager` program or via command line using `virsh`.
|
|
|
|
|
|
[[managing-guests-with-virt-manager]]
|
|
== Managing guests with virt-manager
|
|
|
|
. Start the Virtual Machine Manager by navigating to menu:[Applications]System Tools, or run:
|
|
+
|
|
----
|
|
# virt-manager
|
|
----
|
|
+
|
|
If you are not root, you will be prompted to enter the root password. Choose *Run unprivileged* to operate in read-only non-root mode.
|
|
. Choose the host you wish to manage and click *Connect* in the *Open Connection* dialog window.
|
|
. The list of virtual machines is displayed in the main window. Guests that are running will display a ">" icon. Guests that are not running will be greyed out.
|
|
. To manage a particular guest, double click on it, or right click and select *Open*.
|
|
. A new window for the guest will open that will allow you to use its console, see information about its virtual hardware and start, stop, and pause it.
|
|
|
|
For further information about `virt-manager`, see http://virt-manager.et.redhat.com/.
|
|
|
|
Bugs in the `virt-manager` tool should be reported in http://bugzilla.redhat.com[Bugzilla] against the `virt-manager`
|
|
component.
|
|
|
|
|
|
[[managing-guests-with-virsh]]
|
|
== Managing guests with virsh
|
|
|
|
The `virsh` command-line utility allows you to manage virtual machines on the command line. The `virsh` utility is built around the libvirt management API:
|
|
|
|
* `virsh` has a stable set of commands whose syntax and semantics are preserved across updates to the underlying virtualization platform.
|
|
* `virsh` can be used as an unprivileged user for read-only operations (e.g. listing domains, listing domain statistics).
|
|
* `virsh` can manage domains running under Xen, QEMU/KVM, ESX, or other back-ends with no perceptible difference to the user.
|
|
|
|
To start a virtual machine:
|
|
|
|
----
|
|
# virsh create <name of virtual machine>
|
|
----
|
|
|
|
To list the virtual machines currently running:
|
|
|
|
----
|
|
# virsh list
|
|
----
|
|
|
|
To list all virtual machines, running or not:
|
|
|
|
----
|
|
# virsh list --all
|
|
----
|
|
|
|
To gracefully power off a guest:
|
|
|
|
----
|
|
# virsh shutdown <virtual machine (name | id | uuid)>
|
|
----
|
|
|
|
To non gracefully power off a guest:
|
|
|
|
----
|
|
# virsh destroy <virtual machine (name | id | uuid)>
|
|
----
|
|
|
|
To save a snapshot of the machine to a file:
|
|
|
|
----
|
|
# virsh save <virtual machine (name | id | uuid)> <filename>
|
|
----
|
|
|
|
To restore a previously saved snapshot:
|
|
|
|
----
|
|
# virsh restore <filename>
|
|
----
|
|
|
|
To export the configuration file of a virtual machine:
|
|
|
|
----
|
|
# virsh dumpxml <virtual machine (name | id | uuid)
|
|
----
|
|
|
|
For a complete list of commands available for use with `virsh`:
|
|
|
|
----
|
|
# virsh help
|
|
----
|
|
|
|
Or consult the manual page: `man virsh`.
|
|
|
|
Bugs in the `virsh` tool should be reported in http://bugzilla.redhat.com[Bugzilla] against the *libvirt* component.
|
|
|
|
|
|
[[remote-management]]
|
|
== Remote management
|
|
|
|
The following remote management options are available:
|
|
|
|
* If using non-root users via SSH, see the setup instructions in http://wiki.libvirt.org/page/SSHSetup
|
|
* If using root for access via SSH, then create SSH keys for root, and use `ssh-agent` and `ssh-add` before launching `virt-manager`.
|
|
* To use TLS, set up a local certificate authority and issue x509 certs to all servers and clients. For information on configuring this option, see http://wiki.libvirt.org/page/TLSSetup.
|