By default, the Derby Network Server will only listen on the localhost. Clients must use the localhost host name to connect. By default, clients cannot access the Network Server from another host. To enable connections from other hosts, set the derby.drda.host property, or start the Network Server with the -h option in the java org.apache.derby.drda.NetworkServerControl start command.
In the following example the server will listen only on localhost and clients cannot access the server from another host.
java org.apache.derby.drda.NetworkServerControl start
In the following example, the server runs on host machine sampleserver.sampledomain.com and also listens for clients from other hosts. Clients must specify the server in the URL or DataSource as sampleserver.sampledomain.com:
java org.apache.derby.drda.NetworkServerControl start -h sampleserver.sampledomain.com
java org.apache.derby.drda.NetworkServerControl start -h 0.0.0.0
A server that is started with the -h 0.0.0.0 option will listen to client requests that originate from both localhost and from other machines on the network.
However, administrative commands (for example, org.apache.derby.drda.NetworkServerControl shutdown) can run only on the host where the server was started, even if the server was started with the -h option.