Menu

Tree [bb5275] master /
 History

HTTPS access


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