Bug 484689 - No generic Satellite troubleshooting in the Satellite reference guide
Summary: No generic Satellite troubleshooting in the Satellite reference guide
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite 5
Classification: Red Hat
Component: Docs Installation Guide
Version: 520
Hardware: All
OS: Linux
low
medium
Target Milestone: ---
Assignee: Lana Brindley
QA Contact: Pavel Novotny
URL:
Whiteboard:
Depends On: 644720
Blocks: sat541-docs
TreeView+ depends on / blocked
 
Reported: 2009-02-09 15:15 UTC by Kyle Gonzales
Modified: 2013-10-23 23:12 UTC (History)
5 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-06-16 22:22:03 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

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


Note You need to log in before you can comment on or make changes to this bug.