From fbd08c7e2d38ff20eb44c39c32c61a287b9d311c Mon Sep 17 00:00:00 2001 From: Angus Salkeld Date: Tue, 14 Oct 2014 22:40:24 +1000 Subject: [PATCH] docs: update jeos_building instructions change "glance add" to "glance image-create" remove the oz section Change-Id: I8817d11fbf12c0c228df63c7783daea7bf7a11c5 --- doc/source/getting_started/jeos_building.rst | 97 +------------------- 1 file changed, 1 insertion(+), 96 deletions(-) diff --git a/doc/source/getting_started/jeos_building.rst b/doc/source/getting_started/jeos_building.rst index 8a26c12c4b..373a8d058b 100644 --- a/doc/source/getting_started/jeos_building.rst +++ b/doc/source/getting_started/jeos_building.rst @@ -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