From 7a0d22c0fd70408f6a2ba94bf2af7d6e652c1ca3 Mon Sep 17 00:00:00 2001 From: Varun Gadiraju Date: Wed, 20 Jul 2016 15:23:59 +0000 Subject: [PATCH] Added note to local.conf addressing firewall/proxy blocking Git protocol local.conf file for deploying ironic with devstack uses Git protocol to enable ironic plugin. Git protocol requires access to port 9418 which corporate firewalls commonly block. Added a note to the local.conf file informing users who face this problem how to modify the local.conf file to use https:// instead of git:// so ironic plugin will be enabled. Change-Id: Ia0ab1c23cf1e6979eb7e03bb9746aa94dd3f0257 Closes-Bug: #1604243 --- doc/source/dev/dev-quickstart.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/source/dev/dev-quickstart.rst b/doc/source/dev/dev-quickstart.rst index 21120d1aeb..68782aaba4 100644 --- a/doc/source/dev/dev-quickstart.rst +++ b/doc/source/dev/dev-quickstart.rst @@ -464,6 +464,17 @@ and uses the ``agent_ipmitool`` driver by default:: END +.. note:: + Git protocol requires access to port 9418, which is not a standard port that + corporate firewalls always allow. If you are behind a firewall or on a proxy that + blocks Git protocol, modify the ``enable_plugin`` line to use ``https://`` instead + of ``git://`` and add ``GIT_BASE=https://git.openstack.org`` to the credentials:: + + GIT_BASE=https://git.openstack.org + + # Enable Ironic plugin + enable_plugin ironic https://git.openstack.org/openstack/ironic + .. note:: The agent_ssh and pxe_ssh drivers are being deprecated in favor of the more production-like agent_ipmitool and pxe_ipmitool drivers. When a