pegasus/rpm/manLinux/man8.Z/cimconfig.8 - annotate

Return to cimconfig.8 CVS log

Up to [Pegasus] / pegasus / rpm / manLinux / man8.Z

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

No CVS admin address has been configured