rhsm-icon(8) [centos man page]
rhsm-icon(8) Subscription Status Daemon rhsm-icon(8) NAME
rhsm-icon - Periodically checks installed products against active subscriptions to check their status. SYNOPSIS
rhsm-icon [--check-period] [--force-icon=warning|expired|partial] [--check-immediately] DESCRIPTION
Red Hat provides content updates and support by issuing subscriptions for its products. These subscriptions are applied to systems (machines) and apply to the installed software products. On graphical X systems (systems with a GUI interface), a product status daemon runs every 4 hours to check the currently installed software against the applied subscriptions. If software is installed without a valid and applied subscription (such as a subscription expires or no subscription is available for the product), then the daemon triggers an icon and warning message to display in the notification area of the menu. rhsm-icon only runs on graphical (X-based) systems. Servers which do not have a GUI interface do not run or require the rhsm-icon daemon. OPTIONS
-c, --check-period Sets the interval to use between checks for the product subscription status. The value is in seconds. -f, --force-icon=TYPE Manually displays the given type of icon in the start menu. The TYPE can be warning, expired, or partial and uses a different icon for each type of message. --i, --check-immediately Runs the status check process immediately when the command is invoked. Otherwise, there is a four (4) minute delay before running the check. -d, --debug Shows debug messages for the daemon. USAGE
There are two reasons to invoke rhsm-icon manually: * To run the daemon on a new schedule (immediately or with a different frequency) * To view the status icons or messages regardless of the state of the machine Since X runs the daemon automatically and on schedule, it is not necessary to launch the subscription status daemon manually. The rhsm-icon command can change this schedule. For example: rhsm-icon --check-period 120 Administrators can also run rhsm-icon to view any immediate changes to the subscription status of the system. Using the --check-immediately option runs the check at the time the command is run; otherwise, running rhsm-icon has a four-minute delay before running the status check. rhsm-icon --check-immediately If you just want to know what the different subscription status messages look like, then use the --force-icon option. (Also use the --check-immediately option, or the scan will take the standard four minutes to run and display the icon.) rhsm-icon --force-icon=warning --check-immediately rhsm-icon --force-icon=expired --check-immediately rhsm-icon --force-icon=partial --check-immediately BUGS
This daemon is part of Red Hat Subscription Manager. To file bugs against this daemon, go to https://bugzilla.redhat.com, and select Red Hat > Red Hat Enterprise Linux > subscription-manager. AUTHORS
Deon Lackey, <dlackey@redhat.com>, and James Bowes, <jbowes@redhat.com>. rhsm-icon was written by James Bowes. COPYRIGHT
Copyright (c) 2010-2012 Red Hat, Inc. This is licensed under the GNU General Public License, version 2 (GPLv2). A copy of this license is available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt. version 1.3 December 12, 2012 rhsm-icon(8)
Check Out this Related Man Page
rhsmcertd(8) Subscription Management Certificate Daemon rhsmcertd(8) NAME
rhsmcertd - Periodically scans and updates the entitlement certificates on a registered system. SYNOPSIS
rhsmcertd [--cert-check-interval=MINUTES] [--auto-attach-interval=MINUTES] [--now] [--debug] [--help] Deprecated usage rhsmcertd [certInterval autoattachInterval] DESCRIPTION
Red Hat provides content updates and support by issuing subscriptions for its products. These subscriptions are applied to systems (machines). Red Hat Subscription Manager is a tool which allows administrators to manage those subscriptions by registering systems and people, applying subscriptions, and viewing subscriptions. When subscriptions are applied to a system or when new subscriptions are available, the subscription management system issues that machine an X.509 certificate which contains all of the details of that subscription. The rhsmcertd process runs periodically to check for changes in the subscriptions available to a machine by updating the entitlement certificates installed on the machine and by installing new enti- tlement certificates as they're available. At a defined interval, the process checks with the subscription management service to see if any new subscriptions are available to the system. If there are, it pulls in the associated subscription certificates. If any subscriptions have expired and new subscriptions are available, then the rhsmcertd process will automatically request those subscriptions. This rhsmcertd process invokes the certmgr.py script to perform the certificate add and update operations. Both the certificate interval and the auto-attach interval are configurable and can be reset through the rhsmcertd daemon itself or by editing the Subscription Manager /etc/rhsm/rhsm.conf file. rhsmcertd is started with the machine, by default, and is always running in the background. OPTIONS
-h, --help Prints the specific help information for the given command. -d, --debug Records more verbose output to the /var/log/rhsm/rhsmcertd.log log file. -n, --now Runs the rhsmcertd scan immediately, rather than waiting for the next scheduled interval. -c, --cert-check-interval=MINUTES Resets the interval for checking for new subscription certificates. This value is in minutes. The default is 240, or four hours. This interval is in effect until the daemon restarts, and then the values in the /etc/rhsm/rhsm.conf file are used (unless the argu- ment is passed again). -i, --auto-attach-interval=MINUTES Resets the interval for checking for and replacing expired subscriptions. This value is in minutes. The default is 1440, or 24 hours. This interval is in effect until the daemon restarts, and then the values in the /etc/rhsm/rhsm.conf file are used (unless the argument is passed again). USAGE EXAMPLES
NOTE Be sure to stop the running rhsmcertd daemon before making any configuration changes, or the new configuration is not applied. RESETTING THE CERTIFICATE SCAN INTERVAL service rhsmcertd stop rhsmcertd --cert-check-interval=240 RUNNING CERTIFICATE AND HEALING SCANS IMMEDIATELY Normally, the certificate and auto-attach scans are run periodically, on a schedule defined in the rhsmcertd configuration. The scans can be run immediately -- which is useful if an administrator knows that there are new subscriptions available -- and then the scans resume their schedules. service rhsmcertd stop rhsmcertd -n DEPRECATED USAGE rhsmcertd used to allow the certificate and auto-attach intervals to be reset simply by passing two integers as arguments. rhsmcertd certInterval autoattachInterval For example: service rhsmcertd stop rhsmcertd 180 480 This usage is still allowed, but it is deprecated and not recommended. ASSOCIATED FILES
* /usr/share/rhsm/certmgr.py * /etc/rhsm/rhsm.conf * /var/log/rhsm/rhsmcertd.log BUGS
This daemon is part of Red Hat Subscription Manager. To file bugs against this daemon, go to https://bugzilla.redhat.com, and select Red Hat > Red Hat Enterprise Linux > subscription-manager. AUTHORS
Deon Lackey, <dlackey@redhat.com> and Jeff Ortel, <jortel@redhat.com>. rhsmcertd was written by Jeff Ortel. COPYRIGHT
Copyright (c) 2010-2012 Red Hat, Inc. This is licensed under the GNU General Public License, version 2 (GPLv2). A copy of this license is available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt. version 1.5 April 30, 2013 rhsmcertd(8)