Added Windows documentation.

de4a8ce6 · Richard W.M. Jones · a79cb800 · de4a8ce6 · de4a8ce6
隐藏空白更改
内联并排

Showing with 362 addition and 13 deletion

docs/libvir.html docs/libvir.html +202 -2

docs/windows.html docs/windows.html +160 -11

未找到文件。
--- a/docs/libvir.html
+++ b/docs/libvir.html
@@ -1539,10 +1539,208 @@ use the mailing-list if you don't get an answer there.</p>
 <h2><a name="Windows" id="Windows">Windows support</a></h2>

 <p>
-Instructions for compiling and installing libvirt on Windows will
-appear here shortly.
+Instructions for compiling and installing libvirt on Windows.
 </p>

+<ul>
+  <li><a href="#Windows_binaries">Binaries</a></li>
+  <li><a href="#Windows_compiling">Compiling from source</a></li>
+</ul>
+
+<h3><a name="Windows_binaries">Binaries</a></h3>
+
+<p>
+Binaries will be available from
+<a href="ftp://libvirt.org/libvirt/win32">the download area</a>
+(but we don't have binaries at the moment).
+</p>
+
+<h3><a name="Windows_compiling">Compiling from source</a></h3>
+
+<p>
+These are the steps to compile libvirt and the other
+tools from source on Windows.
+</p>
+
+<p>
+You will need:
+</p>
+
+<ol>
+<li> MS Windows.  Microsoft makes free (as beer) versions
+of some of its operating systems available to
+<a href="http://msdn.microsoft.com/">MSDN subscribers</a>.
+We used Windows 2008 Server for testing, virtualized under
+Linux using KVM-53 (earlier versions of KVM and QEMU won't
+run recent versions of Windows because of lack of full ACPI
+support, so make sure you have the latest KVM).
+</li>
+
+<li> <a href="http://www.cygwin.com/">Cygwin</a>'s
+<a href="http://www.cygwin.com/setup.exe">setup.exe</a>.
+</li>
+
+<li> A large amount of free disk space to install Cygwin.
+Make sure you have 10 GB free to install most Cygwin packages,
+although if you pare down the list of dependencies you may
+get away with much less. </li>
+
+<li> A network connection for Windows, since Cygwin downloads packages
+from the net as it installs. </li>
+
+<li> <a href="http://www.libvirt.org/downloads.html">Libvirt
+latest version from CVS</a> </li>
+
+<li> The latest source patch 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:
+</p>
+
+<ol>
+<li>
+  <p>Run Cygwin 
+    <a href="http://www.cygwin.com/setup.exe">setup.exe</a>.
+    When it starts up it will show a dialog like this:
+  </p>
+
+  <img src="windows-cygwin-1.png" width="504" height="388"
+       alt="Cygwin Net Release Setup Program" />
+</li>
+
+<li>
+  <p>Step through the setup program accepting defaults
+    or making choices as appropriate, until you get to the
+    screen for selecting packages:</p>
+
+  <img src="windows-cygwin-2.png" width="505" height="388"
+       alt="Cygwin Select Packages screen" />
+
+  <p>
+    The user interface here is very confusing.  You have to
+    click the "recycling icon" as shown by the arrow:
+  </p>
+
+  <img src="windows-cygwin-3.png" width="298" height="200"
+       alt="Cygwin Recycling Icon" />
+
+  <p>
+    which takes the package (and all packages in the subtree)
+    through several states such as "Install", "Reinstall", "Keep",
+    "Skip", "Uninstall", etc.
+  </p>
+
+</li>
+
+<li>
+  <p>You can install "All" (everything) or better select
+    just the groups and packages needed.  Select the following
+    groups and packages for installation:
+  </p>
+
+  <table>
+    <tr>
+      <th valign="top" align="right"> Groups </th>
+      <td>
+	Archive <br/>
+	Base <br/>
+	Devel <br/>
+	Editors <br/>
+	Mingw <br/>
+	Perl <br/>
+	Python <br/>
+	Shells <br/>
+      </td>
+    </tr>
+    <tr>
+      <th valign="top" align="right"> Packages </th>
+      <td>
+	openssh <br/>
+	sunrpc <br/>
+      </td>
+    </tr>
+  </table>
+</li>
+
+<li>
+  <p> Once Cygwin has finished installing, start a Cygwin bash shell
+    (either click on the desktop icon or look for Cygwin bash shell
+    in the Start menu). </p>
+
+<li>
+  <p>
+    Check out
+    <a href="http://www.libvirt.org/downloads.html">Libvirt from CVS</a> and
+    <a href="ftp://libvirt.org/libvirt/win32">apply the latest Windows patch</a>
+    to the source.
+  </p>
+</li>
+
+<li>
+  <p> Configure libvirt by doing: </p>
+<pre>
+autoreconf
+./configure --without-xen --without-qemu
+</pre>
+  <p> (The autoreconf step is probably optional). </p>
+  <p> The configure step will tell you if you have all the
+    required parts installed.  If something is missing you
+    will need to go back through Cygwin setup and install it.
+  </p>
+</li>
+
+<li>
+  <p> Rebuild the XDR structures: </p>
+<pre>
+rm qemud/remote_protocol.[ch] qemud/remote_dispatch_*.h
+make -C qemud remote_protocol.c
+</pre>
+</li>
+
+<li>
+  <p> Build: </p>
+<pre>
+make
+</pre>
+  <p> If this step is not successful, you should post a full
+    report <i>including complete messages</i> to
+    <a href="http://www.redhat.com/mailman/listinfo/libvir-list">the
+      libvirt mailing list</a>.
+  </p>
+</li>
+
+<li>
+  <p> Test it.  If you have access to a remote machine
+    running Xen or QEMU/KVM, and the libvirt daemon (<code>libvirtd</code>)
+    then you should be able to connect to it and display
+    domains using, eg:
+  </p>
+<pre>
+src/virsh.exe <a href="http://libvirt.org/uri.html">-c qemu://remote/system</a> list --all
+</pre>
+  <p>
+    Please read more about <a href="http://libvirt.org/remote.html">remote
+      support</a> before sending bug reports, to make sure that
+    any problems are really Windows and not just with remote
+    configuration / security.
+  </p>
+</li>
+
+<li>
+  <p>
+    You may want to install the library and programs by doing:
+  </p>
+<pre>
+make install
+</pre>
+</li>
+</ol>
+
+<!--
+
 <p>
 In the meantime please
 <a href="https://www.redhat.com/archives/libvir-list/2007-November/thread.html#00175">read this thread</a>
@@ -1555,6 +1753,8 @@ Eventually we will have source and binary downloads available in
 <a href="ftp://libvirt.org/libvirt/win32">the download area</a>.
 </p>

+-->
+
 <h2><a name="Remote">Remote support</a></h2>

 <p>

--- a/docs/windows.html
+++ b/docs/windows.html
 <?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">
 <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>Windows support</title></head><body><div id="container"><div id="intro"><div id="adjustments"></div><div id="pageHeader"></div><div id="content2"><h1 class="style1">Windows support</h1><p>
-Instructions for compiling and installing libvirt on Windows will
-appear here shortly.
+Instructions for compiling and installing libvirt on Windows.
+</p><ul><li><a href="#Windows_binaries">Binaries</a></li>
+  <li><a href="#Windows_compiling">Compiling from source</a></li>
+</ul><h3><a name="Windows_binaries" id="Windows_binaries">Binaries</a></h3><p>
+Binaries will be available from
+<a href="ftp://libvirt.org/libvirt/win32">the download area</a>
+(but we don't have binaries at the moment).
+</p><h3><a name="Windows_compiling" id="Windows_compiling">Compiling from source</a></h3><p>
+These are the steps to compile libvirt and the other
+tools from source on Windows.
 </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>.
+You will need:
+</p><ol><li> MS Windows.  Microsoft makes free (as beer) versions
+of some of its operating systems available to
+<a href="http://msdn.microsoft.com/">MSDN subscribers</a>.
+We used Windows 2008 Server for testing, virtualized under
+Linux using KVM-53 (earlier versions of KVM and QEMU won't
+run recent versions of Windows because of lack of full ACPI
+support, so make sure you have the latest KVM).
+</li>

-</p><p>
-Eventually we will have source and binary downloads available in
-<a href="ftp://libvirt.org/libvirt/win32">the download area</a>.
-</p></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>
+<li> <a href="http://www.cygwin.com/">Cygwin</a>'s
+<a href="http://www.cygwin.com/setup.exe">setup.exe</a>.
+</li>
+
+<li> A large amount of free disk space to install Cygwin.
+Make sure you have 10 GB free to install most Cygwin packages,
+although if you pare down the list of dependencies you may
+get away with much less. </li>
+
+<li> A network connection for Windows, since Cygwin downloads packages
+from the net as it installs. </li>
+
+<li> <a href="http://www.libvirt.org/downloads.html">Libvirt
+latest version from CVS</a> </li>
+
+<li> The latest source patch 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:
+</p><ol><li>
+  <p>Run Cygwin 
+    <a href="http://www.cygwin.com/setup.exe">setup.exe</a>.
+    When it starts up it will show a dialog like this:
+  </p>
+
+  <img src="windows-cygwin-1.png" width="504" height="388" alt="Cygwin Net Release Setup Program" /></li>
+
+<li>
+  <p>Step through the setup program accepting defaults
+    or making choices as appropriate, until you get to the
+    screen for selecting packages:</p>
+
+  <img src="windows-cygwin-2.png" width="505" height="388" alt="Cygwin Select Packages screen" /><p>
+    The user interface here is very confusing.  You have to
+    click the "recycling icon" as shown by the arrow:
+  </p>
+
+  <img src="windows-cygwin-3.png" width="298" height="200" alt="Cygwin Recycling Icon" /><p>
+    which takes the package (and all packages in the subtree)
+    through several states such as "Install", "Reinstall", "Keep",
+    "Skip", "Uninstall", etc.
+  </p>
+
+</li>
+
+<li>
+  <p>You can install "All" (everything) or better select
+    just the groups and packages needed.  Select the following
+    groups and packages for installation:
+  </p>
+
+  <table><tr><th valign="top" align="right"> Groups </th>
+      <td>
+	Archive <br />
+	Base <br />
+	Devel <br />
+	Editors <br />
+	Mingw <br />
+	Perl <br />
+	Python <br />
+	Shells <br /></td>
+    </tr><tr><th valign="top" align="right"> Packages </th>
+      <td>
+	openssh <br />
+	sunrpc <br /></td>
+    </tr></table></li>
+
+<li>
+  <p> Once Cygwin has finished installing, start a Cygwin bash shell
+    (either click on the desktop icon or look for Cygwin bash shell
+    in the Start menu). </p>
+
+</li><li>
+  <p>
+    Check out
+    <a href="http://www.libvirt.org/downloads.html">Libvirt from CVS</a> and
+    <a href="ftp://libvirt.org/libvirt/win32">apply the latest Windows patch</a>
+    to the source.
+  </p>
+</li>
+
+<li>
+  <p> Configure libvirt by doing: </p>
+<pre>
+autoreconf
+./configure --without-xen --without-qemu
+</pre>
+  <p> (The autoreconf step is probably optional). </p>
+  <p> The configure step will tell you if you have all the
+    required parts installed.  If something is missing you
+    will need to go back through Cygwin setup and install it.
+  </p>
+</li>
+
+<li>
+  <p> Rebuild the XDR structures: </p>
+<pre>
+rm qemud/remote_protocol.[ch] qemud/remote_dispatch_*.h
+make -C qemud remote_protocol.c
+</pre>
+</li>
+
+<li>
+  <p> Build: </p>
+<pre>
+make
+</pre>
+  <p> If this step is not successful, you should post a full
+    report <i>including complete messages</i> to
+    <a href="http://www.redhat.com/mailman/listinfo/libvir-list">the
+      libvirt mailing list</a>.
+  </p>
+</li>
+
+<li>
+  <p> Test it.  If you have access to a remote machine
+    running Xen or QEMU/KVM, and the libvirt daemon (<code>libvirtd</code>)
+    then you should be able to connect to it and display
+    domains using, eg:
+  </p>
+<pre>
+src/virsh.exe <a href="http://libvirt.org/uri.html">-c qemu://remote/system</a> list --all
+</pre>
+  <p>
+    Please read more about <a href="http://libvirt.org/remote.html">remote
+      support</a> before sending bug reports, to make sure that
+    any problems are really Windows and not just with remote
+    configuration / security.
+  </p>
+</li>
+
+<li>
+  <p>
+    You may want to install the library and programs by doing:
+  </p>
+<pre>
+make install
+</pre>
+</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>