set-cgi-prop <connect_options> [--echo|-e] [--no-prompt|-Q] [--verbose|-v] [--vs|-s vs-name] [--uri-pattern|-t pattern] --config|-c config-name (propertyname=value)+
Use this command to edit the common gateway interface (CGI) properties. CGI programs can be defined with any number of programming languages. The properties that you can edit are as follows:
If you specify the --config option, you can view the following properties:
timeout - The timeout (in seconds) after which the server will terminate a long-running CGI program. The range of values is 0.001-3600, or -1 for no timeout.
idle-timeout - The timeout (in seconds) after which the server will terminate a nonresponsive CGI program. The range of values is 0.001-3600.
cgistub-path - The path to the Cgistub binary. The default value is default.
cgistub-idle-timeout - The timeout (in seconds) after which an unused Cgistub process will be terminated. The range of values is 0.001-3600.
min-cgistubs - The minimum number of Cgistub processes the server will keep while waiting to run the CGI programs. The range of values is 1-4096.
max-cgistubs - The maximum number of Cgistub processes the server will keep on hand, waiting to run CGI programs. The range of values is 1-4096.
If you specify the --vs option, you can view the following properties:
user – The name of the user to execute the CGI programs.
group – The name of the group to execute the CGI programs.
chroot – The additional root directory that you create to limit the server to specific directories.
directory – The directory to change to after chroot but before the execution of the CGI program begins.
nice – The nice value is an increment that determines the priority of the CGI program's relative to the server. Typically, the server runs with a nice value of 0 and the nice increment would be between 0 (the CGI program runs at the same priority as the server) and 19 (the CGI program runs at a much lower priority than the server).
You can increase the priority of the CGI program above that of the server by specifying a nice increment of -1. Sun, however, does not recommended you to do so.
For connect_options description, see help(1).
Specify this option to print this command on the standard output before executing. This option also prints the default value for all the non-mandatory options that you do not provide in the command.
If you specify this option, wadm will not prompt you for passwords while executing this command. Use this option if you have defined all passwords in a password file and specified the file using the --password-file connect_option.
Specify this option to display a verbose output.
(This option is deprecated.) Specify the URI wildcard pattern.
Specify the name of the virtual server that resides within the same physical location as the Sun Java System Web Server.
Specify the name of the configuration.
wadm set-cgi-prop --user=admin --host=serverhost --password-file=../admin.passwd --port=8989 --ssl=true --no-prompt --rcfile=null --config=config1 timeout=10 max-cgistubs=20 idle-timeout=600 min-cgistubs=10 cgistub-idle-timeout=60 cgistub-path=../../lib/Cgistub
The following exit values are returned:
command executed successfully
error in executing the command