Bug 854357 - install-num-migrate-to-rhsm man page updates
Summary: install-num-migrate-to-rhsm man page updates
Keywords:
Status: CLOSED ERRATA
Alias: None
Product: Red Hat Enterprise Linux 5
Classification: Red Hat
Component: subscription-manager
Version: 5.10
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: candlepin-bugs
QA Contact: IDM QE LIST
URL:
Whiteboard:
Depends On:
Blocks: rhsm-rhel510
TreeView+ depends on / blocked
 
Reported: 2012-09-04 18:00 UTC by Matt Reid
Modified: 2013-09-30 22:49 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
No description necessary
Clone Of:
: 857195 (view as bug list)
Environment:
Last Closed: 2013-09-30 22:49:54 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Product Errata RHBA-2013:1332 0 normal SHIPPED_LIVE subscription-manager bug fix and enhancement update 2013-09-30 22:49:24 UTC

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


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