--- title: QA:Testcase Debranding author: Trevor Cooper revision_date: 2022-05-18 rc: prod: Rocky Linux ver: 8 level: Final --- !!! info "Associated release criterion" This test case is associated with the [Release_Criteria - Debranding](9_release_criteria.md#debranding) release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. ## Description The Rocky Linux [Release Engineering Team](/team/release_engineering/) builds and maintains tools to manage the debranding of packages received from the upstream vendor. They have published a comprehensive [debranding guide](/team/release_engineering/debranding/) and maintain a [list of packages](https://git.rockylinux.org/rocky/metadata/-/blob/main/patch.yml) requiring debranding patches. This testcase will verify that all packages available on released media that Rocky Linux Release Engineering has identified as requiring debranding are debranded successfully per their specification. ## Setup 1. Obtain access to an environment with the `dnf`, and `koji` commands and access to [Rocky Linux Gitlab](https://git.rockylinux.org) and [Rocky Linux Koji](https://koji.rockylinux.org) 2. Download the ISO to be tested to test machine. 3. Configure `/etc/koji.conf` to access the [Rocky Linux Koji](https://koji.rockylinux.org). 4. Download a recent copy the [patch.yml](https://git.rockylinux.org/rocky/metadata/-/blob/main/patch.yml) from [Rocky Linux Gitlab](https://git.rockylinux.org). !!! info "patch.yml" Packages listed in `patch.yml` are names of source RPMs. Binary RPMs containing content produced by building the patched source RPMs need to be validated. The easiest way to get the list of all possible binary RPMs for a particular package and arch is to ask obtain that information in koji. ## How to test 1. Mount the ISO to be tested locally. - Example: ``` $ mount -o loop Rocky-8.5-x86_64-dvd1.iso /media ``` 2. Determine the path(s) to the `repodata` directory(ies) on the ISO. - Example: ``` $ find /media -name repodata ``` 3. For each package to be validated get the names of the `noarch` and `` specific packages created from it. - Example: ``` $ koji --quiet latest-build --arch=x86_64 dist-rocky8-compose $ koji --quiet latest-build --arch=noarch dist-rocky8-compose ``` 4. Use `dnf` to obtain the paths to the binary packages requiring debranding. - Example: ``` $ dnf download --urls --repofrompath BaseOS,/media/BaseOS --repo BaseOS \ --repofrompath Minimal,/media/Minimal --repo Minimal \ ``` 5. Copy the `` from the media and examine it's metadata and/or contents to determine if it has obviously been patched. - Example: ``` $ rpm -q --changelog -p | head | \ grep "Release Engineering " -C2 | \ grep -Eq "" $ rpm2cpio | cpio --quiet --extract --to-stdout . | \ grep -Eq "" ``` !!! info "NOTE" Note all debranding patches will patch files directly and leave very obvious traces, some patches don't even add changelog messages to use as an indicator that the package has been patched or debranded. Sometimes the only solution is to extract the binary package and examine the contents directly to find something to test. 6. Unmount the ISO. - Example: ``` $ umount /media ``` ## Expected Results 1. Packages tracked by Release Engineering as requiring debranding and published on installation media are, in fact, debranded per their specification.

Sample Output

=== "Success" ``` $ sudo mount -o loop Rocky-8.5-aarch64-minimal.iso /media mount: /media: WARNING: device write-protected, mounted read-only. $ find /media -name repodata /media/BaseOS/repodata /media/Minimal/repodata $ curl -LOR https://git.rockylinux.org/rocky/metadata/-/raw/main/patch.yml % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 3410 100 3410 0 0 20419 0 --:--:-- --:--:-- --:--:-- 20419 $ yq .debrand.all[] patch.yml | column -x -c 100 -o " " abrt anaconda anaconda-user-help chrony cloud-init cockpit crash dhcp dnf firefox fwupd gcc gcc-toolset-9-gcc gcc-toolset-10-gcc gcc-toolset-11-gcc gcc-toolset-12-gcc gnome-settings-daemon grub2 httpd initial-setup kernel kernel-rt libdnf libreoffice libreport nginx opa-ff opa-fm openscap pesign PackageKit python-pip python3 redhat-rpm-config scap-security-guide shim shim-unsigned-x64 shim-unsigned-aarch64 sos subscription-manager systemd thunderbird WALinuxAgent $ ./yq .debrand.r8[] patch.yml | column -x -c 100 -o " " dotnet3.0 fwupdate gnome-boxes libguestfs pcs plymouth python2 NOTE: Only a single package will be shown in this Example. $ koji --quiet latest-build --arch=x86_64 dist-rocky8-compose sos $ koji --quiet latest-build --arch=noarch dist-rocky8-compose sos sos-4.1-9.el8_5.rocky.3.noarch sos-audit-4.1-9.el8_5.rocky.3.noarch $ dnf download --urls --repofrompath BaseOS,/media/BaseOS --repo BaseOS \ --repofrompath Minimal,/media/Minimal --repo Minimal \ sos sos-audit | grep -E "^file" file:///media/BaseOS/Packages/s/sos-4.1-5.el8.noarch.rpm file:///media/BaseOS/Packages/s/sos-audit-4.1-5.el8.noarch.rpm $ rpm -q --changelog -p /media/BaseOS/Packages/s/sos-4.1-5.el8.noarch.rpm | \ head | grep "Release Engineering " -C2 * Mon Oct 18 2021 Release Engineering - 4.1-5 - Remove Red Hat branding from sos $ echo $? 0 $ rpm -q --changelog -p /media/BaseOS/Packages/s/sos-audit-4.1-5.el8.noarch.rpm | \ head | grep "Release Engineering " -C2 * Mon Oct 18 2021 Release Engineering - 4.1-5 - Remove Red Hat branding from sos $ echo $? 0 $ umount /media ``` === "Failure" ``` $ sudo mount -o loop Rocky-8.5-aarch64-minimal.iso /media mount: /media: WARNING: device write-protected, mounted read-only. $ find /media -name repodata /media/BaseOS/repodata /media/Minimal/repodata $ curl -LOR https://git.rockylinux.org/rocky/metadata/-/raw/main/patch.yml % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 3410 100 3410 0 0 20419 0 --:--:-- --:--:-- --:--:-- 20419 $ yq .debrand.all[] patch.yml | column -x -c 100 -o " " abrt anaconda anaconda-user-help chrony cloud-init cockpit crash dhcp dnf firefox fwupd gcc gcc-toolset-9-gcc gcc-toolset-10-gcc gcc-toolset-11-gcc gcc-toolset-12-gcc gnome-settings-daemon grub2 httpd initial-setup kernel kernel-rt libdnf libreoffice libreport nginx opa-ff opa-fm openscap pesign PackageKit python-pip python3 redhat-rpm-config scap-security-guide shim shim-unsigned-x64 shim-unsigned-aarch64 sos subscription-manager systemd thunderbird WALinuxAgent $ ./yq .debrand.r8[] patch.yml | column -x -c 100 -o " " dotnet3.0 fwupdate gnome-boxes libguestfs pcs plymouth python2 NOTE: Only a single package will be shown in this Example. $ koji --quiet latest-build --arch=x86_64 dist-rocky8-compose sos $ koji --quiet latest-build --arch=noarch dist-rocky8-compose sos sos-4.1-9.el8_5.rocky.3.noarch sos-audit-4.1-9.el8_5.rocky.3.noarch $ dnf download --urls --repofrompath BaseOS,/media/BaseOS --repo BaseOS \ --repofrompath Minimal,/media/Minimal --repo Minimal \ sos sos-audit | grep -E "^file" file:///media/BaseOS/Packages/s/sos-4.1-5.el8.noarch.rpm file:///media/BaseOS/Packages/s/sos-audit-4.1-5.el8.noarch.rpm $ rpm -q --changelog -p /media/BaseOS/Packages/s/sos-4.1-5.el8.noarch.rpm | \ head | grep "Release Engineering " -C2 $ echo $? 1 $ rpm -q --changelog -p /media/BaseOS/Packages/s/sos-audit-4.1-5.el8.noarch.rpm | \ head | grep "Release Engineering " -C2 $ echo $? 1 $ umount /media ``` {% include 'qa_testcase_bottom.md' %}