Bug 1346368

Summary: man rhsm.conf is missing a description for the server_timeout configuration
Product: Red Hat Enterprise Linux 7 Reporter: John Sefler <jsefler>
Component: subscription-managerAssignee: Kevin Howell <khowell>
Status: CLOSED ERRATA QA Contact: John Sefler <jsefler>
Severity: low Docs Contact:
Priority: medium    
Version: 7.3CC: brubisch, gassmann, khowell, redakkan, skallesh, vrjain
Target Milestone: rcKeywords: EasyFix, Triaged
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2017-08-01 19:18:42 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: 1395274    

Description John Sefler 2016-06-14 15:50:39 UTC
Description of problem:
Recently introduced by the following python-rhsm commit is a new/optional configuration for [server] server_timeout that should be described in the man page for rhsm.conf provided by the subscription-manager package.

    Commit: 5780140650a59d45a03372a0390f92fd7c3301eb
    Allow users to set socket timeout.
    Remove the old method of setting a universal timeout (which was required 
    due to limitations in Python versions that we don't support any more) 
    and instead specify the timeout on a per-connection basis.

You will now see it as an available configuration in...

[root@jsefler-rhel7 ~]# subscription-manager config
[server]
   hostname = jsefler-candlepin.usersys.redhat.com
   insecure = [0]
   port = 8443
   prefix = /candlepin
   proxy_hostname = []
   proxy_password = []
   proxy_port = []
   proxy_user = []
   server_timeout = [180]          <========== NEW CONFIG
   ssl_verify_depth = [3]

[rhsm]
   baseurl = [https://cdn.redhat.com]
   ca_cert_dir = [/etc/rhsm/ca/]
   consumercertdir = [/etc/pki/consumer]
   entitlementcertdir = [/etc/pki/entitlement]
   full_refresh_on_yum = [0]
   manage_repos = [1]
   pluginconfdir = [/etc/rhsm/pluginconf.d]
   plugindir = [/usr/share/rhsm-plugins]
   productcertdir = [/etc/pki/product]
   repo_ca_cert = /etc/rhsm/ca/redhat-uep.pem
   report_package_profile = [1]

[rhsmcertd]
   autoattachinterval = [1440]
   certcheckinterval = [240]

[] - Default value in use



Version-Release number of selected component (if applicable):
[root@jsefler-rhel7 ~]# subscription-manager version
server type: This system is currently not registered.
subscription management server: 2.0.13-1
subscription management rules: 5.20
subscription-manager: 1.17.7-1.git.5.9187cce.el7
python-rhsm: 1.17.3-0.git.10.a0557db.el7


How reproducible:


Steps to Reproduce:
1. man rhsm.conf

Actual results:


Expected results:
  The man page for rhsm.conf should include a description for the new option server_timeout under the section for [SERVER] OPTIONS.

Additional info:

Comment 2 Philipp Gassmann 2017-02-07 14:43:21 UTC
When will the updated documentation land in RHEL?

Comment 5 Rehana 2017-04-03 05:00:35 UTC
Retested on :

subscription management server: 0.9.51.21-1
subscription management rules: 5.15.1
subscription-manager: 1.19.4-1.el7
python-rhsm: 1.19.2-1.el7


Observed that now "server_timeout" option is listed under the [SERVER] OPTIONS section.

#man rhsm.conf 

RHSM.CONF(5)                                                                                                                                                                                     RHSM.CONF(5)

NAME
       rhsm.conf - Configuration file for the subscription-manager tooling

DESCRIPTION
       The rhsm.conf file is the configuration file for various subscription manager tooling. This includes subscription-manager, subscription-manager-gui, rhsmcertd, and virt-who.

[SERVER] OPTIONS
  <snip>
       server_timeout
           Set this to a non-blank value to override the HTTP timeout in seconds. The default is 180 seconds (3 minutes).

Marking as verified!!

Comment 6 errata-xmlrpc 2017-08-01 19:18:42 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.

https://access.redhat.com/errata/RHBA-2017:2083