2.4.10 start-domain

Synopsis

asadmin [asadmin-options] start-domain
    [--help] [--debug={true|false}] [--domaindir domain-dir]
    [--dry-run={true|false}] [--upgrade={true|false}]
    [--verbose={true|false}] [--watchdog={true|false}] [domain-name]

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The start-domain subcommand of asadmin starts the DAS of the specified domain. If a domain is not specified, the default domain is assumed. If the domains directory contains two or more domains, the domain-name operand must be specified. This subcommand is supported in local mode only.

The start-domain subcommand prompts for a new admin user password if no password has been set for the admin user. Additionally, the admin user password must not be blank if secure administration is enabled; else, the start-domain subcommand fails.

Arguments

--help | -?

Displays the help text for the subcommand.

{--debug|-d}={true|false}

Specifies whether the domain is started with Java Platform Debugger Architecture (JPDA) debugging enabled.

Type: Boolean

The following values can be specified:

• true

  The instance is started with JPDA debugging enabled and the port number for JPDA debugging is displayed.

• false

  The instance is started with JPDA debugging disabled. This is the default value.

Default value: false

--domaindir domain-dir

Specifies the domain root directory, which contains the directory of the domain that is to be restarted. If specified, the path must be accessible in the file system.

Type: String

The following values can be specified:

• Path of the root directory of the domain

Default value: Application Server installation directory/javaee/glassfish/domains

{--dry-run|-n}={true|false}

Suppresses the actual starting of the domain. Instead, start-domain displays the full Java command that would be used to start the domain, including all options. Reviewing this command can be useful to confirm JVM options and when troubleshooting startup issues.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

--upgrade={true|false}

Specifies whether the configuration of the domain administration server (DAS) is upgraded to the current release.

Type: Boolean

The following values can be specified:

• true

  When the domain is started, the configuration is modified to be compatible with this release of DAS, and DAS process stops.

• false

  The configuration of the DAS is not updated. This is the default value.

Default value: false

{--verbose|-v}={true|false}

Specifies whether detailed information about the domain is displayed in the console window where the subcommand is run.

Type: Boolean

The following values can be specified:

• true

  Detailed startup messages and log messages about the domain are displayed in the console window where the subcommand is run. If the domain is later restarted by running the restart-domain subcommand from a different console window, messages continue to be displayed in the original console window. You can kill Java EE Server process by typing CTRL+C in the console window. You can kill Java EE Server process and obtain a thread dump for the server by typing one of the following key combinations in the console window:

  CTRL+\ on UNIX systems

• false

  Detailed information is not displayed. This is the default value.

Default value: false

{--watchdog|-w}={true|false}

Specifies whether limited information about the domain is displayed in the console window where the subcommand is run.

The --watchdog option is similar to --verbose but does not display the detailed startup messages and log messages. This option is useful when running the asadmin utility in the background or with no attached console.

Type: Boolean

The following values can be specified:

• true

  Limited information is displayed in the console window.

• false

  Limited information is not displayed in the console window. This is the default value.

Default value: false

domain-name

Specifies the unique name of the domain you want to start.

Type: String

The following values can be specified:

• Name of the domain

Default value: N/A

asadmin start-domain mydomain4

Exit Status

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