Skip to content

Commit

Permalink
Update doc for 6.0.17
Browse files Browse the repository at this point in the history 
Change-Id: Icc60dacbc0cd6b86606e50e19ab8372425979575
  • Loading branch information
@sjabasti
sjabasti committed Aug 17, 2021
1 parent 0170c01 commit d86ce42
Show file tree
Hide file tree
Showing 3 changed files with 42 additions and 54 deletions.
22 changes: 11 additions & 11 deletions Documentation/6.0/README.rst
View file
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.. Don't use default python highlighting for code blocks http://www.sphinx-doc.org/en/stable/markup/code.html
========================================================================
Integrating Nuage VSP 6.0.7 with Red Hat OpenStack Platform Director 13
Integrating Nuage VSP 6.0.17 with Red Hat OpenStack Platform Director 13
========================================================================

This document has the following topics:
Expand Down Expand Up @@ -182,14 +182,14 @@ https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html
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 6.0.7 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 6.0.17 with 13.0-1 as an example (this version may change):

* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-api-cfn-6-0-7:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-api-6-0-7:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-engine-6-0-7:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-horizon-6-0-7:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-neutron-server-6-0-7:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-nova-compute-6-0-7:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-api-cfn-6-0-17:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-api-6-0-17:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-heat-engine-6-0-17:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-horizon-6-0-17:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-neutron-server-6-0-17:13.0-1
* registry.connect.redhat.com/nuagenetworks/rhosp13-openstack-nova-compute-6-0-17:13.0-1

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 @@ -220,8 +220,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 6.0.7 please enter following
release: 6-0-7
# for example: Nuage release 6.0.17 please enter following
release: 6-0-17
#Tag for Nuage container images
tag: latest
#Undercloud Local Registry IP Address:PORT
Expand Down Expand Up @@ -1350,7 +1350,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: "6.0.7-265-nuage"
ovs_version: "6.0.17-591-nuage"


Phase 7: Install the nuage-openstack-neutronclient RPM in the Undercloud (Optional)
Expand Down
50 changes: 19 additions & 31 deletions Documentation/6.0/Upgrade/Major_Upgrade_README.rst
View file
Original file line number Diff line number Diff line change
@@ -1,35 +1,33 @@
.. Don't use default python highlighting for code blocks http://www.sphinx-doc.org/en/stable/markup/code.html
===================================
Major Upgrade to Release 6.0.7
Major Upgrade to Release 6.0.17
===================================

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


Use this documentation when upgrading between major Nuage releases. The process applies to updates from Release 5.4.1 U6 (Z7) to Release 6.0.7 (Z11). During this process:
Use this documentation when upgrading between major Nuage releases. The process applies to updates from Release 5.4.1 U17 (Z12) to Release 6.0.17 (Z16). During this process:

1. Nuage components are updated to 6.0.7.
2. Red Hat OpenStack is updated to Z11.
1. Nuage components are updated to 6.0.17.
2. Red Hat OpenStack is updated to Z16.

Note: Nuage 6.0.7 release is supported with RHEL 7.7. Make sure the Red Hat packages are updated to the Z11 stream during the major Nuage update process.
Note: Nuage 6.0.17 release is supported with RHEL 7.9. Make sure the Red Hat packages are updated to the Z16 stream during the major Nuage update process.

It is assumed the operator is familiar with Red Hat OpenStack Platform Director (OSPD) updates, VSP installation, the distribution-specific installation and update practices, and the specific requirements for operations in a production environment.


Upgrade Paths
-------------

In this release, you can upgrade VRS and SR-IOV only from OSP Director 13 (Z7) + 5.4.1 U6 to OSP Director 13 (Z11) + 6.0.7.
AVRS upgrade from 5.4.1 U6 is not supported in this release.

In this release, you can upgrade VRS and SR-IOV only from OSP Director 13 (Z12) + 5.4.1 U17 to OSP Director 13 (Z16) + 6.0.17.

These upgrade paths are not described in this document:

* Upgrade from OpenStack releases before Queens 5.4.1 U6
* Upgrade from VSP releases before Release 5.4.1 U6
* Upgrade from OpenStack releases before Queens 5.4.1 U17
* Upgrade from VSP releases before Release 5.4.1 U17


Basic Configuration
Expand All @@ -38,23 +36,13 @@ Basic Configuration
The basic configuration includes:

* One or more Controller nodes
* One or more Compute nodes (hypervisors) running the VRS and/or SR-IOV nodes running OSP Director 13 (Z7) + 5.4.1 U6


Known Issues
------------

**During the upgrade of OSPD 13 from Z7 to Z11, users will experience the issue described in https://bugzilla.redhat.com/show_bug.cgi?id=1813642.**

**Contact the Red Hat Support team for more information.**

.. Note:: This upgrade assumes the users get the required information on resolving this issue <https://bugzilla.redhat.com/show_bug.cgi?id=1813642>`_ before starting the upgrade process.
* One or more Compute nodes (hypervisors) running the VRS and/or SR-IOV nodes running OSP Director 13 (Z12) + 5.4.1 U17


Before the Upgrade
--------------------

1. Create a single repository containing 6.0.7 Nuage packages. The repository contents may change depending on the roles configured for your deployment.
1. Create a single repository containing 6.0.17 Nuage packages. The repository contents may change depending on the roles configured for your deployment.

::

Expand All @@ -81,22 +69,22 @@ Before the Upgrade
+----------------+----------------------------------------------+-------------------------------------------------------------------------------------------+


2. Make sure the Nuage 6.0.7 repository and Red Hat repositories for OSPD 13 Z11 are enabled on all Overcloud nodes.
2. Make sure the Nuage 6.0.17 repository and Red Hat repositories for OSPD 13 Z16 are enabled on all Overcloud nodes.

3. Run ``yum clean all`` to clean the old yum cache on all your Overcloud modes after enabling the above yum repositories.


Update Workflow
---------------

1. Update container image source and Undercloud to OSP Director 13 Z11 by following Chapters 1, 2 and 3 from https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/keeping_red_hat_openstack_platform_updated/index
1. Update container image source and Undercloud to OSP Director 13 Z16 by following Chapters 1, 2 and 3 from https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/keeping_red_hat_openstack_platform_updated/index

.. Note:: Refer to the releaes notes for more information on the container images and packages on the Undercloud that are qualified in Nuage testing.


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 6.0.7 nuage-ospdirector/nuage-tripleoheat-templates, back up the existing files and then replace them with the new 6.0.7 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 6.0.17 nuage-ospdirector/nuage-tripleoheat-templates, back up the existing files and then replace them with the new 6.0.17 codebase.

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

Expand All @@ -108,7 +96,7 @@ Update Workflow
b. Get the tar files for the update one of these ways:

* Download them from https://github.com/nuagenetworks/nuage-ospdirector/releases
* Use ``git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b <release>``. For example, enter ``git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b 13.607.1``.
* Use ``git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b <release>``. For example, enter ``git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b 13.6017.1``.


c. Copy the nuage-tripleo-heat-templates folder from /home/stack/nuage-ospdirector-osp-13.<release>/nuage-tripleo-heat-templates to /home/stack/ directory on undercloud.
Expand Down Expand Up @@ -153,13 +141,13 @@ Update Workflow

a. Get the environment values from the /home/stack/nuage-ospdirector-bk directory and update all the templates and environment files for the deployment, such as neutron-nuage/nova-nuage.

b. Make sure the resource_registry section of neutron-nuage-config.yaml contains the following line, which are required for 6.0.7:
b. Make sure the resource_registry section of neutron-nuage-config.yaml contains the following line, which are required for 6.0.17:

::

OS::TripleO::Services::NeutronCorePlugin: ../docker/services/neutron-plugin-ml2-nuage.yaml

c. Make sure `parameter_defaults` section in neutron-nuage-config.yaml contains following configurations, which are required for 6.0.7:
c. Make sure `parameter_defaults` section in neutron-nuage-config.yaml contains following configurations, which are required for 6.0.17:

::

Expand All @@ -174,7 +162,7 @@ Update Workflow
PLUGIN/enable_ingress_replication:
value: false

d. Make sure the resource_registry section of nova-nuage-config.yaml contains the following line, which are required for 6.0.7:
d. Make sure the resource_registry section of nova-nuage-config.yaml contains the following line, which are required for 6.0.17:

::

Expand All @@ -189,11 +177,11 @@ Update Workflow
6. To update the Overcloud deployment, follow these instructions: https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/keeping_red_hat_openstack_platform_updated/assembly-updating_the_overcloud


7. Once the overcloud update is complete, enable the Nuage 6.0.7 repository on the Undercloud and update nuage-topology-collector using:
7. Once the overcloud update is complete, enable the Nuage 6.0.17 repository on the Undercloud and update nuage-topology-collector using:

::

$ sudo yum update nuage-topology-collector -y


8. Run the image patching on Z11 (rhel-7.7) overcloud-full image using the latest Nuage packages to update the Overcloud images in glance. Follow the instructions in Phase 4.3: Modify the Overcloud Image from `6.0/README.rst <../../README.rst>`_
8. Run the image patching on Z17 (rhel-7.9) overcloud-full image using the latest Nuage packages to update the Overcloud images in glance. Follow the instructions in Phase 4.3: Modify the Overcloud Image from `6.0/README.rst <../../README.rst>`_
24 changes: 12 additions & 12 deletions Documentation/6.0/Upgrade/README.rst
View file
Original file line number Diff line number Diff line change
@@ -1,31 +1,31 @@
.. Don't use default python highlighting for code blocks http://www.sphinx-doc.org/en/stable/markup/code.html
===================================
Minor Update to Release 6.0.7
Minor Update to Release 6.0.17
===================================

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


Use this documentation when updating between nuage minor releases. The process applies to updates from Release 6.0.5 to Release 6.0.7. During this process, the Nuage components are updated to 6.0.7.
Use this documentation when updating between nuage minor releases. The process applies to updates from Release 6.0.7 to Release 6.0.17. During this process, the Nuage components are updated to 6.0.17.

Note: Nuage 6.0.7 release is supported with RHEL 7.7. Please make sure Red Hat packages are not updated to newer versions during the Nuage minor update process.
Note: Nuage 6.0.17 release is supported with RHEL 7.9. Please make sure Red Hat packages are not updated to newer versions during the Nuage minor update process.

It is assumed the operator is familiar with Red Hat OpenStack Platform Director updates, VSP installation, the distribution-specific installation and update practices, and the specific requirements for operations in a production environment.


Update Paths
-------------

In this release, you can update only from OSP Director 13 + 6.0.5 to OSP Director 13 + 6.0.7.
In this release, you can update only from OSP Director 13 + 6.0.7 to OSP Director 13 + 6.0.17.


These update paths are not described in this document:

* Update from OpenStack releases before Queens 6.0.5
* Update from VSP releases before Release 6.0.5
* Update from OpenStack releases before Queens 6.0.7
* Update from VSP releases before Release 6.0.7


Basic Configuration
Expand All @@ -34,7 +34,7 @@ Basic Configuration
The basic configuration includes:

* One or more Controller node(s)
* One or more Compute nodes (hypervisors) running the VRS, SR-IOV, AVRS or OVRS nodes running Release 6.0.5
* One or more Compute nodes (hypervisors) running the VRS, SR-IOV, AVRS nodes running Release 6.0.7



Expand All @@ -43,7 +43,7 @@ Before the Update

1. If you are updating an AVRS node, migrate all your VMs on the node to an AVRS Compute node that is not being updated. Perform the steps in the "Live Migrate a Virtual Machine" section in https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/director_installation_and_usage/migrating-virtual-machines-between-compute-nodes-osp#live-migrate-a-vm-osp

2. Create a single repository containing 6.0.7 Nuage packages. Enable this repository on all overcloud nodes. The repository contents may change depending on the roles configured for your deployment.
2. Create a single repository containing 6.0.17 Nuage packages. Enable this repository on all overcloud nodes. The repository contents may change depending on the roles configured for your deployment.

::

Expand Down Expand Up @@ -115,7 +115,7 @@ Before the Update
3. For this update, there are a couple of new dependency packages that need to be installed on Avrs nodes. Please make sure Avrs nodes have access to the "rhel-7-server-rpms" repo. The state of all the Red Hat repos should be disabled and during update Nuage will enable "rhel-7-server-rpms" for installing new dependency packages.


4. Please make sure only nuage 6.0.7 repo is enabled and all other repos are disabled on all overcloud nodes for this update.
4. Please make sure only nuage 6.0.17 repo is enabled and all other repos are disabled on all overcloud nodes for this update.

.. Note:: During our update testing, where overcloud nodes are subscribed to Red Hat Subscription since fresh deployment i.e using `openstack overcloud deploy` command, we had to set `rhel_reg_force: false` inside `environment-rhel-registration.yaml`. This way the repolist on overcloud nodes that is done in step-3 won't be changed during update.

Expand All @@ -129,7 +129,7 @@ Update Workflow

1. 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. To get new the Nuage 6.0.7 nuage-ospdirector/nuage-tripleoheat-templates, back up the files before replacing the existing ones with new 6.0.7 codebase.
In the following example, all the templates and environment files for your deployment are in the /home/stack/nuage-ospdirector directory. To get new the Nuage 6.0.17 nuage-ospdirector/nuage-tripleoheat-templates, back up the files before replacing the existing ones with new 6.0.17 codebase.

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

Expand All @@ -141,7 +141,7 @@ Update Workflow
b. Get the tar files for the update one of these ways:

* Download them from https://github.com/nuagenetworks/nuage-ospdirector/releases
* Use ``git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b <release>``. For example, enter ``git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b 13.607.1``.
* Use ``git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b <release>``. For example, enter ``git clone https://github.com/nuagenetworks/nuage-ospdirector.git -b 13.6017.1``.


c. Copy the nuage-tripleo-heat-templates folder from /home/stack/nuage-ospdirector-osp-13.<release>/nuage-tripleo-heat-templates to /home/stack/ directory on undercloud.
Expand Down Expand Up @@ -208,7 +208,7 @@ Update Workflow
5. To update the Overcloud deployment, follow these instructions: https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/13/html/keeping_red_hat_openstack_platform_updated/assembly-updating_the_overcloud


6. Once the overcloud update is complete, enable nuage 6.0.7 repo on undercloud and update nuage-topology-collector using:
6. Once the overcloud update is complete, enable nuage 6.0.17 repo on undercloud and update nuage-topology-collector using:

::

Expand Down

0 comments on commit d86ce42

Please sign in to comment.