Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 2304140

Summary: [doc] overcloud-minimal image documentation is missing kernel and ramdisk
Product: Red Hat OpenStack Reporter: John Fulton <johfulto>
Component: documentationAssignee: Erin Peterson <erpeters>
Status: CLOSED CURRENTRELEASE QA Contact: RHOS Documentation Team <rhos-docs>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 17.1 (Wallaby)CC: erpeters, jelle.hoylaerts.ext, mariel
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2024-08-14 19:13:16 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description John Fulton 2024-08-12 14:02:24 UTC 
"7.2.13. Using the overcloud-minimal image to avoid using a Red Hat subscription entitlement" [1] is missing the configuration to set the kernel and ramdisk and thus customers who follow the procedure will encounter symptoms of BZ 2299694

Step 2 of the procedure has two examples which need to be updated. I will paste the suggested corrected copy below.

Specific Nodes:
"""
- name: Ceph
  count: 3
  instances:
  - hostname: overcloud-ceph-0
    name: node00
    image:
      href: 'file:///var/lib/ironic/images/overcloud-minimal.raw'
      kernel: 'file:///var/lib/ironic/images/overcloud-minimal.vmlinuz'
      ramdisk: 'file:///var/lib/ironic/images/overcloud-minimal.initrd'
  - hostname: overcloud-ceph-1
    name: node01
    image:
      href: file:///var/lib/ironic/images/overcloud-full-custom.qcow2
  - hostname: overcloud-ceph-2
    name: node02
    image:
      href: file:///var/lib/ironic/images/overcloud-full-custom.qcow2
"""

All nodes for a role
"""
- name: Ceph
  count: 3
  defaults:
    image:
      href: 'file:///var/lib/ironic/images/overcloud-minimal.raw'
      kernel: 'file:///var/lib/ironic/images/overcloud-minimal.vmlinuz'
      ramdisk: 'file:///var/lib/ironic/images/overcloud-minimal.initrd'
  instances:
  - hostname: overcloud-ceph-0
    name: node00
  - hostname: overcloud-ceph-1
    name: node01
  - hostname: overcloud-ceph-2
    name: node02
"""


[1] https://docs.redhat.com/en/documentation/red_hat_openstack_platform/17.1/html-single/installing_and_managing_red_hat_openstack_platform_with_director/index#proc_using-the-overcloud-minimal-image-to-avoid-using-a-red-hat-subscription-entitlement_ironic_provisioning
Comment 1 John Fulton 2024-08-12 14:11:34 UTC 
The procedure should also have a prerequisite to ensure that the minimal image's kernel and ramdisk have been uploaded like this.


"""
When using the overcloud-minimal image, the image and its kernel and ramdisk should be stored in /var/lib/ironic/images/ on the undercloud. To upload these files, use a command like the following.

(undercloud) [stack@undercloud ~]$ openstack overcloud image upload --image-path ./images/ --os-image-name overcloud-minimal.qcow2 --update-existing --image-type os
Image "file:///var/lib/ironic/images/overcloud-minimal.vmlinuz" was copied.
+---------------------------------------------------------+-------------------+----------+
|                           Path                          |        Name       |   Size   |
+---------------------------------------------------------+-------------------+----------+
| file:///var/lib/ironic/images/overcloud-minimal.vmlinuz | overcloud-minimal | 12190232 |
+---------------------------------------------------------+-------------------+----------+
Image "file:///var/lib/ironic/images/overcloud-minimal.initrd" was copied.
+--------------------------------------------------------+-------------------+----------+
|                          Path                          |        Name       |   Size   |
+--------------------------------------------------------+-------------------+----------+
| file:///var/lib/ironic/images/overcloud-minimal.initrd | overcloud-minimal | 82284184 |
+--------------------------------------------------------+-------------------+----------+
Image "file:///var/lib/ironic/images/overcloud-minimal.raw" was copied.
+-----------------------------------------------------+-------------------+------------+
|                         Path                        |        Name       |    Size    |
+-----------------------------------------------------+-------------------+------------+
| file:///var/lib/ironic/images/overcloud-minimal.raw | overcloud-minimal | 3242131456 |
+-----------------------------------------------------+-------------------+------------+
"""
Comment 2 Erin Peterson 2024-08-14 19:13:16 UTC 
Documentation updated as noted and republished:

https://docs.redhat.com/en/documentation/red_hat_openstack_platform/17.1/html/installing_and_managing_red_hat_openstack_platform_with_director/assembly_provisioning-and-deploying-your-overcloud#proc_using-the-overcloud-minimal-image-to-avoid-using-a-red-hat-subscription-entitlement_ironic_provisioning