Sun Java System Web Server 6.1 SP11 Administrator's Configuration File Reference

Appendix B Configuration Changes Between iPlanet Web Server 6.0 and Sun Java System Web Server 6.1

This chapter summarizes major configuration file changes between the 6.0 and the 6.1 version of Sun Java System Web Server. The following files are described:

magnus.conf

This section lists the magnus.conf-related changes in the following areas:

Init Functions

The magnus.conf file in SUN Java System Web Server 6.1 has acquired new Init SAFs as listed in the following table:

Table B–1 magnus.conf Init Functions


6.0 Function/Parameter	6.1 Function/Parameter	Comments
NSServletEarlyInit	(none)	Removed.
NSServletLateInit	(none)	Removed.
`nt-console-init`	`createconsole`	Removed. On Windows, you can configure the `createconsole` attribute of the LOG element to redirect stderr output to the console.

Directives

The magnus.conf file has lost directives to other configuration files and some directives supported by the magnus.conf file in previous releases are now deprecated. The following table summarizes the changes:

Table B–2 Changes in magnus.conf Directives


6.0 Directive	6.1 Value	Comments
`AdminLanguage`	(none)	Deprecated.
`AsyncDNS`	`AsyncDNS`	Ignored. Even if the value is set to `on`, the server does not perform asynchronous DNS lookup.
CGIWaitPid	(none)	Deprecated.
`ClientLanguage`	(none)	Deprecated.
`DefaultCharSet`	(none)	Ignored.
`ErrorLog`	(none)	See the Attributes attribute of the LOG element in `server.xml`.
`IOTimeout`	`AcceptTimeout`	Use the `AcceptTimeout` directive to specify the number of seconds the server must wait for data from a client before closing the connection.
`LogVerbose`	(none)	See the Attributes attribute of the LOG element in `server.xml`.
LogVsId	Attributes	See the Attributes attribute of the LOG element in `server.xml`.
`NetsiteRoot`	(none)	Deprecated.
ServerConfigurationFile	(none)	Ignored.
ServerID	(none)	Deprecated.
ServerName	(none)	Deprecated. See the `servername` attribute of the LS element in the `server.xml` file.
#ServerRoot	(none)	Deprecated.

obj.conf

The obj.conf file has acquired new SAFs and parameters as listed in Table 6-7. Only the new and changed directives are listed.

Table B–3 obj.conf Changes


Supported in 6.0	Supported in 6.1	Comments
JSP092 object	(none)	Removed. Sun Java System Web Server 6.1 supports the JSP 2.3 specification and so, the JSP092 object is not required.

server.xml

This section describes the following changes:

Table B–4
Table B–5
Table B–6

The following table lists the correspondences between the server.xml file in iPlanet Web Server 6.0 and the server.xml file in Sun Java System Web Server 6.1:

Table B–4 server.xml to server.xml Correspondences


`legacyls`	Not supported.
`CONNECTIONGROUP`	The `CONNECTIONGROUP element is` not supported. The `defaultvs` and `servername` attributes from the `CONNECTIONGROUP element` are added to the LS element in Sun Java System Web Server 6.1 during migration.
`SSLPARAMS`	The `SSLPARAMS` element, in 6.0 parsed from the `CONNECTIONGROUP` element, is a subelement of the LS element in Sun Java System Web Server 6.1.
`VARS`	The functionality of the `VARS` element is handled by the PROPERTY element in Sun Java System Web Server 6.1. However, the `VARS` element is still retained for backward compatibility.
`webapps_file` `webapps_enable`	Removed. The WEBAPP element of the `VS` element in `server.xml` handles web applications. Web container-specific configuration is handled by the `sun-web.xml` file.

The following table lists the correspondences between the start-jvm file in iPlanet Web Server 6.0 to the server.xml file in Sun Java System Web Server 6.1:

Table B–5 start-jvm and server.xml Correspondences


`NSES_JDK`	Attributes
`NSES_CLASSPATH`	Attributes
`NSES_JRE_RUNTIME_LIBPATH`	Attributes
`NSES_JRE_RUNTIME_CLASSPATH`	`Use the -Xbootclasspath JVM option.`

The following table lists the correspondences between the jvm12.conf file in iPlanet Web Server 6.0 and the server.xml file in Sun Java System Web Server 6.1:

Table B–6 jvm12.conf and server.xml Correspondences


`jvm.minHeapSize`	Use the `-Xms<`value`>` JVM option. Example: <JVMOPTIONS>-Xms128m -Xmx256m</JVMOPTIONS>
`jvm.maxHeapSize`	Use the `-Xmx<value>` JVM option. Example: <JVMOPTIONS>-Xms128m -Xmx256m</JVMOPTIONS>
`jvm.enableClassGC`	Use the -`Xnoclassgc` JVM option to disable garbage collection.
jvm.option	`Use the` JVMOPTIONS element.
jvm.profiler	`Use the` PROFILER element.
`jvm.verboseMode`	Use the -`verbose` JVM option.
`jvm.printErrors`	Not supported.
`jvm.disableThreadRecycling`	Not supported.
`jvm.serializeAttach`	Not supported.
`jvm.stickyAttach`	Not supported.
`jvm.trace`	Configured in the `LOGLEVEL` element of the web container.
`jvm.allowExit`	Refer to information at the following URL for more information about configuring this in the server.policy file: `http://java.sun.com/products/archive/j2se/1.4.1_07/index.html`
jvm.include.CLASSPATH	`Use the` Attributes attribute of the JAVA element.
`jvm.enableDebug`	`Use the debug and` debugoptions `attributes of the` JAVA element.
jvm.classpath	Use the Attributes and Attributes attributes of the JAVA element.

The following table lists the correspondences between the web-apps.xml file in iPlanet Web Server 6.0 and the sun-web.xml file in Sun Java System Web Server 6.1:

Table B–7 web-apps.xml and sun-web.xml Correspondences


`<config-param<param-name>redirect-to-absolute-url</param-name><param-value>false</param-value></config-param>`	Use the <property name="relativeRedirectAllowed" value="true">