rhsm-icon(8) Subscription Status Daemon rhsm-icon(8)NAMErhsm-icon - Periodically checks installed products against active sub‐
scriptions to check their status.
SYNOPSISrhsm-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 sub‐
scription 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 run‐
ning 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 neces‐
sary 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, run‐
ning 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 mes‐
sages 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@red‐
hat.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)
