FAQ.html 6.9 KB
Newer Older
1 2
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
D
Daniel Veillard 已提交
3
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" /><link rel="stylesheet" type="text/css" href="libvirt.css" /><link rel="SHORTCUT ICON" href="/32favicon.png" /><title>FAQ</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">FAQ</h1><p>Table of Contents:</p><ul><li><a href="FAQ.html#License">License(s)</a></li>
D
Daniel Veillard 已提交
4 5 6
  <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>
7
</ul><h3><a name="License" id="License">License</a>(s)</h3><ol><li><em>Licensing Terms for libvirt</em>
8 9 10 11 12
    <p>libvirt is released under the <a href="http://www.opensource.org/licenses/lgpl-license.html">GNU
    LesserGeneral Public License</a>, see the file COPYING.LIB in the
    distributionfor the precise wording. The only library that libvirt
    depends upon isthe Xen store access library which is also licenced under
    the LGPL.</p>
D
Daniel Veillard 已提交
13
  </li>
14
  <li><em>Can I embed libvirt in a proprietary application ?</em>
15 16 17 18
    <p>Yes. The LGPL allows you to embed libvirt into a
    proprietaryapplication. It would be graceful to send-back bug fixes and
    improvementsas patches for possible incorporation in the main development
    tree. Itwill decrease your maintainance costs anyway if you do so.</p>
D
Daniel Veillard 已提交
19
  </li>
20
</ol><h3><a name="Installati" id="Installati">Installation</a></h3><ol><li><em>Where can I get libvirt</em>?
21
    <p>The original distribution comes from <a href="ftp://libvirt.org/libvirt/">ftp://libvirt.org/libvirt/</a>.</p>
D
Daniel Veillard 已提交
22
  </li>
23 24 25 26
  <li><em>I can't install the libvirt/libvirt-devel RPM packages due tofailed
    dependencies</em>
    <p>The most generic solution is to re-fetch the latest src.rpm ,
    andrebuild it locally with</p>
27
    <p><code>rpm --rebuild libvirt-xxx.src.rpm</code>.</p>
28 29 30 31
    <p>If everything goes well it will generate two binary rpm packages
    (oneproviding the shared libs and virsh, and the other one, the
    -develpackage, providing includes, static libraries and scripts needed to
    buildapplications with libvirt that you can install locally.</p>
32 33 34 35
    <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>
D
Daniel Veillard 已提交
36
  </li>
37
  <li><em>Failure to use the API for non-root users</em>
38 39 40 41 42
    <p>Large parts of the API may only be accessible with root
    priviledges,however the read only access to the xenstore data doesnot
    have to beforbidden to user, at least for monitoring purposes. If "virsh
    dominfo"fails to run as an user, change the mode of the xenstore
    read-only socketwith:</p>
43
    <p><code>chmod 666 /var/run/xenstored/socket_ro</code></p>
44 45 46 47
    <p>and also make sure that the Xen Daemon is running correctly with
    localHTTP server enabled, this is defined
    in<code>/etc/xen/xend-config.sxp</code>which need the following line to
    beenabled:</p>
48
    <p><code>(xend-http-server yes)</code></p>
49 50
    <p>If needed restart the xend daemon after making the change with
    thefollowing command run as root:</p>
51
    <p><code>service xend restart</code></p>
52
  </li>
53 54 55 56
</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>
D
Daniel Veillard 已提交
57 58 59 60 61
    <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>
62 63
    <p>At that point you may have to rerun ldconfig or a similar utility
    toupdate your list of installed shared libs.</p>
D
Daniel Veillard 已提交
64
  </li>
65
  <li><em>What other libraries are needed to compile/install libvirt ?</em>
66 67 68
    <p>Libvirt requires libxenstore, which is usually provided by the
    xenpackages as well as the public headers to compile against
    libxenstore.</p>
D
Daniel Veillard 已提交
69 70
  </li>
  <li><em>I use the CVS version and there is no configure script</em>
71 72 73
    <p>The configure script (and other Makefiles) are generated. Use
    theautogen.sh script to regenerate the configure script and
    Makefiles,like:</p>
D
Daniel Veillard 已提交
74 75
    <p><code>./autogen.sh --prefix=/usr --disable-shared</code></p>
  </li>
76 77 78 79
</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
    withpkgconfig support, which can be used directly from autoconf support
    orvia the pkg-config command line tool, like:</p>
80
    <p><code>pkg-config libvirt --libs</code></p>
D
Daniel Veillard 已提交
81
  </li>
82
</ol></div></div><div class="linkList2"><div class="llinks2"><h3 class="links2"><span>main menu</span></h3><ul><li><a href="index.html">Home</a></li><li><a href="news.html">Releases</a></li><li><a href="intro.html">Introduction</a></li><li><a href="architecture.html">libvirt architecture</a></li><li><a href="downloads.html">Downloads</a></li><li><a href="format.html">XML Format</a></li><li><a href="python.html">Binding for Python</a></li><li><a href="errors.html">Handling of errors</a></li><li><a href="FAQ.html">FAQ</a></li><li><a href="bugs.html">Reporting bugs and getting help</a></li><li><a href="html/index.html">API Menu</a></li><li><a href="examples/index.html">C code examples</a></li><li><a href="ChangeLog.html">Recent Changes</a></li></ul></div><div class="llinks2"><h3 class="links2"><span>related links</span></h3><ul><li><a href="https://www.redhat.com/archives/libvir-list/">Mail archive</a></li><li><a href="https://bugzilla.redhat.com/bugzilla/buglist.cgi?product=Fedora+Core&amp;component=libvirt&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;bug_status=MODIFIED&amp;short_desc_type=allwordssubstr&amp;short_desc=&amp;long_desc_type=allwordssubstr">Open bugs</a></li><li><a href="http://virt-manager.et.redhat.com/">virt-manager</a></li><li><a href="http://search.cpan.org/~danberr/Sys-Virt-0.1.0/">Perl bindings</a></li><li><a href="http://www.cl.cam.ac.uk/Research/SRG/netos/xen/index.html">Xen project</a></li><li><form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><input name="query" type="text" size="12" value="Search..." /><input name="submit" type="submit" value="Go" /></form></li><li><a href="http://xmlsoft.org/"><img src="Libxml2-Logo-90x34.gif" alt="Made with Libxml2 Logo" /></a></li></ul><p class="credits">Graphics and design by <a href="mail:dfong@redhat.com">Diana Fong</a></p></div></div><div id="bottom"><p class="p1"></p></div></div></body></html>