Bug 854357

Summary: install-num-migrate-to-rhsm man page updates
Product: Red Hat Enterprise Linux 5 Reporter: Matt Reid <mreid>
Component: subscription-managerAssignee: candlepin-bugs
Status: CLOSED ERRATA QA Contact: IDM QE LIST <seceng-idm-qe-list>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 5.10CC: bkearney, fsharath, jsefler
Target Milestone: ---Keywords: Documentation
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
No description necessary
 Story Points: ---
Clone Of:
: 857195 (view as bug list) Environment:
Last Closed: 2013-09-30 22:49:54 UTC Type: Bug
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:    
Bug Blocks: 840995    

Description Matt Reid 2012-09-04 18:00:11 UTC 
Description of problem:
Looking at version .2, we need to update it a bit to include more current terminology.


Name:
Checks the installation number for a system and copies over the required product certificates.
copies over -> installs

This is used for migrating an offline system to Certificate-based Red Hat Network.
Cert-based RHN -> Red Hat Subscription Management

Description:
install-num-migrate-to-rhsm migrates... used by Certificate-based Red Hat Network.
Cert-based RHN -> Red Hat Subscription Management

Background:
Subscriptions are assigned to a system... -> Subscriptions are attached to a system.

In the new Certificate-based Red Hat Network ... -> Red Hat Subscription Management

For an offline system... to the Certificate-based Red Hat Network subscription model, managed by Subscription Manager.
Certificate-based Red Hat Network -> Red Hat Subscription Management

Options:
-d, --dryrun
This indicates what product certificates will be copied into the /usr/share/rhsm/produt directory, but does not actually copy them over.
copy -> install

Usage:
The script copies in the product certificates that correspond to the available channels from the installation number.
copies in -> installs

This script does not register the system or subscribe the system to any entitlements.
subscribe the system to any entitlements -> attach any subscriptions to the system.

For the procedure to register an offline system with Certificate-based Red Hat Network and assign entitlements, see the RHN documentation:
Certificate-based Red Hat Network -> Red Hat Subscription Management
assign entitlements -> attach subscriptions

Replace the current URL with: https://access.redhat.com/knowledge/docs/en-US/Red_Hat_Customer_Portal/1/html/Red_Hat_Network_Certificate-based_Subscription_Management/managing-consumers.html#web-consumer-register

Because the install-num-migrate-to-rhsm command does not register the system with Certificate-based Red Hat Network...
Certificate-based Red Hat Network -> Red Hat Subscription Management

Files:
/var/log/rhsm/rhsm.log
This contains any errors registering the system to Certificate-based Red Hat Network or with subscribing the system to entitlements. ->
This contains any errors registering the system to Red Hat Subscription Management or with attaching subscriptions to the system.

------------------

We should probably look into a redirect to point the old URL to the one above in the meantime, I guess the name changed, the current URL 404s.
Comment 3 Deon Ballard 2012-09-06 05:07:12 UTC 
Checked into master:
commit 0a98e047252194ec3c209fa01ffea32ea006038d
Comment 5 John Sefler 2012-12-11 19:32:30 UTC 
The install-num-migrate-to-rhsm tool is a RHEL5-only tool.
It is not installed onto RHEL6.

Changing the product to RHEL5...
Comment 6 RHEL Program Management 2013-04-04 12:29:20 UTC 
This request was evaluated by Red Hat Product Management for inclusion
in a Red Hat Enterprise Linux release.  Product Management has
requested further review of this request by Red Hat Engineering, for
potential inclusion in a Red Hat Enterprise Linux release for currently
deployed products.  This request is not yet committed for inclusion in
a release.
Comment 7 Sharath Dwaral 2013-04-30 14:34:17 UTC 
# rpm -qa | egrep "subscription-manager|python-rhsm"
subscription-manager-migration-1.8.6-1.git.7.96019b0.el5
python-rhsm-1.8.9-1.git.7.214419e.el5
subscription-manager-migration-data-1.11.2.7-1.git.0.1dfd00e.el5
subscription-manager-1.8.6-1.git.7.96019b0.el5
subscription-manager-firstboot-1.8.6-1.git.7.96019b0.el5
subscription-manager-gui-1.8.6-1.git.7.96019b0.el5

# man  install-num-migrate-to-rhsm

Name: 
install-num-migrate-to-rhsm  -  Checks  the  installation number for a system and installs the required product certificates. 
           ^^^^^^^^  
This is used for migrating an offline system to Customer Portal Subscription Management.
                                                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Description: 
install-num-migrate-to-rhsm migrates a system...... certificates used by Customer Portal Subscription Management.
                                                                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Background:
Subscriptions are assigned or attached to a system......
                  ^^^^^^^^^^^^^^^^^^^^
In Customer Portal Subscription Management, installed products
   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 
For an offline system, ....... certificate-based Customer Portal Subscription Management, managed by Subscription Manager.
                                                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
Options:
-d, --dryrun
Performs a dry run of the script. This indicates what product certificates will be installed into the /usr/share/rhsm/product directory,
                                                                                   ^^^^^^^^^

Usage:
The script installs the product certificates that correspond to.......
           ^^^^^^^^
This script does not register the system or attach new....
                                            ^^^^^^
For the procedure to register an offline system with Customer Portal Subscription Management and attach subscriptions,
                                                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^     ^^^^^^

URL:
<https://access.redhat.com/knowledge/docs/en-US/Red_Hat_Customer_Portal/1/html/Red_Hat_Network_Certificate-based_Subscription_Management/managing-consumers.html#web-consumer-regis-ter>

Because the install-num-migrate-to-rhsm command does not register the system with Customer Portal Subscription Management......
                                                                                  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Files:
/var/log/rhsm/rhsm.log
The Subscription Manager log file....  system to Customer Portal Subscription Management or with attaching the system to subscriptions.
                                                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^         ^^^^^^^^^

VERIFIED
Comment 9 errata-xmlrpc 2013-09-30 22:49:54 UTC 
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2013-1332.html