From 11fa96e432c4d3701859326a87cdbb1e78a2a41c Mon Sep 17 00:00:00 2001 From: andrewbogott Date: Mon, 7 Mar 2016 18:45:53 -0600 Subject: [PATCH] Modernize README.rst The instructions in this file were well out of date and referred to config lines that no longer exist. Once merged, this change should be backported to Liberty as well. Change-Id: I5b3cce9b1d14f558b4161a20317c6407caa47de4 --- README.rst | 29 ++++++++++++++++++----------- 1 file changed, 18 insertions(+), 11 deletions(-) diff --git a/README.rst b/README.rst index 92b4ab7..4e96394 100644 --- a/README.rst +++ b/README.rst @@ -22,24 +22,31 @@ Howto This will create a python egg in the dist folder, which can be used to install on the horizon machine or within horizon's python virtual environment. -2. Modify horizon's settings file to enabled designatedashboard, note the two lines to add below:: + -- or -- - import designatedashboard.enabled # ADD THIS LINE + Install directly from source by running "python setup.py --install" - ... + Note: On some systems python may throw an error like - INSTALLED_APPS = list(INSTALLED_APPS) # Make sure it's mutable - settings.update_dashboards([ - openstack_dashboard.enabled, - openstack_dashboard.local.enabled, - designatedashboard.enabled, # ADD THIS LINE TOO - ], HORIZON_CONFIG, INSTALLED_APPS) + 'Exception: Versioning for this project requires either an sdist tarball, or access + to an upstream git repository' -3. (Optional) Copy the designate policy file into horizon's policy files folder, and add this config:: + this seems to be a result of mismatched pbr versioning. A hacking workaround for development + purposes is replacing the pbr call with a hard-coded version (e.g. '1.0.1') in + designatedashboard/__init__.py. + +2. Copy panel plugin files into your Horizon config. These files can be found in designatedashboard/enabled + and should be copied to /usr/share/openstack-dashboard/openstack_dashboard/local/enabled or the + equivalent directory for your openstack-dashboard install. + +3. Make sure your keystone catalog contains endpoints for service type 'dns'. If no such endpoints are + found, the designatedashboard panels will not render. + +4. (Optional) Copy the designate policy file into horizon's policy files folder, and add this config:: 'dns': 'designate_policy.json', -4. (Optional) Within your horizon settings file(s) (either the local settings or the other settings.py), add +5. (Optional) Within your horizon settings file(s) (either the local settings or the other settings.py), add the line below. This will make it so the record create/update screen uses a drop down of your floating ip addresses instead of a free form text field::