stackforge/kickstack
Code Issues Proposed changes

doc: Mention Puppet 3 and networking requirements

Browse Source
This commit is contained in:
Florian Haas 2013-07-22 20:23:38 +02:00
parent de1cb46cd0
commit 99e4c45eac
1 changed files with 40 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
doc/prerequisites.md
View File

@ -1,9 +1,43 @@
# What do I need to run Kickstack?
First, you obviously need a Puppet master. There is one non-default
configuration option that you have to enable for Kickstack to
function, which is support for Exported Resources. Please see
## Puppet prerequisites
First, you obviously need a Puppet master, running Puppet 3 or
later.
There is one non-default configuration option that you have to enable
for Kickstack to function, which is support for Exported
Resources. Please see
[the Puppet documentation on Exported Resources](http://docs.puppetlabs.com/puppet/2.7/reference/lang_exported.html)
for details. Just as obviously, your OpenStack nodes need to be
configured as Puppet agents, properly authenticated to the master and
able to run `puppet agent`.
for details.
Just as obviously, your OpenStack nodes need to be configured as
Puppet agents, also running Puppet 3 or later, properly authenticated
to the master and able to run `puppet agent`.
## Networking prerequisites
Kickstack requires that your cloud infrastructure has access to 3
different networks:
* The **management network,** which your cloud nodes use for access to
the database, RPC service, and OpenStack APIs.
* The **data network,** which run the internal, virtual networks
managed by OpenStack Networking.
* The **external network**, which connects your cloud to the outside
world.
Kickstack by default assumes that on your nodes,
* the management network is connected to **eth0**,
* the data network is connected to **eth1**,
* the external network is connected to **eth2**.
If you configuration does not match that assumption, you can override
the defaults by setting the `kickstack_nic_management`,
`kickstack_nic_data` and `kickstack_nic_external` parameters,
respectively.
Kickstack will properly read these interfaces' IP addresses from your
nodes' network configuration, but it will not touch that network
configuration itself.