Bug 484689

Summary: No generic Satellite troubleshooting in the Satellite reference guide
Product: Red Hat Satellite 5 Reporter: Kyle Gonzales <kgonzale>
Component: Docs Installation GuideAssignee: Lana Brindley <lbrindle>
Status: CLOSED CURRENTRELEASE QA Contact: Pavel Novotny <pnovotny>
Severity: medium Docs Contact:
Priority: low    
Version: 520CC: cperry, lbrindle, mhideo, pnovotny, vtsuryawanshi
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-06-16 22:22:03 UTC Type: ---
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: 644720    
Bug Blocks: 677505    

Description Kyle Gonzales 2009-02-09 15:15:16 UTC
The Satellite reference guide has no generic Satellite troubleshooting section.  There are troubleshooting sections for rhnsd and rhnmd, but not for the Satellite itself.

The Satellite installation guide has a troubleshooting section, but I am not sure how many people end up looking at that after they install Satellite or have their Satellite installed by GPS.

I would recommend adding a troubleshooting section to the Reference Guide, covering some of the top support questions regarding a running Satellite.  I would additionally recommend that the section refer customers to kbase.redhat.com for additional solutions that they could search for.

Comment 1 Clifford Perry 2009-02-10 18:35:49 UTC
With 530 we are going to rename the Satellite Install Guide to just Satellite Guide, since it has content for Installing, Configuration, Administration and Troubleshooting of the Satellite. 

this feedback is ideal for the Satellite Guide Troubleshooting section to make note that we do have kbase. Looking at

http://www.redhat.com/docs/manuals/satellite/Red_Hat_Network_Satellite-5.2.0/html/Installation_Guide/s1-satellite-debug.html

I suspect we should say try searching our knowledgebase for further ideas and/or open a Support request if needed. 


Cliff

Comment 5 Lana Brindley 2010-10-08 04:13:18 UTC
This is slated for inclusion in the Satellite 5.5 documentation. If there is
any other source content that is not listed (or linked to) in this bug, please
link to it.

LKB

Comment 6 Lana Brindley 2010-11-16 21:12:42 UTC
Added to content specification for 5.4.1.

LKB

Comment 7 Lana Brindley 2011-01-31 02:40:44 UTC
Please provide direct links to content for inclusion in this section.

LKB

Comment 8 Kyle Gonzales 2011-01-31 18:37:40 UTC
https://access.redhat.com/knowledge/searchResults?col=redhat_kbase&topSearchForm=topSearchForm&language=en&quickSearch=satellite&searchButton.x=0&searchButton.y=0&searchButton=Search

Seriously, we need to distill this information out of the KBase, and into a Troubleshooting guide.

If you are looking for further information, I would tap the System Management SME group: sme-sysmgt.

Comment 9 Lana Brindley 2011-02-07 00:13:49 UTC
I've converted the Troubleshooting chapter in the Installation Guide to a Q&A set, and added the following Kbase articles:
https://access.redhat.com/kb/docs/DOC-34411
https://access.redhat.com/kb/docs/DOC-34410
https://access.redhat.com/kb/docs/DOC-36704
https://access.redhat.com/kb/docs/DOC-34653
https://access.redhat.com/kb/docs/DOC-34421
https://access.redhat.com/kb/docs/DOC-34496

Some reorganising of the information in this chapter is probably still required. Also, I'm sure that there are many more kbase articles that could be included. If you find any specific articles that you would like included, please raise a new bug.

LKB

Comment 10 Lana Brindley 2011-02-07 21:30:47 UTC
Reorganised in revision 1-33. Comments welcome.

LKB

Comment 11 Pavel Novotny 2011-04-21 12:20:13 UTC
Taking this bug for verification.

Comment 12 Pavel Novotny 2011-04-21 17:22:17 UTC
(In reply to comment #9)
> I've converted the Troubleshooting chapter in the Installation Guide to a Q&A
> set, and added the following Kbase articles:
> https://access.redhat.com/kb/docs/DOC-34411
> https://access.redhat.com/kb/docs/DOC-34410
> https://access.redhat.com/kb/docs/DOC-36704
> https://access.redhat.com/kb/docs/DOC-34653
> https://access.redhat.com/kb/docs/DOC-34421
> https://access.redhat.com/kb/docs/DOC-34496
> 

Verified
in Satellite 5.4.1 "Installation Guide", section "7. Troubleshooting".

Comment 13 Lana Brindley 2011-05-06 00:09:41 UTC
This book has now been dropped to translation (RT#75265).
No further updates can be accepted. Please raise a new bug for any changes.
LKB

Comment 14 Lana Brindley 2011-06-16 22:22:03 UTC
5.4.1 Satellite books are now available on docs.redhat.com. Please raise a new bug for any issues.

LKB