1rhsmcertd(8) Subscription Management rhsmcertd(8)
2
3
4
6 rhsmcertd - Periodically scans and updates the entitlement certificates
7 on a registered system.
8
9
11 rhsmcertd [--cert-check-interval=MINUTES] [--auto-attach-interval=MIN‐
12 UTES] [--no-splay] [--now] [--debug] [--help]
13
14
15 Deprecated usage
16
17 rhsmcertd [certInterval autoattachInterval]
18
19
21 Red Hat provides content updates and support by issuing subscriptions
22 for its products. These subscriptions are applied to systems
23 (machines). Red Hat Subscription Manager is a tool which allows admin‐
24 istrators to manage those subscriptions by registering systems and peo‐
25 ple, applying subscriptions, and viewing subscriptions.
26
27
28 When subscriptions are applied to a system or when new subscriptions
29 are available, the subscription management system issues that machine
30 an X.509 certificate which contains all of the details of that sub‐
31 scription. The rhsmcertd process runs periodically to check for changes
32 in the subscriptions available to a machine by updating the entitlement
33 certificates installed on the machine and by installing new entitlement
34 certificates as they're available.
35
36
37 At a defined interval, the process checks with the subscription manage‐
38 ment service to see if any new subscriptions are available to the sys‐
39 tem. If there are, it pulls in the associated subscription certifi‐
40 cates. If any subscriptions have expired and new subscriptions are
41 available, then the rhsmcertd process will automatically request those
42 subscriptions. By default, the initial auto-attach is delayed by a ran‐
43 dom amount of seconds from zero to the autoAttachInterval. The initial
44 cert check is delayed by a random amount of seconds from zero to
45 certCheckInterval.
46
47
48 This rhsmcertd process invokes the rhsmcertd-worker.py script to per‐
49 form the certificate add and update operations.
50
51
52 Both the certificate interval and the auto-attach interval are config‐
53 urable and can be reset through the rhsmcertd daemon itself or by edit‐
54 ing the Subscription Manager /etc/rhsm/rhsm.conf file.
55
56
57 rhsmcertd is started with the machine, by default, and is always run‐
58 ning in the background.
59
60
62 -h, --help
63 Prints the specific help information for the given command.
64
65
66 -d, --debug
67 Records more verbose output to the /var/log/rhsm/rhsmcertd.log
68 log file.
69
70
71 -n, --now
72 Runs the rhsmcertd scan immediately, rather than waiting for the
73 next scheduled interval.
74
75
76 -c, --cert-check-interval=MINUTES
77 Resets the interval for checking for new subscription certifi‐
78 cates. This value is in minutes. The default is 240, or four
79 hours. This interval is in effect until the daemon restarts, and
80 then the values in the /etc/rhsm/rhsm.conf file are used (unless
81 the argument is passed again).
82
83
84 -i, --auto-attach-interval=MINUTES
85 Resets the interval for checking for and replacing expired sub‐
86 scriptions. This value is in minutes. The default is 1440, or 24
87 hours. This interval is in effect until the daemon restarts, and
88 then the values in the /etc/rhsm/rhsm.conf file are used (unless
89 the argument is passed again).
90
91
92 -s, --no-splay
93 If present this option disables the splay feature entirely. When
94 not present the value of "splay" from the /etc/rhsm/rhsm.conf
95 file is used to determine whether the splay feature is on ("1")
96 or off ("0").
97
98
100 NOTE Be sure to stop the running rhsmcertd daemon before making any
101 configuration changes, or the new configuration is not applied.
102
103
104 RESETTING THE CERTIFICATE SCAN INTERVAL
105 service rhsmcertd stop
106 rhsmcertd --cert-check-interval=240
107
108
109 RUNNING CERTIFICATE AND HEALING SCANS IMMEDIATELY
110 Normally, the certificate and auto-attach scans are run periodically,
111 on a schedule defined in the rhsmcertd configuration. The scans can be
112 run immediately -- which is useful if an administrator knows that there
113 are new subscriptions available -- and then the scans resume their
114 schedules.
115 service rhsmcertd stop
116 rhsmcertd -n
117
118
119 DEPRECATED USAGE
120 rhsmcertd used to allow the certificate and auto-attach intervals to be
121 reset simply by passing two integers as arguments.
122
123 rhsmcertd certInterval autoAttachInterval
124
125 For example:
126 service rhsmcertd stop
127 rhsmcertd 180 480
128
129 This usage is still allowed, but it is deprecated and not recommended.
130
131
133 * /usr/share/rhsm/certmgr.py
134
135 * /etc/rhsm/rhsm.conf
136
137 * /var/log/rhsm/rhsmcertd.log
138
139
141 This daemon is part of Red Hat Subscription Manager. To file bugs
142 against this daemon, go to https://bugzilla.redhat.com, and select Red
143 Hat > Red Hat Enterprise Linux > subscription-manager.
144
145
146
148 Deon Lackey, <dlackey@redhat.com> and Jeff Ortel, <jortel@redhat.com>.
149 rhsmcertd was written by Jeff Ortel.
150
151
153 Copyright (c) 2010-2012 Red Hat, Inc. This is licensed under the GNU
154 General Public License, version 2 (GPLv2). A copy of this license is
155 available at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.
156
157
158
159 rhsmcertd(8)