Gael Chamoulaud 02d628f24e Update README
- Reformatted paragraph about required steps before running Packstack from source.
- Removed .gitmodules file as we don't need anymore.

Change-Id: I270c245a2ea3b9bd964e4a638df5e83b6d946e1c
2014-05-23 14:18:08 +02:00
2014-01-23 16:18:36 +01:00
2014-05-22 10:30:53 +00:00
2014-05-22 10:54:21 +02:00
2013-01-11 22:27:22 +00:00
2012-08-02 16:50:19 +01:00
2012-11-30 10:52:44 -05:00
2014-05-23 14:18:08 +02:00
2014-02-24 20:02:11 +01:00
2014-05-22 10:54:21 +02:00

Utility to install OpenStack on Red Hat based operating system.
See other branches for older openstack versions

This utility can be used to install openstack on a single or
group of hosts (over ssh)

This utility is still in the early stages, a lot of the configuration
options have yet to be added

Installation of packstack:
$ yum install -y git
$ git clone git://github.com/stackforge/packstack.git
$ cd packstack && sudo python setup.py install

Installation of openstack-puppet-modules (REQUIRED if running packstack from source):
$ sudo python setup.py install_puppet_modules

Option 1 (using answer file)
$ packstack --gen-answer-file=ans.txt

# then edit ans.txt as appropriate e.g.
o set CONFIG_SSH_KEY to a public ssh key to be installed to remote machines
o Edit the IP address to anywhere you want to install a piece of openstack on another server
o Edit the 3 network interfaces to whatever makes sense in your setup

you'll need to use a icehouse repository for example for RHEL
CONFIG_REPO=http://repos.fedorapeople.org/repos/openstack/openstack-icehouse/epel-6/


$ packstack --answer-file=ans.txt

Option 2 (prompts for configuration options)
$ packstack

that's it, if everything went well you can now start using openstack
$ cd
$ . keystonerc_admin
$ nova list
$ swift list  # if you have installed swift


Config options
CONFIG_NOVA_COMPUTE_HOSTS :
        a comma seperated list of ip addresses on which to install nova compute
CONFIG_SWIFT_STORAGE_HOSTS :
        a comma seperate list of swift storage devices
        1.1.1.1  : create a testing loopback device and use this for storage
        1.1.1.1/sdb : use /dev/sdb on 1.1.1.1 as a storage device

Logging

The location of the log files and generated puppet manifests are in the
/var/tmp/packstack directory under a directory named by the date in which
packstack was run and a random string (e.g. /var/tmp/packstack/20131022-204316-Bf3Ek2).
Inside, we find a manifest directory and the openstack-setup.log file; puppet
manifests and a log file for each one are found inside the manifest directory.

Debugging

To make packstack write more detailed information into the log file you can use the -d switch:

$ packstack -d --allinone
Description
Install utility to deploy OpenStack on multiple hosts.
Readme 23 MiB
Languages
Python 71.5%
Puppet 23%
Shell 3.7%
Ruby 1.5%
HTML 0.3%