Bug 1226814

Summary: Extend Bootdisk chapter with Subnet image
Product: Red Hat Satellite Reporter: Lukas Zapletal <lzap>
Component: Docs Provisioning GuideAssignee: Melanie Corr <mcorr>
Status: CLOSED NEXTRELEASE QA Contact: Stephen Wadeley <swadeley>
Severity: medium Docs Contact:
Priority: medium    
Version: 6.1.0CC: adahms, dmacpher, lzap
Target Milestone: Unspecified   
Target Release: Unused   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2018-02-19 17:56:10 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 Lukas Zapletal 2015-06-01 07:59:36 UTC
Hello,

we are adding new type of disk: "subnet" image for 6.1. Please put the additional paragraph in the docs. You will get the final version in the diff of the README file in this pull request:

https://github.com/theforeman/foreman_bootdisk/pull/9

Thanks.

Comment 1 RHEL Program Management 2015-06-01 08:12:30 UTC
Since this issue was entered in Red Hat Bugzilla, the release flag has been
set to ? to ensure that it is properly evaluated for this release.

Comment 3 Lukas Zapletal 2015-06-18 10:25:40 UTC
The text is here:

https://github.com/theforeman/foreman_bootdisk/pull/9/files

Please wait until the feature is merged, it is undergoing review atm.

Comment 4 Hayley Hudgeons 2015-06-24 19:38:26 UTC
(In reply to Lukas Zapletal from comment #3)
> The text is here:
> 
> https://github.com/theforeman/foreman_bootdisk/pull/9/files
> 
> Please wait until the feature is merged, it is undergoing review atm.

Lukas,

Is there a bug I can follow/link for this so that I know when the feature is merged?

Comment 5 Lukas Zapletal 2015-07-24 09:43:31 UTC
Hayley, sorry for huge delay, we are likely hitting the very last compose with this one. Hopefully next week: https://github.com/theforeman/foreman_bootdisk/pull/9

Comment 6 Andrew Dahms 2016-11-15 11:36:06 UTC
While the new Provisioning Guide does mention subnet images briefly, there are still some details that can be added to the documentation via this bug.

Moving back to NEW and the default assignee to be triaged as the schedule allows.

Comment 7 Andrew Dahms 2017-09-20 05:33:54 UTC
Assigning to Julie for review.

Julie - let's use this bug to add some detail to 'Creating New Hosts with PXE-less Provisioning' in the Provisioning Guide.

Namely, the following changes look like they will be required -

* Add the table comparing features to the start of the section with a line 
  calling out what the table is for.

* Move the descriptions of image types to the start of the section underneath 
  the above table, and provide a few more details about each. In particular,
  the description of the subnet image should mention the following details, 
  although not verbatim -

  "Subnet images are similar to generic images, but chain-loading is done via 
   the TFTP Smart Proxy assigned to the Subnet of the host. The smart proxy 
   must have the "Templates" module enabled and configured.

   This image is generic for all hosts with a provisioning NIC on that subnet."

* The location where the descriptions used to be should just tell users that
  they can click the image type to download that image.

* The CLI user commands should be broken into discrete sub-sections, with one
  section for each image type.

* A new sub-section on writing the ISO to a USB stick should be added to
  let users know how to perform this operation if needed.

Comment 8 Julie 2017-09-26 07:01:58 UTC
(In reply to Andrew Dahms from comment #7)
> Assigning to Julie for review.
> 
> Julie - let's use this bug to add some detail to 'Creating New Hosts with
> PXE-less Provisioning' in the Provisioning Guide.
> 
> Namely, the following changes look like they will be required -
> 
> * Add the table comparing features to the start of the section with a line 
>   calling out what the table is for.

Are you referring to the table in 6.1 docs? It has been removed from 6.2 already. 
> * Move the descriptions of image types to the start of the section
> underneath 
6.1?
>   the above table, and provide a few more details about each. In particular,
>   the description of the subnet image should mention the following details, 
>   although not verbatim -
> 
>   "Subnet images are similar to generic images, but chain-loading is done
> via 
>    the TFTP Smart Proxy assigned to the Subnet of the host. The smart proxy 
>    must have the "Templates" module enabled and configured.
> 
>    This image is generic for all hosts with a provisioning NIC on that
> subnet."
> 
> * The location where the descriptions used to be should just tell users that
>   they can click the image type to download that image.
6.1?
> * The CLI user commands should be broken into discrete sub-sections, with one
>   section for each image type.
> * A new sub-section on writing the ISO to a USB stick should be added to
>   let users know how to perform this operation if needed.

Comment 9 Andrew Dahms 2017-09-27 01:08:53 UTC
Hi Julie,

Thank you for your needinfo request.

We talked about this in person as well, but this does indeed refer to the table that is included in both Satellite 6.1, but most importantly, in the docs on GitHub.

Let me know if there is anything else you need!

Kind regards,

Andrew

Comment 17 Andrew Dahms 2017-12-11 00:55:55 UTC
Updating target milestone to 'GA'.

Comment 18 Melanie Corr 2018-02-19 14:05:29 UTC
As we are pushing close to GA, I have reassigned this to myself and QA to swadeley to try and get this finished on time.

Comment 20 Stephen Wadeley 2018-02-19 16:51:39 UTC
Hello, those changes look good to me


Request to merge BZ#1226814 into master
Merged by Stephen Wadeley less than a minute ago

The changes were merged into master. The source branch has been removed. 

Thnak you