rhsm-icon (8) Linux Manual Page
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
Options
- -c, –check-period
- Sets the interval to use between checks for the product subscription status. The value is in seconds and the default is one day.
- -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 initial 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 [at] redhat.com>, and James Bowes, <jbowes [at] 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.