diff --git a/doc/image-guide/ch_creating_images_automatically.xml b/doc/image-guide/ch_creating_images_automatically.xml
index cf2472c06f..d4d2113475 100644
--- a/doc/image-guide/ch_creating_images_automatically.xml
+++ b/doc/image-guide/ch_creating_images_automatically.xml
@@ -10,30 +10,27 @@
creation.
Oz
- Oz is a command-line tool that automates the
- process of creating a virtual machine image file. Oz is a
- Python app that interacts with KVM to step through the
- process of installing a virtual machine. It uses a
- predefined set of kickstart (Red Hat-based systems) and
- preseed files (Debian-based systems) for operating systems
- that it supports, and it can also be used to create
- Microsoft Windows images. On Fedora, install Oz with yum:#yum install oz
- As of this writing, there are no Oz packages for
- Ubuntu, so you will need to either install from
- source or build your own .deb file.
+ Oz is a command-line tool that automates the process of
+ creating a virtual machine image file. Oz is a Python app that
+ interacts with KVM to step through the process of installing a
+ virtual machine. It uses a predefined set of kickstart (Red
+ Hat-based systems) and preseed files (Debian-based systems) for
+ operating systems that it supports, and it can also be used to
+ create Microsoft Windows images. On Fedora, install Oz with yum:#yum install oz
+ As of this writing, there are no Oz packages for Ubuntu,
+ so you will need to either install from source or build your
+ own .deb file.
- A full treatment of Oz is beyond the scope of this
- document, but we will provide an example. You can find
- additional examples of Oz template files on GitHub at
- A full treatment of Oz is beyond the scope of this document, but
+ we will provide an example. You can find additional examples of Oz
+ template files on GitHub at rackerjoe/oz-image-build/templates. Here's how
- you would create a CentOS 6.4 image with Oz.
+ >rackerjoe/oz-image-build/templates. Here's how you would
+ create a CentOS 6.4 image with Oz.Create a template file (we'll call it
- centos64.tdl) with the following
- contents. The only entry you will need to change is the
+ centos64.tdl) with the following contents.
+ The only entry you will need to change is the
<rootpw>
contents.<template>
<name>centos64</name>
@@ -68,53 +65,45 @@ echo -n > /lib/udev/rules.d/75-persistent-net-generator.rules
</command>
</commands>
</template>
-
- This Oz template specifies where to download the Centos
- 6.4 install ISO. Oz will use the version information to
- identify which kickstart file to use. In this case, it
- will be
+ This Oz template specifies where to download the Centos 6.4
+ install ISO. Oz will use the version information to identify which
+ kickstart file to use. In this case, it will be RHEL6.auto. It adds EPEL as a repository and
- installs the epel-release,
- cloud-utils, and
- cloud-init packages, as specified
- in the packages section of the
- file.
- After Oz does the initial OS install using the kickstart
- file, it customizes the image by doing an update. It also
- removes any reference to the eth0 device that libvirt
- creates while Oz does the customizing, as specified
- in the command section of the XML
+ >RHEL6.auto. It adds EPEL as a repository and install the
+ epel-release, cloud-utils,
+ and cloud-init packages, as specified in the
+ packages section of the file.
+ After Oz does the initial OS install using the kickstart file, it
+ updates the image's install packages with yum
+ update. It also removes any reference to the eth0
+ device that libvirt creates while Oz does the customizing, as
+ specified in the command section of the XML
file.To run this, do, as root:#oz-install -d3 -u centos64.tdl -x centos64-libvirt.xml
- The -d3 flag tells Oz to
- show status information as it runs.
+ The -d3 flag tells Oz to show
+ status information as it runs.The -u tells Oz to do the
- customization (install extra packages, run the
- commands) once it does the initial
- install.
+ customization (install extra packages, run the commands)
+ once it does the initial install.
- The -x <filename> flag
- tells Oz what filename to use to write out a
- libvirt XML file (otherwise it will default to
- something like
+ The -x <filename> flag tells Oz
+ what filename to use to write out a libvirt XML file
+ (otherwise it will default to something like
centos64Apr_03_2013-12:39:42).
- If you leave out the -u
- flag, or you want to edit the file to do additional
- customizations, you can use the
- oz-customize command, using the
- libvirt XML file that oz-install
- creates. For example:
+ If you leave out the -u flag, or
+ you want to edit the file to do additional customizations, you can
+ use the oz-customize command, using the libvirt
+ XML file that oz-install creates. For example:
#oz-customize -d3 centos64.tdl centos64-libvirt.xml
- Oz will invoke libvirt to boot the image inside of KVM,
- then Oz will ssh into the instance and perform the
- customizations.
+ Oz will invoke libvirt to boot the image inside of KVM, then Oz will
+ ssh into the instance and perform the customizations.
VMBuilder