2.6.26 stop-instance

Synopsis

asadmin [asadmin-options] stop-instance [--help]
     [--kill={false|true}] instance-name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The stop-instance subcommand of asadmin stops a running server instance. The subcommand can stop any server instance, regardless of how the instance was created.

Before stopping a server instance, stop from the instances on the front-end server, such as the load-balancing device and the Web server. If you do not stop from the front-end server and requests are left in the server instance, an unexpected error might occur.

When stopping a server, the message KDKD45000-E might be output to the standard error and logger.log files, but the termination processing is not affected.

This subcommand is supported in remote mode only.

When this subcommand is used, there is a timeout period for stopping the server instance. If a timeout occurs while requesting to the Domain Administration Server, the stop processing continues. If a timeout occurs while stopping the server instance or reading the asadmin command, this subcommand fails to run. However, the stop processing of the server instance continues. You can verify whether the server instance has been stopped successfully, by viewing the KDKD20032-I log or the server instance status in the Administration Console.

Precondition

Domain Administration Server (DAS) is running.

Arguments

--help | -?

Displays the help text for the subcommand.

--kill={false|true}

Specifies whether the instance is killed by using functionality of the operating system to terminate the instance process.

Type: Boolean

The following values can be specified:

• true: The instance is killed. The subcommand uses functionality of the operating system to terminate the instance process.

• false: The instance is not killed. The subcommand uses functionality of the Java platform to terminate the instance process. This is the default value.

Default value: false

instance-name

Specifies the name of the server instance to stop.

Type: String

The following values can be specified:

• Name of the server instance

Default value: N/A

asadmin stop-instance yml-i-sj01

Exit Status

Exit Status	Explanation
0	subcommand executed successfully.
1	error in executing the subcommand.