Bug 959563

Summary: man page for subscription-manager needs an update to add new list --status option
Product: Red Hat Enterprise Linux 5 Reporter: John Sefler <jsefler>
Component: subscription-managerAssignee: Deon Ballard <dlackey>
Status: CLOSED ERRATA QA Contact: IDM QE LIST <seceng-idm-qe-list>
Severity: medium Docs Contact:
Priority: unspecified    
Version: 5.10CC: ckozak, fsharath, mreid
Target Milestone: rc   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
No description necessary
Story Points: ---
Clone Of: Environment:
Last Closed: 2013-09-30 23:07:41 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 John Sefler 2013-05-03 19:20:37 UTC
Description of problem:
There is a new "subscription-manager list --status" option that needs to be added to the man page documentation for subscription-manager.

Version-Release number of selected component (if applicable):
[root@jsefler-5 ~]# rpm -q subscription-manager
subscription-manager-1.8.6-1.git.27.f8647f0.el5
[root@jsefler-5 ~]# man -P cat subscription-manager | tail -1
version 2.5                     April 30, 2013         subscription-manager(8)


How reproducible:


Steps to Reproduce:
[root@jsefler-5 ~]# subscription-manager list --help
Usage: subscription-manager list [OPTIONS]

List subscription and product information for this system

options:
  -h, --help            show this help message and exit
  --proxy=PROXY_URL     proxy URL in the form of proxy_hostname:proxy_port
  --proxyuser=PROXY_USER
                        user for HTTP proxy with basic authentication
  --proxypassword=PROXY_PASSWORD
                        password for HTTP proxy with basic authentication
  --installed           list shows those products which are installed
                        (default)
  --available           show those subscriptions which are available
  --all                 used with --available to ensure all subscriptions are
                        returned
  --ondate=ON_DATE      date to search on, defaults to today's date, only used
                        with --available (example: 2013-05-03)
  --consumed            show the subscriptions being consumed by this system
  --status              show the current status of the system and reasons it
                        is not fully compliant.   <=========== NEW LIST STATUS OPTION
  --servicelevel=SERVICE_LEVEL
                        shows only subscriptions matching the specified
                        service level; only used with --available and
                        --consumed

[root@jsefler-5 ~]# subscription-manager list --status
+-------------------------------------------+
   System Status Details
+-------------------------------------------+
Overall Status: Invalid

Red Hat Enterprise Linux Server: Not covered by a valid subscription.

Comment 1 RHEL Program Management 2013-05-03 19:27:38 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 3 John Sefler 2013-05-22 14:39:44 UTC
Sorry Deon, apologizes on behalf of mreid and ckozak who changed this behavior...
[root@jsefler-5 ~]# rpm -q subscription-manager
subscription-manager-1.8.8-1.git.0.2ca28df.el5


The "subscription-manager list --status" functionality has been moved out of the list module and into it's own module:

[root@jsefler-5 ~]# subscription-manager status --help
Usage: subscription-manager status [OPTIONS]

Show status information for this system's subscriptions and products

options:
  -h, --help  show this help message and exit


The man page needs a re-update.

Comment 5 Bryan Kearney 2013-06-05 12:36:18 UTC
Moving all modified bugs to ON_QA

Comment 6 Sharath Dwaral 2013-06-05 14:14:53 UTC
Ver# rpm -qa | egrep "subscription-manager|python-rhsm"
subscription-manager-migration-data-1.11.3.1-1.git.1.78afd75.el5
subscription-manager-migration-1.8.10-1.git.1.b44c4b1.el5
python-rhsm-1.8.12-1.git.0.d747a65.el5
subscription-manager-firstboot-1.8.10-1.git.1.b44c4b1.el5
subscription-manager-1.8.10-1.git.1.b44c4b1.el5
subscription-manager-gui-1.8.10-1.git.1.b44c4b1.el5sion:


>> man page extract

STATUS OPTIONS
       The status command shows the current status of the products and attached subscriptions for the system. If some products are not fully covered or subscriptions have expired, then  the
       status command shows why subscriptions are not current.

       [root@server ~]# subscription-manager status
       +-------------------------------------------+
           Installed Product Status
       +-------------------------------------------+
       Product Name: Red Hat Enterprise Linux
       Product ID: 69
       Version: 7
       Arch: x86_64
       Status: Subscribed
       Status Details:
       Starts: 01/01/2012
       Ends: 01/01/2022

       +-------------------------------------------+
            System Status Details
       +-------------------------------------------+
       Overall Status: Subscribed

       This command has no options.

# man -P cat subscription-manager | tail -1
version 2.7                      May 23, 2013          subscription-manager(8)


VERIFIED

Comment 8 errata-xmlrpc 2013-09-30 23:07:41 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