Red Hat Bugzilla – Bug 983660
man page entry needed for new auto-attach module
Last modified: 2013-09-30 19:13:08 EDT
Description of problem:
A new subscription-manager module called "auto-attach" has been implemented that is simply used to enable/disable a flag on the registered consumer. When the flag is true, then the system will attempt to auto-attach subscriptions at the next check-in time determined by the rhsmcertd.autoAttachInterval (configured in /etc/rhsm/rhsm.conf). When the flag is false, the system will NOT attempt to auto-attach subscriptions for any incompliant products or partial subscriptions at the next autoAttachInterval check-in time.
[root@jsefler-5 ~]# subscription-manager --help
Usage: subscription-manager MODULE-NAME [MODULE-OPTIONS] [--help]
attach Attach a specified subscription to the registered system
list List subscription and product information for this system
refresh Pull the latest subscription data from the server
register Register this system to the Customer Portal or another subscription management service
release Configure which operating system release to use
remove Remove all or specific subscriptions from this system
status Show status information for this system's subscriptions and products
unregister Unregister this system from the Customer Portal or another subscription management service
auto-attach Set if this system runs auto-attach each check-in
clean Remove all local system and subscription data without affecting the server
config List, set, or remove the configuration parameters in use by this system
environments Display the environments available for a user
facts View or update the detected system information
identity Display the identity certificate for this system or request a new one
import Import certificates which were provided outside of the tool
orgs Display the organizations against which a user can register a system
plugins View and configure subscription-manager plugins
redeem Attempt to redeem a subscription for a preconfigured system
repos List the repositories which this system is entitled to use
service-level Manage service levels for this system
subscribe Deprecated, see attach
unsubscribe Deprecated, see remove
version Print version information
^^^^^^^ SEE new Other Module "auto-attach"
[root@jsefler-5 ~]# subscription-manager auto-attach --help
Usage: subscription-manager auto-attach [OPTIONS]
Set if this system runs auto-attach each check-in
-h, --help show this help message and exit
--proxy=PROXY_URL proxy URL in the form of proxy_hostname:proxy_port
user for HTTP proxy with basic authentication
password for HTTP proxy with basic authentication
--enable try to attach subscriptions for uncovered products
--disable do not try to automatically attach subscriptions each
--show show the current auto-attach preference
Version-Release number of selected component (if applicable):
[root@jsefler-5 ~]# subscription-manager version
server type: This system is currently not registered.
subscription management server: 0.8.16-1
[root@jsefler-5 ~]# man -P cat subscription-manager | tail -1
version 2.7 May 23, 2013 subscription-manager(8)
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
This request was not resolved in time for the current release.
Red Hat invites you to ask your support representative to
propose this request, if still desired, for consideration in
the next release of Red Hat Enterprise Linux.
# rpm -qa | egrep "subscription-manager|python-rhsm"
Abstract from subscription-manager man page
The auto-attach command sets whether the ability to check, attach, and update subscriptions occurs automatically on the system. Auto-attaching subscriptions checks the currently-
installed products, attached subscriptions, and any changes in available subscriptions every four hours using the rhsmcertd daemon.
Enables the auto-attach option for the system. If there is any change in the subscriptions for the system, any subscriptions expire, or any new products are installed, then
subscription-manager detects the changes and automatically attaches the appropriate subscriptions so that the system remains covered.
Disables the auto-attach option for the system. If auto-attach is disabled, then any changes in installed products or subscriptions for the system (including expirations) must
be addressed manually by the administrator.
man -P cat subscription-manager | tail -1
version 2.7 May 23, 2013 subscription-manager(8)
--show Shows whetehr auto-attach is enabled on the systems.
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.