Bug 746257
| Summary: | “Man subscription-manager “Displays wrong example for activation key | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| Product: | Red Hat Enterprise Linux 6 | Reporter: | spandey | ||||||
| Component: | subscription-manager | Assignee: | Bryan Kearney <bkearney> | ||||||
| Status: | CLOSED ERRATA | QA Contact: | IDM QE LIST <seceng-idm-qe-list> | ||||||
| Severity: | unspecified | Docs Contact: | |||||||
| Priority: | unspecified | ||||||||
| Version: | 6.2 | CC: | bkearney, dlackey, jmolet, jsefler, kbanerje, skallesh, spandey, wpoteat | ||||||
| Target Milestone: | rc | Keywords: | Documentation | ||||||
| Target Release: | --- | ||||||||
| Hardware: | Unspecified | ||||||||
| OS: | Unspecified | ||||||||
| Whiteboard: | |||||||||
| Fixed In Version: | Doc Type: | Bug Fix | |||||||
| Doc Text: | Story Points: | --- | |||||||
| Clone Of: | Environment: | ||||||||
| Last Closed: | 2011-12-06 17:25:59 UTC | Type: | --- | ||||||
| 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: | 682238, 748554 | ||||||||
| Attachments: |
|
||||||||
Deon,
Just to help clarify... the REGISTER OPTIONS/--activationkey=KEYS section of the subscription-manager man page is pasted below. In this section we'd like to remove "--username=admin --password=secret" from the example. You could also add a note to the effect that the no username and password are needed when registering with an activationkey because the authentication is implied in the key. <- Maybe Bryan or Will can help with that wording.
--activationkey=KEYS
Gives a comma-separated list of product keys to use to redeem or apply specific subscriptions to the machine. This is used generally for preconfigured
machines, which may already have products installed and subscriptions allocated for that consumer. For example:
subscription-manager register --username=admin --password=secret
--org="IT Dept" --activationkey=1234abcd
Giving the org name is not necessary in hosted environments or infrastructures which have only a single organization.
Created attachment 528574 [details]
edited manpage
I changed the --activationkey example as indicated, and I also added a little note about the authentication and --org stuff, also as indicated.
NEEDINFO from bkearney or wpoteat...
When the --activationkey option is used, it is not necessary to use the --username and --password options, because the user information and authentication is implicit in the activation key.
^^^
Is the "because...." clause of Deon's re-worded description from attachment 528574 [details] of the activationkey option accurately stated? I don't think "the user information and" should be in this sentence.
The user information is not in the key but the authentication information is. Created attachment 528673 [details]
edited manpage #2
Removed the user reference. Users are gone and only authentication remains.
fixed in rhel6.2 eafe19ba and master 7615c9054817c6 Verifying Version...
[root@jsefler-onprem-62server ~]# rpm -q subscription-manager
subscription-manager-0.96.15-1.git.7.fbf42c7.el6.x86_64
[root@jsefler-onprem-62server ~]# man subscription-manager
...SNIP...
--activationkey=KEYS
Gives a comma-separated list of product keys to use to redeem or apply specific subscriptions to the machine. This is used generally for preconfigured machines, which may already have products installed and subscriptions allocated for that consumer.
When the --activationkey option is used, it is not necessary to use the --username and --password options, because the authentication information is implicit in the activation key.
In hosted or single organization environments, it is not necessary to specify an organization with the --org option, but in multi-organization environments, this is required.
For example:
subscription-manager register --org="IT Dept" --activationkey=1234abcd
Giving the org name is not necessary in hosted environments or infrastructures which have only a single organization.
...SNIP...
^^^ THIS MAN PAGE DESCRIPTION FOR REGISTER OPTION --activationkey IS GOOD
Moving to VERIFIED
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-2011-1695.html |
Description of problem: Version-Release number of selected component (if applicable): How reproducible: Prerequisites: Rhel6.2 client with following rpm subscription-manager-firstboot-0.96.15-1.el6.x86_64 . subscription-manager-gnome-0.96.15-1.el6.x86_64. subscription-manager-0.96.15-1.el6.x86_64 . Steps to Repro : Execute following command on console to display subscription manager man page man subscription-manager check for activationkey info Expected Result : It should display no user and password is required for activation key registration Actual Result : subscription-manager register --username=admin --password=secret --org="IT Dept" –activationkey=1234abcd