image\cslogo3d1.gif

Changing ASP Server Settings

The Chili!Soft ASP Administration Console Server Settings page provides access to the basic configuration settings for the ASP Server. To change these settings, use the following procedure.

Note

In order for these changes to take effect, you must restart the ASP Server. Restarting the ASP Server resets all Session and Application variables.

To change ASP Server settings

1.   If necessary, open the Administration Console by using the following URL:

http://[HOSTNAME]:[PORT]

where [HOSTNAME] is the hostname of your Web server and [PORT] is the port on which the Administration Console is running (5100 by default).

13.   On the ASP Server tab of the Server Management page (the first page to appear when you open the console), click Settings.

image\settings_c.gif

The Server Settings page displays.

image\server_settings.gif

14.   Configure the settings you want, as described in the following table.

15.   When finished, click Save to save your changes.

– or –

Click Cancel to revert to the last settings that were saved.

The Server Management page displays.

16.   Restart the ASP Server by clicking Restart.

ASP Server Setting

Explanation

Scripts buffering on

Yes enables scripts buffering, so that the ASP Server processes an entire ASP page before returning its HTML output to the browser. This yields better server performance. No disables scripts buffering, so that the ASP Server returns the HTML output for an ASP page to the browser incrementally, as soon as the HTML is processed. This makes debugging easier. This setting is yes by default. For more information, see "Enabling Scripts Buffering" in this chapter.

Session timeout

This specifies the number of minutes that the ASP Server maintains a user’s session information since the last page request. When a user does not submit a page request for the specified length of time, the server cancels the session and discards its information. If a value for SessionTimeout is specified in the script, it overrides this setting. This setting is 20 minutes by default. For more information, see "Changing the Session Timeout Value" in this chapter.

Script timeout

This specifies the number of seconds the ASP Server waits for a page to finish processing before it cancels the page request. A value for ScriptTimeout specified in a script is used only if it is higher than this value. This setting is 90 seconds by default. For more information, see "Changing the Script Timeout Value" in this chapter.

Allow session state

This specifies whether or not the ASP Server maintains session state. This setting must be enabled (yes) in order for Session objects in scripts to function. This setting is yes by default. For more information, see "Enabling Session State" in this chapter.

Cache Scripts

Yes enables ASP scripts to be cached in memory, so ASP page s are served faster, and no disables caching, which reduces the system memory used by the server. This setting is yes by default. For more information, see "Enabling Script Caching" in this chapter.

ASP errors logging file

To enable logging for the ASP Server and specify the location of the log file, type the absolute path name of the log file in this text box. Chili!Soft ASP creates the log file in the directory you specify. You cannot give the log file the same name as a file that already exists in that directory. If the ASP errors logging file text box is empty (the default), no logging is performed. For more information, see "Enabling ASP Error Logging" in this chapter.

ASP engine mode

This specifies the mode in which the ASP Server runs: multi-process or multi-threaded. This setting is Multi-threaded by default. For more information, see "Running in Multi-process Mode" and "Running in Multi-threaded Mode" in this chapter. Linux does not support multi-process mode. This feature is not available for the Linux or Cobalt versions of Chili!Soft ASP.

Number of threads

-or-

Number of processes

Depending on the engine mode in which the ASP Server is running, this specifies the number of simultaneous threads or processes the ASP Server handles. The number of threads is 5 by default. If you have many ASP pages that include blocking operations (e.g., database access) it is best to increase this number. However, keep in mind that doing this also increases system overhead. For more information, see "Running in Multi-process Mode" and "Running in Multi-threaded Mode" in this chapter.

Application variables

This setting is ignored in multi-threaded mode. In multi-process mode, this setting is Read-Only by default. When set to Read-Only, application-level variables cannot be set or modified once the global.asa file has been read. When set to Read/Write, application-level variables can be set or modified; however, the ASP Server can become unstable under heavy stress. For more information, see "Running in Multi-process Mode" in this chapter. Linux does not support multi-process mode. This feature is not available for the Linux or Cobalt versions of Chili!Soft ASP 3.6.

Inherit user security

When Inherit user security is set to yes, the ASP Server runs with the permissions of the Apache Web Server or the Virtual Host defined in the Apache Web Server httpd.conf file. This is the default security mode for Chili!Soft ASP. However, if you are running a Netscape or Zeus Web server, be sure to read the security note that follows.

When Inherit user security is set to no, the ASP Server runs with the permissions of the user who started the ASP Server, unless a different user or group is specified in the Chili!Soft ASP configuration file, casp.cnfg. This can create a security risk for your server. If you change Inherit user security to no, be sure to specify a user or group in casp.cnfg, as described in "Editing the Chili!Soft Configuration File" in Chapter 3: Managing Chili!Soft ASP."

Important Security Note about Netscape and Zeus Web Servers

Netscape and Zeus Web servers do not support Inherit user security mode, even when it is configured in the Administration Console. To protect the security of your server, when running Chili!Soft ASP with these Web servers, you should take the following steps:

- Set Inherit user security to no in the Administration Console.

- Specify a user or group in the casp.cnfg file, as described in "Editing the Chili!Soft Configuration File" in Chapter 3: Managing Chili!Soft ASP." The ASP Server then runs with the permissions of that user or group.

For more information, see "Securing the Server" in this chapter.

Enable Java support

Yes enables Java support for this ASP Server, which is required for Chili!Beans. To reduce system overhead, do not enable Java support unless you are using Chili!Beans. This setting is no by default. For more information, see "Enabling Java Support" in this chapter. Chili!Beans are not available for Cobalt systems.

Locale

This specifies the locale setting. The ASP Server uses the appropriate code page for the language associated with the locale specified here. It also correctly formats dates, numbers, and currency according to the locale. For more information, see "Configuring International Support" in this chapter. (Supported locales are US English, British English, Dutch, French, German, Japanese Shift-JIS, Spanish, and Swedish.)

Copyright 2001 Sun Microsystems, Inc. All rights reserved. Legal Notice.