openstack/deb-heat
Code Issues Proposed changes

docs: update jeos_building instructions

Browse Source 
change "glance add" to "glance image-create"
remove the oz section

Change-Id: I8817d11fbf12c0c228df63c7783daea7bf7a11c5
This commit is contained in:
Angus Salkeld 2014-10-14 22:40:24 +10:00
parent 4a8cb4b204
commit fbd08c7e2d
1 changed files with 1 additions and 96 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

97
doc/source/getting_started/jeos_building.rst
View File

@ -78,102 +78,7 @@ you can follow the steps bellow to build a fedora based image::
heat-config-script \
-o fedora-software-config.qcow2
Building an image with Oz
~~~~~~~~~~~~~~~~~~~~~~~~~
Another approach to building a heat-cfntools enabled image is to use Oz wrapped in a convenience script.
The example below demonstrates how to build an F17 image, but there are Oz tdl templates for several other distributions provided in heat-templates/jeos
Get heat-templates
------------------
Clone the heat-templates repository from GitHub at ``git://github.com/openstack/heat-templates.git``
Note Oz does not work in virt on virt situations. In this case, it is recommended that the prebuilt images are used.
Download OS install DVD and copy it to libvirt images location
--------------------------------------------------------------
::
sudo cp Downloads/Fedora-17-x86_64-DVD.iso /var/lib/libvirt/images
Install Oz (RPM distros)
------------------------
We recommend cloning oz from the latest master. Support for building guests based on recent distributions is not available in the version of Oz shipped with many distros.
On Fedora and other RPM-based distros::
git clone -q https://github.com/clalancette/oz.git
pushd oz
rm -f ~/rpmbuild/RPMS/noarch/oz-*
make rpm
sudo yum -q -y localinstall ~/rpmbuild/RPMS/noarch/oz-*
popd
Note: In the steps above, it's only necessary to be root for the yum localinstall, it's recommended not to be root while building the rpm.
Install Oz (DEB distros)
------------------------
We recommend cloning oz from the latest master. The debian packaging is broken in older versions and support for building guests based on recent distributions is not available in the version of Oz shipped with many distros.
On Fedora and other RPM-based distros:
On Debian, Ubuntu and other deb based distros::
git clone https://github.com/clalancette/oz.git
cd oz
make deb
cd ..
sudo dpkg -i oz_*_all.deb
sudo apt-get -f install
Note: Select yes to "Create or update supermin appliance.". This will rebuild the guestfs appliance to work with latest updates of Ubuntu. Oz will not work properly without updating the guestfs appliance.
Configure libguestfs (required by Oz) to work in latest Ubuntu 12
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Some files shipped with Ubuntu 12 are incompatible with libguestfs
used by the image creation software Oz. To allow heat-jeos to work
properly, run the following commands::
sudo chmod 644 /boot/vmlinuz*
sudo update-guestfs-appliance
Note: For more details see: http://permalink.gmane.org/gmane.comp.emulators.guestfs/1382
and http://libguestfs.org/guestfs-faq.1.html
Note: If you want to create F17 images, you may need a new libguestfs binary of version 1.18.0 or later. Ubuntu Precise may not have this version yet.
You can use the Debian Wheezy version including the `guestfs shared library`_, the tools_ and the `python libraries`_.
.. _guestfs shared library: http://packages.debian.org/wheezy/amd64/libguestfs0/download
.. _tools: http://packages.debian.org/wheezy/amd64/libguestfs-tools/download
.. _python libraries: http://packages.debian.org/wheezy/amd64/python-guestfs/download
Create a JEOS with heat-jeos.sh script
--------------------------------------
heat-templates/tools contains a convenience wrapper for Oz which demonstrates how to create a JEOS::
cd heat-templates/tools
sudo ./heat-jeos.sh ../jeos/F17-x86_64-cfntools.tdl F17-x86_64-cfntools
Note: the second argument is the name as defined inside the TDL, so it may not necessarily match the filename
Note: ``heat-jeos.sh`` must be run as root in order to create the disk image.
Register the image with glance
------------------------------
On successful completion, the heat-jeos.sh script will generate a qcow2 image under /var/lib/libvirt/images/
The image may then be pushed to glance, e.g::
source ~/.openstack/keystonerc
glance add name=F17-x86_64-cfntools is_public=true disk_format=qcow2 container_format=bare < /var/lib/libvirt/images/F17-x86_64-cfntools.qcow2
glance image-create --name=fedora-software-config --is-public=true --disk-format=qcow2 --container-format=bare < fedora-software-config.qcow2