Skip to content

Commit

Permalink
Update doc for 5.4.1U17
Browse files Browse the repository at this point in the history 
Change-Id: Ie4ba65543acdc133faf745836ae20b34d242225d
  • Loading branch information
@sjabasti
sjabasti committed Mar 18, 2021
1 parent 053cb5f commit 6066b5b
Show file tree
Hide file tree
Showing 2 changed files with 66 additions and 63 deletions.
38 changes: 19 additions & 19 deletions Documentation/5.4.1/README.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ In this phase, get the Nuage Tripleo Heat Templates, image patching files, and t
Example:

cd /home/stack
git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b 13.541U16.1
git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b 13.541U17.1
ln -s nuage-ospdirector/nuage-tripleo-heat-templates .


Expand All @@ -182,20 +182,20 @@ In this phase, you prepare the Red Hat OpenStack and Nuage containers for the in
Phase 3.1: Configure the Container Image Source and Pull the Red Hat OpenStack Containers
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

This release is supported only on RHEL 7.8. The list of RHEL 7.8 based overcloud container images that were used for qualification can be found on the wiki: https://github.com/nuagenetworks/nuage-ospdirector/wiki/upstream-container-list-tested-with-Nuage-5.4.1.U16-(RHEL-7.8 OSPD13z12).
This release is supported only on RHEL 7.8. The list of RHEL 7.8 based overcloud container images that were used for qualification can be found on the wiki: https://github.com/nuagenetworks/nuage-ospdirector/wiki/upstream-container-list-tested-with-Nuage-5.4.1.U17-(RHEL-7.8 OSPD13z12).


Phase 3.2: Pull the Nuage Containers from the Red Hat Catalog
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Nuage provides the customized OpenStack containers with Nuage plugins and extensions. The container names change from release to release. This is a sample from Release 5.4.1 U16 with 13.0-1 as an example (this version may change):
Nuage provides the customized OpenStack containers with Nuage plugins and extensions. The container names change from release to release. This is a sample from Release 5.4.1 U17 with 13.0-1 as an example (this version may change):

* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-api-cfn-5-4-1-u16:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-api-5-4-1-u16:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-engine-5-4-1-u16:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-horizon-5-4-1-u16:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-neutron-server-5-4-1-u16:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-nova-compute-5-4-1-u16:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-api-cfn-5-4-1-u17:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-api-5-4-1-u17:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-engine-5-4-1-u17:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-horizon-5-4-1-u17:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-neutron-server-5-4-1-u17:13.0-2
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-nova-compute-5-4-1-u17:13.0-2

For the list of containers against which the Nuage integration was tested, see the `Release Notes <https://github.com/nuagenetworks/nuage-ospdirector/releases>`_ for this release.

Expand Down Expand Up @@ -226,8 +226,8 @@ The Nuage containers are now available in the Red Hat Partner Container Catalog.
#OpenStack version number
version: 13
#Nuage Release and format is <Major-release, use '-' instead of '.'>-<Minor-release>-<Updated-release>
# for example: Nuage release 5.4.1 U16 please enter following
release: 5-4-1-u16
# for example: Nuage release 5.4.1 U17 please enter following
release: 5-4-1-u17
#Tag for Nuage container images
tag: latest
#Undercloud Local Registry IP Address:PORT
Expand Down Expand Up @@ -384,7 +384,7 @@ The repository contents may change depending on the roles configured for your de
| +----------------------------------------------+-------------------------------------------------------------------------------------------+
| | selinux-policy-nuage-avrs | nuage-avrs-selinux |
+----------------+----------------------------------------------+-------------------------------------------------------------------------------------------+
| Nuage SR-IOV | nuage-topology-collector (for Nuage SR-IOV) | nuage-openstack |
| Nuage SR-IOV | nuage-topology-collector (for Nuage SR-IOV) | https://github.com/nuagenetworks/topology-collector/releases/tag/release-5.4.1.U17 |
| packages | | |
|----------------+----------------------------------------------+-------------------------------------------------------------------------------------------+

Expand Down Expand Up @@ -1079,7 +1079,7 @@ Phase 6: Verify that OpenStack Platform Director Has Been Deployed Successfully
Interface "svc-rl-tap1"
Port "svc-rl-tap2"
Interface "svc-rl-tap2"
ovs_version: "5.4.1-523-nuage"
ovs_version: "5.4.1-548-nuage"


Phase 7: Install the nuage-openstack-neutronclient RPM in the Undercloud (Optional)
Expand Down Expand Up @@ -1111,19 +1111,19 @@ For a local repository for Nuage OpenStack packages and Red Hat OpenStack-depend
::

[nuage]
name=nuage_osp13_5.4.1.u16_nuage
name=nuage_osp13_5.4.1.u17_nuage
baseurl=http://1.2.3.4/nuage_osp13_5.4.1/nuage_extra
enabled=1
gpgcheck=1

[nuage_vrs]
name=nuage_osp13_5.4.1.u16_nuage_vrs
name=nuage_osp13_5.4.1.u17_nuage_vrs
baseurl=http://1.2.3.4/nuage_osp13_5.4.1/nuage_vrs
enabled=0
gpgcheck=1

[nuage_avrs]
name=nuage_osp13_5.4.1.u16_nuage_avrs
name=nuage_osp13_5.4.1.u17_nuage_avrs
baseurl=http://1.2.3.4/nuage_osp13_5.4.1/avrs
enabled=0
gpgcheck=1
Expand Down Expand Up @@ -1156,19 +1156,19 @@ For a local repository for Nuage packages and a Red Hat Subscription for depende
::

[nuage]
name=nuage_osp13_5.4.1.u16_nuage
name=nuage_osp13_5.4.1.u17_nuage
baseurl=http://1.2.3.4/nuage_osp13_5.4.1/nuage_extra
enabled=1
gpgcheck=1

[nuage_vrs]
name=nuage_osp13_5.4.1.u16_nuage_vrs
name=nuage_osp13_5.4.1.u17_nuage_vrs
baseurl=http://1.2.3.4/nuage_osp13_5.4.1/nuage_vrs
enabled=0
gpgcheck=1

[nuage_avrs]
name=nuage_osp13_5.4.1.u16_nuage_avrs
name=nuage_osp13_5.4.1.u17_nuage_avrs
baseurl=http://1.2.3.4/nuage_osp13_5.4.1/avrs
enabled=0
gpgcheck=1
Expand Down
91 changes: 47 additions & 44 deletions Documentation/5.4.1/Upgrade/README.rst
View file
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
.. Don't use default python highlighting for code blocks http://www.sphinx-doc.org/en/stable/markup/code.html
===================================
Minor Upgrade to Release 5.4.1 U16
Minor Upgrade to Release 5.4.1 U17
===================================

.. contents::
:local:
:depth: 3


Use this documentation when upgrading between Nuage minor releases. The process applies to upgrades from Release 5.4.1U12 with RH OSPD13z12 with RHEL 7.8 or later to Release 5.4.1U16 with RH OSPD13z12 with RHEL 7.8.
Use this documentation when upgrading between Nuage minor releases. The process applies to upgrades from Release 5.4.1U12 with RH OSPD13z12 with RHEL 7.8 or later to Release 5.4.1U17 with RH OSPD13z12 with RHEL 7.8.

During this process:

1. Nuage components are updated to 5.4.1.U16
1. Nuage components are updated to 5.4.1.U17
2. Red Hat OpenStack stays as OSPD13z12.
3. Red Hat Enterprise Linux stays as 7.8

Note: Nuage 5.4.1.U16 release is supported with RHEL 7.8. Make sure the Red Hat Openstack Platform Director packages are updated to the z12 stream during the minor Nuage update process.
Note: Nuage 5.4.1.U17 release is supported with RHEL 7.8. Make sure the Red Hat Openstack Platform Director packages are updated to the z12 stream during the minor Nuage update process.


It is assumed the operator is familiar with Red Hat OpenStack Platform Director upgrades, VSP installation, the distribution-specific installation and upgrade practices, and the specific requirements for operations in a production environment.
Expand All @@ -26,7 +26,7 @@ It is assumed the operator is familiar with Red Hat OpenStack Platform Director
Upgrade Paths
-------------

In this release, you can upgrade only from Queens 5.4.1 U12(RH OSPD13z12) to Queens 5.4.1 U16(RH OSPD13z12).
In this release, you can upgrade only from Queens 5.4.1 U12(RH OSPD13z12) to Queens 5.4.1 U17(RH OSPD13z12).


These upgrade paths are not described in this document:
Expand All @@ -52,7 +52,7 @@ The basic configuration includes:
Before the Upgrade
--------------------

1. Create the following repositories containing 5.4.1U16 nuage packages:
1. Create the following repositories containing 5.4.1U17 nuage packages:


* Nuage_base_repo:
Expand All @@ -70,7 +70,7 @@ Before the Upgrade
- It contains nuage-metadata-agent, nuage-openvswitch (avrs), nuage-selinux-avrs, and 6WIND packages.
- Enable this repository on the Nova Compute AVRS nodes.

2. Make sure the Nuage 5.4.1.U16 repository and Red Hat repositories for OSPD 13 Z12 are enabled on all Overcloud nodes.
2. Make sure the Nuage 5.4.1.U17 repository and Red Hat repositories for OSPD 13 Z12 are enabled on all Overcloud nodes.

3. Please run "yum clean all" to clean the old yum cache on all your overcloud nodes after enabling above yum repositories.

Expand All @@ -85,7 +85,7 @@ Upgrade Workflow

2. Back up the configuration files for your deployment.

In the following example, all the templates and environment files for your deployment are in the /home/stack/nuage-ospdirector directory. Before getting the new Nuage 5.4.1 U16 nuage-ospdirector/nuage-tripleoheat-templates, back up the existing files and then replace them with the new 5.4.1 U16 codebase.
In the following example, all the templates and environment files for your deployment are in the /home/stack/nuage-ospdirector directory. Before getting the new Nuage 5.4.1 U17 nuage-ospdirector/nuage-tripleoheat-templates, back up the existing files and then replace them with the new 5.4.1 U17 codebase.

a. Back up the templates and environment files from /home/stack/nuage-ospdirector to /home/stack/nuage-ospdirector-bk.

Expand Down Expand Up @@ -163,58 +163,60 @@ Upgrade Workflow
Post Upgrade Verifications
--------------------------

- The computes should have the 5.4.1.U12 nuage-openvswitch version.
- The computes should have the 5.4.1.U17 nuage-openvswitch version.

::

[heat-admin@overcloud-compute-1 ~]$ sudo ovs-appctl version
ovs-vswitchd (Open vSwitch) 5.4.1-523-nuage
Compiled Jul 9 2020 22:38:51
ovs-vswitchd (Open vSwitch) 5.4.1-544-nuage
Compiled Mar 4 2021 03:13:30
Open vSwitch base release: 0x250

[heat-admin@overcloud-computeavrs-1 ~]$ sudo ovs-appctl version
ovs-vswitchd (Open vSwitch) 5.4.1-523-6wind-nuage
Compiled Jul 9 2020 23:00:28
ovs-vswitchd (Open vSwitch) 5.4.1-544-6wind-nuage
Compiled Mar 4 2021 03:11:24
Open vSwitch base release: 0x250


- The computes should have the 5.4.1.U16 nuage rmps
- The computes should have the 5.4.1.U17 nuage rmps

::

[heat-admin@overcloud-compute-1 ~]$ rpm -qa | grep nuage
nuage-metadata-agent-5.4.1-523.el7.x86_64
selinux-policy-nuage-5.4.1-443.el7.x86_64
nuage-bgp-5.4.1-483.x86_64
nuage-openstack-neutronclient-6.5.0-5.4.1_524_nuage.noarch
nuage-openvswitch-5.4.1-523.el7.x86_64
selinux-policy-nuage-5.4.1-518.el7.x86_64
nuage-bgp-5.4.1-544.x86_64
python-openvswitch-nuage-5.4.1-544.6wind.el7.x86_64
nuage-openstack-neutronclient-6.5.0-5.4.1_545_nuage.noarch
nuage-openvswitch-5.4.1-544.el7.x86_64
nuage-puppet-modules-5.4-0.x86_64
python-openvswitch-nuage-5.4.1-523.el7.x86_64
nuage-metadata-agent-5.4.1-544.el7.x86_64

[heat-admin@overcloud-computeavrs-1 ~]$ rpm -qa | grep "nuage\|6wind\|virtual"
6windgate-fp-ovs-4.23.12.NUAGE.13-0.x86_64
nuage-openvswitch-5.4.1-544.6wind.el7.x86_64
6windgate-fpn-sdk-dpdk-4.23.12.NUAGE.13-0.x86_64
6windgate-linux-fp-sync-4.23.12.NUAGE.13-0.x86_64
nuage-bgp-5.4.1-483.x86_64
selinux-policy-nuage-5.4.1-518.el7.x86_64
nuage-bgp-5.4.1-544.x86_64
6windgate-dpdk-pmd-mellanox-rdma-core-4.23.12.NUAGE.13-0.x86_64
6windgate-tools-common-libs-pyroute2-0.4.13-6windgate.4.23.12.NUAGE.13.x86_64
6windgate-tools-common-libs-libconsole-4.23.12.NUAGE.13-0.x86_64
6windgate-dpdk-pmd-virtio-host-4.23.12.NUAGE.13-0.x86_64
6windgate-linux-fp-sync-fptun-4.23.12.NUAGE.13-0.x86_64
6windgate-fpn-sdk-dpdk-4.23.12.NUAGE.13-0.x86_64
nuage-openvswitch-5.4.1-523.6wind.el7.x86_64
selinux-policy-nuage-5.4.1-443.el7.x86_64
nuage-metadata-agent-5.4.1-544.6wind.el7.x86_64
python-openvswitch-nuage-5.4.1-544.6wind.el7.x86_64
nuage-openstack-neutronclient-6.5.0-5.4.1_545_nuage.noarch
selinux-policy-nuage-avrs-5.4.1-518.el7.x86_64
6windgate-tools-common-libs-daemonctl-4.23.12.NUAGE.13-0.x86_64
6windgate-tools-common-libs-pyroute2-0.4.13-6windgate.4.23.12.NUAGE.13.x86_64
nuage-metadata-agent-5.4.1-523.6wind.el7.x86_64
6windgate-linux-fp-sync-vrf-4.23.12.NUAGE.13-0.x86_64
6windgate-product-base-4.23.12.NUAGE.13-0.x86_64
6windgate-linux-fp-sync-fptun-4.23.12.NUAGE.13-0.x86_64
virtual-accelerator-base-1.9.12.NUAGE.13-0.x86_64
6windgate-dpdk-pmd-mellanox-rdma-core-4.23.12.NUAGE.13-0.x86_64
6windgate-fp-ovs-4.23.12.NUAGE.13-0.x86_64
nuage-openstack-neutronclient-6.5.0-5.4.1_524_nuage.noarch
6windgate-tools-common-libs-libconsole-4.23.12.NUAGE.13-0.x86_64
6windgate-fp-4.23.12.NUAGE.13-0.x86_64
selinux-policy-nuage-avrs-5.4.1-443.el7.x86_64
python-openvswitch-nuage-5.4.1-523.6wind.el7.x86_64
nuage-puppet-modules-5.4-0.x86_64
6windgate-linux-fp-sync-vrf-4.23.12.NUAGE.13-0.x86_64
6windgate-dpdk-4.23.12.NUAGE.13-0.x86_64
6windgate-linux-fp-sync-ovs-4.23.12.NUAGE.13-0.x86_64
nuage-puppet-modules-5.4-0.x86_64
6windgate-fp-4.23.12.NUAGE.13-0.x86_64
6windgate-product-base-4.23.12.NUAGE.13-0.x86_64
python-pyelftools-0.24-6windgate.4.23.12.NUAGE.13.x86_64



- The computes should now have the Nuage VXLAN iptables rule as stateless
Expand All @@ -225,18 +227,18 @@ Post Upgrade Verifications
ACCEPT udp -- anywhere anywhere multiport dports 4789 /* 118 neutron stateless vxlan networks ipv4 */


- The controllers should have the 5.4.1.U16 nuage and RHEL 7.8 RHOSP container images
- The controllers should have the 5.4.1.U17 nuage and RHEL 7.8 RHOSP container images

::

[heat-admin@overcloud-controller-0 ~]$ sudo docker ps | grep nuagenetworks
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
7934af1bd9bf 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-neutron-server-5-4-1-u16:latest "dumb-init --singl..." About an hour ago Up About an hour (healthy) neutron_api
720c3881257f 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-heat-api-5-4-1-u16:latest "dumb-init --singl..." About an hour ago Up About an hour heat_api_cron
2bac3ff0d02f 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-heat-api-cfn-5-4-1-u16:latest "dumb-init --singl..." About an hour ago Up About an hour (healthy) heat_api_cfn
32d15910de69 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-heat-engine-5-4-1-u16:latest "dumb-init --singl..." About an hour ago Up About an hour (healthy) heat_engine
a345d417faa0 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-heat-api-5-4-1-u16:latest "dumb-init --singl..." About an hour ago Up About an hour (healthy) heat_api
2b3529c1ab4d 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-horizon-5-4-1-u16:latest "dumb-init --singl..." About an hour ago Up About an hour horizon
7934af1bd9bf 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-neutron-server-5-4-1-u17:latest "dumb-init --singl..." About an hour ago Up About an hour (healthy) neutron_api
720c3881257f 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-heat-api-5-4-1-u17:latest "dumb-init --singl..." About an hour ago Up About an hour heat_api_cron
2bac3ff0d02f 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-heat-api-cfn-5-4-1-u17:latest "dumb-init --singl..." About an hour ago Up About an hour (healthy) heat_api_cfn
32d15910de69 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-heat-engine-5-4-1-u17:latest "dumb-init --singl..." About an hour ago Up About an hour (healthy) heat_engine
a345d417faa0 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-heat-api-5-4-1-u17:latest "dumb-init --singl..." About an hour ago Up About an hour (healthy) heat_api
2b3529c1ab4d 192.168.200.1:8787/nuagenetworks/rhosp13-openstack-horizon-5-4-1-u17:latest "dumb-init --singl..." About an hour ago Up About an hour horizon


- The kmods are properly build for AVRS computes
Expand All @@ -247,3 +249,4 @@ Post Upgrade Verifications
fpn-sdk, 4.23.12.NUAGE.13, 3.10.0-1127.19.1.el7.x86_64, x86_64: installed
fptun, 4.23.12.NUAGE.13, 3.10.0-1127.19.1.el7.x86_64, x86_64: installed
vrf, 4.23.12.NUAGE.13, 3.10.0-1127.19.1.el7.x86_64, x86_64: installed

0 comments on commit 6066b5b

Please sign in to comment.