2005-12-07 09:33:00 +00:00
<?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">
2006-02-09 17:45:11 +00:00
< 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 >
2005-12-08 23:49:08 +00:00
< 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 >
2006-02-10 08:43:31 +00:00
< / 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
2005-12-09 13:04:05 +00:00
General Public License< / a > , see the file COPYING.LIB in the distribution
2006-02-10 08:43:31 +00:00
for the precise wording. The only library that libvirt depends upon is the
2005-12-09 13:04:05 +00:00
Xen store access library which is also licenced under the LGPL.< / p >
2005-12-08 23:49:08 +00:00
< / li >
2006-02-10 08:43:31 +00:00
< li > < em > Can I embed libvirt in a proprietary application ?< / em >
< p > Yes. The LGPL allows you to embed libvirt into a proprietary
2005-12-09 13:04:05 +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
will decrease your maintainance costs anyway if you do so.< / p >
2005-12-08 23:49:08 +00:00
< / li >
2006-02-10 08:43:31 +00:00
< / ol > < h3 > < a name = "Installati" id = "Installati" > Installation< / a > < / h3 > < ol > < li > < em > Where can I get libvirt< / em > ?
< p > The original distribution comes from < a href = "ftp://libvirt.org/libvirt/" > ftp://libvirt.org/libvirt/< / a > .< / p >
2005-12-08 23:49:08 +00:00
< / li >
2006-02-10 08:43:31 +00:00
< li > < em > I can't install the libvirt/libvirt-devel RPM packages due to failed
2005-12-08 23:49:08 +00:00
dependencies< / em >
< p > The most generic solution is to re-fetch the latest src.rpm , and
rebuild it locally with< / p >
2006-02-10 08:43:31 +00:00
< p > < code > rpm --rebuild libvirt-xxx.src.rpm< / code > .< / p >
2005-12-08 23:49:08 +00:00
< p > If everything goes well it will generate two binary rpm packages (one
2005-12-09 13:04:05 +00:00
providing the shared libs and virsh, and the other one, the -devel
2005-12-08 23:49:08 +00:00
package, providing includes, static libraries and scripts needed to build
2006-02-10 08:43:31 +00:00
applications with libvirt that you can install locally.< / p >
2005-12-09 13:04:05 +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 >
2005-12-08 23:49:08 +00:00
< / li >
2005-12-13 17:20:25 +00:00
< li > < em > Failure to use the API for non-root users< / em >
2006-01-23 13:24:07 +00:00
< 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 be
2006-02-03 16:51:36 +00:00
forbidden to user, at least for monitoring purposes. If "virsh dinfo"
2006-01-23 13:24:07 +00:00
fails to run as an user, change the mode of the xenstore read-only socket
with:< / p >
2005-12-13 17:20:25 +00:00
< p > < code > chmod 666 /var/run/xenstored/socket_ro< / code > < / p >
2006-01-29 10:56:15 +00:00
< p > and also make sure that the Xen Daemon is running correctly with local
HTTP server enabled, this is defined in
< code > /etc/xen/xend-config.sxp< / code > which need the following line to be
enabled:< / p >
< p > < code > (xend-http-server yes)< / code > < / p >
< p > If needed restart the xend daemon after making the change with the
following command run as root:< / p >
< p > < code > service xend restart< / code > < / p >
2005-12-13 17:20:25 +00:00
< / li >
2006-02-10 08:43:31 +00:00
< / 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 >
2005-12-08 23:49:08 +00:00
< 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
update your list of installed shared libs.< / p >
< / li >
2006-02-10 08:43:31 +00:00
< li > < em > What other libraries are needed to compile/install libvirt ?< / em >
2005-12-08 23:49:08 +00:00
< p > Libvir requires libxenstore, which is usually provided by the xen
2005-12-09 13:04:05 +00:00
packages as well as the public headers to compile against libxenstore.< / p >
2005-12-08 23:49:08 +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
autogen.sh script to regenerate the configure script and Makefiles,
like:< / p >
< p > < code > ./autogen.sh --prefix=/usr --disable-shared< / code > < / p >
< / li >
2006-02-10 08:43:31 +00:00
< / 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
2005-12-09 13:04:05 +00:00
pkgconfig support, which can be used directly from autoconf support or
via the pkg-config command line tool, like:< / p >
2006-02-10 08:43:31 +00:00
< p > < code > pkg-config libvirt --libs< / code > < / p >
2005-12-08 23:49:08 +00:00
< / li >
2006-02-10 08:43:31 +00:00
< / 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 = "FAQ.html" > FAQ< / a > < / li > < li > < a href = "bugs.html" > Reporting bugs and getting help< / a > < / li > < li > < a style = "font-weight:bold" href = "html/index.html" > API Menu< / 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 = "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 >
