Hitachi

Hitachi Application Server V10 Command Reference Guide (For Windows® Systems)


2.6.25 stop-cluster

Stops Java EE Server cluster.

Synopsis

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

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The stop-cluster subcommand of asadmin stops Java EE Server cluster by stopping all running server instances in the cluster. This subcommand is supported in remote mode only.

When this subcommand is used, there is a timeout period for stopping the cluster. If a timeout occurs while stopping the cluster or reading the asadmin command, then this subcommand fails to run. However, the stop processing of the cluster continues. You can verify whether the cluster 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.

--verbose={false|true}

Specifies whether additional progress messages about the status of instances in the cluster are displayed while the cluster is being stopped.

Type: Boolean

The following values can be specified:

  • true

    Additional progress messages about the status of instances in the cluster are displayed.

  • false

    No messages about the status of instances in the cluster are displayed.

Default value: false

--kill={false|true}

Specifies whether each instance in the cluster is killed using functionality of the operating system to terminate the instance process.

Type: String

The following values can be specified:

  • true

    Each instance is killed. The subcommand uses functionality of the operating system to terminate each instance process.

  • false

    No instances are killed. The subcommand uses functionality of the Java platform to terminate each instance process. This is the default value.

Default value: false

cluster-name

Specifies the name of the cluster to stop.

Type: String

The following values can be specified:

  • Name of the cluster

Default value: N/A

Examples

The following example stops the cluster pmdcluster.

asadmin stop-cluster pmdcluster

Exit Status

Exit Status

Explanation

0

command executed successfully.

1

error in executing the command.