docs/deployment.html

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <!--
   5         This file is autogenerated from deployment.html.in
   6         Do not edit this file. Changes will be lost.
   7       -->
   8   <head>
   9     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  10     <link rel="stylesheet" type="text/css" href="main.css" />
  11     <link rel="SHORTCUT ICON" href="32favicon.png" />
  12     <title>libvirt: Deployment</title>
  13     <meta name="description" content="libvirt, virtualization, virtualization API" />
  14   </head>
  15   <body>
  16     <div id="header">
  17       <div id="headerLogo"></div>
  18       <div id="headerSearch">
  19         <form action="search.php" enctype="application/x-www-form-urlencoded" method="get"><div>
  20             <input id="query" name="query" type="text" size="12" value="" />
  21             <input id="submit" name="submit" type="submit" value="Search" />
  22           </div></form>
  23       </div>
  24     </div>
  25     <div id="body">
  26       <div id="menu">
  27         <ul class="l0"><li>
  28             <div>
  29               <a title="Front page of the libvirt website" class="inactive" href="index.html">Home</a>
  30             </div>
  31           </li><li>
  32             <div>
  33               <a title="Details of new features and bugs fixed in each release" class="inactive" href="news.html">News</a>
  34             </div>
  35           </li><li>
  36             <div>
  37               <a title="Applications known to use libvirt" class="inactive" href="apps.html">Applications</a>
  38             </div>
  39           </li><li>
  40             <div>
  41               <a title="Get the latest source releases, binary builds and get access to the source repository" class="inactive" href="downloads.html">Downloads</a>
  42             </div>
  43           </li><li>
  44             <div>
  45               <a title="Information for users, administrators and developers" class="active" href="docs.html">Documentation</a>
  46               <ul class="l1"><li>
  47                   <div>
  48                     <a title="How to compile libvirt" class="inactive" href="compiling.html">Compiling</a>
  49                   </div>
  50                 </li><li>
  51                   <div>
  52                     <span class="active">Deployment</span>
  53                     <ul class="l2"><li>
  54                         <div>
  55                           <a title="The URI formats used for connecting to libvirt" class="inactive" href="uri.html">URI format</a>
  56                         </div>
  57                       </li><li>
  58                         <div>
  59                           <a title="Enable remote access over TCP" class="inactive" href="remote.html">Remote access</a>
  60                         </div>
  61                       </li><li>
  62                         <div>
  63                           <a title="Configure authentication for the libvirt daemon" class="inactive" href="auth.html">Authentication</a>
  64                         </div>
  65                       </li><li>
  66                         <div>
  67                           <a title="Configure access control libvirt APIs" class="inactive" href="acl.html">Access control</a>
  68                         </div>
  69                       </li><li>
  70                         <div>
  71                           <a title="Migrating guests between machines" class="inactive" href="migration.html">Migration</a>
  72                         </div>
  73                       </li><li>
  74                         <div>
  75                           <a title="Access the libvirt daemon from a native Windows client" class="inactive" href="windows.html">Windows port</a>
  76                         </div>
  77                       </li><li>
  78                         <div>
  79                           <a title="The library and the daemon logging support" class="inactive" href="logging.html">Logging</a>
  80                         </div>
  81                       </li><li>
  82                         <div>
  83                           <a title="Audit trail logs for host operations" class="inactive" href="auditlog.html">Audit log</a>
  84                         </div>
  85                       </li><li>
  86                         <div>
  87                           <a title="Firewall and network filter configuration" class="inactive" href="firewall.html">Firewall</a>
  88                         </div>
  89                       </li><li>
  90                         <div>
  91                           <a title="Ensuring exclusive guest access to disks" class="inactive" href="locking.html">Disk locking</a>
  92                         </div>
  93                       </li><li>
  94                         <div>
  95                           <a title="Control groups integration" class="inactive" href="cgroups.html">CGroups</a>
  96                         </div>
  97                       </li><li>
  98                         <div>
  99                           <a title="Hooks for system specific management" class="inactive" href="hooks.html">Hooks</a>
 100                         </div>
 101                       </li></ul>
 102                   </div>
 103                 </li><li>
 104                   <div>
 105                     <a title="Overview of the logical subsystems in the libvirt API" class="inactive" href="intro.html">Architecture</a>
 106                   </div>
 107                 </li><li>
 108                   <div>
 109                     <a title="Description of the XML formats used in libvirt" class="inactive" href="format.html">XML format</a>
 110                   </div>
 111                 </li><li>
 112                   <div>
 113                     <a title="Hypervisor specific driver information" class="inactive" href="drivers.html">Drivers</a>
 114                   </div>
 115                 </li><li>
 116                   <div>
 117                     <a title="Reference manual for the C public API" class="inactive" href="html/index.html">API reference</a>
 118                   </div>
 119                 </li><li>
 120                   <div>
 121                     <a title="Bindings of the libvirt API for other languages" class="inactive" href="bindings.html">Language bindings</a>
 122                   </div>
 123                 </li><li>
 124                   <div>
 125                     <a title="Working on the internals of libvirt API, driver and daemon code" class="inactive" href="internals.html">Internals</a>
 126                   </div>
 127                 </li><li>
 128                   <div>
 129                     <a title="A guide and reference for developing with libvirt" class="inactive" href="devguide.html">Development Guide</a>
 130                   </div>
 131                 </li><li>
 132                   <div>
 133                     <a title="Command reference for virsh" class="inactive" href="virshcmdref.html">Virsh Commands</a>
 134                   </div>
 135                 </li><li>
 136                   <div>
 137                     <a title="Project governance and code of conduct" class="inactive" href="governance.html">Governance</a>
 138                   </div>
 139                 </li></ul>
 140             </div>
 141           </li><li>
 142             <div>
 143               <a title="User contributed content" class="inactive" href="http://wiki.libvirt.org">Wiki</a>
 144             </div>
 145           </li><li>
 146             <div>
 147               <a title="Frequently asked questions" class="inactive" href="http://wiki.libvirt.org/page/FAQ">FAQ</a>
 148             </div>
 149           </li><li>
 150             <div>
 151               <a title="How and where to report bugs and request features" class="inactive" href="bugs.html">Bug reports</a>
 152             </div>
 153           </li><li>
 154             <div>
 155               <a title="How to contact the developers via email and IRC" class="inactive" href="contact.html">Contact</a>
 156             </div>
 157           </li><li>
 158             <div>
 159               <a title="Available test suites for libvirt" class="inactive" href="testsuites.html">Test suites</a>
 160             </div>
 161           </li><li>
 162             <div>
 163               <a title="Miscellaneous links of interest related to libvirt" class="inactive" href="relatedlinks.html">Related Links</a>
 164             </div>
 165           </li><li>
 166             <div>
 167               <a title="Overview of all content on the website" class="inactive" href="sitemap.html">Sitemap</a>
 168             </div>
 169           </li></ul>
 170       </div>
 171       <div id="content">
 172         <h1>Deployment</h1>
 173         <ul><li>
 174             <a href="#packages">Pre-packaged releases</a>
 175           </li><li>
 176             <a href="#tarball">Self-built releases</a>
 177           </li><li>
 178             <a href="#git">Built from GIT</a>
 179           </li></ul>
 180         <h2>
 181           <a name="packages" shape="rect" id="packages">Pre-packaged releases</a>
 182           <a class="headerlink" href="#packages" title="Permalink to this headline">¶</a>
 183         </h2>
 184         <p>
 185       The libvirt API is now available in all major Linux distributions,
 186       so the simplest deployment approach is to use your distributions'
 187       package management software to install the <code>libvirt</code>
 188       module.
 189     </p>
 190         <h2>
 191           <a name="tarball" shape="rect" id="tarball">Self-built releases</a>
 192           <a class="headerlink" href="#tarball" title="Permalink to this headline">¶</a>
 193         </h2>
 194         <p>
 195       libvirt uses GNU autotools for its build system, so deployment
 196       follows the usual process of <code>configure; make ; make install</code>
 197     </p>
 198         <pre xml:space="preserve">
 199
 200       # ./configure --prefix=$HOME/usr
 201       # make
 202       # make install
 203     </pre>
 204         <h2>
 205           <a name="git" shape="rect" id="git">Built from GIT</a>
 206           <a class="headerlink" href="#git" title="Permalink to this headline">¶</a>
 207         </h2>
 208         <p>
 209       When building from GIT it is necessary to generate the autotools
 210       support files. This requires having <code>autoconf</code>,
 211       <code>automake</code>, <code>libtool</code> and <code>intltool</code>
 212       installed. The process can be automated with the <code>autogen.sh</code>
 213       script.
 214     </p>
 215         <pre xml:space="preserve">
 216
 217       # ./autogen.sh --prefix=$HOME/usr
 218       # make
 219       # make install
 220     </pre>
 221       </div>
 222     </div>
 223     <div id="footer">
 224       <p id="sponsor">
 225             Sponsored by:<br /><a href="http://et.redhat.com/"><img src="et.png" alt="Project sponsored by Red Hat Emerging Technology" /></a></p>
 226     </div>
 227   </body>
 228 </html>