1cimprovider(1) cimprovider(1)
2
6 cimprovider - disable, enable, remove , group, list or display status
7 of registered CIM providers or CIM provider modules
8
10 cimprovider -d -m module
11 cimprovider -e -m module
13 cimprovider -r -m module [ -p provider ]
15 cimprovider -g group -m module
17 cimprovider -l [ -s | -f | -m module ]
19 cimprovider -h
21 cimprovider --help
23 cimprovider --version
25 Remarks
28 The -l option for this command can be executed by any user(s). All
29 other options require superuser permissions.
30 This command disables, enables, or removes one CIM provider module or
32 CIM provider at a time.
33
35 The cimprovider command provides a command line interface to disable,
36 enable, unregister, group and list registered CIM providers. If a CIM
37 provider is disabled, the CIM Server rejects any requests to the
38 provider. If a CIM provider is enabled, the CIM Server forwards
39 requests to the provider. And if a CIM provider is unregistered, the
40 CIM Server will no longer have any information about the provider.
41 In order to use the cimprovider command, cimserver has to be running
43 and the specified provider module (a grouping of providers in the same
44 shared library) or provider has to be registered with WBEM Services.
45 The first form of cimprovider disables the specified provider module.
47 When a specified provider module is in the disabled state, any new
48 requests to the providers that are contained in the specified provider
49 module will be rejected.
50 The second form of cimprovider enables the providers that are contained
52 in the specified provider module. The providers that are contained in
53 the specified provider module are now ready to accept new requests.
54 The third form of cimprovider removes (un-registers) the specified
56 provider module and all of its contained providers or the specified
57 provider in the specified provider module. Once removed, a provider or
58 provider module must be re-registered (typically by loading its regis‐
59 tration schema via the cimmof command).
60 The fourth form of cimprovider sets the provider module group. If the
62 provider module is active, provider module is disabled first, group is
63 set and enabled again. If group name is CIMServer, provider module is
64 loaded into CIMServer process depending on UserContext value. Specify
65 empty string to remove from grouping.
66 The last form of cimprovider lists all the registered provider modules
68 and module status or all the providers in the specified provider mod‐
69 ule. To list all providers in all modules, issue a cimprovider -l com‐
70 mand, followed by cimprovider -l -m for each listed module.
71 The following provider module status values are defined:
73 OK The provider module is enabled.
75 Stopping The provider module is in the process of being disabled.
77 Stopped The provider module is disabled.
79 Degraded A failure was detected in an out-of-process provider
81 module. Disable and re-enable the provider module to
82 ensure any active indication subscriptions are being
83 served.
84 Error An invalid registration instance was encountered upon
86 CIM Server initialization.
87 Specifying no options with the cimprovider command displays the command
89 usage.
90 Options
92 The cimprovider command recognizes the following options:
93 -d Disables the specified CIM provider R module .
95 If user(s) try to disable a module that is
96 already disabled, an error message is returned
97 and no action is taken.
98 -e Enables the specified CIM provider R module . If
100 user(s) try to enable a module that is already
101 enabled or try to enable a module that is dis‐
102 abling, an error message is returned and no
103 action is taken.
104 -h, --help Display command usage information.
106 -l Displays all the registered provider modules.
108 -m module Specifies the provider module for the operation.
110 -p provider Specifies the provider for the operation.
112 -r Removes the specified provider module and all of
114 its contained providers. If provider is speci‐
115 fied, removes the specified provider in the spec‐
116 ified provider module (not affecting any other
117 providers in that module).
118 -g Sets the CIM provider module group. Specify
120 empty string to remove from grouping. If the
121 provider module is active, provider module is
122 disabled first, group is set and enabled again.
123 All provider modules with the same group name are
124 loaded into a single agent process except when
125 overridden by specific UserContext values. If
126 group name is CIMServer , provider module is
127 loaded into CIMServer process depending on User‐
128 Context value.
129 -s Displays the status of provider modules.
131 -f Displays the full status of provider modules with
133 group name.
134 --version Display CIM Server version number.
136
138 When an error occurs, an error message is written to stderr and an
139 error value 1 is returned. The following return values are returned:
140 0 Successful completion
142 1 Error
143
145 The cimprovider command requires that the CIM Server is running. If an
146 operation requires more than two minutes to be processed, the cim‐
147 provider command prints a timeout message and returns an error value.
148
150 Disable provider module "OperatingSystemProvider" and all of its con‐
151 tained providers (placing them in a stopped state).
152 cimprovider -d -m OperatingSystemProvider
154 Enable provider module "OperatingSystemProvider" and all of its con‐
156 tained providers (placing them in an OK state).
157 cimprovider -e -m OperatingSystemProvider
159 Remove (un-register) the "OperatingSystemProvider" provider module and
161 all of its contained providers.
162 cimprovider -r -m OperatingSystemProvider
164 Remove (un-register) the "PG_OperatingSystemProvider" provider that is
166 contained in the "OperatingSystemProvider" provider module.
167 cimprovider -r -m OperatingSystemProvider -p PG_OperatingSystem‐
169 Provider
170 List the registered provider modules.
172 cimprovider -l
174 List the registered provider modules and their status (such as OK,
176 Stopping, Stopped).
177 cimprovider -l -s
179 List the registered providers which are contained in the "OperatingSys‐
181 temProvider" provider module.
182 cimprovider -l -m OperatingSystemProvider
184 Set the group name of the "OperatingSystemProvider" provider module to
186 "CIMServer".
187 cimprovider -g CIMServer -m OperatingSystemProvider
189 Remove "OperatingSystemProvider" provider module from grouping.
191 cimprovider -g "" -m OperatingSystemProvider
193
195 cimmof(1), cimserver(1).
196 cimprovider(1)