diff options
| author | Christophe Fergeau <cfergeau@redhat.com> | 2013-09-23 14:24:49 +0200 |
|---|---|---|
| committer | Christophe Fergeau <cfergeau@redhat.com> | 2013-09-23 14:25:27 +0200 |
| commit | bcd5007503f6487e56dda36c9978cdd23cf0b4c0 (patch) | |
| tree | 01ec0c7ed146130d961173daf4a8a96e4f2d9c12 | |
| parent | 3a33b53035f5f47ead3ef27ce8d9b3a1b88cf727 (diff) | |
Remove generated files
| -rw-r--r-- | books/docbook/resources/pepper.png (renamed from books/html/resources/pepper.png) | bin | 10582 -> 10582 bytes | |||
| -rw-r--r-- | books/docbook/resources/spicec01.png (renamed from books/html/resources/spicec01.png) | bin | 10244 -> 10244 bytes | |||
| -rw-r--r-- | books/html/chunks/ch01.html | 31 | ||||
| -rw-r--r-- | books/html/chunks/ch01s02.html | 25 | ||||
| -rw-r--r-- | books/html/chunks/ch02.html | 21 | ||||
| -rw-r--r-- | books/html/chunks/ch02s02.html | 65 | ||||
| -rw-r--r-- | books/html/chunks/ch03.html | 3 | ||||
| -rw-r--r-- | books/html/chunks/ch03s02.html | 30 | ||||
| -rw-r--r-- | books/html/chunks/ch03s03.html | 27 | ||||
| -rw-r--r-- | books/html/chunks/ch04.html | 3 | ||||
| -rw-r--r-- | books/html/chunks/index.html | 6 | ||||
| -rw-r--r-- | books/pdf/SpiceUserManual.pdf | bin | 77535 -> 0 bytes |
12 files changed, 0 insertions, 211 deletions
diff --git a/books/html/resources/pepper.png b/books/docbook/resources/pepper.png Binary files differindex e837194..e837194 100644 --- a/books/html/resources/pepper.png +++ b/books/docbook/resources/pepper.png diff --git a/books/html/resources/spicec01.png b/books/docbook/resources/spicec01.png Binary files differindex e2cf8c5..e2cf8c5 100644 --- a/books/html/resources/spicec01.png +++ b/books/docbook/resources/spicec01.png diff --git a/books/html/chunks/ch01.html b/books/html/chunks/ch01.html deleted file mode 100644 index 700aa4b..0000000 --- a/books/html/chunks/ch01.html +++ /dev/null @@ -1,31 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 1. Introduction</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="index.html" title="Spice User Manual"><link rel="next" href="ch01s02.html" title="Features"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 1. Introduction</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 1. Introduction"><div class="titlepage"><div><div><h2 class="title"><a name="d0e50"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch01.html#d0e69">Spice and Spice-related Compoments</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#spice_server">Spice Server</a></span></dt><dt><span class="section"><a href="ch01.html#spice_client">Spice Client</a></span></dt><dt><span class="section"><a href="ch01.html#d0e82">QXL Device and Drivers</a></span></dt><dt><span class="section"><a href="ch01.html#d0e87">VDI Port Device</a></span></dt><dt><span class="section"><a href="ch01.html#vdagent">Spice Agent</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">Features</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#multiple_channels">Multiple Channels</a></span></dt><dt><span class="section"><a href="ch01s02.html#image_compression">Image Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#video_compression">Video Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#mouse_modes">Mouse modes</a></span></dt><dt><span class="section"><a href="ch01s02.html#other_features">Other Features</a></span></dt></dl></dd></dl></div><p> - Spice is an open remote computing solution, providing client access to remote displays and devices (e.g. keyboard, mouse, audio). - Spice provides a desktop like user experience, while trying to offload most of the intensive CPU and GPU tasks to the client. - - The basic building blocks of Spice are: - </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><a class="link" href="ch01.html#spice_server" title="Spice Server">Spice Server</a></p></li><li class="listitem"><p><a class="link" href="ch01.html#spice_client" title="Spice Client">Spice CLient</a></p></li><li class="listitem"><p>Spice Protocol</p></li></ol></div><p> - The following sections provide basic iformation on Spice components and features, obtaining, building installing and using Spice. - </p><div class="section" title="Spice and Spice-related Compoments"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e69"></a>Spice and Spice-related Compoments</h2></div></div></div><div class="section" title="Spice Server"><div class="titlepage"><div><div><h3 class="title"><a name="spice_server"></a>Spice Server</h3></div></div></div><p> - Spice server is implemented in libspice, a VDI pluggable library. - Virtual Device Interface (VDI) defines a set of interfaces that provide a standard way to publish virtual devices (e.g. display device, keyboard, mouse) - and enables different Spice components to interact with those devices. - On one side, the server communicates with the remote client using the Spice protocol and on the other side, it interacts with the VDI host application (e.g QEMU). - </p></div><div class="section" title="Spice Client"><div class="titlepage"><div><div><h3 class="title"><a name="spice_client"></a>Spice Client</h3></div></div></div><p> - Spice cross-platform (Linux and Windows) client is the interface for the end user e.g. spicec or spicy. - </p></div><div class="section" title="QXL Device and Drivers"><div class="titlepage"><div><div><h3 class="title"><a name="d0e82"></a>QXL Device and Drivers</h3></div></div></div><p> - Spice server supports QXL VDI interface. When libspice is used with QEMU, a specific QEMU QXL PCI device can be used for improving - remote display performance and enhancing the graphic capabilities of the guest graphic system. - QXL device requires guest QXL drivers for full functionality. - However, standard VGA is supported when no driver exists. - </p></div><div class="section" title="VDI Port Device"><div class="titlepage"><div><div><h3 class="title"><a name="d0e87"></a>VDI Port Device</h3></div></div></div><p> - Spice protocol supports a communication channel between the client and the agent on the server side. - When using QEMU, Spice agent resides on the guest. VDI port is a QEMU PCI device used for communication with the agent. - </p></div><div class="section" title="Spice Agent"><div class="titlepage"><div><div><h3 class="title"><a name="vdagent"></a>Spice Agent</h3></div></div></div><p> - The Spice agent is an optional component for enhancing user experience and performing guest-oriented management tasks. - For example, the agent injects mouse position and state to the guest when using client mouse mode. It also enables you to - move cursor freely between guest and client. Other features of agent are shared clipboard and - aligning guest resolution with client while entering fullscreen mode. - - </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="index.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Spice User Manual </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Features</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/chunks/ch01s02.html b/books/html/chunks/ch01s02.html deleted file mode 100644 index d6cc381..0000000 --- a/books/html/chunks/ch01s02.html +++ /dev/null @@ -1,25 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Features</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch01.html" title="Chapter 1. Introduction"><link rel="prev" href="ch01.html" title="Chapter 1. Introduction"><link rel="next" href="ch02.html" title="Chapter 2. Installation"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Features</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><th width="60%" align="center">Chapter 1. Introduction</th><td width="20%" align="right"> <a accesskey="n" href="ch02.html">Next</a></td></tr></table><hr></div><div class="section" title="Features"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features"></a>Features</h2></div></div></div><p> - The server and client communicate via channels. Each channel is dedicated to a specific type of data. The available channels are following. - </p><div class="section" title="Multiple Channels"><div class="titlepage"><div><div><h3 class="title"><a name="multiple_channels"></a>Multiple Channels</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="bold"><strong>Main</strong></span> - control and configuration</p></li><li class="listitem"><p><span class="bold"><strong>Display</strong></span> - graphics commands images and video streams</p></li><li class="listitem"><p><span class="bold"><strong>Inputs</strong></span> - keyboard and mouse inputs</p></li><li class="listitem"><p><span class="bold"><strong>Cursor</strong></span> - pointer device position and cursor shape</p></li><li class="listitem"><p><span class="bold"><strong>Playback</strong></span> - audio received from the server to be played by the client</p></li><li class="listitem"><p><span class="bold"><strong>Record</strong></span> - audio capture on the client side</p></li></ol></div></div><div class="section" title="Image Compression"><div class="titlepage"><div><div><h3 class="title"><a name="image_compression"></a>Image Compression</h3></div></div></div><p> - Spice offers several image compression algorithms, which can be chosen on server initiation and dynamically at run-time. Quic is a Spice proprietary image compression technology based on the SFALIC algorithm. The Lempel-Ziv (LZ) algorithm is another option. Both Quic and LZ are local algorithms encoding each image separately. Global LZ (GLZ) is another proprietary Spice technology that uses LZ with history based global dictionary. GLZ takes advantage of repeating patterns among images to shrink the traffic and save bandwidth, which is critical in a WAN environment. Spice also offers an automatic mode for compression selection per image, where the choice between LZ/GLZ and Quic is heuristically based on image properties. Conceptually, synthetic images are better compressed with LZ/GLZ and real images are better with Quic. - </p></div><div class="section" title="Video Compression"><div class="titlepage"><div><div><h3 class="title"><a name="video_compression"></a>Video Compression</h3></div></div></div><p> - Spice uses loss-less compression for images sent to the client. However, video streams are handled differently. Spice server heuristically identifies video areas and sends them as a video stream coded using M-JPEG. This handling saves a lot of traffic, improving Spice performance, especially in a WAN environment. However, in some circumstances the heuristic behavior might cause low quality image (e.g. identifying updated text area as a video stream). Video streaming can be chosen on server initiation and dynamically at run-time. - </p></div><div class="section" title="Mouse modes"><div class="titlepage"><div><div><h3 class="title"><a name="mouse_modes"></a>Mouse modes</h3></div></div></div><p> - Spice supports two mouse modes: server and client. The mode can be changed dynamically and is negotiated between the client and the server. - </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p> - <span class="bold"><strong>Server mouse</strong></span> - When a user clicks inside the Spice client window, the client mouse is captured and set invisible. In this mode, the server controls the mouse position on display. However, it might be problematic on WAN or a loaded server, where mouse cursor might have some latency or non-responsiveness. - </p></li><li class="listitem"><p> - <span class="bold"><strong>Client mouse</strong></span> - Not captured and is used as the effective pointing device. For enabling client mouse, VDI host application must register an absolute pointing device (e.g. USB tablet in QEMU). This mode is appropriate for WAN or loaded server, since cursor has smooth motion and responsiveness. However, the cursor might loose synchronization (position and shape) for a while. - </p></li></ol></div></div><div class="section" title="Other Features"><div class="titlepage"><div><div><h3 class="title"><a name="other_features"></a>Other Features</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p> - <span class="bold"><strong>Multiple Monitors</strong></span> - any number of monitors is supported - </p></li><li class="listitem"><p> - <span class="bold"><strong>Bidirectional Audio</strong></span> - Spice supports audio playback and recording. Playback is compressed using the CELT algorithm - </p></li><li class="listitem"><p> - <span class="bold"><strong>Lip-sync</strong></span> - between video and audio. Available only when video streaming is enabled. - </p></li><li class="listitem"><p> - <span class="bold"><strong>Migration</strong></span> - switching channel connectivity for supporting server migration - </p></li><li class="listitem"><p> - <span class="bold"><strong>Pixmap and Pallete caching</strong></span> - </p></li></ol></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch01.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 1. Introduction </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 2. Installation</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/chunks/ch02.html b/books/html/chunks/ch02.html deleted file mode 100644 index 3988cca..0000000 --- a/books/html/chunks/ch02.html +++ /dev/null @@ -1,21 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 2. Installation</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="ch01s02.html" title="Features"><link rel="next" href="ch02s02.html" title="Building Spice in Generic Linux"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Installation</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch02s02.html">Next</a></td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 2. Installation"><div class="titlepage"><div><div><h2 class="title"><a name="d0e199"></a>Chapter 2. Installation</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch02.html#rhel_fedora">Installing Spice in RHEL or Fedora </a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#d0e207">RHEL >=6 and Fedora >=13</a></span></dt><dt><span class="section"><a href="ch02.html#d0e220">RHEL 5</a></span></dt><dt><span class="section"><a href="ch02.html#d0e230">RHEVM Users</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s02.html">Building Spice in Generic Linux</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s02.html#req_client">Client requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#req_host">Host requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e312">Guest requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e397">Setting up PATH</a></span></dt></dl></dd></dl></div><div class="section" title="Installing Spice in RHEL or Fedora"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="rhel_fedora"></a>Installing Spice in RHEL or Fedora </h2></div></div></div><p> - Be aware that there is no build of spice-server for i386 so you can run only client part on i386. The reason for it is that there is no buld of qemu-kvm for RHEL of Fedora i386 either. - </p><div class="section" title="RHEL >=6 and Fedora >=13"><div class="titlepage"><div><div><h3 class="title"><a name="d0e207"></a>RHEL >=6 and Fedora >=13</h3></div></div></div><p> - </p><pre class="screen">yum install qemu-kvm spice-client</pre><p> - </p><pre class="screen">yum install spice-gtk # Only on Fedora >=14</pre><p> - </p><p> - Package spice-protocol will be downloaded automatically as a dependency for package kvm. - </p></div><div class="section" title="RHEL 5"><div class="titlepage"><div><div><h3 class="title"><a name="d0e220"></a>RHEL 5</h3></div></div></div><p> - </p><pre class="screen">yum install kvm qspice-client</pre><p> - </p><p> - Similarly as in RHEL6 package kvm has qspice-libs as a dependency. - </p></div><div class="section" title="RHEVM Users"><div class="titlepage"><div><div><h3 class="title"><a name="d0e230"></a>RHEVM Users</h3></div></div></div><p> - <span class="bold"><strong> - RHEVM users could be also interested in spice-xpi package as - it's allow you to execute spice-client directly from the RHEVM - UserPortal. - </strong></span> - </p><pre class="screen">yum install spice-xpi</pre><p> - </p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch01s02.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch02s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Features </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Building Spice in Generic Linux</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/chunks/ch02s02.html b/books/html/chunks/ch02s02.html deleted file mode 100644 index 001880a..0000000 --- a/books/html/chunks/ch02s02.html +++ /dev/null @@ -1,65 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Building Spice in Generic Linux</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch02.html" title="Chapter 2. Installation"><link rel="prev" href="ch02.html" title="Chapter 2. Installation"><link rel="next" href="ch03.html" title="Chapter 3. Spice basics"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Building Spice in Generic Linux</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02.html">Prev</a> </td><th width="60%" align="center">Chapter 2. Installation</th><td width="20%" align="right"> <a accesskey="n" href="ch03.html">Next</a></td></tr></table><hr></div><div class="section" title="Building Spice in Generic Linux"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="linux_generic"></a>Building Spice in Generic Linux</h2></div></div></div><p> - This section is for distributions that don't have *spice* packages in their repositories. - It will show you step by step how to build required spice components. - </p><div class="section" title="Client requirements"><div class="titlepage"><div><div><h3 class="title"><a name="req_client"></a>Client requirements</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="bold"><strong>autotools</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>pixman >= 1.7.1</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>celt = 0.5.1.3</strong></span> The exact version is required due no backwards compatibility of celt.</p></li><li class="listitem"><p><span class="bold"><strong>alsa</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>log4cpp</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>openssl</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>libXrandr</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>cegui</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>libgcrypt-devel</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>pyparsing</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>dev86</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>iasl</strong></span></p></li><li class="listitem"><p><span class="bold"><strong>nss</strong></span></p></li></ol></div></div><div class="section" title="Host requirements"><div class="titlepage"><div><div><h3 class="title"><a name="req_host"></a>Host requirements</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="bold"><strong>KVM supported by kernel</strong></span> (It should work also without KVM, but - it's not being tested as most Linux distrubitions already support - KVM.)</p></li></ol></div></div><div class="section" title="Guest requirements"><div class="titlepage"><div><div><h3 class="title"><a name="d0e312"></a>Guest requirements</h3></div></div></div><div class="section" title="Linux Guest"><div class="titlepage"><div><div><h4 class="title"><a name="d0e315"></a>Linux Guest</h4></div></div></div><p> - spice-vdagent requires virtio-serial support should to be enabled. This will be described in <a class="link" href="SpiceUserManual-Basics.xml#basics" target="_top">chapter Spice basics</a>. - Guest should have installed qxl driver (xorg-x11-drv-qxl on Fedora and RHEL). - </p></div><div class="section" title="Windows Guest"><div class="titlepage"><div><div><h4 class="title"><a name="d0e323"></a>Windows Guest</h4></div></div></div><p> - Drivers for QXL and drivers for virtio-serial assume Win XP SP3 and Win 7. - </p></div><div class="section" title="Setting up build environment"><div class="titlepage"><div><div><h4 class="title"><a name="setting_be"></a>Setting up build environment</h4></div></div></div><p> - <span class="bold"><strong>This is list of prerequisities on RHEL or Fedora. Install - package equivalents for your distrubition in case that you're not using RHEL - or Fedora.</strong></span> - </p><p> - <span class="bold"><strong>All prerequisities for Windows are available in one big package which is available - at <a class="link" href="http://spice-space.org/download.html" target="_top">http://spice-space.org/download.html</a>.</strong></span> - </p><pre class="screen">yum install git pixman-devel celt051-devel cegui-devel libjpeg-devel alsa-lib-devel log4cpp-devel \ - openssl-devel libXrandr-devel libgcrypt-devel SDL-devel nss-devel dev86 iasl pyparsing</pre><p> - <span class="bold"><strong>Package prerequisities for Ubuntu</strong></span> - </p><pre class="screen">apt-get install build-essential autoconf git-core libtool liblog4cpp5-dev libavcodec-dev \ - libssl-dev xlibmesa-glu-dev libasound-dev libpng12-dev libfreetype6-dev libfontconfig1-dev \ - libogg-dev libxrandr-dev kvm libgcrypt-dev libsdl-dev</pre></div><div class="section" title="Building libcacard"><div class="titlepage"><div><div><h4 class="title"><a name="building_libcacard"></a>Building libcacard</h4></div></div></div><p>Fedora >=14 RHEL >=6.1 has libcacard already available. So you can install it directly trough yum.</p><pre class="screen">yum install libcacard</pre><p>Otherwise follow these instructions. <span class="bold"><strong>Environmental - variable $BUILD_ROOT will point to a directory with stored sources and will - be used during whole build process. Variable $INST_ROOT will point to a - directory in which will be spice installed.</strong></span></p><pre class="screen">export BUILD_ROOT=/tmp/spice; mkdir $BUILD_ROOT; cd $BUILD_ROOT; -export INST_ROOT="/opt/spice"; mkdir $INST_ROOT -git clone git://anongit.freedesktop.org/~alon/libcacard -cd libcacard -./configure --prefix=/usr --libdir=/usr/lib64 # Ignore --libdir at Ubuntu -make -make install</pre></div><div class="section" title="Getting client sources"><div class="titlepage"><div><div><h4 class="title"><a name="getting_client"></a>Getting client sources</h4></div></div></div><pre class="screen">cd $BUILD_ROOT -git clone git://cgit.freedesktop.org/spice/spice-protocol -git clone git://cgit.freedesktop.org/spice/spice -wget http://downloads.us.xiph.org/releases/celt/celt-0.5.1.3.tar.gz -tar xvzf celt-0.5.1.3.tar.gz - </pre></div><div class="section" title="Getting client/server sources"><div class="titlepage"><div><div><h4 class="title"><a name="getting_server"></a>Getting client/server sources</h4></div></div></div><p>Skip this section if you don't want to build server side.</p><pre class="screen">cd $BUILD_ROOT -git clone git://cgit.freedesktop.org/spice/qemu -cd qemu; git checkout -b spice.v13 origin/spice.v13; cd .. -git clone git://cgit.freedesktop.org/spice/spice-protocol -git clone git://cgit.freedesktop.org/spice/spice -git clone git://cgit.freedesktop.org/spice/win32/vd_agent -git clone git://cgit.freedesktop.org/spice/win32/qxl -git clone git://cgit.freedesktop.org/spice/slirp -wget http://downloads.us.xiph.org/releases/celt/celt-0.5.1.3.tar.gz -tar xvzf celt-0.5.1.3.tar.gz</pre></div><div class="section" title="Building common sources."><div class="titlepage"><div><div><h4 class="title"><a name="building_common"></a>Building common sources.</h4></div></div></div><p>This part applies to both server and client build process.</p><pre class="screen">cd $BUILD_ROOT/spice-protocol -mkdir m4 -./autogen.sh --prefix=$INST_ROOT -sudo make install -cd $BUILD_ROOT/celt-0.5.1.3 -./configure --prefix=$INST_ROOT -sudo make install -</pre></div><div class="section" title="Building client side tools"><div class="titlepage"><div><div><h4 class="title"><a name="d0e385"></a>Building client side tools</h4></div></div></div><pre class="screen">cd $BUILD_ROOT/spice -./autogen.sh --prefix=$INST_ROOT --enable-smartcard -cd client -sudo make install</pre></div><div class="section" title="Building server side tools"><div class="titlepage"><div><div><h4 class="title"><a name="d0e390"></a>Building server side tools</h4></div></div></div><p>These instruction contains flags for minimal working build of qemu with spice support enabled. - You might want to build qemu with --enable-io-thread options</p><pre class="screen">cd $SRC_ROOT/qemu -./configure --prefix=$INST_ROOT --target-list=x86_64-softmmu --enable-spice -make</pre></div></div><div class="section" title="Setting up PATH"><div class="titlepage"><div><div><h3 class="title"><a name="d0e397"></a>Setting up PATH</h3></div></div></div><p>Last steps before starting with spice are to set proper PATH variable. - For example RHEL is using /usr/libexec as directory for spicec and qemu-kvm binaries. - Following setup should be suitable for qemu and spice build according to instructions in - this chapter.</p><pre class="screen">echo "export PATH=$PATH:$INST_ROOT/bin:$BUILD_ROOT/x86_64-softmmu >> ~/.bashrc -source ~/.bashrc</pre><p>You should now be able to access qemu-system-x86_64 and spicec binaries.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 2. Installation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. Spice basics</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/chunks/ch03.html b/books/html/chunks/ch03.html deleted file mode 100644 index b08f809..0000000 --- a/books/html/chunks/ch03.html +++ /dev/null @@ -1,3 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 3. Spice basics</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="ch02s02.html" title="Building Spice in Generic Linux"><link rel="next" href="ch03s02.html" title="Launching qemu"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 3. Spice basics</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a></td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 3. Spice basics"><div class="titlepage"><div><div><h2 class="title"><a name="basics"></a>Chapter 3. Spice basics</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="ch03.html#definitions">Basic Definitions</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#host">Host</a></span></dt><dt><span class="section"><a href="ch03.html#guest">Guest</a></span></dt><dt><span class="section"><a href="ch03.html#client">Client</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s02.html">Launching qemu</a></span></dt><dt><span class="section"><a href="ch03s03.html">Connecting to guest</a></span></dt></dl></div><div class="section" title="Basic Definitions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="definitions"></a>Basic Definitions</h2></div></div></div><div class="section" title="Host"><div class="titlepage"><div><div><h3 class="title"><a name="host"></a>Host</h3></div></div></div><p>Host is a machine running instance of qemu-kvm.</p></div><div class="section" title="Guest"><div class="titlepage"><div><div><h3 class="title"><a name="guest"></a>Guest</h3></div></div></div><p>Guest is a virtual machine hosted on <a class="link" href="ch03.html#host" title="Host">host</a> which will be accessed by using spice client.</p></div><div class="section" title="Client"><div class="titlepage"><div><div><h3 class="title"><a name="client"></a>Client</h3></div></div></div><p>Client is reffering to a system running spice client (e.g. spicec or spicy).</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s02.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch03s02.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Building Spice in Generic Linux </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Launching qemu</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/chunks/ch03s02.html b/books/html/chunks/ch03s02.html deleted file mode 100644 index e8f899f..0000000 --- a/books/html/chunks/ch03s02.html +++ /dev/null @@ -1,30 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Launching qemu</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch03.html" title="Chapter 3. Spice basics"><link rel="prev" href="ch03.html" title="Chapter 3. Spice basics"><link rel="next" href="ch03s03.html" title="Connecting to guest"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Launching qemu</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Spice basics</th><td width="20%" align="right"> <a accesskey="n" href="ch03s03.html">Next</a></td></tr></table><hr></div><div class="section" title="Launching qemu"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="qemu_basics"></a>Launching qemu</h2></div></div></div><p>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 <a class="link" href="definitions" target="_top">Basic Definitions</a> to be sure that you know - difference between the host, client and guest. You can ignore notation If guest, client - and host are on the same machine.</p><p> - <span class="bold"><strong>First important thing to do is to create a guest - image.</strong></span> You can use any raw device like clean logical volume, or iSCSI - lun. You may also use file as image for guest. I'll use file created by qemu-img as a demonstration. - </p><p> - Following command will allocate 10GB file. See qemu-img manpage for further information. - </p><pre class="screen">host# qemu-img create /path/to/xp.img 10G</pre><p> - 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. - </p><pre class="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</pre><p> - 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. - </p><p> Spice port option define what port will be used for communication with client. Spice - option disable-ticketing is telling us that ticketing <span class="italic">(simple - authentification method)</span> is not used. Virtio and chardev devices are - required by <a class="link" href="SpiceUserManual-Introduction.xml#vdagent" target="_top">guest - agent</a>. - </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03s03.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 3. Spice basics </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Connecting to guest</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/chunks/ch03s03.html b/books/html/chunks/ch03s03.html deleted file mode 100644 index 8821749..0000000 --- a/books/html/chunks/ch03s03.html +++ /dev/null @@ -1,27 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Connecting to guest</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="ch03.html" title="Chapter 3. Spice basics"><link rel="prev" href="ch03s02.html" title="Launching qemu"><link rel="next" href="ch04.html" title="Chapter 4. References"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Connecting to guest</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a> </td><th width="60%" align="center">Chapter 3. Spice basics</th><td width="20%" align="right"> <a accesskey="n" href="ch04.html">Next</a></td></tr></table><hr></div><div class="section" title="Connecting to guest"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="spicec_basics"></a>Connecting to guest</h2></div></div></div><p> - Folliwng section will show you basic usage of spice client. Example connection will be related to qemu - instance executed in <a class="link" href="ch03s02.html" title="Launching qemu">previous section</a>. - </p><p> - Be aware that port used for spice communication <span class="italic">(port 3001 in our case)</span> should not be blocked by firewall. - <span class="bold"><strong>Host myhost is reffering to machine which is running our qemu instance.</strong></span> - </p><pre class="screen">client# spicec -h myhost -p 3001</pre><div class="figure"><a name="d0e480"></a><p class="title"><b>Figure 3.1. Established connection to Windows 2008 guest</b></p><div class="figure-contents"><div class="mediaobject"><img src="../resources/spicec01.png" alt="Established connection to Windows 2008 guest"></div></div></div><br class="figure-break"><p> - 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. - - <span class="bold"><strong>You can eliminate this problem by using <a class="link" href="ch03s03.html#ticketing">ticketing</a> or SSL.</strong></span> - - </p><p><a name="ticketing"></a> - Ticketing is simple authentication system which enables you to set simple ticket to a vm. - Client has to authentificate before connection can be established. See spice option password in - following example. - </p><pre class="screen">host# sudo qemu-kvm -boot order=dc -vga qxl \ - -spice port=3001,password=mysecretpassword -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</pre><pre class="screen">client# spicec -h myhost -p 3001 -w mysecretpassword</pre><p>Spice session won't be established in case that correct ticket wasn't passed to the client.</p><p> - You might have figured out that passing ticket as commandline option isn't very safe way at all. - <span class="bold"><strong>It's not safe as everybody with access to host can read it from output of ps(1).</strong></span> - To prevent this ticket can be also set by using qemu-console command spice._set_ticket. - </p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Launching qemu </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 4. References</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/chunks/ch04.html b/books/html/chunks/ch04.html deleted file mode 100644 index 640ef71..0000000 --- a/books/html/chunks/ch04.html +++ /dev/null @@ -1,3 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Chapter 4. References</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="up" href="index.html" title="Spice User Manual"><link rel="prev" href="ch03s03.html" title="Connecting to guest"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 4. References</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s03.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr></div><div lang="" class="chapter" title="Chapter 4. References"><div class="titlepage"><div><div><h2 class="title"><a name="d0e508"></a>Chapter 4. References</h2></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><a name="spice_protocol_defs"></a>Spice remote computing protocol definition</p></li></ol></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s03.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top">Connecting to guest </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/html/chunks/index.html b/books/html/chunks/index.html deleted file mode 100644 index c31562e..0000000 --- a/books/html/chunks/index.html +++ /dev/null @@ -1,6 +0,0 @@ -<html><head> - <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> - <title>Spice User Manual</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><link rel="home" href="index.html" title="Spice User Manual"><link rel="next" href="ch01.html" title="Chapter 1. Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Spice User Manual</th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr></table><hr></div><div lang="en" class="book" title="Spice User Manual"><div class="titlepage"><div><div><h1 class="title"><a name="d0e2"></a>Spice User Manual</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author">Lubos Kocman</h3><code class="email"><<a class="email" href="mailto:lkocman@redhat.com">lkocman@redhat.com</a>></code></div><div class="author"><h3 class="author">Arnon Giloba</h3><code class="email"><<a class="email" href="mailto:agiloba@redhat.com">agiloba@redhat.com</a>></code></div><div class="author"><h3 class="author">Yaniv Kamay</h3><code class="email"><<a class="email" href="mailto:ykamay@redhat.com">ykamay@redhat.com</a>></code></div></div></div><div><p class="releaseinfo">Draft 54</p></div><div><p class="copyright">Copyright © 2009, 2010, 2011 Red Hat, Inc.</p></div><div><div class="legalnotice" title="Legal Notice"><a name="d0e31"></a><p> - Licensed under a Creative Commons Attribution-Share Alike 3.0 United States License - (see <a class="link" href="http://creativecommons.org/licenses/by-sa/3.0/us/legalcode" target="_top">http://creativecommons.org/licenses/by-sa/3.0/us/legalcode</a>). - </p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="ch01.html">1. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#d0e69">Spice and Spice-related Compoments</a></span></dt><dd><dl><dt><span class="section"><a href="ch01.html#spice_server">Spice Server</a></span></dt><dt><span class="section"><a href="ch01.html#spice_client">Spice Client</a></span></dt><dt><span class="section"><a href="ch01.html#d0e82">QXL Device and Drivers</a></span></dt><dt><span class="section"><a href="ch01.html#d0e87">VDI Port Device</a></span></dt><dt><span class="section"><a href="ch01.html#vdagent">Spice Agent</a></span></dt></dl></dd><dt><span class="section"><a href="ch01s02.html">Features</a></span></dt><dd><dl><dt><span class="section"><a href="ch01s02.html#multiple_channels">Multiple Channels</a></span></dt><dt><span class="section"><a href="ch01s02.html#image_compression">Image Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#video_compression">Video Compression</a></span></dt><dt><span class="section"><a href="ch01s02.html#mouse_modes">Mouse modes</a></span></dt><dt><span class="section"><a href="ch01s02.html#other_features">Other Features</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch02.html">2. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#rhel_fedora">Installing Spice in RHEL or Fedora </a></span></dt><dd><dl><dt><span class="section"><a href="ch02.html#d0e207">RHEL >=6 and Fedora >=13</a></span></dt><dt><span class="section"><a href="ch02.html#d0e220">RHEL 5</a></span></dt><dt><span class="section"><a href="ch02.html#d0e230">RHEVM Users</a></span></dt></dl></dd><dt><span class="section"><a href="ch02s02.html">Building Spice in Generic Linux</a></span></dt><dd><dl><dt><span class="section"><a href="ch02s02.html#req_client">Client requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#req_host">Host requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e312">Guest requirements</a></span></dt><dt><span class="section"><a href="ch02s02.html#d0e397">Setting up PATH</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ch03.html">3. Spice basics</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#definitions">Basic Definitions</a></span></dt><dd><dl><dt><span class="section"><a href="ch03.html#host">Host</a></span></dt><dt><span class="section"><a href="ch03.html#guest">Guest</a></span></dt><dt><span class="section"><a href="ch03.html#client">Client</a></span></dt></dl></dd><dt><span class="section"><a href="ch03s02.html">Launching qemu</a></span></dt><dt><span class="section"><a href="ch03s03.html">Connecting to guest</a></span></dt></dl></dd><dt><span class="chapter"><a href="ch04.html">4. References</a></span></dt></dl></div><div class="list-of-figures"><p><b>List of Figures</b></p><dl><dt>3.1. <a href="ch03s03.html#d0e480">Established connection to Windows 2008 guest</a></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="ch01.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Chapter 1. Introduction</td></tr></table></div></body></html>
\ No newline at end of file diff --git a/books/pdf/SpiceUserManual.pdf b/books/pdf/SpiceUserManual.pdf Binary files differdeleted file mode 100644 index 367648e..0000000 --- a/books/pdf/SpiceUserManual.pdf +++ /dev/null |
