Red Hat Satellite engineering is moving the tracking of its product development work on Satellite to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "Satellite project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs will be migrated starting at the end of May. If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "Satellite project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/SAT-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.
Bug 1188133 - [RFE] Add best practices, workflow-like documentation
Summary: [RFE] Add best practices, workflow-like documentation
Keywords:
Status: CLOSED NOTABUG
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Documentation
Version: 6.0.7
Hardware: Unspecified
OS: Unspecified
medium
high
Target Milestone: Unspecified
Assignee: Athene Chan
QA Contact: David O'Brien
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2015-02-02 07:01 UTC by Fred van Zwieten
Modified: 2015-05-11 22:10 UTC (History)
4 users (show)

Fixed In Version:
Doc Type: Enhancement
Doc Text:
Clone Of:
Environment:
Last Closed: 2015-02-06 06:20:14 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Bugzilla 1173386 0 medium CLOSED [doc] Sat 6 Provisioning Guide: diagram of objects and relationships/dependency involved in provisioning 2021-10-15 19:13:42 UTC

Internal Links: 1173386

Description Fred van Zwieten 2015-02-02 07:01:03 UTC
Description of problem:
What I miss in the documentation is more sections on how to best use the different components together. I experience users (sys admins) often get lost because of the sheer amount of concepts that are brought together in this product. What are the best practices. Describe sample use cases (For example: DEV-QA-PROD). Write out how all different aspect interlock and work together. When to best use compiste content views? When not? How to model your host groups, host collections, etc, in combination with you activation keys, conent views, life cycle envrionment? I see a lot of mistakes happen when using Satellite 6 for the first time. Some call this "best practices", other call this "work flows" and some call is "patterns". You could even think about setting it up as a "cook book". Describe, for example, an imaginary IT shop, with a typical DEV-QA-PROD staging setup or some variation on that, and multiple business apps that need to be managed. Add a mixtures of external third party yum repo's and internal dev shops, some of who deliver RPM's and Puppet modules, some don't. Then describe how to set this all up in Satellite. 

Version-Release number of selected component (if applicable):


How reproducible:
Give a sysadmin Satellite (without any prior knowledge of the product), let him first read the docs, and then let him use it. Observe what happens.

Steps to Reproduce:
1.
2.
3.

Actual results:
Much trail and error happening 

Expected results:
Get it set up correctly in one go

Additional info:


Document URL: 

Section Number and Name: 

Describe the issue: 

Suggestions for improvement: 

Additional information:

Comment 2 RHEL Program Management 2015-02-02 07:13:39 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.


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