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 1332972 - Installation manaul Chapter 1 What Sat Server and Capule Server do raises questions instead of giving answers
Summary: Installation manaul Chapter 1 What Sat Server and Capule Server do raises que...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Documentation
Version: 6.2.0
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: Unspecified
Assignee: Peter Ondrejka
QA Contact: Allison Heslin
URL:
Whiteboard:
Depends On:
Blocks: 1122832
TreeView+ depends on / blocked
 
Reported: 2016-05-04 12:52 UTC by Peter Vreman
Modified: 2019-09-25 20:33 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2016-08-14 23:08:18 UTC
Target Upstream Version:
Embargoed:

Attachments (Terms of Use)

Description Peter Vreman 2016-05-04 12:52:53 UTC 
Document URL: https://access.redhat.com/documentation/en/red-hat-satellite/6.2-beta/installation-guide/chapter-1-what-satellite-server-and-capsule-server-do

Section Number and Name: Chapter 1

Describe the issue: 
The text on the capsule is asking for more questions than it solves. Using capsule is predicted 'solve all problems' with texts like 'Capsule Servers decrease the load on the central server, increase redundancy, and reduce bandwidth usage.'.

- What this means on the installation and the preparation the user is left alone without any clue.
- The redundancy is not incorrect word as it does not provide failover to multiple capsules from a client. Also the capsule does not provide the same functiionaly as the Satellite Server with, e.g. the UI and having more capsules.


Suggestions for improvement: 
- Please describe deployment scenarios
- Please describe correct what a capsule is and how it interacts with the Sat6
-- What does it provide on 'redundancy'
-- What does it provide on isolation
-- What does it provide on load decrease on central server
-- What does it provide on low-bandwidth usage
- Alternative is to refer to a separate document that contains more details.

Additional information:
Comment 1 Peter Vreman 2016-05-04 15:48:06 UTC 
This is a regression over Sat6.1 that has a good introduction:

https://access.redhat.com/documentation/en-US/Red_Hat_Satellite/6.1/html-single/Installation_Guide/index.html#chap-Red_Hat_Satellite-Installation_Guide-Introduction_to_Red_Hat_Satellite
Comment 2 Andrew Dahms 2016-05-05 13:58:00 UTC 
Assigning to Ali for review.
Comment 3 Allison Heslin 2016-05-26 17:56:15 UTC 
Copying and pasting the comment from bz1332911 because I think it's better addressed as part of this bug:

...it is unclear what is 'Satellite Server' and 'Capsule Server'. Does 'Satellite Server' include an internal Capsule or not?
E.g. Do i need to run both 'foreman-installer --scenario=katello' and 'foreman-installer --scenario=capsule' on a single server?

Recommend is have have scenarios base on different deployment architectures:
- satellite-server-without-capsule
- satellite-server-with-capsule
- capsule-server
Comment 4 Andrew Dahms 2016-06-14 12:37:48 UTC 
Re-assigning to Peter for review.

Peter is working on content for a planned Architecture Guide where this content would be a more natural fit.
Comment 6 Andrew Dahms 2016-08-14 23:08:18 UTC 
This content is live on the Customer Portal.

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