Skip to content
This repository has been archived by the owner on May 31, 2021. It is now read-only.

Latest commit

 

History

History
61 lines (46 loc) · 2.26 KB

prerequisites.md

File metadata and controls

61 lines (46 loc) · 2.26 KB
Raw

What do I need to run Kickstack?

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 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.

Puppet modules

Besides the dependencies listed in the Modulefile, Kickstack requires a couple of other modules currently not yet available on the Puppet Forge. You will have to fetch and install them from GitHub:

  • neutron, managing OpenStack Networking,
  • vswitch, managing OpenVSwitch

In addition, the glance module, as available in its 2.0.0 version from the Puppet Forge, was unfortunately released with a bug that renders it unsuitable for use with Ubuntu. Until a new version of that module is released, you will also have to fetch the glance module from GitHub.

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 runs 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.