+Thu Nov 29 16:19:00 GMT 2007 Richard W.M. Jones <rjones@redhat.com>
+
+ * docs/libvir.html, docs/windows.html: Updated Windows
+ documentation now that we have shared libraries and Python
+ working.
+
Thu Nov 29 09:15:00 GMT 2007 Richard W.M. Jones <rjones@redhat.com>
* src/virsh.c: Added #include <time.h> so it can compile
<li> The latest source patch from
<a href="ftp://libvirt.org/libvirt/win32">the download area</a>. </li>
+
+<li> A version of Cygwin sunrpc, patched to support building
+ <code>librpc.dll</code>.
+ A patch and a binary package are available from
+ <a href="ftp://libvirt.org/libvirt/win32">the download area</a>. </li>
</ol>
<p>
<th valign="top" align="right"> Packages </th>
<td>
openssh <br/>
- sunrpc <br/>
+ sunrpc ≥ 4.0-4 (see below) <br/>
</td>
</tr>
</table>
Note that you need to do this as Windows Administrator. </p>
</li>
+<li>
+ <p> Install Cygwin sunrpc ≥ 4.0-4 package, patched to include
+ <code>librpc.dll</code>.
+ To do this, first check to see whether <code>/usr/lib/librpc.dll</code>
+ exists. If it does, you're good to go and can skip to the next
+ step. </p>
+
+ <p>
+ If you don't have this file, either install the binary package
+ <a href="ftp://libvirt.org/libvirt/win32/sunrpc-4.0-4.tar.bz2">sunrpc-4.0-4.tar.bz2</a> (just unpack it, as Administrator, in the Cygwin root directory).
+ Or you can download the
+ <a href="ftp://libvirt.org/libvirt/win32/sunrpc-4.0-dll.patch">source patch</a>
+ and apply it by hand to the Cygwin sunrpc package (eg. using
+ cygport).
+ </p>
+</li>
+
<li>
<p>
Check out
make install
</pre>
</li>
-</ol>
-<!--
+<li>
+ <p>
+ The above steps should also build and install Python modules.
+ However for reasons which I don't fully understand, Python won't
+ look in the
+ non-standard <code>/usr/local/lib/python*/site-packages/</code>
+ directory by default so you may need to set the environment
+ variable PYTHONPATH:
+ </p>
-<p>
-In the meantime please
-<a href="https://www.redhat.com/archives/libvir-list/2007-November/thread.html#00175">read this thread</a>
-and in particular
-<a href="https://www.redhat.com/archives/libvir-list/2007-November/msg00211.html">the
-current status of libvirt support in Windows</a>.
+<pre>
+export PYTHONPATH=/usr/local/lib/python2.5/site-packages
+</pre>
-<p>
-Eventually we will have source and binary downloads available in
-<a href="ftp://libvirt.org/libvirt/win32">the download area</a>.
-</p>
+ (Change the version number to your version of Python). You
+ can test Python support from the command line:
+ </p>
--->
+<pre>
+python
+>>> import libvirt
+>>> conn = libvirt.open ("test:///default")
+>>> conn.listDomainsID ()
+[1]
+>>> dom = conn.lookupByID (1)
+>>> dom.XMLDesc (0)
+"<domain type='test' id='1'> ..."
+</pre>
+
+ <p>
+ The most common failure will be with <code>import libvirt</code>
+ which usually indicates that either <code>PYTHONPATH</code> is
+ wrong or a DLL cannot be loaded.
+ </p>
+</li>
+
+</ol>
<h2><a name="Remote">Remote support</a></h2>
<li> The latest source patch from
<a href="ftp://libvirt.org/libvirt/win32">the download area</a>. </li>
+
+<li> A version of Cygwin sunrpc, patched to support building
+ <code>librpc.dll</code>.
+ A patch and a binary package are available from
+ <a href="ftp://libvirt.org/libvirt/win32">the download area</a>. </li>
</ol><p>
These are the steps to take to compile libvirt from
source on Windows:
</tr><tr><th valign="top" align="right"> Packages </th>
<td>
openssh <br />
- sunrpc <br /></td>
+ sunrpc ≥ 4.0-4 (see below) <br /></td>
</tr></table></li>
<li>
Note that you need to do this as Windows Administrator. </p>
</li>
+<li>
+ <p> Install Cygwin sunrpc ≥ 4.0-4 package, patched to include
+ <code>librpc.dll</code>.
+ To do this, first check to see whether <code>/usr/lib/librpc.dll</code>
+ exists. If it does, you're good to go and can skip to the next
+ step. </p>
+
+ <p>
+ If you don't have this file, either install the binary package
+ <a href="ftp://libvirt.org/libvirt/win32/sunrpc-4.0-4.tar.bz2">sunrpc-4.0-4.tar.bz2</a> (just unpack it, as Administrator, in the Cygwin root directory).
+ Or you can download the
+ <a href="ftp://libvirt.org/libvirt/win32/sunrpc-4.0-dll.patch">source patch</a>
+ and apply it by hand to the Cygwin sunrpc package (eg. using
+ cygport).
+ </p>
+</li>
+
<li>
<p>
Check out
make install
</pre>
</li>
+
+<li>
+ <p>
+ The above steps should also build and install Python modules.
+ However for reasons which I don't fully understand, Python won't
+ look in the
+ non-standard <code>/usr/local/lib/python*/site-packages/</code>
+ directory by default so you may need to set the environment
+ variable PYTHONPATH:
+ </p>
+
+<pre>
+export PYTHONPATH=/usr/local/lib/python2.5/site-packages
+</pre>
+
+ <p>
+ (Change the version number to your version of Python). You
+ can test Python support from the command line:
+ </p>
+
+<pre>
+python
+>>> import libvirt
+>>> conn = libvirt.open ("test:///default")
+>>> conn.listDomainsID ()
+[1]
+>>> dom = conn.lookupByID (1)
+>>> dom.XMLDesc (0)
+"<domain type='test' id='1'> ..."
+</pre>
+
+ <p>
+ The most common failure will be with <code>import libvirt</code>
+ which usually indicates that either <code>PYTHONPATH</code> is
+ wrong or a DLL cannot be loaded.
+ </p>
+</li>
+
</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">Bindings for other languages</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="windows.html">Windows support</a></li><li><a href="remote.html">Remote support</a></li><li><a href="uri.html">Connection URIs</a></li><li><a href="hvsupport.html">Hypervisor support</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&component=libvirt&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=MODIFIED&short_desc_type=allwordssubstr&short_desc=&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://libvirt.org/ocaml/">OCaml bindings</a></li><li><a href="http://libvirt.org/ruby/">Ruby 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>
projects / libvirt.git / commitdiff