<!--Arbortext, Inc., 1988-2008, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub EntList bull rArr sect>
<refentry id="start-domain-1"><?Pub Tag atict:info tracking="off" ref="2"><?Pub Tag
atict:user user="hl34125" fullname=""><?Pub Tag atict:user user="pmdavies"
fullname=""><?Pub Tag atict:user user="ah95648" fullname="">
<!-- @(#)start-domain.1 1.10 07/07/11 SMI; -->
<refmeta><refentrytitle>start-domain</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">4 Aug 2008</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2008, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>start-domain</primary></indexterm><indexterm>
<primary>starts a domain</primary></indexterm>
<refname>start-domain</refname><refpurpose>starts a domain</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>start-domain</command>  [<option role="double-dash">domaindir</option> <replaceable>
domain-dir</replaceable>]
 <option role="double-dash">user</option> <replaceable>admin_user</replaceable> <option
role="double-dash">passwordfile</option> <replaceable>file_name</replaceable>
 [<option role="double-dash">terse</option>={true|false}] [<option
role="double-dash">echo</option>={true|false}]
 [<option role="double-dash">interactive</option>={true|false}] [<option
role="double-dash">verbose</option>={true|false}]
 [<option role="double-dash">debug</option>={true|false}] [<replaceable>domain_name
</replaceable>]</synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>Use the <command>start-domain</command> command to start a domain. If
the domain directory is not specified, the domain in the default <filename><replaceable>
install_dir</replaceable>/domains</filename> directory is started. If there
are two or more domains, the <replaceable>domain_name</replaceable> operand
must be specified. </para>
<para>On the Mac OS X platform, processes can bind to the same port. To avoid
this problem, do not start multiple domains with the same port number at the
same time.</para>
<para>This command is supported in local mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="wholeline">
<varlistentry><term><option role="double-dash">domaindir</option></term>
<listitem><para>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 <filename><replaceable>install_dir</replaceable>/domains</filename> directory
is started.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>u</option> <option role="double-dash">user</option></term>
<listitem><para>The authorized domain administrative username. </para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">passwordfile</option></term>
<listitem><para>The file containing the domain password associated with the
administrative instance. The password is defined in the following form: <envar>AS_ADMIN_PASSWORD
</envar>=<replaceable>password</replaceable>. Where <replaceable>password</replaceable> is
the actual administrator password for the domain. </para>
</listitem>
</varlistentry>
<varlistentry><term><option>t</option><option role="double-dash">terse</option></term>
<listitem><para>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.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>e</option> <option role="double-dash">echo</option></term>
<listitem><para>Setting to true will echo the command line statement on to
the standard output. Default is false.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>I</option> <option role="double-dash">interactive</option></term>
<listitem><para>If set to true (default), only the required password options
are prompted.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">verbose</option></term>
<listitem><para>By default this flag is set to false. If set to true, detailed
server startup output is displayed. On Windows, press CTRL-Break in the domain's
 window to print a thread dump. On UNIX, press CTRL-C to kill the server and
press CTRL-\\ to print a thread dump.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">debug</option></term>
<listitem><para>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.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="narrow">
<varlistentry><term><replaceable>domain_name</replaceable></term>
<listitem><para>The unique name of the domain you wish to start.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>Using the start-domain command on Sun GlassFish Communications
Server</title>
<screen>asadmin> <userinput>start-domain domain1</userinput>
Starting Domain domain1, please wait.
<?Pub Caret>Log redirected to /usr/appserver/domains/domain1/logs/server.log.
Redirecting output to /usr/appserver/domains/domain1/logs/server.log
Domain domain1 started.
Domain [domain1] is running [Sun GlassFish Communications Server
1.0 (build b44)] with its configuration and logs at: [/usr/appserver/domains].
Admin Console is available at [http://localhost:4848].
Use the same port [4848] for "asadmin" commands.
User web applications are available at these URLs:
[http://localhost:8080 https://localhost:8181 ].
Following web-contexts are available:
[/web1  /__wstx-services ].
Standard JMX Clients (like JConsole) can connect to JMXServiceURL:
[service:jmx:rmi:///jndi/rmi://pdavies.SFBay.Sun.COM:8686/jmxrmi] for domain 
management purposes.
Domain listens on at least following ports for connections:
[8080 8181 4848 3700 3820 3920 8686 ].
Domain supports application server clusters and other standalone instances.

Domain listens on at least following ports for SIP connections:
[SIP 0.0.0.0:5060, SIPS 0.0.0.0:5061]</screen>
<para>Where: <filename>domain1</filename> is the domain in the <filename>/usr/appserver/domains
</filename> directory.</para>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="medium">
<varlistentry><term>0</term>
<listitem><para>command executed successfully</para>
</listitem>
</varlistentry>
<varlistentry><term>1</term>
<listitem><para>error in executing the command</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetdoc="asrefman" targetptr="create-domain-1">create-domain(1)</olink>, <olink
targetdoc="asrefman" targetptr="delete-domain-1">delete-domain(1)</olink>, <olink
targetdoc="asrefman" targetptr="stop-domain-1">stop-domain(1)</olink>, <olink
targetdoc="asrefman" targetptr="list-domains-1">list-domains(1)</olink></para>
</refsect1>
</refentry>
<?Pub *0000007478 0>
