Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Reference Manual

## start-domain(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

#### NAME

start-domain– starts a domain

#### SYNOPSIS

`start-domain` [––domaindir install_dir/domains] [––user admin_user] [––passwordfile file_name] [––terse=false] [––echo=false] [––interactive=true] [––verbose=false] [––debug=false] [domain_name]

#### DESCRIPTION

Use the `start-domain` command to start a domain. If the domain directory is not specified, the domain in the default `install_dir/domains` directory is started. If there is more that one domain, the domain_name operand must be identified.

This command is supported in local mode only.

#### OPTIONS

`––domaindir`

  The directory where the domain is to be started. If specified, the path must be accessible in the filesystem. If not specified, the domain in the default `install_dir/domains` directory is started.

`–u` `––user`

  The authorized domain application server administrative username.

`–w` `––password`

  The `` `––password` option is deprecated. Use `` `––passwordfile` instead.

`–W` `––passwordfile`

  The file containing the domain application server password associated with the administrative instance. The password is defined in the following form: AS_ADMIN_PASSWORD=password. Where password is the actual administrator password for the domain.

`–t` `––terse`

  Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.

`–e` `––echo`

  Setting to true will echo the command line statement on to the standard output. Default is false.

`–I` `––interactive`

  If set to true (default), only the required password options are prompted.

`––verbose`

  By default this flag is set to false. If set to true, detailed server startup output is displayed. Press CTRL-C to kill the server. Press CTRL-\\ to print a thread dump.

`––debug`

  By default this flag is set to false. If set to true, the server is started in debug mode and prints the JPDA port on the console.

`––domaindir`

  The directory where the domain is to be started. If specified, the path must be accessible in the filesystem. If not specified, the domain in the default `install_dir/domains` directory is started.

`–u` `––user`

  The authorized domain application server administrative username.

`–w` `––password`

  The `` `––password` option is deprecated. Use `` `––passwordfile` instead.

`` `––passwordfile`

  This option replaces the `–– password` option. Using the `––password` option on the command line or through the environment is deprecated. The `––passwordfile` option specifies the name of a file containing the password entries in a specified format. The entry for the password must have the AS_ADMIN prefix followed by the password name in capital letters. For example, to specify the domain application server password, use an entry with the following format: `AS_ADMIN_PASSWORD`=password, where password is the actual administrator password. Other passwords that can be specified include MAPPEDPASSWORD, USERPASSWORD, SAVEDMASTERPASSWORD, MQPASSWORD, ALIASPASSWORD, and so on.

`–t` `––terse`

  Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.

`–e` `––echo`

  Setting to true will echo the command line statement on to the standard output. Default is false.

`–I` `––interactive`

  If set to true (default), only the required password options are prompted.

`––verbose`

  By default this flag is set to false. If set to true, detailed server startup output is displayed. On UNIX, press CTRL-C to kill the server. On Windows, press Ctrl-Break to kill the server. Press CTRL-\\ to print a thread dump.

`––debug`

  By default this flag is set to false. If set to true, the server is started in debug mode and prints the JPDA port on the console.

#### OPERANDS

domain_name

  The unique name of the domain you wish to start.

#### EXAMPLES

##### Example 1 Using the start-domain command

    asadmin> start-domain --domaindir /export/domains --user admin --passwordfile pass sampleDomain
    Where: the sampleDomain domain in the /export/domains directory is started using admin password stored in pass file.

#### EXIT STATUS

0

  command executed successfully

1

  error in executing the command

#### SEE ALSO

create-domain(1), delete-domain(1), stop-domain(1), list-domains(1)

J2EE SDK 1.4 Last Revised 31 Jan 2005

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | SEE ALSO

- © 2010, Oracle Corporation and/or its affiliates