Start-up page
Derby Server and Administration Guide
41
relative path /derbynet. See the documentation for your Application Server for instructions
on how to install it.
For example, if derby.war is installed in WebSphere Application Server with a context
root of
derby
, the URL of the server is:
http://<server>[:port]/derby/derbynet
Notes:
· A servlet engine is not part of the Network Server.
· When the Network Server is started by the servlet interface, shutting down the
Application Server also shuts the Network Server down, since both run in the same
JVM.
The servlet takes the following optional configuration parameters:
host
Specifies the host name to be used by the Network Server. See the Security
Considerations section below.
portNumber
Specifies the port number to be used by the Network Server.
startNetworkServerOnInit
Specifies that the Network Server is to be started when the servlet is initialized.
tracingDirectory
Specifies the location for trace files. If the tracing directory is not specified, the traces
are placed in derby.system.home.
Security Considerations
For general security considerations for the Network Server, see
The "host" parameter allows configuration of the host name that will be used for the
listening socket for network connections. By default, the Network Server will listen to
requests only on the loopback address, which means that it will only accept connections
from the local host. Changing this value could expose the server to external connections,
which raises security concerns, so before using the "host" parameter, you should run
under the Java security manager and enable user authentication.
This section describes the servlet pages.
Start-up page
Use the start-up page to start the server.
In addition to starting the Network Server, you can use the startup page to perform the
following actions:
· Turn logging on when the server is started.
· Turn tracing on for all sessions when the server is started.
Running page
If the Network Server is running (whether it was started by initializing the servlet or in
some other manner), the running page is displayed. The running page indicates whether
logging is on or off, whether tracing is on or off, and if tracing is on, indicates for which
session.
You can use the running page to stop the server and turn logging and tracing on or off.
The following options are available from the running page:
· Start or stop logging.
· Start or stop tracing all sessions.
