add docs from the heat wiki

updated index.rst to mimic the layout of the keystone docs
updated the structure for troubleshooting
ported howto guides from the heat wiki
ported the troubleshooting page from the heat wiki
updated the nav for the man pages and getting started
added docs for a cfn template and hot template

Change-Id: I14c1b0b6aa6ea3529c4de994851f7a798a3061bf
Update openstack.common.config

- Add generator.py from Oslo
- Add notifier from Oslo
- Add generator bash script used by other projects to generate configuration
files
- Update openstack-common.conf file

The patch https://review.openstack.org/#/c/36493/ needs
to be merged before this one. I'll rebase this patch and
generate the heat configuration.

Fix bug #1183275

Change-Id: Id7f24874b7e3e07d06dcf14bc381b9d630f67fc8
Set tenant headers from ec2 authentication.

Without this, ec2token middleware on its own doesn't set enough
headers to perform heat requests.

Change-Id: I7a0867196741c0df222d491fb1bfbe203158032c
Set role headers from ec2 authentication.

Without this roles are not available in the context when
ec2token middleware is used on its own.

Change-Id: I1214e44c588f547ee6f90f0f71a085f786e7ea7f
Configure standalone pipelines for cfn and cloudwatch.

This allows waitconditions and cloud watch data to authenticate
using just the ec2token middleware. Stacks have been successfully launched
with a standalone heat onto an external grizzly openstack, including working
waitconditions and watch data.

This means that currently when in standalone mode, heat-cfn cannot
authenticate since it defaults to auth strategy keystone (and it appears
that auth strategy ec2 signing has not been implemented yet). This case
is sufficiently obscure that it most likely won't affect anyone at this
stage.

Implements blueprint heat-standalone

Change-Id: I7d096b11e70c234d0b2322c93bf5f4d4e6b01b4f
Wrap the watch rule start in a method

This is the first step in making the watch task dependant on:
1) whether we even have an alarm in the stack
2) whether the alarm is a ceilometer alarm

The test confirms the current behaviour, which is a periodic task
is created whether or not a watch is in the stack.

bug 1202031
Change-Id: Iebb948f788270fca0dbef61a2e122fe3900d84b2
Only create the period watch task if there is a watch in the stack

This prevents unneccessary greentheads polling the db.

bug 1202031
Change-Id: I065955d03df543df40af285f87a7fd3dfa779413
Reset the the watch_rule.last_evaluated on start up

This is so we don't fire off alarms when the engine has not been running.

bug 1202552

Change-Id: Ief258fd601b48e2495ac69091a942f23a019e92c
Add a py33 tox environment

This way one can optionally run tests against Python 3.x

Change-Id: I578cc6f2e933fbdc469dd14d23e9cf5b9f1d246f
Merge "Wrap the watch rule start in a method"
Merge "Only create the period watch task if there is a watch in the stack"
Merge "Set tenant headers from ec2 authentication."
Merge "Set role headers from ec2 authentication."
Merge "Configure standalone pipelines for cfn and cloudwatch."
Migrate all tests to use dummy_context.

Change-Id: Idc00ccbd254aca2c64c1bcb376fe7a3aab4d1cb4
Merge "Add a py33 tox environment"
Reset state before resource recreation

So the destroyed resource can be recreated, and HARestarted main logic
resource destory and create can work.

Change-Id: Id79988560e105c254d304e30d598427a2bbc5b26
Fixes: bug #1202492
Handle 'detaching' state of Volume

When detaching volume, the state of volume changed from 'in-use'
to 'detaching', and then from 'detaching' to 'available'.
The code used to ignore 'detaching' state by assuming the volume
has been detached when its state is not 'in-use' any more.
Now we take care 'detaching' state and raise error if detaching
failed.

Fixes bug #1197747

Change-Id: I555eea19409142ccb306c0cceaf7c55e71385bc6
Refactor the code in heat/tests/test_volume.py

The test code in heat/tests/test_volume.py has lots of
duplicated code and logic.
Extract them into common method and reuse the methods.

Change-Id: I5053c53a3eebf5f43cddfb96ee63a1f4f8615e76
Merge "add docs from the heat wiki"