stop-database

stops the Java DB

Synopsis

stop-database [--help] [--dbuser db-user]
[--dbhost host] [--dbport port-no]

Description

The stop-database subcommand stops a process of the Java DB server. Java DB server is available for use with GlassFish Server and is based upon Apache Derby. The database is typically started with the start-database(1) subcommand. A single host can have multiple database server processes running on different ports. The stop-database subcommand stops the database server process for the specified port only.

This subcommand is supported in local mode only.

Options

--help

-?

Displays the help text for the subcommand.

--dbuser

The user name of the Java DB user that is to stop the server process. This option is required only when Java DB user authentication is enabled.

If this option is omitted, no user is specified. By default, Java DB user authentication is disabled, so no user or password is required.

--dbhost

The host name or IP address of the Java DB server process. The default is the IP address 0.0.0.0, which denotes all network interfaces on the host where you run the stop-database subcommand.

--dbport

The port number where the Java DB server listens for client connections. The default is 1527.

Examples

Example 1 Stopping Java DB

This example stops Java DB on host host1 and port 5001.

asadmin> stop-database --dbhost host1 --dbport 5001
Connection obtained for host: host1, port number 5001.
Shutdown successful.
Command stop-database executed successfully.

Exit Status

The exit status applies to errors in executing the asadmin utility. For information on database errors, see the derby.log file. This file is located in the directory you specify by using the --dbhome option when you run the start-database subcommand. If you did not specify --dbhome, the value of DERBY_INSTALL defaults to as-install/javadb.

0: command executed successfully
1: error in executing the command