serverroot

The install root of the ASP Server.

Warning: DO NOT change this parameter.

serverlib

ASP Server libraries.

Warning: DO NOT change this parameter.

caspd_pid

(optional)

The name and location of the process ID (PID) file for the Sun ONE ASP daemon.

license

The absolute path name of the directory containing the Sun ONE ASP license file.

maxprocesses (1 to 20)

The maximum number of ASP Server threads that are used to process pending ASP requests. The number specified can be between 1 and 20. I/O-heavy scripts run better with more processes.

inherit_user (1/0)

This setting enables you to specify the security mode under which the ASP Server runs, and can have a serious impact on the security of your server, especially if you are running Sun ONE Web Server.

When inherit_user=1 (Inherit User Security mode), the ASP Server runs with the permissions of the Apache Web server or the virtual host defined in the Apache Web server’s httpd.conf file. This is the case even if a different user and group is specified in the [default machine] section of casp.cnfg. This mode is available only for Sun ONE ASP running with the Apache Web server (for Sun ONE Web server, see below).

When inherit_user=0 (Defined User Security mode), the ASP Server runs with the permissions of the user who started the ASP Server, unless a different user and group is specified in casp.cnfg. This mode is available for both the Apache and Sun ONE Web servers.

Warning: When inherit_user=0 and no user and group is specified in the [default machine] section of casp.cnfg, the ASP Server runs as root. This can create a security risk for your server. Do not set inherit_user=0 unless you also define a user and group for the ASP Server to run under.

For more information about the security modes and their implications, see Setting the Security Mode.

user

(optional)

The username for the account under which the ASP Server runs. Make sure that this user has permission to open Sun ONE ASP configuration files such as casp.cnfg and odbc.ini. The user starting the ASP Server by using caspctrl must have root permissions. If this attribute is not present and inherit_user=0, the ASP Server runs under the account of the user who started the ASP Server.

Note: To start the ASP Server under a non-root user account, do the following:

- chmod otw [C-ASP_INSTALL_DIR]/asp-server-####

- chmod otw [C-ASP_INSTALL_DIR]/asp-server-   ####/casp.cnfg

- chmod otr [C-ASP_INSTALL_DIR]/asp-server-   ####/odbc.ini

These steps are required for ADO functionality.

group

(optional)

The group name for the account under which the ASP Server runs. Make sure that this group has permission to open Sun ONE ASP configuration files such as casp.cnfg and odbc.ini. The user starting the ASP Server by using caspctrl must have greater permissions than this group. If this attribute is not present and inherit_user=0, the ASP Server runs under the account of the user who started the ASP Server.

See the note pertaining to non-root user accounts under the user parameter (above).

asplogfile

(optional)

The full file path for where ASP errors will be logged.

enablemonitoring (yes/no)

Yes, the default, enables creation of performance counter log files, as follows:

/tmp/.casp[PORT]/chili-psm

/tmp/.casp[PORT]/.pm-chili-psm

/tmp/.pm-chili-psm

/tmp/chili-psm

These files are created with permissions that might not be appropriate in a shared Web hosting environment.

No disables performance monitoring and the creation of these files.

javasupport (yes/no)

Yes (the default) enables Java support, which is required for the Sun ONE ASP Chili!Beans wrapper, and for XML and ASP servlet interface functionality. No disables Java support. Because Java support can affect server performance, it is a good idea to enable it only when using Chili!Beans.

codepage

The value for the code page associated with the specified locale (LCID).

lcid

The value for the specified geographic locale (LCID).

javasecurity manager (yes/no)

Yes, the default, enables the Java virtual machine Security Manager. No disables it. For security reasons, the Java virtual machine Security Manager should be enabled in multi-user environments in which users supply their own Java classes.

JavaUserClsPath

(optional)

Specifies additional paths to look for Java classes. Full directory paths can be separated by semicolons (;).