version 1.1, 2004/08/27 04:55:12
|
version 1.2, 2004/12/07 16:03:46
|
|
|
.\" $Header$ | .\" $Header$ |
.TA c \" lowercase initial leter of .TH name |
.\" .TA c \" lowercase initial leter of .TH name |
.TH cimconfig 8 |
.TH "cimconfig" "8" "" "" "" |
.SH NAME |
.SH "NAME" |
cimconfig - get, set, unset, or list CIM Server configuration properties |
cimconfig \- get, set, unset, or list CIM Server configuration properties |
.SH SYNOPSIS |
.SH "SYNOPSIS" |
|
\fBcimconfig\fP \fB\-g\fP name [ \fB\-c\fP ] [ \fB\-d\fP ] [ \fB\-p\fP ] |
| |
\fBcimconfig\fP \fB-g\fP configuration_property [ \fB-c\fP ] [ \fB-p\fP ] [ \fB-d\fP ] |
\fBcimconfig\fP \fB\-s\fP name=value [ \fB\-c\fP ] [ \fB\-p\fP ] |
| |
\fBcimconfig\fP |
\fBcimconfig\fP \fB\-u\fP name [ \fB\-c\fP ] [ \fB\-p\fP ] |
\fB-s\fP configuration_property=value |
|
[ \fB-c\fP ] |
|
[ \fB-p\fP ] |
|
| |
\fBcimconfig\fP |
\fBcimconfig\fP \fB\-l\fP [ \fB\-c\fP | \fB\-p\fP ] |
\fB-u\fP configuration_property |
|
[ \fB-c\fP ] |
|
[ \fB-p\fP ] |
|
| |
.B cimconfig |
\fBcimconfig\fP \fB\-h\fP |
.B -l |
|
[ \fB-c\fP |
\fBcimconfig\fP \fB\-\-help\fP |
| \fB-p\fP ] |
|
.SH DESCRIPTION |
\fBcimconfig\fP \fB\-\-version\fP |
|
|
|
.SH "DESCRIPTION" |
.PP | .PP |
The | The |
.B cimconfig | .B cimconfig |
|
|
.B shutdownTimeout | .B shutdownTimeout |
.IP | .IP |
.BR Description: " When a | .BR Description: " When a |
.B cimserver -s |
.B cimserver \-s |
shutdown command is | shutdown command is |
issued, specifies the maximum time in seconds for the CIM Server to complete | issued, specifies the maximum time in seconds for the CIM Server to complete |
outstanding CIM operation requests before shutting down; if the specified | outstanding CIM operation requests before shutting down; if the specified |
|
|
properties are set to | properties are set to |
.B False , | .B False , |
neither HTTP nor HTTPS connections will be allowed, and the CIM Server will be | neither HTTP nor HTTPS connections will be allowed, and the CIM Server will be |
shut down and disabled from automatically being re-started. |
shut down and disabled from automatically being re\-started. |
.PP | .PP |
The current and planned | The current and planned |
values of the configuration properties are stored in the files | values of the configuration properties are stored in the files |
.B /var/opt/tog-pegasus/cimserver_current.conf |
.B /var/opt/tog\-pegasus/cimserver_current.conf |
and | and |
.B /var/opt/tog-pegasus/cimserver_planned.conf , |
.B /var/opt/tog\-pegasus/cimserver_planned.conf , |
respectively. The configuration | respectively. The configuration |
properties may only be modified via the | properties may only be modified via the |
.B cimconfig | .B cimconfig |
|
|
command recognizes the following options: | command recognizes the following options: |
.RS | .RS |
.TP 15 | .TP 15 |
\fB-g\fP configuration_property |
\fB\-g\fP configuration_property |
Gets the specified value (current, planned and/or default) of the specified | Gets the specified value (current, planned and/or default) of the specified |
configuration property. By default, gets the current value. | configuration property. By default, gets the current value. |
.TP | .TP |
\fB-s\fP configuration_property = value |
\fB\-s\fP configuration_property = value |
Sets the specified value (current and/or planned) of the specified configuration | Sets the specified value (current and/or planned) of the specified configuration |
property to | property to |
.IR value . | .IR value . |
By default, sets the current value. | By default, sets the current value. |
.TP | .TP |
\fB-u\fP configuration_property |
\fB\-u\fP configuration_property |
Unsets the specified | Unsets the specified |
value (current and/or planned) of the specified configuration property, and | value (current and/or planned) of the specified configuration property, and |
resets it to its default value. By | resets it to its default value. By |
default, unsets the current value and resets it to its default value. | default, unsets the current value and resets it to its default value. |
.TP | .TP |
.B -l |
.B \-l |
Lists all the specified (current or planned) configuration property name and | Lists all the specified (current or planned) configuration property name and |
value pairs in the CIM Server. By default, | value pairs in the CIM Server. By default, |
lists only the names of all the current configuration properties. | lists only the names of all the current configuration properties. |
.TP | .TP |
.B -c |
.B \-c |
Specifies that the operation (get, set, unset, or list) be performed on the | Specifies that the operation (get, set, unset, or list) be performed on the |
current configuration properties. For set or | current configuration properties. For set or |
unset operations, returns an error when the CIM Server is not running or the | unset operations, returns an error when the CIM Server is not running or the |
specified property is not a dynamic property. | specified property is not a dynamic property. |
.TP | .TP |
.B -p |
.B \-p |
Specifies that the operation (get, set, unset, or list) be performed on the | Specifies that the operation (get, set, unset, or list) be performed on the |
planned configuration properties. For set and | planned configuration properties. For set and |
unset operations, operates on the value of the specified property in the | unset operations, operates on the value of the specified property in the |
planned configuration file if the CIM Server is not running. | planned configuration file if the CIM Server is not running. |
.TP | .TP |
.B -d |
.B \-d |
Specifies that the get operation be performed on the default configuration | Specifies that the get operation be performed on the default configuration |
properties. Returns an error when the CIM Server is not running. | properties. Returns an error when the CIM Server is not running. |
.RE | .RE |
|
|
If no options are specified, | If no options are specified, |
.B cimconfig | .B cimconfig |
displays a usage message. | displays a usage message. |
.SH EXIT STATUS |
.SH "EXIT STATUS" |
.PP | .PP |
When an error occurs, an | When an error occurs, an |
error message is written to stderr and an error value of 1 is returned. The | error message is written to stderr and an error value of 1 is returned. The |
|
|
Error | Error |
.PD | .PD |
.RE | .RE |
.SH EXAMPLES |
.SH "EXAMPLES" |
.PP | .PP |
Get the current value for the configuration property | Get the current value for the configuration property |
.B shutdownTimeout . | .B shutdownTimeout . |
.IP | .IP |
.B cimconfig -g shutdownTimeout -c |
.B cimconfig \-g shutdownTimeout \-c |
.PP | .PP |
Get the planned value for the configuration property | Get the planned value for the configuration property |
.B shutdownTimeout . | .B shutdownTimeout . |
.IP | .IP |
.B cimconfig -g shutdownTimeout -p |
.B cimconfig \-g shutdownTimeout \-p |
.PP | .PP |
Get the default value for the configuration property | Get the default value for the configuration property |
.B shutdownTimeout . | .B shutdownTimeout . |
.IP | .IP |
.B cimconfig -g shutdownTimeout -d |
.B cimconfig \-g shutdownTimeout \-d |
.PP | .PP |
Set the current value of the property | Set the current value of the property |
.B shutdownTimeout | .B shutdownTimeout |
to the new value 15. | to the new value 15. |
.IP | .IP |
.B cimconfig -s shutdownTimeout=15 -c |
.B cimconfig \-s shutdownTimeout=15 \-c |
.PP | .PP |
Set the planned value of the property | Set the planned value of the property |
.B shutdownTimeout , | .B shutdownTimeout , |
to the new value 5. | to the new value 5. |
.IP | .IP |
.B cimconfig -s shutdownTimeout=5 -p |
.B cimconfig \-s shutdownTimeout=5 \-p |
.PP | .PP |
Reset the current value of the property | Reset the current value of the property |
.B shutdownTimeout | .B shutdownTimeout |
to its default value. | to its default value. |
.IP | .IP |
.B cimconfig -u shutdownTimeout -c |
.B cimconfig \-u shutdownTimeout \-c |
.PP | .PP |
Reset the planned value of the property | Reset the planned value of the property |
.B shutdownTimeout | .B shutdownTimeout |
to its default value. | to its default value. |
.IP | .IP |
.B cimconfig -u shutdownTimeout -p |
.B cimconfig \-u shutdownTimeout \-p |
.PP | .PP |
List all the current configuration property names. | List all the current configuration property names. |
.IP | .IP |
.B cimconfig -l |
.B cimconfig \-l |
.PP | .PP |
List all the current configuration property names and their values. | List all the current configuration property names and their values. |
.IP | .IP |
.B cimconfig -l -c |
.B cimconfig \-l \-c |
.PP | .PP |
List all the planned configuration property names and their values. | List all the planned configuration property names and their values. |
.IP | .IP |
.B cimconfig -l -p |
.B cimconfig \-l \-p |
.SH FILES |
.SH "FILES" |
.TP 30 | .TP 30 |
.PD 0 | .PD 0 |
.B /var/opt/tog-pegasus/cimserver_current.conf |
.B /var/opt/tog\-pegasus/cimserver_current.conf |
Current configuration | Current configuration |
.TP | .TP |
.B /var/opt/tog-pegasus/cimserver_planned.conf |
.B /var/opt/tog\-pegasus/cimserver_planned.conf |
Planned configuration | Planned configuration |
.PD | .PD |
.SH SEE ALSO |
.SH "SEE ALSO" |
.PP | .PP |
cimserver (8), cimauth (8). | cimserver (8), cimauth (8). |