Netscape ENTERPRISE SERVER 6.1, Manual

Page: 298 / 373

Elements in server.dtd and server.xml
298 Netscape Enterprise Server NSAPI Programmer’s Guide • April 2002 (Draft)
LS (Listen Socket)
Defines a listen socket.
Subelements:
CONNECTIONGROUP
Attributes:
NOTE
When you create a secure listen socket through the Server Manager,
security is automatically turned on globally in
magnus.conf.
When
you create a secure listen socket manually in
server.xml
, security
must be turned on by editing
magnus.conf.
id
(optional) The socket family type. A socket family type cannot
begin with a number.
When you create a secure listen socket in the
server.xml
file,
Security
must be turned on in
magnus.conf
. When you create a secure listen socket in
the Server Manager, security is automatically turned on
globally in
magnus.conf
.
A listen socket name cannot
begin with a number.
ip
IP address of the listen socket. Can be in dotted-pair or IPv6
notation. Can also be
any
for
INADDR_ANY
. Configuring a
listen socket to listen on
any
is required if more than one
CONNECTIONGROUP
is configured to it.
port
Port number to create the listen socket on. Legal values are
1
-
65535
. On UNIX, creating sockets that listen on ports
1
-
1024
requires superuser privileges. Configuring an SSL listen
socket to listen on port 443 is recommended. Two different IP
addresses can’t use the same port.
security
(optional) Determines whether the listen socket runs SSL.
Legal values are
on
,
off
,
yes
,
no
,
1
,
0
. The default is
no
. You
can turn SSL2 or SSL3 on or off and set ciphers using an
SSLPARAMS
object in a
CONNECTIONGROUP
object.
The
Security
setting in the
magnus.conf
file globally
enables or disables SSL by making certificates available to the
server instance. Therefore,
Security
in
magnus.conf
must
be
on
or
security
in
server.xml
does not work. For more
information, see Chapter 7, “Syntax and Use of magnus.conf.”