File	Date	Author	Commit
apt_cache	2011-02-02	Sumit Shah	[d40f43] add initial lucid apt cache files
cda	2011-01-21	Sumit Shah	[2f860d] add exploded cda installer
chef	2011-08-23	Jakub Slawinski	[fce620] MIFOSSUPPORT-91: Added support for etl_job_warn...
dbsnapshots	2011-03-16	Sumit Shah	[31d66e] add apache config for db snapshot download
imaging	2011-08-18	Jakub Slawinski	[c6fad8] Bumping Mifos version from 2.1.4 to 2.1.5.
ldif	2011-03-10	Sumit Shah	[fd3951] add rwhitney
mail	2011-06-02	Van Mittal-Henkle	[96b2ce] Added BI version to email templates (specified ...
maint	2011-08-18	Jakub Slawinski	[2c09b2] Fixed nodeInChef method and added additional sl...
sql	2011-02-25	Sumit Shah	[f660fb] initial schema for cloud mgmt
statefiles	2011-12-04	Mifos CI	[bb5275] statefile updated from CI
COPYING	2011-03-22	Adam Monsen	[38af45] Added copyright and license (GPLv3).
README	2011-03-22	Adam Monsen	[38af45] Added copyright and license (GPLv3).
bundle_image.sh	2011-02-15	Sumit Shah	[825c0c] change UID to USERID
create_ldap_image.sh	2011-04-19	Sumit Shah	[d772bf] refactor so we can separate build
create_ldap_state.sh	2011-02-02	Sumit Shah	[7298b3] add automation scripts
create_mifos_2_0_bi_1_1_image.sh	2011-04-28	Sumit Shah	[a0c575] add a mifos 2.0 build
create_mifos_2_1_bi_1_1_image.sh	2011-04-19	Sumit Shah	[7a6e41] refactor so we can separate build
create_mifos_2_1_bi_1_2_image.sh	2011-04-19	Sumit Shah	[d772bf] refactor so we can separate build
create_mifos_2_1_bi_1_3_image.sh	2011-07-15	Jakub Slawinski	[8f6633] Added scripts for new ami generation (Mifos 2.1...
create_mifos_2_2_bi_1_2_image.sh	2011-04-21	Sumit Shah	[0403bb] first pass at jetty image
create_mifos_jetty_state.sh	2011-04-21	Sumit Shah	[948f54] add servlet api
create_mifos_tomcat_state.sh	2011-06-17	Jakub Slawinski	[0bfc02] Added vim to packages.
create_state.sh	2011-02-25	Sumit Shah	[96336a] tag only if changed
upload_mifos_image.sh	2011-02-16	Sumit Shah	[5c4cdf] make ami name compliant

Read Me

= Cloud Imaging

== Copyright, license

Copyright (c) 2005-2011 Grameen Foundation USA. All rights reserved.

Mifos Cloud (all source code herein) is free software: you can redistribute it
and/or modify it under the terms of the GNU General Public License as published
by the Free Software Foundation, either version 3 of the License, or (at your
option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.

link:COPYING[] is a complete copy of the GNU General Public License. If you
have trouble viewing this file, see http://www.gnu.org/licenses/.

== What's in here and how to use it

The cloud imaging is divived in two stages.

1. Generate statefile that contains a list of all debian packages and their
versions.
2. From this statefile generate an ec2 bootable image (and in the future a
livecd, etc) from this statefile

The script imaging/create_state.sh is used to accomplish both stages.

The statefile is checked into version control and the exact image can be
generated at any point in the history of the statefile.

A CI job can then poll version control and run the create_state.sh with the
`--build_image` flag to generate a bootable ec2 image.

If desired a CI job could also periodically generate the statefile and check it
in headlessly.  Upon checkin this could kick off the above job.

A typical invocation for stage (1) would look like:

 sudo ./imaging/create_state.sh --statefile statefiles/lucid_updated_chef_tomcat6_jdk.state

For stage (2) it might look like:

 sudo ./imaging/create_state.sh --statefile statefiles/lucid_updated_chef_tomcat6_jdk.state --build_image --imagedir /home/ubuntu/build

`--imagedir` should be an empty ebs volume mounted as ext3.

In addition the validation.pem cert (and other secrets) must be in the private 
directory which by default is in `$HOME/private` and can be overriden with the
`--private <dir>` flag.

After an invocation of stage (2) an ami can be created like so:

 bash> ec2-create-snapshot -d "<description>" <ebs volume>
 SNAPSHOT	snap-c38766ae	vol-7e16dc16	pending	2010-12-14T00:35:44+0000		790832682666	2	test ec2

 bash> ec2-register --kernel aki-407d9529 --root-device-name /dev/sda1 --name "<name>" --snapshot snap-c38766ae
 IMAGE	ami-6208fe0b

or

 ec2-bundle-image -r i386 -i tmp/debian-ami -c <PATH_TO_CERT> -k <PATH_TO_PEM> -u <ACCOUNT>
 ec2-upload-bundle -b mifos-amis -m /tmp/debian-ami.manifest.xml -a <KEY> -s <SECRET>