Administrator's Guide

APPENDIX A

The httpd.props File

This appendix describes the httpd.props file and has these sections:

 
Top of page

About the httpd.props file

The Novell exteNd Application Server maintains most of its properties in the internal AgProperties system table (for more information, see System Tables and URLs). You set these properties using the SMC or the Administration API (you don't access AgProperties directly).

However, some properties are needed at server startup time and are therefore stored externally so they are available when the server starts. These properties are stored in the httpd.props configuration file, which is located in the server's \Resources directory. You can change these settings either by modifying the httpd.props file or by using the SMC, which updates the httpd.props file when the change is saved.

NOTE:   Whenever possible, it is best to make changes in the SMC rather than directly in the httpd.props file.

IMPORTANT:   Always stop the server before editing the file. You can use the Stop button in the SMC. For more information, see Shutting down the application server.

 
Top of page

Server properties

The following properties appear in the default httpd.props file and are listed in alphabetical order. (There are additional httpd.props properties that are optional and rarely used. They do not appear in the following table, but are described in the appropriate sections of the documentation.) All properties are case-sensitive.

NOTE:   All property names begin with http-server.

Property/panel in SMC where settable

Description/default

com.sssw.db.dbplatforms

NOTE:   Not settable in SMC or API

Database platforms configuration file location

Default: \\Resources\\platforms.dbl in the server's installation directory

NOTE:   Do not change this value.

com.sssw.orb.orbkey

SMC: Configuration/General

ORB to use

Default: ObjectEra_Jbroker

com.sssw.orb.orbplatforms

NOTE:   Not settable in SMC or API

ORB platforms configuration file

Default: \\Resources\\orbs.dbl in the server's installation directory

NOTE:   Do not change this value.

com.sssw.srv.agent.debug

SMC: Configuration/Advanced/Debug

Prints information about the execution of each running Web application. The number assigned (1-5) represents the level of verbosity for the messages. Enter 0 to disable.

For more information    See Low-level debugging.

Default: 0

com.sssw.srv.filecache.dir

NOTE:   Not settable in the SMC

Specifies the location of the filecache directory. The filecache directory contains the JAR files that the J2EE classloader is serving plus the contents of all WAR files.

The default value is the \filecache directory in the application server's install directory.

com.sssw.srv.loader.debug

SMC: Configuration/Advanced/Debug

Prints information about the execution of each ClassLoader. The number assigned (1-5) represents the level of verbosity for the messages. Enter 0 to disable.

For more information    See Low-level debugging.

Default: 0

com.sssw.srv.client.debug

SMC: Configuration/Advanced/Debug

Prints debug messages for client connections to the server console. The number assigned (1-5) represents the level of verbosity for the messages. Enter 0 to disable.

For more information    See Low-level debugging.

Default: 0

com.sssw.srv.ContentCache.Disk. Directory

NOTE:   Not settable in SMC or API

Location of content cache

Default: \\temp\\ContentCache in the server's installation directory

com.sssw.srv.http.authHeaderRealm

SMC:Security/General

A String that will be displayed as the security realm in a server login dialog. This value is also passed on the WWW-Authenticate response header sent to the client.

Requires a server reboot.

Default: Novell exteNd Application Server

com.sssw.srv.http.listen_admin

com.sssw.srv.http.listen_rt

SMC: Configuration/General

Whether the server listens on any or all of the HTTP administration or runtime ports. Default is true, meaning that the server listens on the HTTP port. False means that the server will not listen on the HTTP port.

For more information    See Setting up separate ports.

Default: true

com.sssw.srv.http.webmaster

SMC: Configuration/General

SilverMaster data source name

Default: Set at installation

com.sssw.srv.https.listen_dsa_admin

com.sssw.srv.https.listen_dsa_rt

SMC: Security/Server Security

Whether the server listens on any or all of the HTTPS DSA administration or runtime ports

For more information    See Setting up separate ports.

Default: false

com.sssw.srv.https.listen_rsa_admin

com.sssw.srv.https.listen_rsa_rt

SMC: Security/Server Security

Whether the server listens on any or all of the administration or runtime HTTPS RSA ports

For more information    See Setting up separate ports.

Default: false

com.sssw.srv.https.port_dsa_admin

com.sssw.srv.https.port_dsa_rt

SMC: Security/Server Security

The HTTPS DSA administration and/or runtime port. At initialization time, the server will bind its accepting socket to the host it runs on and to the provided port. The server will use a DSA/Diffie-Hellman certificate and encryption algorithms for SSL on this port.

For more information    See Setting up separate ports.

Default: 444

com.sssw.srv.https.port_rsa_admin

com.sssw.srv.https.port_rsa_rt

SMC: Security/Server Security

The HTTPS RSA administration and/or runtime port. At initialization time, the server will bind its accepting socket to the host it runs on, and to the provided port. The server will use an RSA certificate and encryption algorithms for SSL on this port.

For more information    See Setting up separate ports.

Default: 443

com.sssw.srv.jms.debug

NOTE:   Not settable in SMC or API

Prints Novell exteNd JMS server-related debug messages to the server console. For basic debugging, specify 1. For deeper debugging, specify a number greater than 1. Specify 0 to disable.

For more information    See Running the JMS server.

Default: 0

com.sssw.srv.jmsServerLaunch

NOTE:   Not settable in SMC or API

Whether the application server tries to start the JMS server when starting up. To automatically start the JMS server, specify true. Otherwise, specify false.

When you install the application server, the installation program asks if you want to configure the JMS server and then sets this property according to your response.

For more information    See Running the JMS server.

Default: false (if jmsServerLaunch property is removed)

com.sssw.srv.loader.debug

NOTE:   Not settable in SMC

Whether to turn on ClassLoader-related debugging messages that display in the server console. Values range from 1 to 5; 5 gives the most detail. Enter 0 to disable.

Default: 0

com.sssw.srv.logger

SMC: Configuration/ General

The logging class

Default: com.sssw.srv.http.AgLogger

com.sssw.srv.logger.logging

SMC: Configuration/ General

Whether to log every standard HTTP client request to the server

Default: false

com.sssw.srv.logger.errlogging

SMC: Configuration/General

Whether to turn on error logging

Default: true

com.sssw.srv.logger.errorlogname

SMC: Configuration/General

The name of the error log file (if you are logging to a file)

Default: errlog

com.sssw.srv.logger.logname

SMC: Configuration/General

The name of the HTTP log file (if you are logging to a file)

Default: log

com.sssw.srv.logger.tracelogging

SMC: Configuration/General

Whether to turn on trace logging

Default: false

com.sssw.srv.logger.tracelogname

SMC: Configuration/General

The name of the trace file (if you are logging to a file)

Default: traces

com.sssw.srv.logger

SMC: Configuration/General

Java class to do the logging

Default: com.sssw.srv.http.AgLogger

com.sssw.srv.nameServicePort

SMC: Configuration/General

The port of the name service the server is using

Default: 54890

com.sssw.srv.port_admin

com.sssw.srv.port_rt

SMC: Configuration/General

Server HTTP administration and/or runtime port

For more information    See Setting up separate ports.

Default: 80

com.sssw.srv.server

NOTE:   Not settable in SMC or API

Application server protocol version

Default: exteNd Application Server/5.0

com.sssw.srv.sminit

NOTE:   Not settable in SMC or API

Location of internal sminit.props file, used by SilverMasterInit (do not edit this file)

Default: the server's \\Resources\\sminit.props

com.sssw.srv.sql.debug

SMC: Configuration/Advanced/Debug

Prints debug messages for SQL database calls to the server console. The number assigned (1-5) represents the level of verbosity for the messages. Enter 0 to disable.

Default: 0

com.sssw.srv.SupportNTLocalGroups

NOTE:   Not settable in SMC (settable as PROP_SUPPORT_NT_LOCAL_GROUPS in AgiAdmServer and AgiAdmCluster)

Whether the application server uses NT local groups for authentication

Default: true

For more information    See Speeding NT authentication.

com.sssw.srv.system.out.log.allowed

Whether the application server when run as an NT service will log output to System.out and System.err

Default: False

com.sssw.srv.system.out.log.file

The file to which the application server when run as an NT service will log output to System.out and System.err (if the property system.out.log.allowed is True)

Default: the server's \\temp\\SilverServerSysOut.txt

Jdbc.LDSKey

SMC: Configuration/Databases

JDBC driver for SilverMaster

Default: Set at installation

Jdbc.URL

SMC: Configuration/Databases

The database URL. The driver uses it to connect to the SilverMaster database. The URL is driver-specific. See your driver documentation for more information.

Default: Set at installation

Jdbc.URL.Attributes

SMC: Configuration/Databases

Any extra attributes to set for the JDBC driver. The syntax is driver-specific. See your driver documentation for more information.

Default: Set at installation


Copyright © 2003 Novell, Inc. All rights reserved. Copyright © 1997, 1998, 1999, 2000, 2001, 2002, 2003 SilverStream Software, LLC. All rights reserved.  more ...