Bug 1379957

Summary:	[RFE] [6.3] Documentation Changes required for Discovery7.0 which is planned for satellite6.3 release
Product:	Red Hat Satellite	Reporter:	Sachin Ghai <sghai>
Component:	Docs Upgrading and Updating Red Hat Satellite	Assignee:	csherrar
Status:	CLOSED NEXTRELEASE	QA Contact:	Stephen Wadeley <swadeley>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	6.3.0	CC:	adahms, lzap, sghai, swadeley
Target Milestone:	Unspecified	Keywords:	FutureFeature
Target Release:	Unused
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Enhancement
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2017-10-19 23:28:34 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:
Bug Depends On:
Bug Blocks:	1454572, 1486095

Description Sachin Ghai 2016-09-28 08:54:05 UTC

Document URL: 
https://access.redhat.com/documentation/en/red-hat-satellite/6.2/single/installation-guide#upgrading_satellite_server

Please make a change where we are updating "PXELinux global default" template for discovery.

 
Step24. 1. user needs to first unlock the "PXELinux Global default" template to change the 'local' to 'discovery' under 'ONTIMEOUT' option.

2. Now new "pxelinux_discovery" scriptlet has been added in discovery7.0, that includes the discovery stanza. This needs to be updated with two things

1. update image locations. 
Currently it uses "KERNEL /boot/fdi-image/vmlinuz0". However it should be like: "KERNEL /boot/fdi-image-rhel_7-vmlinuz"

Similarly for "APPEND initrd=boot/fdi-image-rhel_7-img"

2. proxy.url=<%= foreman_server_url %> This needs to be updated with port no 9090 if proxy.type=proxy 

like: proxy.url=<%= foreman_server_url %>:9090


I'm not sure if we have any variable for capsule like "capsule_server_url" in case user wants to perform discovery via external capsule.

Comment 1 Sachin Ghai 2016-09-28 08:54:57 UTC

I'll update the BZ if more changes are required wrt Discovery7.0

Comment 2 Andrew Dahms 2017-09-26 00:59:35 UTC

Assigning to Clifton for review.

Clifton - the above changes must be applied to Step 23. of the procedure on upgrading Satellite Server, and to the same block in the 'Upgrading Discovery on Capsule Servers' section.

These changes apply to the new 'Upgrade Guide' for Satellite 6.3.

Let's also check with Sachin when the changes go in to make sure they match those expected.

Comment 4 Andrew Dahms 2017-09-26 22:59:58 UTC

Hi Clifton,

Thank you for your needinfo request.

It looks like the majority of changes have been made, but I have one or two questions that can be cleared up by taking a look at the UI and seeking review from Sachin -

1. I don't see any mention of the 'ONTIMEOUT' option in the procedure, but
   perhaps this is already covered in the first step. It would be nice to
   check the UI and see if the current step makes sense, or if anything
   else needs to be called out.

2. The 'KERNEL boot/fdi-image-rhel_7-vmlinuz' line in the documentation does
   not include a leading '/' before 'boot'. We should check with Sachin if
   this is ok.

After we clear these up, we can address any changes and process the bug as usual, or if no changes are required, just close this bug out.

Kind regards,

Andrew

Comment 6 Andrew Dahms 2017-10-03 05:12:02 UTC

Changing component to 'Docs Upgrade Guide' where this content will be targeted.

Comment 25 Andrew Dahms 2017-10-19 23:28:34 UTC

These changes will be published on the Customer Portal with the next release of the Red Hat Satellite 6.3 documentation.

Closing.

Comment 26 Andrew Dahms 2017-12-11 01:54:30 UTC

Updating the target milestone to reflect the time frame in which this work was completed.

Comment 27 Andrew Dahms 2018-01-16 00:15:38 UTC

Updating the doc type.