Build Crowbar.ISO

Build the Crowbar ISO Instructions

https://github.com/dellcloudedge/crowbar/blob/master/README.build

Prereq: See Build Sledgehammer TAR and results into /.crowbar-build-cache

Notes:

• Please CORRECT this page if you find errors!
• Ensure that you are running bash 4 or greater as your shell.
• build_crowbar.sh uses associative arrays, which bash got in version 4.
• lines below assume working from home directory
• Build as ROOT (otherwise, check the install script to see which commands require sudo rights)
• Build ''requires'' a component known as "sledgehammer" that is a CentOS based image for discovery that is expected to be in the "../crowbar-sledgehammer/bin" directory. This TFTPboot image does not change often and is not part of the normal build steps. See Build Sledgehammer tar for details.
• Build process has been tested on Ubuntu 10.10

Build ISOs and Sledgehammer TARs are available on http://crowbar.zehicle.com if you don’t want to follow these steps then download the ISO. We are updating the code daily, but Rob creates a new ISO less frequently, so don’t assume that you have that latest!

Note: these instructions are for Ubuntu-10.10, CentOS-5.7 & RHEL-5.7! The build machine should have enough memory (more than 360 MB, 2GB is ideal) otherwise it could fail during the build process.

Build Crowbar (first build takes a while because components must be cached)

1. su -
2. apt-get install git build-essential debootstrap mkisofs binutils ruby curl
3. git clone git://github.com/dellcloudedge/crowbar.git
4. cd ~/crowbar
5. git submodule init
6. git submodule update
7. ./build_crowbar.sh
8. ls *.iso

Build OpenStack (or any specialized) version of Crowbar

1. cd ~/crowbar
2. git checkout -b openstack-os-build origin/openstack-os-build
3. git submodule init
4. git submodule update
5. ./build_crowbar.sh
6. ls *.iso

Variations

To build Hadoop on CentOS 5.7 complete the steps above making the following changes:

• Also install: apt-get install rpm
• Change branch: git checkout -b hadoop-os-build origin/hadoop-os-build
• Add Parameter: ./build_crowbar.sh centos-5.7
• The CentOS & RHEL DVDs are larger (4 GB!) so you may need larger volumes (>20 GB) to build

Prerequisites

To build Crowbar, you need an linux machine and access to the internet. These videos show on how you can build using a Rackspace Cloud Server (http://youtu.be/FsOBaAiDgYs) or on a local VM (http://youtu.be/qvsfXPH5k5Q). We build Crowbar inside our firewall on our PCs too. No matter how you do it, Crowbar is full of fuzzily delicious cloud bits.

Of course, you still need to run the ISO to build a staged OS that can Install Crowbar.

Build Options that you can set via EXPORTS

Note: You can store these in a ~/.build-crowbar.conf for easier reuse!

Usage "export PARAM=VALUE"

• USE_PROXY : [0] no, 1 = yes
  • PROXY_HOST
  • PROXY_USER
• ALLOW_CACHE_UPDATE : [true], false
• CACHE_DIR : ["$HOME/.crowbar-build-cache"]
• ISO_LIBRARY : ["$CACHE_DIR/iso"]
• SLEDGEHAMMER_PXE_DIR : [""$CACHE_DIR/tftpboot"]
  • SLEDGEHAMMER_DIR : ["${CROWBAR_DIR}/../crowbar-sledgehammer"]
• ... there are more...