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

dbswitch.conf

Purpose

Specifies the LDAP directory that Sun Java System Web Server uses.

Location

server_root/userdb

Syntax

directory name LDAP_URLname:property1 [value1]
name:property2 [value2]
...

The default contents of this file are as follows:

directory default null:///none

Edit the file as follows for anonymous binding over SSL:

directory default ldaps://directory.sun.com:636:/dc%3Dcom

Edit the file as follows for anonymous binding not over SSL:

directory default ldap://directory.sun.com:389:/dc%3Dcom

See Also

User Database Selection

The following table describes properties in the dbswitch.conf file. The Property column lists the property names. The Allowed Values column from the left lists allowed values. The Default Value column from the left lists default values. The Description column lists property descriptions.

Table 6–2 dbswitch.conf Properties

Property  

Allowed Values  

Default Value  

Description  

nsessions

A positive integer 

8

The number of LDAP connections for the database. 

dyngroups

off, on, recursive

on

Determines how dynamic groups are handled. If off, dynamic groups are not supported. If on, dynamic groups are supported. If recursive, dynamic groups can contain other groups.

binddn

A valid DN 

 

The DN used for connecting to the database. If both binddn and bindpw are not present, binding is anonymous.

bindpw

   

The password used for connecting to the database. If both binddn and bindpw are not present, binding is anonymous.

dcsuffix

A valid DN (relative to the LDAP URL) 

none 

If present, the default value of the base DN for the request’s virtual server is determined by a dc tree search of the connection group’s servername attribute, starting at the dcsuffix DN.

If not present, the default value of the base DN is the base DN value in the LDAP URL.

The basedn attribute of a USERDB element in the server.xml file overrides this value.

digestauth

off, on

off

Specifies whether the database can perform digest authentication. If on, a special Directory Server plug-in is required. For information about how to install this plug-in, see the Sun Java System Web Server 6.1 SP9 Administrator’s Guide.

syntax

keyfile, digest, htaccess

keyfile

Specifies what type of file auth-db will be used 

keyfile

   

Specifies the path to the keyfile. Required, if syntax is set to keyfile.

digestfile

   

Specifies the path to the digestfile. Required, if syntax is set to digestfile.

groupfile

   

Path to the AuthGroupFile. If the groupfile is the same as the userfile, this file contains both user and group data, otherwise it contains only group data. Required if syntax is set to htaccess. For more information about the syntax of the AuthGroupFile, see the Sun Java System Web Server 6.1 SP9 Administrator’s Guide.

userfile

   

Path to the AuthUserFile. If the userfile is the same as the groupfile, this file contains both user and group data, otherwise it contains only user data. Required if syntax is set to htaccess. For more information about the syntax of the AuthUserFile, see the Sun Java System Web Server 6.1 SP9 Administrator’s Guide.