heat : Getting started updates for Cloudwatch

Update GettingStarted.rst:
- Add heat-api-cloudwatch section
- Add firewall rules required for heat-metadata and heat-api-cloudwatch

Change-Id: I3b232f378a23b6c334c7e8e5af3ab067ffd50381
Signed-off-by: Steven Hardy <shardy@redhat.com>

diff --git a/docs/GettingStarted.rst b/docs/GettingStarted.rst
index f3870bf530dcde1ed534a227e8d5f0b33cd17032..3db719c1a89f1bbfcd6954298e620abbb30ddfcc 100644 (file)
--- a/docs/GettingStarted.rst
+++ b/docs/GettingStarted.rst
@@ -310,6 +310,31 @@ Some templates require the ``heat-metadata`` server also. The metadata server mu
     
     sudo -E bash -c 'heat-metadata &'
 
+Open up port 8002 so that the guests can communicate with the heat-metadata server:
+
+::
+    sudo iptables -I INPUT -p tcp --dport 8002 -j ACCEPT -i demonetbr0
+
+Note the above rule will not persist across reboot, so you may wish to add it to /etc/sysconfig/iptables
+
+Configure Heat Cloudwatch server
+--------------------------------
+
+If you wish to try any of the HA or autoscaling templates (which collect stats from instances via the CloudWatch API), it is neccessary to start the heat-api-cloudwatch server::
+
+    sudo -E bash -c 'heat-api-cloudwatch &'
+
+Open up port 8003 so that the guests can communicate with the heat-api-cloudwatch server:
+
+::
+    sudo iptables -I INPUT -p tcp --dport 8003 -j ACCEPT -i demonetbr0
+
+Note the above rule will not persist across reboot, so you may wish to add it to /etc/sysconfig/iptables
+
+Further information on using the heat cloudwatch features is available in the Using-Cloudwatch_ wiki page
+
+.. _Using-Cloudwatch: https://github.com/heat-api/heat/wiki/Using-CloudWatch
+
 Troubleshooting
 ===============