libvirt/docs/drvlxc.html.in

<html>
  <body>
    <h1>LXC container driver</h1>
<p>
The libvirt LXC driver manages "Linux Containers".  Containers are sets of processes
with private namespaces which can (but don't always) look like separate machines, but
do not have their own OS.  Here are two example configurations.  The first is a very
light-weight "application container" which does not have it's own root image.  You would
start it using
</p>

<h3>Example config version 1</h3>
<p></p>
<pre>
&lt;domain type='lxc'&gt;
  &lt;name&gt;vm1&lt;/name&gt;
  &lt;memory&gt;500000&lt;/memory&gt;
  &lt;os&gt;
    &lt;type&gt;exe&lt;/type&gt;
    &lt;init&gt;/bin/sh&lt;/init&gt;
  &lt;/os&gt;
  &lt;vcpu&gt;1&lt;/vcpu&gt;
  &lt;clock offset='utc'/&gt;
  &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
  &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
  &lt;on_crash&gt;destroy&lt;/on_crash&gt;
  &lt;devices&gt;
    &lt;emulator&gt;/usr/libexec/libvirt_lxc&lt;/emulator&gt;
    &lt;interface type='network'&gt;
      &lt;source network='default'/&gt;
    &lt;/interface&gt;
    &lt;console type='pty' /&gt;
  &lt;/devices&gt;
&lt;/domain&gt;
</pre>

<p>
In the &lt;emulator&gt; element, be sure you specify the correct path
to libvirt_lxc, if it does not live in /usr/libexec on your system.
</p>

<p>
The next example assumes there is a private root filesystem
(perhaps hand-crafted using busybox, or installed from media,
debootstrap, whatever) under /opt/vm-1-root:
</p>
<p></p>
<pre>
&lt;domain type='lxc'&gt;
  &lt;name&gt;vm1&lt;/name&gt;
  &lt;memory&gt;32768&lt;/memory&gt;
  &lt;os&gt;
    &lt;type&gt;exe&lt;/type&gt;
    &lt;init&gt;/init&lt;/init&gt;
  &lt;/os&gt;
  &lt;vcpu&gt;1&lt;/vcpu&gt;
  &lt;clock offset='utc'/&gt;
  &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
  &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
  &lt;on_crash&gt;destroy&lt;/on_crash&gt;
  &lt;devices&gt;
    &lt;emulator&gt;/usr/libexec/libvirt_lxc&lt;/emulator&gt;
    &lt;filesystem type='mount'&gt;
      &lt;source dir='/opt/vm-1-root'/&gt;
      &lt;target dir='/'/&gt;
    &lt;/filesystem&gt;
    &lt;interface type='network'&gt;
      &lt;source network='default'/&gt;
    &lt;/interface&gt;
    &lt;console type='pty' /&gt;
  &lt;/devices&gt;
&lt;/domain&gt;
</pre>

<p>
In both cases, you can define and start a container using:</p>
<pre>
virsh --connect lxc:/// define v1.xml
virsh --connect lxc:/// start vm1
</pre>
and then get a console  using:
<pre>
virsh --connect lxc:/// console vm1
</pre>
<p>Now doing 'ps -ef' will only show processes in the container, for
instance.  You can undefine it using
</p>
<pre>
virsh --connect lxc:/// undefine vm1
</pre>
  </body>
</html>
Split website out into one file per page. APply new layout and styling 2008-04-23 21:08:31 +04:00			`<html>`
			`<body>`
			`<h1>LXC container driver</h1>`
* drvlxc.html.in drvlxc.html: some examples from Serge Hallyn daniel 2009-04-16 00:00:29 +04:00			`<p>`
			`The libvirt LXC driver manages "Linux Containers". Containers are sets of processes`
			`with private namespaces which can (but don't always) look like separate machines, but`
			`do not have their own OS. Here are two example configurations. The first is a very`
			`light-weight "application container" which does not have it's own root image. You would`
			`start it using`
			`</p>`

			`<h3>Example config version 1</h3>`
			`<p></p>`
			`<pre>`
			`<domain type='lxc'>`
Whitespace cleanup for pre-tags on the website 2009-11-14 02:09:20 +03:00			`<name>vm1</name>`
			`<memory>500000</memory>`
			`<os>`
			`<type>exe</type>`
			`<init>/bin/sh</init>`
			`</os>`
			`<vcpu>1</vcpu>`
			`<clock offset='utc'/>`
			`<on_poweroff>destroy</on_poweroff>`
			`<on_reboot>restart</on_reboot>`
			`<on_crash>destroy</on_crash>`
			`<devices>`
			`<emulator>/usr/libexec/libvirt_lxc</emulator>`
			`<interface type='network'>`
			`<source network='default'/>`
			`</interface>`
			`<console type='pty' />`
			`</devices>`
* drvlxc.html.in drvlxc.html: some examples from Serge Hallyn daniel 2009-04-16 00:00:29 +04:00			`</domain>`
			`</pre>`

docs: fix lxc examples * docs/drvlxc.html.in: Use correct VM name, and mention that libvirt_lxc might be in an alternate location. 2010-06-16 02:46:21 +04:00			`<p>`
			`In the <emulator> element, be sure you specify the correct path`
			`to libvirt_lxc, if it does not live in /usr/libexec on your system.`
			`</p>`

* drvlxc.html.in drvlxc.html: some examples from Serge Hallyn daniel 2009-04-16 00:00:29 +04:00			`<p>`
			`The next example assumes there is a private root filesystem`
			`(perhaps hand-crafted using busybox, or installed from media,`
			`debootstrap, whatever) under /opt/vm-1-root:`
			`</p>`
			`<p></p>`
			`<pre>`
			`<domain type='lxc'>`
Whitespace cleanup for pre-tags on the website 2009-11-14 02:09:20 +03:00			`<name>vm1</name>`
			`<memory>32768</memory>`
			`<os>`
			`<type>exe</type>`
			`<init>/init</init>`
			`</os>`
			`<vcpu>1</vcpu>`
			`<clock offset='utc'/>`
			`<on_poweroff>destroy</on_poweroff>`
			`<on_reboot>restart</on_reboot>`
			`<on_crash>destroy</on_crash>`
			`<devices>`
			`<emulator>/usr/libexec/libvirt_lxc</emulator>`
			`<filesystem type='mount'>`
			`<source dir='/opt/vm-1-root'/>`
			`<target dir='/'/>`
			`</filesystem>`
			`<interface type='network'>`
			`<source network='default'/>`
			`</interface>`
			`<console type='pty' />`
			`</devices>`
* drvlxc.html.in drvlxc.html: some examples from Serge Hallyn daniel 2009-04-16 00:00:29 +04:00			`</domain>`
			`</pre>`

			`<p>`
			`In both cases, you can define and start a container using:</p>`
			`<pre>`
Small doc fixes * src/libvirt.c: fix the doc of virNodeGetFreeMemory to say bytes * docs/drvlxc.html.in docs/drvlxc.html: fix command used in examples daniel 2009-04-17 19:34:53 +04:00			`virsh --connect lxc:/// define v1.xml`
docs: fix lxc examples * docs/drvlxc.html.in: Use correct VM name, and mention that libvirt_lxc might be in an alternate location. 2010-06-16 02:46:21 +04:00			`virsh --connect lxc:/// start vm1`
* drvlxc.html.in drvlxc.html: some examples from Serge Hallyn daniel 2009-04-16 00:00:29 +04:00			`</pre>`
			`and then get a console using:`
			`<pre>`
docs: fix lxc examples * docs/drvlxc.html.in: Use correct VM name, and mention that libvirt_lxc might be in an alternate location. 2010-06-16 02:46:21 +04:00			`virsh --connect lxc:/// console vm1`
* drvlxc.html.in drvlxc.html: some examples from Serge Hallyn daniel 2009-04-16 00:00:29 +04:00			`</pre>`
			`<p>Now doing 'ps -ef' will only show processes in the container, for`
docs: fix lxc examples * docs/drvlxc.html.in: Use correct VM name, and mention that libvirt_lxc might be in an alternate location. 2010-06-16 02:46:21 +04:00			`instance. You can undefine it using`
* drvlxc.html.in drvlxc.html: some examples from Serge Hallyn daniel 2009-04-16 00:00:29 +04:00			`</p>`
docs: fix lxc examples * docs/drvlxc.html.in: Use correct VM name, and mention that libvirt_lxc might be in an alternate location. 2010-06-16 02:46:21 +04:00			`<pre>`
			`virsh --connect lxc:/// undefine vm1`
			`</pre>`
Split website out into one file per page. APply new layout and styling 2008-04-23 21:08:31 +04:00			`</body>`
			`</html>`