2005-12-07 09:33:00 +00:00
|
|
|
<?xml version="1.0" encoding="ISO-8859-1"?>
|
2008-04-25 16:23:51 +00:00
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
2008-04-23 17:08:31 +00:00
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
|
|
|
<!--
|
|
|
|
|
This file is autogenerated from FAQ.html.in
|
|
|
|
|
Do not edit this file. Changes will be lost.
|
|
|
|
|
-->
|
|
|
|
|
<head>
|
|
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
|
|
|
|
|
<link rel="stylesheet" type="text/css" href="main.css" />
|
|
|
|
|
<link rel="SHORTCUT ICON" href="32favicon.png" />
|
|
|
|
|
<title>libvirt: FAQ</title>
|
|
|
|
|
<meta name="description" content="libvirt, virtualization, virtualization API" />
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
<div id="header">
|
|
|
|
|
<div id="headerLogo"></div>
|
|
|
|
|
<div id="headerSearch">
|
2008-04-25 16:23:51 +00:00
|
|
|
<form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><div>
|
|
|
|
|
<input id="query" name="query" type="text" size="12" value="" />
|
|
|
|
|
<input id="submit" name="submit" type="submit" value="Search" />
|
|
|
|
|
</div></form>
|
2008-04-23 17:08:31 +00:00
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
<div id="body">
|
2008-04-25 16:23:51 +00:00
|
|
|
<div id="menu">
|
|
|
|
|
<ul class="l0"><li>
|
|
|
|
|
<div>
|
|
|
|
|
<a title="Front page of the libvirt website" class="inactive" href="index.html">Home</a>
|
|
|
|
|
</div>
|
|
|
|
|
</li><li>
|
|
|
|
|
<div>
|
|
|
|
|
<a title="Details of new features and bugs fixed in each release" class="inactive" href="news.html">News</a>
|
|
|
|
|
</div>
|
|
|
|
|
</li><li>
|
|
|
|
|
<div>
|
|
|
|
|
<a title="Get the latest source releases, binary builds and get access to the source repository" class="inactive" href="downloads.html">Downloads</a>
|
|
|
|
|
</div>
|
|
|
|
|
</li><li>
|
|
|
|
|
<div>
|
|
|
|
|
<a title="Information for users, administrators and developers" class="inactive" href="docs.html">Documentation</a>
|
|
|
|
|
</div>
|
|
|
|
|
</li><li>
|
|
|
|
|
<div>
|
|
|
|
|
<a title="User contributed content" class="inactive" href="http://wiki.libvirt.org">Wiki</a>
|
|
|
|
|
</div>
|
|
|
|
|
</li><li>
|
|
|
|
|
<div>
|
|
|
|
|
<span class="active">FAQ</span>
|
|
|
|
|
</div>
|
|
|
|
|
</li><li>
|
|
|
|
|
<div>
|
|
|
|
|
<a title="How and where to report bugs and request features" class="inactive" href="bugs.html">Bug reports</a>
|
|
|
|
|
</div>
|
|
|
|
|
</li><li>
|
|
|
|
|
<div>
|
|
|
|
|
<a title="How to contact the developers via email and IRC" class="inactive" href="contact.html">Contact</a>
|
|
|
|
|
</div>
|
|
|
|
|
</li><li>
|
|
|
|
|
<div>
|
|
|
|
|
<a title="Miscellaneous links of interest related to libvirt" class="inactive" href="relatedlinks.html">Related Links</a>
|
|
|
|
|
</div>
|
|
|
|
|
</li><li>
|
|
|
|
|
<div>
|
|
|
|
|
<a title="Overview of all content on the website" class="inactive" href="sitemap.html">Sitemap</a>
|
|
|
|
|
</div>
|
|
|
|
|
</li></ul>
|
|
|
|
|
</div>
|
2008-04-23 17:08:31 +00:00
|
|
|
<div id="content">
|
|
|
|
|
<h1>FAQ</h1>
|
|
|
|
|
<p>Table of Contents:</p>
|
|
|
|
|
<ul><li>
|
|
|
|
|
<a href="FAQ.html#License">License(s)</a>
|
|
|
|
|
</li><li>
|
|
|
|
|
<a href="FAQ.html#Installati">Installation</a>
|
|
|
|
|
</li><li>
|
|
|
|
|
<a href="FAQ.html#Compilatio">Compilation</a>
|
|
|
|
|
</li><li>
|
|
|
|
|
<a href="FAQ.html#Developer">Developer corner</a>
|
|
|
|
|
</li></ul>
|
|
|
|
|
<h3><a name="License" id="License">License</a>(s)</h3>
|
|
|
|
|
<ol><li>
|
|
|
|
|
<em>Licensing Terms for libvirt</em>
|
|
|
|
|
<p>libvirt is released under the <a href="http://www.opensource.org/licenses/lgpl-license.html">GNU Lesser
|
2007-03-22 15:17:31 +00:00
|
|
|
General Public License</a>, see the file COPYING.LIB in the distribution
|
|
|
|
|
for the precise wording. The only library that libvirt depends upon is
|
|
|
|
|
the Xen store access library which is also licenced under the LGPL.</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li><li>
|
|
|
|
|
<em>Can I embed libvirt in a proprietary application ?</em>
|
|
|
|
|
<p>Yes. The LGPL allows you to embed libvirt into a proprietary
|
2007-03-22 15:17:31 +00:00
|
|
|
application. It would be graceful to send-back bug fixes and improvements
|
|
|
|
|
as patches for possible incorporation in the main development tree. It
|
2008-03-17 10:27:31 +00:00
|
|
|
will decrease your maintenance costs anyway if you do so.</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li></ol>
|
|
|
|
|
<h3>
|
|
|
|
|
<a name="Installati" id="Installati">Installation</a>
|
|
|
|
|
</h3>
|
|
|
|
|
<ol><li><em>Where can I get libvirt</em> ?
|
2006-02-10 08:43:31 +00:00
|
|
|
<p>The original distribution comes from <a href="ftp://libvirt.org/libvirt/">ftp://libvirt.org/libvirt/</a>.</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li><li>
|
|
|
|
|
<em>I can't install the libvirt/libvirt-devel RPM packages due to
|
2007-03-22 15:17:31 +00:00
|
|
|
failed dependencies</em>
|
2008-04-23 17:08:31 +00:00
|
|
|
<p>The most generic solution is to re-fetch the latest src.rpm , and
|
2007-03-22 15:17:31 +00:00
|
|
|
rebuild it locally with</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
<p><code>rpm --rebuild libvirt-xxx.src.rpm</code>.</p>
|
|
|
|
|
<p>If everything goes well it will generate two binary rpm packages (one
|
2007-03-22 15:17:31 +00:00
|
|
|
providing the shared libs and virsh, and the other one, the -devel
|
|
|
|
|
package, providing includes, static libraries and scripts needed to build
|
|
|
|
|
applications with libvirt that you can install locally.</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
<p>One can also rebuild the RPMs from a tarball:</p>
|
|
|
|
|
<p>
|
|
|
|
|
<code>rpmbuild -ta libdir-xxx.tar.gz</code>
|
|
|
|
|
</p>
|
|
|
|
|
<p>Or from a configured tree with:</p>
|
|
|
|
|
<p>
|
|
|
|
|
<code>make rpm</code>
|
|
|
|
|
</p>
|
|
|
|
|
</li><li>
|
|
|
|
|
<em>Failure to use the API for non-root users</em>
|
|
|
|
|
<p>Large parts of the API may only be accessible with root privileges,
|
2007-03-22 15:17:31 +00:00
|
|
|
however the read only access to the xenstore data doesnot have to be
|
|
|
|
|
forbidden to user, at least for monitoring purposes. If "virsh dominfo"
|
|
|
|
|
fails to run as an user, change the mode of the xenstore read-only socket
|
|
|
|
|
with:</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
<p>
|
|
|
|
|
<code>chmod 666 /var/run/xenstored/socket_ro</code>
|
|
|
|
|
</p>
|
|
|
|
|
<p>and also make sure that the Xen Daemon is running correctly with local
|
2007-03-22 15:17:31 +00:00
|
|
|
HTTP server enabled, this is defined in
|
|
|
|
|
<code>/etc/xen/xend-config.sxp</code> which need the following line to be
|
|
|
|
|
enabled:</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
<p>
|
|
|
|
|
<code>(xend-http-server yes)</code>
|
|
|
|
|
</p>
|
|
|
|
|
<p>If needed restart the xend daemon after making the change with the
|
2007-03-22 15:17:31 +00:00
|
|
|
following command run as root:</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
<p>
|
|
|
|
|
<code>service xend restart</code>
|
|
|
|
|
</p>
|
|
|
|
|
</li></ol>
|
|
|
|
|
<h3>
|
|
|
|
|
<a name="Compilatio" id="Compilatio">Compilation</a>
|
|
|
|
|
</h3>
|
|
|
|
|
<ol><li>
|
|
|
|
|
<em>What is the process to compile libvirt ?</em>
|
|
|
|
|
<p>As most UNIX libraries libvirt follows the "standard":</p>
|
|
|
|
|
<p>
|
|
|
|
|
<code>gunzip -c libvirt-xxx.tar.gz | tar xvf -</code>
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
<code>cd libvirt-xxxx</code>
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
<code>./configure --help</code>
|
|
|
|
|
</p>
|
|
|
|
|
<p>to see the options, then the compilation/installation proper</p>
|
|
|
|
|
<p>
|
|
|
|
|
<code>./configure [possible options]</code>
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
<code>make</code>
|
|
|
|
|
</p>
|
|
|
|
|
<p>
|
|
|
|
|
<code>make install</code>
|
|
|
|
|
</p>
|
|
|
|
|
<p>At that point you may have to rerun ldconfig or a similar utility to
|
2007-03-22 15:17:31 +00:00
|
|
|
update your list of installed shared libs.</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li><li>
|
|
|
|
|
<em>What other libraries are needed to compile/install libvirt ?</em>
|
|
|
|
|
<p>Libvirt requires libxenstore, which is usually provided by the xen
|
2007-03-22 15:17:31 +00:00
|
|
|
packages as well as the public headers to compile against libxenstore.</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
</li><li>
|
|
|
|
|
<em>I use the CVS version and there is no configure script</em>
|
|
|
|
|
<p>The configure script (and other Makefiles) are generated. Use the
|
2007-03-22 15:17:31 +00:00
|
|
|
autogen.sh script to regenerate the configure script and Makefiles,
|
|
|
|
|
like:</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
<p>
|
|
|
|
|
<code>./autogen.sh --prefix=/usr --disable-shared</code>
|
|
|
|
|
</p>
|
|
|
|
|
</li></ol>
|
|
|
|
|
<h3><a name="Developer" id="Developer">Developer</a> corner</h3>
|
|
|
|
|
<ol><li>
|
|
|
|
|
<em>Troubles compiling or linking programs using libvirt</em>
|
|
|
|
|
<p>To simplify the process of reusing the library, libvirt comes with
|
2007-03-22 15:17:31 +00:00
|
|
|
pkgconfig support, which can be used directly from autoconf support or
|
|
|
|
|
via the pkg-config command line tool, like:</p>
|
2008-04-23 17:08:31 +00:00
|
|
|
<p>
|
|
|
|
|
<code>pkg-config libvirt --libs</code>
|
|
|
|
|
</p>
|
|
|
|
|
</li></ol>
|
|
|
|
|
</div>
|
|
|
|
|
</div>
|
|
|
|
|
<div id="footer">
|
2008-04-28 08:29:35 +00:00
|
|
|
<p id="sponsor">
|
|
|
|
|
Sponsored by:<br /><a href="http://et.redhat.com/"><img src="et.png" alt="Project sponsored by Red Hat Emerging Technology" /></a></p>
|
2008-04-23 17:08:31 +00:00
|
|
|
</div>
|
|
|
|
|
</body>
|
|
|
|
|
</html>
|
