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