diff options
author | mrpa <miruna.paun@enea.com> | 2020-04-21 18:46:02 +0200 |
---|---|---|
committer | Miruna Paun <mrpa@enea.se> | 2020-04-21 20:02:01 +0200 |
commit | acb3384a8e42c7de1b35029055110b916af0ce51 (patch) | |
tree | 1b55fb598325dcb0939f692d02225615e196dc11 /doc/book-enea-nfv-access-release-info/doc | |
parent | 531ec2b2c9f05b3c5b908c70843868bc5e5fe117 (diff) | |
download | el_releases-nfv-access-acb3384a8e42c7de1b35029055110b916af0ce51.tar.gz |
Modified content in:
book-enea-nfv-access-cmc-example-usecases
book-enea-nfv-access-getting-started
book-enea-nfv-access-open-source
book-enea-nfv-access-release-info
book-enea-nfv-access-system-test-specification.
Change-Id: I1f17c4d484e25d1b94a9fb5cd28b3d02f246a40c
Signed-off-by: mrpa <miruna.paun@enea.com>
Diffstat (limited to 'doc/book-enea-nfv-access-release-info/doc')
3 files changed, 206 insertions, 202 deletions
diff --git a/doc/book-enea-nfv-access-release-info/doc/about_release.xml b/doc/book-enea-nfv-access-release-info/doc/about_release.xml index 4235d36..5219270 100644 --- a/doc/book-enea-nfv-access-release-info/doc/about_release.xml +++ b/doc/book-enea-nfv-access-release-info/doc/about_release.xml | |||
@@ -5,11 +5,13 @@ | |||
5 | <title>About This Release</title> | 5 | <title>About This Release</title> |
6 | 6 | ||
7 | <para>The Enea NFV Access <xi:include | 7 | <para>The Enea NFV Access <xi:include |
8 | href="../../s_doceneacommon/doc/eltf_params_updated.xml" xmlns:xi="http://www.w3.org/2001/XInclude" | 8 | href="../../s_doceneacommon/doc/eltf_params_updated.xml" |
9 | xpointer="element(EneaLinux_REL_VER/1)" /> Release includes a new version | 9 | xmlns:xi="http://www.w3.org/2001/XInclude" |
10 | of the uCPE Manager as well as other features and optimizations, security | 10 | xpointer="element(EneaLinux_REL_VER/1)" /> Release includes a new version of |
11 | patches and documentation updates. A list of new features can be found | 11 | the uCPE Manager as well as other features and optimizations, security |
12 | in <xref linkend="relinfo-changes-other">Section 2.1 New Features</xref>.</para> | 12 | patches and documentation updates. A list of new features can be found in |
13 | <xref linkend="relinfo-changes-other">Section 2.1 New | ||
14 | Features</xref>.</para> | ||
13 | 15 | ||
14 | <para> | 16 | <para> |
15 | <remark>INFO <emphasis role="bold">eltf_params_updated.xml</emphasis> | 17 | <remark>INFO <emphasis role="bold">eltf_params_updated.xml</emphasis> |
@@ -31,19 +33,27 @@ | |||
31 | 33 | ||
32 | <itemizedlist> | 34 | <itemizedlist> |
33 | <listitem> | 35 | <listitem> |
34 | <para>Enea_NFV_Access_Run_Time_Platform_XeonD_2.2.1.zip</para> | 36 | <para>Enea_NFV_Access_Run_Time_Platform_XeonD_2.2.2.zip</para> |
35 | </listitem> | 37 | </listitem> |
36 | 38 | ||
37 | <listitem> | 39 | <listitem> |
38 | <para>Enea_NFV_Access_Run_Time_Platform_C3000_2.2.1.zip</para> | 40 | <para>Enea_NFV_Access_Run_Time_Platform_C3000_2.2.2.zip</para> |
39 | </listitem> | 41 | </listitem> |
40 | 42 | ||
41 | <listitem> | 43 | <listitem> |
42 | <para>uCPEManager-1.0.1-CentOS.zip</para> | 44 | <para>Enea_NFV_Access_2.2.2_UpgradeKit_XeonD.zip</para> |
43 | </listitem> | 45 | </listitem> |
44 | 46 | ||
45 | <listitem> | 47 | <listitem> |
46 | <para>Automation and Test Harness (nfvaccess_2.2.1_af-th.zip)</para> | 48 | <para>Enea_NFV_Access_2.2.2_UpgradeKit_C3000.zip</para> |
49 | </listitem> | ||
50 | |||
51 | <listitem> | ||
52 | <para>uCPEManager-1.1.1-CentOS.zip</para> | ||
53 | </listitem> | ||
54 | |||
55 | <listitem> | ||
56 | <para>Automation and Test Harness (nfvaccess_2.2.2_af-th.zip)</para> | ||
47 | </listitem> | 57 | </listitem> |
48 | 58 | ||
49 | <listitem> | 59 | <listitem> |
@@ -82,8 +92,7 @@ | |||
82 | contains userspace tools and kernel configurations necessary | 92 | contains userspace tools and kernel configurations necessary |
83 | for developing, debugging and profiling applications and | 93 | for developing, debugging and profiling applications and |
84 | kernel modules */ | 94 | kernel modules */ |
85 | -- various artifacts | 95 | -- various artifacts</programlisting> |
86 | </programlisting> | ||
87 | </section> | 96 | </section> |
88 | 97 | ||
89 | <remark>INFO Below is a complete section with ID | 98 | <remark>INFO Below is a complete section with ID |
@@ -140,6 +149,12 @@ | |||
140 | </listitem> | 149 | </listitem> |
141 | 150 | ||
142 | <listitem> | 151 | <listitem> |
152 | <para>Enea NFV Access Automation Framework and Test Harness | ||
153 | Open-Source Report. Provides license information pertaining to | ||
154 | packages available with the AFTH.</para> | ||
155 | </listitem> | ||
156 | |||
157 | <listitem> | ||
143 | <para>Enea NFV Access Automation Framework and Test Harness User | 158 | <para>Enea NFV Access Automation Framework and Test Harness User |
144 | Guide. Describes the Automation Framework and Test Harness for Enea | 159 | Guide. Describes the Automation Framework and Test Harness for Enea |
145 | NFV Access and provides instructions regarding the necessary steps to | 160 | NFV Access and provides instructions regarding the necessary steps to |
@@ -152,4 +167,4 @@ | |||
152 | </listitem> | 167 | </listitem> |
153 | </itemizedlist> | 168 | </itemizedlist> |
154 | </section> | 169 | </section> |
155 | </chapter> | 170 | </chapter> \ No newline at end of file |
diff --git a/doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml b/doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml index 961a281..ce9e9e0 100644 --- a/doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml +++ b/doc/book-enea-nfv-access-release-info/doc/known_bugs_and_limitations.xml | |||
@@ -4,100 +4,94 @@ | |||
4 | <chapter id="bugs-limitations"> | 4 | <chapter id="bugs-limitations"> |
5 | <title>Known Issues and Limitations in this Release</title> | 5 | <title>Known Issues and Limitations in this Release</title> |
6 | 6 | ||
7 | <para>This chapter lists the known issues that affect the current | 7 | <para>This chapter lists the known general issues and limitations that |
8 | release.</para> | 8 | affect the current release.</para> |
9 | 9 | ||
10 | <para><remark>The section further down is generated from JIRA with | 10 | <para><remark>The section further down is generated from JIRA with |
11 | gen_known_issues.py, but that script is HARDCODED with affectedversion | 11 | gen_known_issues.py, but that script is HARDCODED with affectedversion |
12 | "EL7_3-virtualization" and needs to be adapted when a release info for | 12 | "EL7_3-virtualization" and needs to be adapted when a release info for |
13 | another ENFV Access version changes.</remark><emphasis | 13 | another ENFV Access version changes.</remark></para> |
14 | role="bold">Product-specific Issues and Limitations</emphasis></para> | ||
15 | 14 | ||
16 | <itemizedlist> | 15 | <itemizedlist> |
17 | <para><emphasis role="bold">Enea uCPE Manager</emphasis></para> | ||
18 | |||
19 | <listitem> | 16 | <listitem> |
20 | <para><remark>ELCCR-99</remark>The uCPE Manager fails to onboard renamed | 17 | <para><remark>ELCCR-119</remark>Multiple uCPE devices behind a firewall |
21 | VNF bundles downloaded to the same repo.</para> | 18 | or a gateway connecting with Call-Home are not supported.</para> |
22 | </listitem> | 19 | </listitem> |
23 | 20 | ||
24 | <listitem> | 21 | <listitem> |
25 | <para><remark>ELCCR-119</remark>No support is provided for multiple uCPE | 22 | <para><remark>ELCCR-319</remark>After a successful installation or |
26 | devices behind a firewall or gateway connecting Call Home to the uCPE | 23 | upgrade, it takes about 2 minutes until the device is accessible from |
27 | Manager (running outside the local network).</para> | 24 | the uCPE Manager.</para> |
28 | </listitem> | 25 | </listitem> |
29 | 26 | ||
30 | <listitem> | 27 | <listitem> |
31 | <para><remark>ELCCR-319</remark>After a successful installation or | 28 | <para><remark>ELCCR-349</remark>If the uCPE Manager has not been |
32 | upgrade, it takes about 2 minutes until the device is accessible from | 29 | successfully installed originally or if the installed resources (files, |
33 | the browser.</para> | 30 | users, services, databases, environment variables, etc.) have been |
31 | manually changed/removed, the uninstallation may fail and some resources will | ||
32 | have to be removed manually.</para> | ||
33 | </listitem> | ||
34 | |||
35 | <listitem> | ||
36 | <para><remark>ELCCR-349</remark>Recovery in case of a failed uCPE Manager | ||
37 | uninstallation is not implemented. In case of a failure the resources have to | ||
38 | be removed manually.</para> | ||
34 | </listitem> | 39 | </listitem> |
35 | 40 | ||
36 | <listitem> | 41 | <listitem> |
37 | <para><remark>ELCCR-349</remark>After uninstalling the uCPE manager | 42 | <para><remark>ELCCR-454</remark>Only the default database is supported, |
38 | using the <filename>uninstall.sh</filename> script, the | 43 | any requests for alternative databases are custom adaptations not tested |
39 | <literal>ec_postgres</literal> service remains in an abnormal state. If | 44 | by Enea.</para> |
40 | a product has not been successfully installed originally or if the | ||
41 | installed resources (files, users, services, databases, environment | ||
42 | variables, etc.) have been manually changed/removed, the uninstall may | ||
43 | fail and some resources will not be removed from the machine. Reverting | ||
44 | resources in the case of a failed uninstall is not implemented.</para> | ||
45 | </listitem> | 45 | </listitem> |
46 | |||
47 | <listitem><remark>ELCCR-454</remark>Only the default database is supported, any requests for alternative databases are custom adaptations.</listitem> | ||
48 | 46 | ||
49 | <listitem> | 47 | <listitem> |
50 | <para><remark>ELCCR-371</remark>A software image for NFV Access runs | 48 | <para><remark>ELCCR-474</remark>Deleting VNF instances with flows |
51 | only upon the hardware platform it is built for. Currently, NFV Access | 49 | configured on the OVS bridges can be done only after removing the |
52 | supports two separate platforms: Intel atom-c and Intel xeon-d. The user | 50 | flows.</para> |
53 | uploading a software image to the uCPE Manager can specify which | ||
54 | platform the image belongs to. When upgrading devices that have older | ||
55 | versions of NFV Access (2.2.1 and earlier), the device does not provide | ||
56 | information about its platform. In such cases, it is not possible to | ||
57 | validate if it is acceptable to use a given software image for an | ||
58 | upgrade. In more recent versions of NFV Access (2.2.2 onwards), the | ||
59 | device supplies its platform and while upgrading a device, the system | ||
60 | will validate that the software image being upgraded to is of the same | ||
61 | platform type as the device.</para> | ||
62 | </listitem> | 51 | </listitem> |
63 | 52 | ||
64 | <listitem> | 53 | <listitem> |
65 | <para><remark>ELCCR-474</remark>In case one VNF has configured flows in | 54 | <para><remark>ELCCR-527</remark>Cancelling a file upload in the uCPE |
66 | one of the OVS bridges it is connected to, the VNF instance cannot be | 55 | Manager will require the user to close and reopen the upload window for |
67 | deleted before removing the appropriate flows.</para> | 56 | the next upload to work.</para> |
68 | </listitem> | 57 | </listitem> |
69 | |||
70 | <listitem><remark>ELCCR-527</remark>When uploading a file, if the user cancels the upload, the upload window must be closed and reopened in order for the next upload to work.</listitem> | ||
71 | 58 | ||
72 | <listitem> | 59 | <listitem> |
73 | <para><remark>LXCR-9088</remark>Automation Framework and Test Harness | 60 | <para><remark>ELCCR-572</remark>Sometimes when selecting and deleting |
74 | tests require python version 2.7.X. Please make sure it is installed | 61 | more than one VNF instance simultaneously, an error message might be |
75 | before using the framework.</para> | 62 | triggered, even if the delete operation succeeds.</para> |
76 | </listitem> | 63 | </listitem> |
77 | 64 | ||
78 | <listitem> | 65 | <listitem> |
79 | <para><remark>LXCR-????</remark>The Call Home functionality does not | 66 | <para><remark>LXCR-????</remark>The Call Home functionality does not |
80 | support having multiple interfaces/routes that go from the device to the | 67 | support having multiple interfaces/routes that go from the device to the |
81 | uCPE Manager. The IP/DNS address might need to be changed to the | 68 | uCPE Manager.</para> |
82 | established socket IP.</para> | ||
83 | </listitem> | 69 | </listitem> |
84 | 70 | ||
85 | <listitem> | 71 | <listitem> |
86 | <para><remark>LXCR-9799</remark>In case two HDDs installed with NFV | 72 | <para><remark>LXCR-9799</remark>NFV Access can boot from the wrong |
87 | Access are attached to the same device, it is possible that NFV Access | 73 | partition if two HDDs are attached to the same device, this must be |
88 | will boot from the wrong partition. Please avoid having two NFV Access | 74 | avoided.</para> |
89 | images installed on two HDDs on the same device.</para> | ||
90 | </listitem> | 75 | </listitem> |
91 | </itemizedlist> | ||
92 | 76 | ||
93 | <para><remark>The section further down is generated from JIRA with | 77 | <listitem> |
94 | gen_known_issues.py, but that script is HARDCODED with affectedversion | 78 | <para><remark>LXCR-9853</remark>The WAN interface of uCPE device needs |
95 | "EL7_3-virtualization" and needs to be adapted when a release info for | 79 | to be connected to a network with at least a router/gateway installed |
96 | another ENFV Access version changes.</remark></para> | 80 | for next-hop communication.</para> |
81 | </listitem> | ||
82 | |||
83 | <listitem> | ||
84 | <para><remark>LXCR-9853</remark>When configuring a VNF with WAN and | ||
85 | Management access on different interfaces, the user has to ensure VNF's | ||
86 | virtual interfaces are configured so that proper routes are used for | ||
87 | traffic egress-ing the VNF.</para> | ||
88 | </listitem> | ||
97 | 89 | ||
98 | <para><emphasis role="bold">General Issues and Limitations</emphasis></para> | 90 | <listitem> |
91 | <para><remark>LXCR-9904</remark>NFV Access cannot be installed on USB | ||
92 | storage devices.</para> | ||
93 | </listitem> | ||
99 | 94 | ||
100 | <itemizedlist> | ||
101 | <listitem condition="hidden"> | 95 | <listitem condition="hidden"> |
102 | <para><emphasis role="bold">PDF navigation</emphasis>: When using links | 96 | <para><emphasis role="bold">PDF navigation</emphasis>: When using links |
103 | to open other PDFs, or jump to another place in the same PDF, jumping | 97 | to open other PDFs, or jump to another place in the same PDF, jumping |
@@ -106,121 +100,6 @@ | |||
106 | configured to open PDF files in an external PDF reader. As a workaround, | 100 | configured to open PDF files in an external PDF reader. As a workaround, |
107 | open the HTML version of the document.<remark>LXCR-3283</remark></para> | 101 | open the HTML version of the document.<remark>LXCR-3283</remark></para> |
108 | </listitem> | 102 | </listitem> |
109 | |||
110 | <listitem> | ||
111 | <para><remark>LXCR-9773</remark>REST API changes for specified modules | ||
112 | that might cause backward compatibility issues, are listed below:</para> | ||
113 | |||
114 | <itemizedlist> | ||
115 | <listitem> | ||
116 | <para>CustomScripts:</para> | ||
117 | |||
118 | <para>The <literal>uploadCustomScript()</literal> method takes in an | ||
119 | additional argument (device module name). This should not affect | ||
120 | current REST clients, since CustomScript functionality is available | ||
121 | only for NFV Access 2.2.2.</para> | ||
122 | </listitem> | ||
123 | |||
124 | <listitem> | ||
125 | <para>Device Upgrade:</para> | ||
126 | |||
127 | <para>A new method <literal>-- upload() --</literal> has been added | ||
128 | to allow uploads of NFV Access software images to the uCPE Manager. | ||
129 | This should not affect current REST clients, since it is a new | ||
130 | method.</para> | ||
131 | </listitem> | ||
132 | |||
133 | <listitem> | ||
134 | <para>VnfManager:</para> | ||
135 | |||
136 | <para>A new method <literal>-- upload() --</literal> has been added | ||
137 | to allow uploads of VNF images to the uCPE Manager as part of the | ||
138 | onboarding process. This should not affect current REST clients, | ||
139 | since it is a new method.</para> | ||
140 | </listitem> | ||
141 | |||
142 | <listitem> | ||
143 | <para>VcpeAgent (i.e. NFV Access device module):<itemizedlist> | ||
144 | <listitem> | ||
145 | <para>The system-attributes config table was split into | ||
146 | system-attributes-state (operational data) and | ||
147 | system-attributes (configuration data).<itemizedlist> | ||
148 | <listitem> | ||
149 | <para>The configuration data still contains the | ||
150 | attributes: device-name, device-description and | ||
151 | initial-configuration-complete.</para> | ||
152 | </listitem> | ||
153 | |||
154 | <listitem> | ||
155 | <para>The fields device-type, device-version, device-id, | ||
156 | device-latitude, and device-longitude are now | ||
157 | operational data. device-ip-address has been added as | ||
158 | oper data.</para> | ||
159 | </listitem> | ||
160 | |||
161 | <listitem> | ||
162 | <para>customer-tag in release version 2.2.1 was a config | ||
163 | leaf-list, it is now a leaf called device-customer-tags | ||
164 | (comma-separated).</para> | ||
165 | </listitem> | ||
166 | |||
167 | <listitem> | ||
168 | <para>mgmt-ip-address has been added as oper data. This | ||
169 | attribute was configured within an ovs-bridge of type | ||
170 | inband-mgmt.</para> | ||
171 | </listitem> | ||
172 | </itemizedlist></para> | ||
173 | </listitem> | ||
174 | |||
175 | <listitem> | ||
176 | <para>The external-interface-capabilities operational table | ||
177 | now has "wan" and "mgmt" Booleans.</para> | ||
178 | </listitem> | ||
179 | |||
180 | <listitem> | ||
181 | <para>The external-interface configuration table now has a | ||
182 | choice of "wan".</para> | ||
183 | |||
184 | <para>New fields for this type are mgmt-interface, | ||
185 | address-assignment , ip-address, gateway, netmask (only | ||
186 | considered if static).</para> | ||
187 | </listitem> | ||
188 | |||
189 | <listitem> | ||
190 | <para>In ovs-bridge, for the choice of inband-mgmt, the | ||
191 | mgmt-address and mgmt-port fields have been removed (there are | ||
192 | no fields left in this choice).</para> | ||
193 | </listitem> | ||
194 | |||
195 | <listitem> | ||
196 | <para>In the Host operational table, there are a couple of | ||
197 | changes:<itemizedlist> | ||
198 | <listitem> | ||
199 | <para>The "name" field has been removed, there is still | ||
200 | a "host-name" field.</para> | ||
201 | </listitem> | ||
202 | |||
203 | <listitem> | ||
204 | <para>A "machine-type" field has been added.</para> | ||
205 | </listitem> | ||
206 | </itemizedlist></para> | ||
207 | </listitem> | ||
208 | </itemizedlist></para> | ||
209 | </listitem> | ||
210 | </itemizedlist> | ||
211 | </listitem> | ||
212 | |||
213 | <listitem> | ||
214 | <para>REST clients should see some minor changes depending upon whether | ||
215 | they are dealing with version 2.2.1 or 2.2.2 of the device. Code that | ||
216 | deals with the system-attributes table, in-band management OVS bridges, | ||
217 | or the host operational data might need to be modified.</para> | ||
218 | |||
219 | <para>The new wan interface type only matters in that you need a | ||
220 | wan-mgmt interface configured to create the in-band mgmt. bridge. This | ||
221 | should typically happen automatically as part of initial install or | ||
222 | upgrade and should not affect the REST clients</para> | ||
223 | </listitem> | ||
224 | </itemizedlist> | 103 | </itemizedlist> |
225 | 104 | ||
226 | <!-- The file with a section below is autocreated by make init --> | 105 | <!-- The file with a section below is autocreated by make init --> |
diff --git a/doc/book-enea-nfv-access-release-info/doc/main_changes.xml b/doc/book-enea-nfv-access-release-info/doc/main_changes.xml index 6719a36..58435ff 100644 --- a/doc/book-enea-nfv-access-release-info/doc/main_changes.xml +++ b/doc/book-enea-nfv-access-release-info/doc/main_changes.xml | |||
@@ -14,28 +14,25 @@ | |||
14 | 14 | ||
15 | <itemizedlist> | 15 | <itemizedlist> |
16 | <listitem> | 16 | <listitem> |
17 | <para>uCPE Manager 1.0.1</para> | 17 | <para>Use of OpenJDK as the Java Engine in the uCPE Manager.</para> |
18 | </listitem> | 18 | </listitem> |
19 | 19 | ||
20 | <listitem> | 20 | <listitem> |
21 | <para>Support for standard (non-DPDK) interfaces on the virtualized | 21 | <para>USB Installer Web User Interface.</para> |
22 | networking infrastructure.</para> | ||
23 | </listitem> | 22 | </listitem> |
24 | 23 | ||
25 | <listitem> | 24 | <listitem> |
26 | <para>Support for OpenvSwitch using kernel datapath.</para> | 25 | <para>Support of ZTP extensions through custom scripting.</para> |
27 | </listitem> | 26 | </listitem> |
28 | 27 | ||
29 | <listitem> | 28 | <listitem> |
30 | <para>In-band management extension for VNFs' management plane.</para> | 29 | <para>Support for uCPE device software management from the Enea uCPE |
30 | Manager.</para> | ||
31 | </listitem> | 31 | </listitem> |
32 | 32 | ||
33 | <listitem> | 33 | <listitem> |
34 | <para>UEFI Secure Boot.</para> | 34 | <para>Support for Layer 3 networking configuration from the Enea uCPE |
35 | </listitem> | 35 | Manager.</para> |
36 | |||
37 | <listitem> | ||
38 | <para>Bare Metal Provisioning.</para> | ||
39 | </listitem> | 36 | </listitem> |
40 | </itemizedlist> | 37 | </itemizedlist> |
41 | </section> | 38 | </section> |
@@ -48,13 +45,126 @@ | |||
48 | release.</para> | 45 | release.</para> |
49 | </section> | 46 | </section> |
50 | 47 | ||
51 | <section condition="hidden" id="relinfo-backward-compat"> | 48 | <section id="relinfo-backward-compat"> |
52 | <title>Compatibility</title> | 49 | <title>Compatibility</title> |
53 | 50 | ||
54 | <para>In the development of any complex software platform, there is a need | 51 | <para condition="hidden">In the development of any complex software |
55 | to strike a balance between backwards compatibility and new development. | 52 | platform, there is a need to strike a balance between backwards |
56 | In most cases, compatibility will be maintained as long as reasonably | 53 | compatibility and new development. In most cases, compatibility will be |
57 | possible. Necessary compatibility breaks will be done only as needed and | 54 | maintained as long as reasonably possible. Necessary compatibility breaks |
58 | in major releases.</para> | 55 | will be done only as needed and in major releases.</para> |
56 | |||
57 | <para><remark>LXCR-9773</remark>Following REST API changes were added:</para> | ||
58 | |||
59 | <itemizedlist> | ||
60 | <listitem> | ||
61 | <para>The <literal>uploadCustomScript()</literal> method included in the | ||
62 | <literal>CustomScripts</literal> module takes in an | ||
63 | additional argument (device module name).</para> | ||
64 | </listitem> | ||
65 | |||
66 | <listitem> | ||
67 | <para>A new <literal>-- upload() --</literal> method has been added to | ||
68 | the Device Upgrade module to allow for uploads of NFV Access software | ||
69 | images to the uCPE Manager.</para> | ||
70 | </listitem> | ||
71 | |||
72 | <listitem> | ||
73 | <para>A new <literal>-- upload() --</literal> method has been added to | ||
74 | the <literal>VnfManager</literal> module to allow uploads of VNF | ||
75 | images to the uCPE Manager as part of the onboarding process.</para> | ||
76 | </listitem> | ||
77 | </itemizedlist> | ||
78 | |||
79 | <para>The <literal>VcpeAgent</literal> (i.e. the NFV Access device module) | ||
80 | was redesigned:</para> | ||
81 | |||
82 | <itemizedlist> | ||
83 | <listitem> | ||
84 | <para> The <literal>system-attributes</literal> config table was split | ||
85 | into <literal>system-attributes-state</literal> (operational data) and | ||
86 | <literal>system-attributes</literal> (configuration data).</para> | ||
87 | |||
88 | <itemizedlist> | ||
89 | <listitem> | ||
90 | <para> The configuration data still contains the attributes: | ||
91 | <literal>device-name</literal>, | ||
92 | <literal>device-description</literal> and | ||
93 | <literal>initial-configuration-complete</literal>.</para> | ||
94 | </listitem> | ||
95 | |||
96 | <listitem> | ||
97 | <para>The fields <literal>device-type</literal>, | ||
98 | <literal>device-version</literal>, <literal>device-id</literal>, | ||
99 | <literal>device-latitude</literal>, and | ||
100 | <literal>device-longitude</literal> are now operational data. | ||
101 | <literal>device-ip-address</literal> has been added as oper | ||
102 | data.</para> | ||
103 | </listitem> | ||
104 | |||
105 | <listitem> | ||
106 | <para>The <literal>customer-tag</literal> in release version 2.2.1 | ||
107 | was a config leaf-list, it is now a leaf called | ||
108 | <literal>device-customer-tags</literal> (comma-separated).</para> | ||
109 | </listitem> | ||
110 | |||
111 | <listitem> | ||
112 | <para>The <literal>mgmt-ip-address</literal> has been added as | ||
113 | oper data. This attribute was configured within an ovs-bridge of | ||
114 | type <literal>inband-mgmt</literal>.</para> | ||
115 | </listitem> | ||
116 | </itemizedlist> | ||
117 | </listitem> | ||
118 | |||
119 | <listitem> | ||
120 | <para>The <literal>external-interface-capabilities</literal> | ||
121 | operational table now has <literal>wan</literal> and | ||
122 | <literal>mgmt</literal> Booleans.</para> | ||
123 | </listitem> | ||
124 | |||
125 | <listitem> | ||
126 | <para>The <literal>external-interface</literal> configuration table | ||
127 | now has a choice of <literal>wan</literal>. </para> | ||
128 | |||
129 | <para>New fields for this type are <literal>mgmt-interface</literal>, | ||
130 | <literal>address-assignment</literal>, <literal>ip-address</literal>, | ||
131 | <literal>gateway</literal>, and <literal>netmask</literal> (only | ||
132 | considered if static).</para> | ||
133 | </listitem> | ||
134 | |||
135 | <listitem> | ||
136 | <para>In an <literal>ovs-bridge</literal>, for the choice of | ||
137 | <literal>inband-mgmt</literal>, the <literal>mgmt-address</literal> | ||
138 | and <literal>mgmt-port</literal> fields have been removed (there are | ||
139 | no fields left in this choice).</para> | ||
140 | </listitem> | ||
141 | |||
142 | <listitem> | ||
143 | <para>In the Host operational table, there are a couple of | ||
144 | changes:</para> | ||
145 | |||
146 | <itemizedlist> | ||
147 | <listitem> | ||
148 | <para>The <literal>name</literal> field has been removed, however, | ||
149 | there is still a <literal>host-name</literal> field.</para> | ||
150 | </listitem> | ||
151 | |||
152 | <listitem> | ||
153 | <para>A <literal>machine-type</literal> field has been | ||
154 | added.</para> | ||
155 | </listitem> | ||
156 | </itemizedlist> | ||
157 | </listitem> | ||
158 | </itemizedlist> | ||
159 | |||
160 | <para>REST clients should see only some minor changes when upgrading from | ||
161 | NFV Access 2.2.1 to NFV Access 2.2.2. Code that deals with the | ||
162 | system-attributes table, in-band management OVS bridges, or the host | ||
163 | operational data may need to be modified.</para> | ||
164 | |||
165 | <para>The new WAN interface type needs a <literal>wan-mgmt</literal> | ||
166 | interface configured to create the <literal>in-band mgmt</literal> bridge. | ||
167 | This should typically happen automatically as part of initial installation | ||
168 | or upgrade and should not affect the REST clients.</para> | ||
59 | </section> | 169 | </section> |
60 | </chapter> | 170 | </chapter> \ No newline at end of file |