1cimconfig(8) cimconfig(8)
2
6 cimconfig - get, set, unset, or list CIM Server configuration proper‐
7 ties
8
10 cimconfig -g name [ -c ] [ -d ] [ -p ]
11 cimconfig -s name=value [ -c ] [ -p ]
13 cimconfig -u name [ -c ] [ -p ]
15 cimconfig -l [ -c | -p ]
17 cimconfig -h
19 cimconfig --help
21 cimconfig --version
23
26 The cimconfig command manages CIM Server configuration properties. The
27 operations are executed on the local host by submitting requests to the
28 CIM Server. An operation on a current configuration property takes
29 effect immediately, and an operation on a planned configuration prop‐
30 erty takes effect the next time the CIM Server is started with cim‐
31 server (8) . Modifications to a configuration property via cimconfig
32 remain in effect until changed via another cimconfig command. Configu‐
33 ration properties may also be modified temporarily via the cimserver
34 [1m(8) command, in which case, the modification of the configuration prop‐
35 erty remains in effect for that execution of the cimserver (8) command
36 only. A default value is associated with each configuration property.
37 Each configuration property is initially assigned its default value,
38 until modified by a cimconfig command or cimserver (8) command.
39 Dynamic configuration properties are those whose current values may be
40 set while the CIM server is running.
41 The following configuration properties are available:
43 enableAssociationTraversal
45 Description: If True, the CIM Server will support the four asso‐
47 ciation traversal operators: Associators, AssociatorNames, Ref‐
48 erences, and ReferenceNames.
49 Default Value: True
50 Dynamic: No
51 enableIndicationService
53 Description: If True, the CIM Server will support CIM Indica‐
55 tions.
56 Default Value: True
57 Dynamic: No
58 enableHttpConnection
60 Description: If True, allows connections to the CIM Server using
62 the HTTP protocol
63 Default Value: False
64 Dynamic: No
65 enableHttpsConnection
67 Description: If True, allows connections to the CIM Server using
69 the HTTPS protocol (HTTP using Secure Socket Layer encryption)
70 Default Value: True
71 Dynamic: No
72 enableNamespaceAuthorization
74 Description: If True, the CIM Server restricts access to names‐
76 paces based on configured user authorizations [user authoriza‐
77 tions may be configured using cimauth (8) ]
78 Default Value: False
79 Dynamic: No
80 enableRemotePrivilegedUserAccess
82 Description: If True, the CIM Server allows access by a privi‐
84 leged user from a remote system
85 Default Value: True
86 Dynamic: No
87 enableSubscriptionsForNonprivilegedUsers
89 Description: If True, nonprivileged user of the system will be
91 allowed to create Indication Subscription, otherwise privileged
92 access is required.
93 Default Value: True
94 Dynamic: No
95 logLevel
97 Description: Defines the desired level of logging. Valid values
99 include: TRACE, INFORMATION, WARNING, SEVERE, FATAL
100 Default Value: INFORMATION
101 Dynamic: Yes
102 shutdownTimeout
104 Description: When a cimserver -s shutdown command is issued,
106 specifies the maximum time in seconds for the CIM Server to com‐
107 plete outstanding CIM operation requests before shutting down;
108 if the specified timeout period expires, the CIM Server will
109 shut down, even if there are still CIM operations in progress.
110 Minimum value is 2 seconds.
111 Default Value: 10
112 Dynamic: No
113 If both the enableHttpsConnection and enableHttpConnection properties
115 are set to False , neither HTTP nor HTTPS connections will be allowed.
116 On some platforms, the OpenPegasus CIM Server has been enhanced to
117 include support for a local (single system), non-standard protocol.
118 This allows the OpenPegasus CIM Server to continue to receive and
119 process requests from local OpenPegasus CIM Clients even if both HTTP
120 ports are disabled. If a local protocol is not supported, the CIM
121 Server will be shut down and disabled from automatically being
122 re-started.
123 The current and planned values of the configuration properties are
125 stored in the files /var/opt/tog-pegasus/cimserver_current.conf and
126 /var/opt/tog-pegasus/cimserver_planned.conf , respectively. The con‐
127 figuration properties may only be modified via the cimconfig and cim‐
128 server (8) commands; the files must not be edited directly.
129 Options
131 The cimconfig command recognizes the following options:
132 -g configuration_property
134 Gets the specified value (current, planned and/or
135 default) of the specified configuration property.
136 By default, gets the current value.
137 -s configuration_property = value
139 Sets the specified value (current and/or planned)
140 of the specified configuration property to R
141 value . By default, sets the current value.
142 -u configuration_property
144 Unsets the specified value (current and/or
145 planned) of the specified configuration property,
146 and resets it to its default value. By default,
147 unsets the current value and resets it to its
148 default value.
149 -l Lists all the specified (current or planned) con‐
151 figuration property name and value pairs in the
152 CIM Server. By default, lists only the names of
153 all the current configuration properties.
154 -c Specifies that the operation (get, set, unset, or
156 list) be performed on the current configuration
157 properties. For set or unset operations, returns
158 an error when the CIM Server is not running or
159 the specified property is not a dynamic property.
160 -p Specifies that the operation (get, set, unset, or
162 list) be performed on the planned configuration
163 properties. For set and unset operations, oper‐
164 ates on the value of the specified property in
165 the planned configuration file if the CIM Server
166 is not running.
167 -d Specifies that the get operation be performed on
169 the default configuration properties. Returns an
170 error when the CIM Server is not running.
171 If no options are specified, cimconfig displays a usage message.
173
175 When an error occurs, an error message is written to stderr and an
176 error value of 1 is returned. The following return values are returned:
177 0 Successful completion
179 1 Error
180
182 Get the current value for the configuration property shutdownTimeout .
183 cimconfig -g shutdownTimeout -c
185 Get the planned value for the configuration property shutdownTimeout .
187 cimconfig -g shutdownTimeout -p
189 Get the default value for the configuration property shutdownTimeout .
191 cimconfig -g shutdownTimeout -d
193 Set the current value of the property shutdownTimeout to the new value
195 15.
196 cimconfig -s shutdownTimeout=15 -c
198 Set the planned value of the property shutdownTimeout , to the new
200 value 5.
201 cimconfig -s shutdownTimeout=5 -p
203 Reset the current value of the property shutdownTimeout to its default
205 value.
206 cimconfig -u shutdownTimeout -c
208 Reset the planned value of the property shutdownTimeout to its default
210 value.
211 cimconfig -u shutdownTimeout -p
213 List all the current configuration property names.
215 cimconfig -l
217 List all the current configuration property names and their values.
219 cimconfig -l -c
221 List all the planned configuration property names and their values.
223 cimconfig -l -p
225
227 /var/opt/tog-pegasus/cimserver_current.conf
228 Current configuration
229 /var/opt/tog-pegasus/cimserver_planned.conf
230 Planned configuration
231
233 cimserver (8), cimauth (8).
234 cimconfig(8)