Description

Installs the Openstack dashboard (codename: Horizon) from packages.

http://horizon.openstack.org

Requirements

Chef 0.10.0 or higher required (for Chef environment use).

Cookbooks

The following cookbooks are dependencies:

• apache2
• database
• mysql
• openstack-common >= 0.1.8

Usage

db

Configures database for use with Horizon

"run_list": [
    "recipe[horizon::db]"
]

server

Sets up the Horizon dashboard within an Apache mod_wsgi container.

"run_list": [
    "recipe[horizon::server]"
]

Attributes

• horizon["db"]["username"] - username for horizon database access
• horizon["server_hostname"] - sets the ServerName in the Apache config.
• horizon["use_ssl"] - toggle for using ssl with dashboard (default true)
• horizon["ssl"]["dir"] - directory where ssl certs are stored on this system
• horizon["ssl"]["cert"] - name to use when creating the ssl certificate
• horizon["ssl"]["key"] - name to use when creating the ssl key
• horizon["dash_path"] - base path for dashboard files (document root)
• horizon["wsgi_path"] - path for wsgi dir
• horizon["ssl_offload"] - Set SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTOCOL', 'https') flag for offloading SSL
• horizon["plugins"] - Array of plugins to include via INSTALED_APPS

Testing

This cookbook is using ChefSpec for testing. Run the following before commiting. It will run your tests, and check for lint errors.

% ./run_tests.bash

License and Author

Author:: Justin Shepherd (justin.shepherd@rackspace.com) Author:: Jason Cannavale (jason.cannavale@rackspace.com) Author:: Ron Pedde (ron.pedde@rackspace.com) Author:: Joseph Breu (joseph.breu@rackspace.com) Author:: William Kelly (william.kelly@rackspace.com) Author:: Darren Birkett (darren.birkett@rackspace.co.uk) Author:: Evan Callicoat (evan.callicoat@rackspace.com) Author:: Jay Pipes (jaypipes@att.com) Author:: John Dewey (jdewey@att.com)

Copyright 2012, Rackspace US, Inc. Copyright 2012-2013, AT&T Services, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and⋅ limitations under the License.