diff options
Diffstat (limited to 'books/docbook/SpiceUserManual-Basics.xml')
-rw-r--r-- | books/docbook/SpiceUserManual-Basics.xml | 54 |
1 files changed, 46 insertions, 8 deletions
diff --git a/books/docbook/SpiceUserManual-Basics.xml b/books/docbook/SpiceUserManual-Basics.xml index 599b725..ae5d5b2 100644 --- a/books/docbook/SpiceUserManual-Basics.xml +++ b/books/docbook/SpiceUserManual-Basics.xml @@ -1,9 +1,7 @@ <?xml version="1.0" encoding="UTF-8"?> <?oxygen RNGSchema="http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rng" type="xml"?> -<chapter xmlns="http://docbook.org/ns/docbook" - xmlns:xi="http://www.w3.org/2001/XInclude" - xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="basics"> +<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="basics"> <title>Spice basics</title> <section xml:id="definitions"> <title>Basic Definitions</title> @@ -49,17 +47,57 @@ locally stored ISO of your favourite operating system so you can use it for installation. </para> - <screen>host# sudo qemu-kvm -boot order=dc -vga qxl -spice port=3001,disable-ticketing -soundhw ac97 \ - -cdrom /path/to/your.iso /path/to/your.img</screen> + <screen>host# sudo qemu-kvm -boot order=dc -vga qxl \ + -spice port=3001,disable-ticketing -soundhw ac97 \ + -device virtio-serial -chardev spicevmc,id=vdagent,debug=0,name=vdagent \ + -device virtserialport,chardev=vdagent,name=com.redhat.spice.0 \ + -cdrom /path/to/your.iso /path/to/your.img</screen> <para> Let's take just briefly look trough used qemu options. Option -boot order=dc specifies that guest system should try to boot from first cdrom and then fallback to first disk, -vga qxl specifies that qemu should - emulate qxl device adapter. + emulate qxl device adapter. </para> + <para> Spice port option define what port will be used for communication with client. Spice + option disable-ticketing is telling us that ticketing <emphasis role="italic">(simple + authentification method)</emphasis> is not used. Virtio and chardev devices are + required by <link xlink:href="SpiceUserManual-Introduction.xml#vdagent">guest + agent</link>. + </para> + + </section> + <section xml:id="spicec_basics"> + <title>Connecting to guest</title> + <para> - There will be no running <link xlink:href="SpiceUserManual-Introduction.xml#vdagent">agent</link> - on the <link xlink:href="guest">guest</link> system so we don't have to emulate virtio device yet. + Folliwng section will show you basic usage of spice client. Example connection will be related to qemu + instance executed in <link xlink:href="#qemu_basics">previous section</link>. </para> + + <para> + Be aware that port used for spice communication <emphasis role="italic">(port 3001 in our case)</emphasis> should not be blocked by firewall. + <emphasis role="bold">Host myhost is reffering to machine which is running our qemu instance.</emphasis> + </para> + + <screen>client# spicec -h myhost -p 3001</screen> + <figure> + <title>Established connection to Windows 2008 guest</title> + <mediaobject> + <imageobject> + <imagedata fileref="resources/spicec01.png"/> + </imageobject> + </mediaobject> + </figure> + + <para> + Spice does not currently suport multiple connections to one qemu instance. + So anybody who will connect to the same host and port can simply take your session. + + <emphasis role="bold">You can eliminate this problem by using <link xlink:href="#ticketing">ticketing</link> or SSL.</emphasis> + + </para> + + + </section> </chapter> |