1 =============================================================================================
2 OPNFV Release Notes for the Arno SR1 release of OPNFV when using Foreman as a deployment tool
3 =============================================================================================
6 .. contents:: Table of Contents
13 This document provides the release notes for Arno SR1 release with the Foreman/QuickStack deployment
19 All Foreman/QuickStack and "common" entities are protected by the Apache License
20 ( http://www.apache.org/licenses/ )
26 +--------------------+--------------------+--------------------+--------------------+
27 | **Date** | **Ver.** | **Author** | **Comment** |
29 +--------------------+--------------------+--------------------+--------------------+
30 | 2015-04-16 | 0.1.0 | Tim Rozet | First draft |
32 +--------------------+--------------------+--------------------+--------------------+
33 | 2015-06-02 | 0.1.1 | Chris Price | Minor Edits |
35 +--------------------+--------------------+--------------------+--------------------+
36 | 2015-06-03 | 0.1.2 | Tim Rozet | Minor Edits |
38 +--------------------+--------------------+--------------------+--------------------+
39 | 2015-09-10 | 0.2.0 | Tim Rozet | Updated for SR1 |
41 +--------------------+--------------------+--------------------+--------------------+
42 | 2015-09-25 | 0.2.1 | Randy Levensalor | Added Workaround |
43 | | | | for DHCP issue |
44 +--------------------+--------------------+--------------------+--------------------+
50 This is the OPNFV Arno SR1 release that implements the deploy stage of the OPNFV CI pipeline.
52 Carefully follow the installation-instructions which guide a user on how to deploy OPNFV using
53 Foreman/QuickStack installer.
58 Arno release with the Foreman/QuickStack deployment toolchain will establish an OPNFV target system on
59 a Pharos compliant lab infrastructure. The current definition of an OPNFV target system is and
60 OpenStack Juno version combined with OpenDaylight version: Helium. The system is deployed with
61 OpenStack High Availability (HA) for most OpenStack services. OpenDaylight is deployed in non-HA form
62 as HA is not availble for Arno SR1 release. Ceph storage is used as Cinder backend, and is the only
63 supported storage for Arno. Ceph is setup as 3 OSDs and 3 Monitors, one OSD+Mon per Controller node.
65 - Documentation is built by Jenkins
66 - .iso image is built by Jenkins
67 - Jenkins deploys an Arno release with the Foreman/QuickStack deployment toolchain baremetal, which includes 3 control+network nodes, and 2 compute nodes.
72 +--------------------------------------+--------------------------------------+
73 | **Project** | genesis |
75 +--------------------------------------+--------------------------------------+
76 | **Repo/tag** | genesis/arno.2015.2.0 |
78 +--------------------------------------+--------------------------------------+
79 | **Release designation** | arno.2015.2.0 |
81 +--------------------------------------+--------------------------------------+
82 | **Release date** | 2015-09-23 |
84 +--------------------------------------+--------------------------------------+
85 | **Purpose of the delivery** | OPNFV Arno SR1 release |
87 +--------------------------------------+--------------------------------------+
92 Module version changes
93 ~~~~~~~~~~~~~~~~~~~~~~
94 This is the Service Release 1 version of the Arno release with the Foreman/QuickStack deployment
95 toolchain. It is based on following upstream versions:
97 - OpenStack (Juno release)
99 - OpenDaylight Helium-SR3
103 Document version changes
104 ~~~~~~~~~~~~~~~~~~~~~~~~
106 This is the SR1 version of Arno release with the Foreman/QuickStack deployment toolchain. The following
107 documentation is provided with this release:
109 - OPNFV Installation instructions for the Arno release with the Foreman/QuickStack deployment toolchain - ver. 0.2.0
110 - OPNFV Release Notes for the Arno release with the Foreman/QuickStack deployment toolchain - ver. 0.2.0 (this document)
115 +--------------------------------------+--------------------------------------+
116 | **JIRA REFERENCE** | **SLOGAN** |
118 +--------------------------------------+--------------------------------------+
119 | JIRA: BGS-73 | Changes Virtual deployments to |
120 | | only require 1 interface, and adds |
121 | | accesbility in China |
122 +--------------------------------------+--------------------------------------+
123 | JIRA: BGS-75 | Adds ability to specify number of |
125 +--------------------------------------+--------------------------------------+
126 | JIRA: APEX-3 | clean now removes all VMs |
128 +--------------------------------------+--------------------------------------+
129 | JIRA: APEX-4 | Adds ability to specify NICs to |
130 | | bridge to on the jumphost |
131 +--------------------------------------+--------------------------------------+
132 | JIRA: BGS-86 | Adds ability to specify domain name |
134 +--------------------------------------+--------------------------------------+
135 | JIRA: APEX-1 | Adds ability to specify VM resources |
136 | | such as disk size, memory, vcpus |
137 +--------------------------------------+--------------------------------------+
138 | JIRA: APEX-33 | Adds ability to use single interface |
139 | | for baremetal installs |
140 +--------------------------------------+--------------------------------------+
147 +--------------------------------------+--------------------------------------+
148 | **JIRA REFERENCE** | **SLOGAN** |
150 +--------------------------------------+--------------------------------------+
151 | JIRA: BGS-65 | Fixes external network bridge and |
152 | | increases neutron quota limits |
153 +--------------------------------------+--------------------------------------+
154 | JIRA: BGS-74 | Fixes verification of vbox drivers |
156 +--------------------------------------+--------------------------------------+
157 | JIRA: BGS-59 | Adds ODL Deployment stack docs to |
159 +--------------------------------------+--------------------------------------+
160 | JIRA: BGS-60 | Migrates github bgs_vagrant project |
162 +--------------------------------------+--------------------------------------+
163 | JIRA: BGS-89 | Fixes public allocation IP |
165 +--------------------------------------+--------------------------------------+
166 | JIRA: BGS-71 | Adds check to ensure subnets are the |
167 | | minimum size required |
168 +--------------------------------------+--------------------------------------+
169 | JIRA: BGS-78 | Fixes Foreman clean to not hang and |
170 | | now also removes libvirt |
171 +--------------------------------------+--------------------------------------+
172 | JIRA: APEX-7 | Adds check to make sure 3 control |
173 | | nodes are set when HA is enabled |
174 +--------------------------------------+--------------------------------------+
175 | JIRA: BGS-68 | Adds check to make sure baremetal |
176 | | nodes are powered off when deploying |
177 +--------------------------------------+--------------------------------------+
178 | JIRA: APEX-14 | Fixes Vagrant base box to be opnfv |
180 +--------------------------------------+--------------------------------------+
181 | JIRA: APEX-8 | Fixes puppet modules to come from |
182 | | the Genesis repo |
183 +--------------------------------------+--------------------------------------+
184 | JIRA: APEX-17 | Fixes clean to kill vagrant processes|
186 +--------------------------------------+--------------------------------------+
187 | JIRA: APEX-2 | Removes default vagrant route from |
189 +--------------------------------------+--------------------------------------+
190 | JIRA: APEX-9 | Fixes external network to be created |
191 | | by the services tenant |
192 +--------------------------------------+--------------------------------------+
193 | JIRA: APEX-10 | Disables DHCP on external neutron |
195 +--------------------------------------+--------------------------------------+
196 | JIRA: APEX-19 | Adds check to ensure provided arg |
197 | | static_ip_range is correct |
198 +--------------------------------------+--------------------------------------+
199 | JIRA: APEX-12 | Fixes horizon IP URL for non-HA |
201 +--------------------------------------+--------------------------------------+
202 | JIRA: BGS-84 | Set default route to public |
204 +--------------------------------------+--------------------------------------+
209 Software deliverables
210 ~~~~~~~~~~~~~~~~~~~~~
211 Foreman/QuickStack@OPNFV .iso file
212 deploy.sh - Automatically deploys Target OPNFV System to Bare Metal or VMs
214 Documentation deliverables
215 ~~~~~~~~~~~~~~~~~~~~~~~~~~
216 - OPNFV Installation instructions for the Arno release with the Foreman/QuickStack deployment toolchain - ver. 1.2.0
217 - OPNFV Release Notes for the Arno release with the Foreman/QuickStack deployment toolchain - ver. 1.2.0 (this document)
219 Known Limitations, Issues and Workarounds
220 =========================================
225 **Max number of blades:** 1 Foreman/QuickStack master, 3 Controllers, 20 Compute blades
227 **Min number of blades:** 1 Foreman/QuickStack master, 1 Controller, 1 Compute blade
229 **Storage:** Ceph is the only supported storage configuration.
231 **Min master requirements:** At least 2048 MB of RAM
239 +--------------------------------------+--------------------------------------+
240 | **JIRA REFERENCE** | **SLOGAN** |
242 +--------------------------------------+--------------------------------------+
243 | JIRA: APEX-13 | Keystone Config: bind host is wrong |
245 +--------------------------------------+--------------------------------------+
246 | JIRA: APEX-38 | Neutron fails to provide DHCP address|
248 +--------------------------------------+--------------------------------------+
253 JIRA: APEX-38 - Neutron fails to provide DHCP address to instance
255 1. Find the controller that is running the DHCP service. ssh to oscontroller[1-3] and
256 run the command below until the command returns a namespace that start with with "qdhcp".
258 ``ip netns | grep qdhcp``
260 2. Restart the neturon server and the neutron DHCP service.
262 ``systemctl restart neutron-server``
264 ``systemctl restart neutron-dhcp-agent``
266 3. Restart the interface on the VM or restart the VM.
272 The Arno release with the Foreman/QuickStack deployment toolchain has undergone QA test runs with the
275 https://wiki.opnfv.org/arno_sr1_result_page?rev=1443626728
280 For more information on the OPNFV Arno release, please see:
282 http://wiki.opnfv.org/release/arno
284 :Authors: Tim Rozet (trozet@redhat.com)
287 **Documentation tracking**