1cimprovider(1)                                                  cimprovider(1)
2
3
4

NAME

6       cimprovider  -  disable, enable, remove , group, list or display status
7       of registered CIM providers or CIM provider modules
8

SYNOPSIS

10       cimprovider -d -m module
11
12       cimprovider -e -m module
13
14       cimprovider -r -m module [ -p provider ]
15
16       cimprovider -g group -m module
17
18       cimprovider -l  [ -s | -f | -m module ]
19
20       cimprovider -h
21
22       cimprovider --help
23
24       cimprovider --version
25
26
27   Remarks
28       The -l option for this command can be  executed  by  any  user(s).  All
29       other options require superuser permissions.
30
31       This  command  disables, enables, or removes one CIM provider module or
32       CIM provider at a time.
33

DESCRIPTION

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
42       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
46       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
51       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
55       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
61       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
67       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
72       The following provider module status values are defined:
73
74       OK             The provider module is enabled.
75
76       Stopping       The provider module is in the process of being disabled.
77
78       Stopped        The provider module is disabled.
79
80       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
85       Error          An invalid registration instance  was  encountered  upon
86                      CIM Server initialization.
87
88       Specifying no options with the cimprovider command displays the command
89       usage.
90
91   Options
92       The cimprovider command recognizes the following options:
93
94              -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
99              -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
105              -h, --help     Display command usage information.
106
107              -l             Displays all the registered provider modules.
108
109              -m module      Specifies the provider module for the operation.
110
111              -p provider    Specifies the provider for the operation.
112
113              -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
119              -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
130              -s             Displays the status of provider modules.
131
132              -f             Displays the full status of provider modules with
133                             group name.
134
135              --version      Display CIM Server version number.
136

EXIT STATUS

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
141              0      Successful completion
142              1      Error
143

USAGE NOTES

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

EXAMPLES

150       Disable provider module "OperatingSystemProvider" and all of  its  con‐
151       tained providers (placing them in a stopped state).
152
153              cimprovider -d -m OperatingSystemProvider
154
155       Enable  provider  module  "OperatingSystemProvider" and all of its con‐
156       tained providers (placing them in an OK state).
157
158              cimprovider -e -m OperatingSystemProvider
159
160       Remove (un-register) the "OperatingSystemProvider" provider module  and
161       all of its contained providers.
162
163              cimprovider -r -m OperatingSystemProvider
164
165       Remove  (un-register) the "PG_OperatingSystemProvider" provider that is
166       contained in the "OperatingSystemProvider" provider module.
167
168              cimprovider -r -m OperatingSystemProvider -p PG_OperatingSystem‐
169              Provider
170
171       List the registered provider modules.
172
173              cimprovider -l
174
175       List  the  registered  provider  modules  and their status (such as OK,
176       Stopping, Stopped).
177
178              cimprovider -l -s
179
180       List the registered providers which are contained in the "OperatingSys‐
181       temProvider" provider module.
182
183              cimprovider -l -m OperatingSystemProvider
184
185       Set  the group name of the "OperatingSystemProvider" provider module to
186       "CIMServer".
187
188              cimprovider -g CIMServer -m OperatingSystemProvider
189
190       Remove "OperatingSystemProvider" provider module from grouping.
191
192              cimprovider -g "" -m OperatingSystemProvider
193

SEE ALSO

195       cimmof(1), cimserver(1).
196
197
198
199                                                                cimprovider(1)
Impressum