Open Stack

We are excited to announce the release of:

instack-undercloud 8.3.0: instack-undercloud

This release is part of the queens release series.

The source is available from:

    https://git.openstack.org/cgit/openstack/instack-undercloud

Download the package from:

    https://tarballs.openstack.org/instack-undercloud/

Please report issues through launchpad:

    https://bugs.launchpad.net/tripleo

For more details, please see below.

8.3.0
^^^^^


Prelude
*******

With support for routed networks, several options are deprecated and
the way undercloud networking is defined in the configuration file has
several changes. Please refer to the **Deprecation Notes** and
**Upgrade notes** section for details.


New Features
************

* Routed networks support adds the ability to configure Ironic
  Inspector and Neutron provisioning network in the undercloud to
  enable provisioning of nodes via DHCP-relay to the undercloud from
  remote routed network segments. Routed networks is by default
  disabled, to enable set option "enable_routed_networks" to "True" in
  "undercloud.conf".

  Note: Changing the "enable_routed_networks" option after the
    initial undercloud installation is not possible.


Upgrade Notes
*************

* If you had cron triggers for Mistral in the undercloud, they will
  now only execute at most every 10 minutes. Previously they could run
  as frequently as every second.

* With support for routed network segments, several options are
  deprecated and the way undercloud networking is defined in the
  configuration file has several changes.

  **New option:** "subnets" A list of subnets. One entry for each
  routed network segment used for provisioning and introspection. For
  each network segment a section/group needs to be added to the
  configuration file specifying the following subnet options:

  +------------------------+--------------------------------------------------+
  | option                 | Description                                      |
  +========================+==================================================+
  | "cidr"                 | Network CIDR for the subnet.                     |
  +------------------------+--------------------------------------------------+
  | "dhcp_start"           | Start of DHCP allocation range for PXE and DHCP. |
  +------------------------+--------------------------------------------------+
  | "dhcp_end"             | End of DHCP allocation range for PXE and DHCP.   |
  +------------------------+--------------------------------------------------+
  | "inspection_iprange"   | Temporary IP range that will be given to nodes   |
  |                        | during the inspection process.                   |
  +------------------------+--------------------------------------------------+
  | "gateway"              | Network(subnet) gateway/router.                  |
  +------------------------+--------------------------------------------------+
  | "masquerade"           | (Boolean) If "True" the undercloud will          |
  |                        | masquerade this network for external access.     |
  +------------------------+--------------------------------------------------+

  **New option:** "local_subnet" The name of the local subnet, where
  the PXE boot and DHCP interfaces for overcloud instances is located.
  The IP address of the local_ip/local_interface should reside in this
  subnet.

  Note: Upgrade with migration to routed networks support is not
    possible.Routed networks use the neutron segments service_plugin,
    this plugin adds functionality that allows subnet to be associated
    with a network segment. It is currently not possible to add
    segment association to an existing subnet, because of this we
    cannot add segment association to the existing ctlplane subnet on
    the upgraded undercloud. The existing ctlplane network and subnet
    will still be in place after an upgrade and the upgraded
    undercloud can continue to manage the existing overcloud.

  The following example shows what changes to make to the
  configuration to move to the new model.

  Replace usage of deprecated options:

     [DEFAULT]
     network_gateway = 192.168.24.1
     network_cidr = 192.168.24.0/24
     dhcp_start = 192.168.24.5
     dhcp_end = 192.168.24.24
     inspection_iprange = 192.168.24.100,192.168.24.120
     masquerade_network = 192.168.24.0/24

  replace with:

     [DEFAULT]
     subnets = subnet0
     local_subnet = subnet0

     [subnet0]
     cidr = 192.168.24.0/24
     dhcp_start = 192.168.24.5
     dhcp_end = 192.168.24.24
     inspection_iprange = 192.168.24.100,192.168.24.120
     gateway = 192.168.24.1
     masquerade = True


Deprecation Notes
*****************

* With support for routed networks/subnets the "network_gateway"
  option in the "[DEFAULT]" section is deprecated. Moved to per-subnet
  options group.

* With support for routed networks/subnets the "network_cidr" option
  in the "[DEFAULT]" section is deprecated. Moved to per-subnet
  options group.

* With support for routed networks/subnets the "dhcp_start" and
  "dhcp_end" options in the "[DEFAULT]" section are deprecated. Moved
  to per-subnet options group.

* With support for routed networks/subnets the "inspection_iprange"
  option in the "[DEFAULT]" section is deprecated. Moved to per-subnet
  options group.

* With support for routed networks/subnets the "masquerade_network"
  option in the "[DEFAULT]" section is deprecated. Use the boolean
  option in each subnet group.


Bug Fixes
*********

* Fixed an incompatability with mistralclient 3.2.0, where a
  different exception type was raised and thus not handled during the
  undercloud install post config. See #1749186

Changes in instack-undercloud 8.2.0..8.3.0
------------------------------------------

3225d64 Revert "Ensure FORWARD is ACCEPT by default"
bfb758b Fix bootstrap NAT
79b1d0b Add validation for rotued networks disabled
da31c6e Ensure FORWARD is ACCEPT by default
720fc49 Revert "Add option to install the Octavia client"
a903c10 Update routed network reno
52dbe13 Make routed networks optional
e86ba84 Enable CORS for nova
aabd6e6 Catch APIException exceptions raised by Mistral
fef5be3 Add option to install the Octavia client
f6ab30c docker: use ensure_resource
3e702f3 Increase the Mistral cron_trigger interval
8dc0d28 Fix typo that can prevent undercloud installation.
46a5df2 Tripleo routed networks ironic inspector, and Undercloud
983c2be Add per subnet masquerading
1b83386 Add per subnet network cidr nat rules
5353915 Create static routes for remote subnets
a1d5484 Add support for multiple inspection subnets
be7cd8b Update validations to validate all subnets
a10b999 Update config to use per network groups
a7d2891 Move ctlplane network/subnet setup to python
79f8c2e Zuul: Remove project name
a4d6987 Disable memcached's cachedump
dd08192 Updated from global requirements
82c2fea Add support for configuring additional architectures
28fd522 Ensure Boolean Strings from the environment are treated correctly


Diffstat (except docs and test files)
-------------------------------------

.../install.d/02-puppet-stack-config               |   7 +
.../puppet-stack-config/puppet-stack-config.pp     |  29 +-
.../puppet-stack-config.yaml.template              |  24 +-
.../var/opt/undercloud-stack/masquerade            |   6 +-
.../post-configure.d/98-undercloud-setup           |  81 ----
instack_undercloud/undercloud.py                   | 465 +++++++++++++++++++--
instack_undercloud/validator.py                    | 114 +++--
...ix-mistral-error-handling-58010a43f53ded5e.yaml |   6 +
...rigger_subsystem_interval-fdacb60599948e91.yaml |   6 +
...routed-subnets-undercloud-64bb87222db0555b.yaml |  98 +++++
requirements.txt                                   |   2 +-
templates/config.json.template                     |   2 +-
templates/net-config.json.template                 |   1 +
test-requirements.txt                              |   6 +-
undercloud.conf.sample                             | 105 +++--
zuul.d/layout.yaml                                 |   2 -
18 files changed, 1173 insertions(+), 211 deletions(-)


Requirements updates
--------------------

diff --git a/requirements.txt b/requirements.txt
index 12b411c..16af2ea 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -5 +5 @@ six>=1.10.0 # MIT
-python-ironicclient>=1.14.0 # Apache-2.0
+python-ironicclient>=2.2.0 # Apache-2.0
diff --git a/test-requirements.txt b/test-requirements.txt
index d17d920..717ba55 100644
--- a/test-requirements.txt
+++ b/test-requirements.txt
@@ -5,2 +5,2 @@
-openstackdocstheme>=1.17.0 # Apache-2.0
-sphinx>=1.6.2 # BSD
+openstackdocstheme>=1.18.1 # Apache-2.0
+sphinx!=1.6.6,>=1.6.2 # BSD
@@ -17 +17 @@ mock>=2.0.0 # BSD
-oslotest>=1.10.0 # Apache-2.0
+oslotest>=3.2.0 # Apache-2.0