246/461

## start-cluster

starts a cluster

Synopsis

    start-cluster [--help] [--autohadboverride={true|false}]
    [--verbose={false|true}] cluster-name

Description

The `start-cluster` subcommand starts a cluster by starting all GlassFish Server instances in the cluster that are not already running. This subcommand requires the Distributed Component Object Model (DCOM) remote protocol or secure shell (SSH) to be configured on the host where the domain administration server (DAS) is running and on all hosts where instances in the cluster reside.

Note:

If all instances reside on the same host as the DAS, DCOM or SSH is not required. You might require to start a cluster in which instances reside on hosts where DCOM or SSH is not configured that are remote from the DAS. In this situation, run the start-local-instance(1) subcommand for each instance from the host where the instance resides.

You may run this subcommand from any host that can contact the DAS.

This subcommand is supported in remote mode only.

Options

`--help`
`-?`

  Displays the help text for the subcommand.

`--autohadboverride`

  Do not specify this option. This option is retained for compatibility with earlier releases. If you specify this option, a syntax error does not occur. Instead, the subcommand runs successfully and displays a warning message that the option is ignored.

`--verbose`

  Specifies whether additional status information is displayed when the cluster is started.

  Valid values are as follows:

  `true`

    Displays the command to start each instance in the cluster and whether the attempt to start each instance succeeded.

  `false`

    Displays no additional status information (default).

Operands

cluster-name

  The name of the cluster to start.

Examples

Example 1 Staring a Cluster

  This example starts the cluster `ymlcluster`. Additional status information is displayed when the cluster is started.

      asadmin> start-cluster --verbose ymlcluster
      start-instance yml-i-sr1-usca-02
      start-instance yml-i-sr1-usca-01

      The command start-instance executed successfully for:
      yml-i-sr1-usca-02 yml-i-sr1-usca-01

      Command start-cluster executed successfully.

Exit Status

0

  command executed successfully

1

  error in executing the command

See Also

create-cluster(1), delete-cluster(1), list-clusters(1), setup-ssh(1), start-local-instance(1), stop-cluster(1), validate-dcom(1)

asadmin(1M)