From 2d87e6fbf68885731a6743e9411c5325cde588ad Mon Sep 17 00:00:00 2001 From: Your Name Date: Fri, 11 Mar 2011 12:55:45 +0100 Subject: working on spice-bascis --- books/docbook/SpiceUserManual-Basics.xml | 54 ++++++++++++++++++++++++++----- books/docbook/SpiceUserManual.pdf | Bin 60137 -> 0 bytes books/docbook/resources/spicec01.png | Bin 0 -> 10244 bytes books/html/ch03.html | 2 +- books/html/ch03s02.html | 21 +++++++----- books/html/ch03s03.html | 9 ++++++ books/html/ch04.html | 2 +- books/html/index.html | 2 +- books/pdf/SpiceUserManual.pdf | Bin 60139 -> 62484 bytes 9 files changed, 71 insertions(+), 19 deletions(-) delete mode 100644 books/docbook/SpiceUserManual.pdf create mode 100644 books/docbook/resources/spicec01.png create mode 100644 books/html/ch03s03.html 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 @@ - + Spice basics
Basic Definitions @@ -49,17 +47,57 @@ locally stored ISO of your favourite operating system so you can use it for installation. - 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 + 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 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. + Spice port option define what port will be used for communication with client. Spice + option disable-ticketing is telling us that ticketing (simple + authentification method) is not used. Virtio and chardev devices are + required by guest + agent. + + +
+
+ Connecting to guest + - There will be no running agent - on the guest 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 previous section. + + + Be aware that port used for spice communication (port 3001 in our case) should not be blocked by firewall. + Host myhost is reffering to machine which is running our qemu instance. + + + client# spicec -h myhost -p 3001 +
+ Established connection to Windows 2008 guest + + + + + +
+ + + 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. + + You can eliminate this problem by using ticketing or SSL. + + + + +
diff --git a/books/docbook/SpiceUserManual.pdf b/books/docbook/SpiceUserManual.pdf deleted file mode 100644 index 7872cbf..0000000 Binary files a/books/docbook/SpiceUserManual.pdf and /dev/null differ diff --git a/books/docbook/resources/spicec01.png b/books/docbook/resources/spicec01.png new file mode 100644 index 0000000..e2cf8c5 Binary files /dev/null and b/books/docbook/resources/spicec01.png differ diff --git a/books/html/ch03.html b/books/html/ch03.html index a14fc8c..de6b601 100644 --- a/books/html/ch03.html +++ b/books/html/ch03.html @@ -1,3 +1,3 @@ - Chapter 3. Spice basics

Chapter 3. Spice basics

Basic Definitions

Host

Host is a machine running instance of qemu-kvm.

Guest

Guest is a virtual machine hosted on host which will be accessed by using spice client.

Client

Client is reffering to a system running spice client (e.g. spicec or spicy).

\ No newline at end of file + Chapter 3. Spice basics

Chapter 3. Spice basics

Basic Definitions

Host

Host is a machine running instance of qemu-kvm.

Guest

Guest is a virtual machine hosted on host which will be accessed by using spice client.

Client

Client is reffering to a system running spice client (e.g. spicec or spicy).

\ No newline at end of file diff --git a/books/html/ch03s02.html b/books/html/ch03s02.html index 93c7b45..5a77dc0 100644 --- a/books/html/ch03s02.html +++ b/books/html/ch03s02.html @@ -1,6 +1,6 @@ - Launching qemu

Launching qemu

I'll use qemu-kvm as a name for the executable. If you're using manually built qemu or + Launching qemu

Launching qemu

I'll use qemu-kvm as a name for the executable. If you're using manually built qemu or qemu without kvm then just replace qemu-kvm with your own binary. I'll use host# client# guest# shell prompt notation to distinguish wherever should be the command executed. See section Basic Definitions to be sure that you know @@ -14,12 +14,17 @@

host# qemu-img create /path/to/xp.img 10G

So we already have image created and shall now start with image popullation. I assume that you have locally stored ISO of your favourite operating system so you can use it for installation. -

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

+

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

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. -

- There will be no running agent - on the guest system so we don't have to emulate virtio device yet. -

\ No newline at end of file + emulate qxl device adapter. +

Spice port option define what port will be used for communication with client. Spice + option disable-ticketing is telling us that ticketing (simple + authentification method) is not used. Virtio and chardev devices are + required by guest + agent. +

\ No newline at end of file diff --git a/books/html/ch03s03.html b/books/html/ch03s03.html new file mode 100644 index 0000000..7902dcf --- /dev/null +++ b/books/html/ch03s03.html @@ -0,0 +1,9 @@ + + + Connecting client

Connecting client

+ Folliwng section will show you basic usage of spice client. Example connection will be related to qemu + instance executed in previous section. +

+ Be aware that port used for spice communication (port 3001 in our case) should not be blocked by firewall. + Host myhost is reffering to machine which is running our qemu instance. +

client# spicec -h myhost -p 3001

Figure 3.1. Established connection to Windows 2008 guest

Established connection to Windows 2008 guest

\ No newline at end of file diff --git a/books/html/ch04.html b/books/html/ch04.html index ad1aaa2..41ecde7 100644 --- a/books/html/ch04.html +++ b/books/html/ch04.html @@ -1,3 +1,3 @@ - Chapter 4. References

Chapter 4. References

  1. Spice remote computing protocol definition

\ No newline at end of file + Chapter 4. References

Chapter 4. References

  1. Spice remote computing protocol definition

\ No newline at end of file diff --git a/books/html/index.html b/books/html/index.html index 0bfcf92..95a5037 100644 --- a/books/html/index.html +++ b/books/html/index.html @@ -3,4 +3,4 @@ Spice User Manual \ No newline at end of file +


\ No newline at end of file diff --git a/books/pdf/SpiceUserManual.pdf b/books/pdf/SpiceUserManual.pdf index 4fe23d0..c150e0e 100644 Binary files a/books/pdf/SpiceUserManual.pdf and b/books/pdf/SpiceUserManual.pdf differ -- cgit v1.2.3