rhsm-icon man page

rhsm-icon — Periodically checks installed products against active subscriptions to check their status.


rhsm-icon [--check-period] [--force-icon=warning|expired|partial] [--check-immediately]


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.

only runs on graphical (X-based) systems. Servers which do not have a GUI interface do not run or require the rhsm-icon daemon.


-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.


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


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.


Deon Lackey, <dlackey@redhat.com>, and James Bowes, <jbowes@redhat.com>. rhsm-icon was written by James Bowes.


RHSM Desktop Icon