Bug 1930274 - Make necessary edits in the Framework for Upgrades guide, to reflect container-tools module changes
Summary: Make necessary edits in the Framework for Upgrades guide, to reflect containe...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 16.1 (Train)
Hardware: x86_64
OS: Linux
unspecified
medium
Target Milestone: z4
: ---
Assignee: Vlada Grosu
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-02-18 16:04 UTC by Vlada Grosu
Modified: 2021-03-18 16:02 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: If docs needed, set a value
Doc Text:
Clone Of:
Environment:
Last Closed: 2021-03-18 16:02:49 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Comment 2 Vlada Grosu 2021-02-19 14:15:46 UTC
Hi Jesse,

I am not sure how BZ#1866479 affects the FFU process, particularly what happens when we creating an upgrades environment file (that enables the container-tools module) when we're configuring the overcloud for a Leapp upgrade. 

What documentation changes must be made to reflect the work that's been done in BZ#1866479?

Many thanks,
Vlada

Comment 3 Jesse Pretorius 2021-02-25 15:52:08 UTC
https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.1/html-single/framework_for_upgrades_13_to_16.1/index?lb_target=production#enabling-repositories-for-the-undercloud stays the same, but https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.1/html-single/framework_for_upgrades_13_to_16.1/index?lb_target=production#creating-an-upgrades-environment-file-overcloud-leapp will need changing to remove:

    sudo dnf module disable -y container-tools:rhel8
    sudo dnf module enable -y container-tools:2.0
    sudo dnf module disable -y virt:rhel
    sudo dnf module enable -y virt:8.2

and due to https://bugzilla.redhat.com/show_bug.cgi?id=1923887 we'll need to add:

parameter_defaults:
  ...
  DnfStreams: [{'module':'container-tools', 'stream':'2.0'}]

I need to verify whether this works, but we should also be adding something like this as a workaround to cover the virt module too:

parameter_defaults:
  UpgradeInitCommand: |
    {% if 'Compute' in group_names or 'Controller' in group_names %}
    sudo dnf module disable -y virt:rhel
    sudo dnf module enable -y virt:8.2
    {% endif %}

So the whole file should look like this:

parameter_defaults:
  # Begin workaround for BZ1923887
  DnfStreams: [{'module':'container-tools', 'stream':'2.0'}]
  UpgradeInitCommand: |
    {% if 'Compute' in group_names or 'Controller' in group_names %}
    sudo dnf module disable -y virt:rhel
    sudo dnf module enable -y virt:8.2
    {% endif %}
  # End workaround for BZ1923887
  UpgradeLeappCommandOptions: "--enablerepo rhel-8-for-x86_64-baseos-eus-rpms --enablerepo rhel-8-for-x86_64-appstream-eus-rpms --enablerepo fast-datapath-for-rhel-8-x86_64-rpms"


I will endeavour to test whether this works ASAP.

Comment 4 Jesse Pretorius 2021-02-25 19:03:29 UTC
I can confirm that the above method works. The comments 'workaround for...' can be removed so that the final result is:

parameter_defaults:
  DnfStreams: [{'module':'container-tools', 'stream':'2.0'}]
  UpgradeInitCommand: |
    {% if 'Compute' in group_names or 'Controller' in group_names %}
    sudo dnf module disable -y virt:rhel
    sudo dnf module enable -y virt:8.2
    {% endif %}
  UpgradeLeappCommandOptions: "--enablerepo rhel-8-for-x86_64-baseos-eus-rpms --enablerepo rhel-8-for-x86_64-appstream-eus-rpms --enablerepo fast-datapath-for-rhel-8-x86_64-rpms"

Once z5 releases with the fix for BZ1923887 then this file will reduce to:

parameter_defaults:
  UpgradeLeappCommandOptions: "--enablerepo rhel-8-for-x86_64-baseos-eus-rpms --enablerepo rhel-8-for-x86_64-appstream-eus-rpms --enablerepo fast-datapath-for-rhel-8-x86_64-rpms"

Comment 8 Vlada Grosu 2021-03-18 13:12:35 UTC
Reopening this to address https://bugzilla.redhat.com/show_bug.cgi?id=1923887#c8


Note You need to log in before you can comment on or make changes to this bug.