Bug 795429 - System registration instructions not valid
Summary: System registration instructions not valid
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Satellite
Classification: Red Hat
Component: Docs User Guide
Version: 6.0.1
Hardware: Unspecified
OS: Unspecified
high
medium
Target Milestone: Unspecified
Assignee: Athene Chan
QA Contact: ecs-bugs
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2012-02-20 14:08 UTC by James Laska
Modified: 2019-09-25 21:04 UTC (History)
9 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Document how to subscribe an image to CFSE: https://fedorahosted.org/katello/wiki/GuideSystemRegistrationClient).
Clone Of:
Environment:
Last Closed: 2012-12-10 21:41:36 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description James Laska 2012-02-20 14:08:50 UTC
Description of problem:

The public docs and the internal documentation differ on the setup required for subscribing an image to katello

Internal - http://documentation-stage.bne.redhat.com/docs/en-US/CloudForms/1.0/html/User_Documentation/sect-User_Documentation-Using_Synchronization-Registering_a_System.html
Community - https://fedorahosted.org/katello/wiki/GuideSystemRegistrationClient

  
Actual results:

 1) The provided subscription instructions do not work for a private katello instance.  I believe they'll register you to hosted (or similar).

Expected results:

 1) a series of instructions that when performed, subscribe a system to katello content
 2) also, I'd expect to see some similar steps as outlined in the community registration page (https://fedorahosted.org/katello/wiki/GuideSystemRegistrationClient)

Additional info:
 * Escalating as a final release blocker for CloudForms

Comment 2 James Laska 2012-03-08 14:30:43 UTC
Note, bug#790835 was fixed and the instructions have been updated to reflect this new procedure (see https://fedorahosted.org/katello/wiki/GuideSystemRegistrationClient).

Lana, let me know if you need more detail.  Someone from System Engine may be needed to document this feature.

Comment 8 Lana Brindley 2012-03-11 23:11:45 UTC
    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
Document how to subscribe an image to CFSE:
https://fedorahosted.org/katello/wiki/GuideSystemRegistrationClient).

Comment 9 Og Maciel 2012-04-09 18:16:13 UTC
Lana: just trying to understand what the resolution is: are we adding this to the release notes only (and if so, how do we validate it?) or adding to the official docs for the 1.0 release?

Comment 10 James Laska 2012-04-09 19:13:57 UTC
(In reply to comment #9)
> Lana: just trying to understand what the resolution is: are we adding this to
> the release notes only (and if so, how do we validate it?) or adding to the
> official docs for the 1.0 release?

I believe this will be release noted for v1.0, and moved to the user guide for future releases.  Lana, does that match your expectations?

As for validating, the Cloud Engine crew has a similar bug.  They are walking through the upstream instructions to see if they can backup the database(s) and configs, reinstall a fresh Engine system, and restore the previous database(s) and configs.

Comment 11 Lana Brindley 2012-06-12 03:21:09 UTC
Back to assigned for doc update.

LKB

Comment 12 Athene Chan 2012-10-08 01:04:50 UTC
Hi James,

I've been comparing the steps in https://fedorahosted.org/katello/wiki/GuideSystemRegistrationClient and the ones we have added in the 1.1 User Guide. 

Can you review the following for us and let us know if more information needs to be added?

http://documentation-devel.engineering.redhat.com/docs/en-US/CloudForms/1.1/html/System_Engine_User_Guide/Registering_a_System.html

I realize that our "Registering systems" section deals only with activation key registration. I'd like some guidance between the options of using the bootstrap configuration and manual configuration. Are there any situations wherein manual configuration is required?

Comment 13 James Laska 2012-10-08 12:34:42 UTC
Hi Athene,

I might divide up registration into the following sub-sections.  As always, feel free to adjust to your liking ...

6.2. Registering a System
  6.2.1 Configuration
     6.2.1.1 Automated
       [ detail installing cert-consumer.rpm installation ]

     6.2.1.2 Manual
       [ Detail updating /etc/rhsm/rhsm.conf via `subscription-manager config` ]

  6.2.2 Registration
       [ subscription-manager register --org [your_CFSE_org_name] ]

  NOTE: Simplify registration with activation keys
    
       [ subscription-manager register --org [your_CFSE_org_name] --activationkey [your_CFSE_activation_key]]

For more information on managing subscriptions and entitlements, consult the "RHEL Deployment Guide :: Chapter 4. Product Subscriptions and Entitlements" at https://access.redhat.com/knowledge/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/entitlements.html

Comment 16 Corey Welton 2012-10-17 08:48:05 UTC
mass-move of docs-related bugs to ecs-bugs.

If this appears to be incorrect, feel free to bounce back to katello-qa-list and/or request clarification.

Comment 18 Lana Brindley 2012-11-19 02:36:21 UTC
This documentation has now been dropped to translation ahead of publication. For any further issues, please open a new a bug.

LKB

Comment 19 Lana Brindley 2012-12-10 21:41:36 UTC
This document is now publicly available on access.redhat.com. For any further issues, please raise a new bug.

LKB

Comment 20 Mike McCune 2013-08-16 18:09:44 UTC
getting rid of 6.0.0 version since that doesn't exist


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