1 martin 1.3 .\" $Header: /cvs/MSB/pegasus/rpm/manLinux/man8.Z/cimconfig.8,v 1.2 2004/12/07 16:03:46 a.arora Exp $
|
2 a.arora 1.2 .\" .TA c \" lowercase initial leter of .TH name
3 .TH "cimconfig" "8" "" "" ""
4 .SH "NAME"
5 cimconfig \- get, set, unset, or list CIM Server configuration properties
6 .SH "SYNOPSIS"
7 \fBcimconfig\fP \fB\-g\fP name [ \fB\-c\fP ] [ \fB\-d\fP ] [ \fB\-p\fP ]
|
8 denise.eckstein 1.1
|
9 a.arora 1.2 \fBcimconfig\fP \fB\-s\fP name=value [ \fB\-c\fP ] [ \fB\-p\fP ]
|
10 denise.eckstein 1.1
|
11 a.arora 1.2 \fBcimconfig\fP \fB\-u\fP name [ \fB\-c\fP ] [ \fB\-p\fP ]
|
12 denise.eckstein 1.1
|
13 a.arora 1.2 \fBcimconfig\fP \fB\-l\fP [ \fB\-c\fP | \fB\-p\fP ]
|
14 denise.eckstein 1.1
|
15 a.arora 1.2 \fBcimconfig\fP \fB\-h\fP
16
17 \fBcimconfig\fP \fB\-\-help\fP
18
19 \fBcimconfig\fP \fB\-\-version\fP
20
21 .SH "DESCRIPTION"
22 .PP
|
23 denise.eckstein 1.1 The
24 .B cimconfig
25 command manages
26 CIM Server configuration properties. The operations are executed on the local
27 host by submitting requests to the CIM Server.
28 An operation on a current configuration property takes effect immediately,
29 and an operation on a planned configuration property takes effect the next time
30 the CIM Server is started with
31 .B "cimserver (8)" .
32 Modifications to a configuration property via
33 .B cimconfig
34 remain in effect
35 until changed via another
36 .B cimconfig
37 command. Configuration properties may also be modified temporarily via the
38 .B "cimserver (8)"
39 command, in which case, the modification of the configuration
40 property remains in effect for that execution of the
41 .B "cimserver (8)"
42 command only. A default value is associated with each configuration property.
43 Each configuration property is initially
44 denise.eckstein 1.1 assigned its default value, until modified by a
45 .B cimconfig
46 command or
47 .B "cimserver (8)"
48 command. Dynamic configuration
49 properties are those whose current values may be set while the CIM server is
50 running.
|
51 a.arora 1.2 .PP
|
52 denise.eckstein 1.1 The following configuration properties are available:
|
53 a.arora 1.2 .PP
|
54 denise.eckstein 1.1 .B enableAssociationTraversal
|
55 a.arora 1.2 .IP
|
56 denise.eckstein 1.1 .BR Description: " If True, the CIM Server will support the four association traversal operators:
57 Associators, AssociatorNames, References, and ReferenceNames.
58 .PD 0
|
59 a.arora 1.2 .IP
|
60 denise.eckstein 1.1 .BR "Default Value: " True
|
61 a.arora 1.2 .IP
|
62 denise.eckstein 1.1 .BR Dynamic: \0No
63 .PD
|
64 a.arora 1.2 .PP
|
65 denise.eckstein 1.1 .B enableIndicationService
|
66 a.arora 1.2 .IP
|
67 denise.eckstein 1.1 .BR Description: " If True, the CIM Server will support CIM Indications."
68 .PD 0
|
69 a.arora 1.2 .IP
|
70 denise.eckstein 1.1 .BR "Default Value: " True
|
71 a.arora 1.2 .IP
|
72 denise.eckstein 1.1 .BR Dynamic: \0No
73 .PD
|
74 a.arora 1.2 .PP
|
75 denise.eckstein 1.1 .B enableHttpConnection
|
76 a.arora 1.2 .IP
|
77 denise.eckstein 1.1 .BR Description: " If True, allows connections to the CIM Server
78 using the HTTP protocol
79 .PD 0
|
80 a.arora 1.2 .IP
|
81 denise.eckstein 1.1 .BR "Default Value: " False
|
82 a.arora 1.2 .IP
|
83 denise.eckstein 1.1 .BR Dynamic: \0No
84 .PD
|
85 a.arora 1.2 .PP
|
86 denise.eckstein 1.1 .B enableHttpsConnection
|
87 a.arora 1.2 .IP
|
88 denise.eckstein 1.1 .BR Description: " If True, allows connections to the CIM Server
89 using the HTTPS protocol (HTTP using Secure Socket Layer encryption)
90 .PD 0
|
91 a.arora 1.2 .IP
|
92 denise.eckstein 1.1 .BR "Default Value: " True
|
93 a.arora 1.2 .IP
|
94 denise.eckstein 1.1 .BR Dynamic: \0No
95 .PD
|
96 a.arora 1.2 .PP
|
97 denise.eckstein 1.1 .B enableNamespaceAuthorization
|
98 a.arora 1.2 .IP
|
99 denise.eckstein 1.1 .BR Description: " If True, the CIM Server restricts access to
100 namespaces based on configured user authorizations [user authorizations may
101 be configured using
102 .B "cimauth (8)"
103 ]
104 .PD 0
|
105 a.arora 1.2 .IP
|
106 denise.eckstein 1.1 .BR "Default Value: " False
|
107 a.arora 1.2 .IP
|
108 denise.eckstein 1.1 .BR Dynamic: \0No
109 .PD
|
110 a.arora 1.2 .PP
|
111 denise.eckstein 1.1 .B enableRemotePrivilegedUserAccess
|
112 a.arora 1.2 .IP
|
113 denise.eckstein 1.1 .BR Description: " If True, the CIM Server allows access by a
114 privileged user from a remote system
115 .PD 0
|
116 a.arora 1.2 .IP
|
117 denise.eckstein 1.1 .BR "Default Value: " True
|
118 a.arora 1.2 .IP
|
119 denise.eckstein 1.1 .BR Dynamic: \0No
120 .PD
|
121 a.arora 1.2 .PP
|
122 denise.eckstein 1.1 .B enableSubscriptionsForNonprivilegedUsers
|
123 a.arora 1.2 .IP
|
124 denise.eckstein 1.1 .BR Description: " If True, nonprivileged user of the system will be
125 allowed to create Indication Subscription, otherwise privileged access
126 is required.
127 .PD 0
|
128 a.arora 1.2 .IP
|
129 denise.eckstein 1.1 .BR "Default Value: " True
|
130 a.arora 1.2 .IP
|
131 denise.eckstein 1.1 .BR Dynamic: \0No
132 .PD
|
133 a.arora 1.2 .PP
|
134 denise.eckstein 1.1 .B logLevel
|
135 a.arora 1.2 .IP
|
136 denise.eckstein 1.1 .BR Description: " Defines the desired level of logging. Valid values include:
137 TRACE, INFORMATION, WARNING, SEVERE, FATAL
138 .PD 0
|
139 a.arora 1.2 .IP
|
140 denise.eckstein 1.1 .BR "Default Value: " INFORMATION
|
141 a.arora 1.2 .IP
|
142 denise.eckstein 1.1 .BR Dynamic: \0Yes
143 .PD
|
144 a.arora 1.2 .PP
|
145 denise.eckstein 1.1 .B shutdownTimeout
|
146 a.arora 1.2 .IP
|
147 denise.eckstein 1.1 .BR Description: " When a
|
148 a.arora 1.2 .B cimserver \-s
|
149 denise.eckstein 1.1 shutdown command is
150 issued, specifies the maximum time in seconds for the CIM Server to complete
151 outstanding CIM operation requests before shutting down; if the specified
152 timeout period expires, the CIM Server will shut down, even if there are
153 still CIM operations in progress.
154 Minimum value is 2 seconds.
155 .PD 0
|
156 a.arora 1.2 .IP
|
157 denise.eckstein 1.1 .BR "Default Value: " 10
|
158 a.arora 1.2 .IP
|
159 denise.eckstein 1.1 .BR Dynamic: \0No
160 .PD
|
161 martin 1.3 .PP
|
162 denise.eckstein 1.1 If both the
163 .B enableHttpsConnection
164 and
165 .B enableHttpConnection
166 properties are set to
|
167 martin 1.3 .B False ,
168 neither HTTP nor HTTPS connections will be allowed. On some platforms, the
169 OpenPegasus CIM Server has been enhanced to include support for a local
170 (single system), non-standard protocol. This allows the OpenPegasus CIM Server
171 to continue to receive and process requests from local OpenPegasus CIM Clients
172 even if both HTTP ports are disabled. If a local protocol is not supported,
173 the CIM Server will be shut down and disabled from automatically being
174 re\-started.
|
175 a.arora 1.2 .PP
|
176 denise.eckstein 1.1 The current and planned
177 values of the configuration properties are stored in the files
|
178 a.arora 1.2 .B /var/opt/tog\-pegasus/cimserver_current.conf
|
179 denise.eckstein 1.1 and
|
180 a.arora 1.2 .B /var/opt/tog\-pegasus/cimserver_planned.conf ,
|
181 denise.eckstein 1.1 respectively. The configuration
182 properties may only be modified via the
183 .B cimconfig
184 and
185 .B "cimserver (8)"
186 commands;
187 the files must not be edited directly.
188 .SS Options
|
189 a.arora 1.2 .PP
|
190 denise.eckstein 1.1 The
191 .B cimconfig
192 command recognizes the following options:
193 .RS
194 .TP 15
|
195 a.arora 1.2 \fB\-g\fP configuration_property
|
196 denise.eckstein 1.1 Gets the specified value (current, planned and/or default) of the specified
197 configuration property. By default, gets the current value.
|
198 a.arora 1.2 .TP
199 \fB\-s\fP configuration_property = value
|
200 denise.eckstein 1.1 Sets the specified value (current and/or planned) of the specified configuration
201 property to
|
202 a.arora 1.2 .I R value .
|
203 denise.eckstein 1.1 By default, sets the current value.
|
204 a.arora 1.2 .TP
205 \fB\-u\fP configuration_property
|
206 denise.eckstein 1.1 Unsets the specified
207 value (current and/or planned) of the specified configuration property, and
208 resets it to its default value. By
209 default, unsets the current value and resets it to its default value.
|
210 a.arora 1.2 .TP
211 .B \-l
|
212 denise.eckstein 1.1 Lists all the specified (current or planned) configuration property name and
213 value pairs in the CIM Server. By default,
214 lists only the names of all the current configuration properties.
|
215 a.arora 1.2 .TP
216 .B \-c
|
217 denise.eckstein 1.1 Specifies that the operation (get, set, unset, or list) be performed on the
218 current configuration properties. For set or
219 unset operations, returns an error when the CIM Server is not running or the
220 specified property is not a dynamic property.
|
221 a.arora 1.2 .TP
222 .B \-p
|
223 denise.eckstein 1.1 Specifies that the operation (get, set, unset, or list) be performed on the
224 planned configuration properties. For set and
225 unset operations, operates on the value of the specified property in the
226 planned configuration file if the CIM Server is not running.
|
227 a.arora 1.2 .TP
228 .B \-d
|
229 denise.eckstein 1.1 Specifies that the get operation be performed on the default configuration
230 properties. Returns an error when the CIM Server is not running.
231 .RE
|
232 a.arora 1.2 .PP
|
233 denise.eckstein 1.1 If no options are specified,
234 .B cimconfig
235 displays a usage message.
|
236 a.arora 1.2 .SH "EXIT STATUS"
237 .PP
|
238 denise.eckstein 1.1 When an error occurs, an
239 error message is written to stderr and an error value of 1 is returned. The
240 following return values are returned:
241 .RS
|
242 a.arora 1.2 .TP
|
243 denise.eckstein 1.1 .B 0
244 Successful completion
245 .PD 0
|
246 a.arora 1.2 .TP
|
247 denise.eckstein 1.1 .B 1
248 Error
249 .PD
250 .RE
|
251 a.arora 1.2 .SH "EXAMPLES"
252 .PP
|
253 denise.eckstein 1.1 Get the current value for the configuration property
254 .B shutdownTimeout .
|
255 a.arora 1.2 .IP
256 .B cimconfig \-g shutdownTimeout \-c
257 .PP
|
258 denise.eckstein 1.1 Get the planned value for the configuration property
259 .B shutdownTimeout .
|
260 a.arora 1.2 .IP
261 .B cimconfig \-g shutdownTimeout \-p
262 .PP
|
263 denise.eckstein 1.1 Get the default value for the configuration property
264 .B shutdownTimeout .
|
265 a.arora 1.2 .IP
266 .B cimconfig \-g shutdownTimeout \-d
267 .PP
|
268 denise.eckstein 1.1 Set the current value of the property
269 .B shutdownTimeout
270 to the new value 15.
|
271 a.arora 1.2 .IP
272 .B cimconfig \-s shutdownTimeout=15 \-c
273 .PP
|
274 denise.eckstein 1.1 Set the planned value of the property
275 .B shutdownTimeout ,
276 to the new value 5.
|
277 a.arora 1.2 .IP
278 .B cimconfig \-s shutdownTimeout=5 \-p
279 .PP
|
280 denise.eckstein 1.1 Reset the current value of the property
281 .B shutdownTimeout
282 to its default value.
|
283 a.arora 1.2 .IP
284 .B cimconfig \-u shutdownTimeout \-c
285 .PP
|
286 denise.eckstein 1.1 Reset the planned value of the property
287 .B shutdownTimeout
288 to its default value.
|
289 a.arora 1.2 .IP
290 .B cimconfig \-u shutdownTimeout \-p
291 .PP
|
292 denise.eckstein 1.1 List all the current configuration property names.
|
293 a.arora 1.2 .IP
294 .B cimconfig \-l
295 .PP
|
296 denise.eckstein 1.1 List all the current configuration property names and their values.
|
297 a.arora 1.2 .IP
298 .B cimconfig \-l \-c
299 .PP
|
300 denise.eckstein 1.1 List all the planned configuration property names and their values.
|
301 a.arora 1.2 .IP
302 .B cimconfig \-l \-p
303 .SH "FILES"
|
304 denise.eckstein 1.1 .TP 30
305 .PD 0
|
306 a.arora 1.2 .B /var/opt/tog\-pegasus/cimserver_current.conf
|
307 denise.eckstein 1.1 Current configuration
|
308 a.arora 1.2 .TP
309 .B /var/opt/tog\-pegasus/cimserver_planned.conf
|
310 denise.eckstein 1.1 Planned configuration
311 .PD
|
312 a.arora 1.2 .SH "SEE ALSO"
313 .PP
|
314 denise.eckstein 1.1 cimserver (8), cimauth (8).
|