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.

ChangeLog

+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

docs/libvir.html

@@ -1593,6 +1593,11 @@ latest version from CVS</a> </li>
 
 <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>
@@ -1659,7 +1664,7 @@ source on Windows:
       <th valign="top" align="right"> Packages </th>
       <td>
 	openssh <br/>
-	sunrpc <br/>
+	sunrpc &ge; 4.0-4 (see below) <br/>
       </td>
     </tr>
   </table>
@@ -1678,6 +1683,23 @@ source on Windows:
     Note that you need to do this as Windows Administrator. </p>
 </li>
 
+<li>
+  <p> Install Cygwin sunrpc &ge; 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
@@ -1745,23 +1767,45 @@ src/virsh.exe <a href="http://libvirt.org/uri.html">-c qemu://remote/system</a>
 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>
+  <p>
+    (Change the version number to your version of Python).  You
+    can test Python support from the command line:
+  </p>
 
--->
+<pre>
+python
+&gt;&gt;&gt; import libvirt
+&gt;&gt;&gt; conn = libvirt.open ("test:///default")
+&gt;&gt;&gt; conn.listDomainsID ()
+[1]
+&gt;&gt;&gt; dom = conn.lookupByID (1)
+&gt;&gt;&gt; dom.XMLDesc (0)
+"&lt;domain type='test' id='1'&gt; ..."
+</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>
 

docs/windows.html

@@ -39,6 +39,11 @@ latest version from CVS</a> </li>
 
 <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:
@@ -87,7 +92,7 @@ source on Windows:
     </tr><tr><th valign="top" align="right"> Packages </th>
       <td>
 	openssh <br />
-	sunrpc <br /></td>
+	sunrpc &#8805; 4.0-4 (see below) <br /></td>
     </tr></table></li>
 
 <li>
@@ -103,6 +108,23 @@ source on Windows:
     Note that you need to do this as Windows Administrator. </p>
 </li>
 
+<li>
+  <p> Install Cygwin sunrpc &#8805; 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
@@ -170,4 +192,42 @@ src/virsh.exe <a href="http://libvirt.org/uri.html">-c qemu://remote/system</a>
 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
+&gt;&gt;&gt; import libvirt
+&gt;&gt;&gt; conn = libvirt.open ("test:///default")
+&gt;&gt;&gt; conn.listDomainsID ()
+[1]
+&gt;&gt;&gt; dom = conn.lookupByID (1)
+&gt;&gt;&gt; dom.XMLDesc (0)
+"&lt;domain type='test' id='1'&gt; ..."
+</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&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://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>