<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub EntList brvbar bull cross dash diam diams frac12 frac13 frac14 hellip
 laquo lArr loz mdash nabla ndash para pound rArr raquo sect yen ne>
<?Pub Inc>
<refentry id="start-domain-1">
<refmeta><refentrytitle>start-domain</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="start-domain">start-domain &mdash;
starts a domain</primary></indexterm><indexterm><primary sortas="starts a domain">
starts a domain &mdash; start-domain</primary></indexterm><refname>start-domain
</refname><refpurpose>starts a domain</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>start-domain</command><arg>&Dash;&Dash;domaindir <replaceable>
install_dir</replaceable>/domains</arg><arg choice="plain">&Dash;&Dash;user <replaceable>
admin_user</replaceable></arg><arg choice="plain">&Dash;&Dash;passwordfile <replaceable>
file_name</replaceable></arg><arg>&Dash;&Dash;terse=<replaceable>false</replaceable></arg>
<arg>&Dash;&Dash;echo=<replaceable>false</replaceable></arg><arg>&Dash;&Dash;interactive=<replaceable>
true</replaceable></arg><arg>&Dash;&Dash;verbose=<replaceable>false</replaceable></arg>
<arg>&Dash;&Dash;debug=<replaceable>false</replaceable></arg><arg><replaceable>
domain_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</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>You can use the <command>start-domain</command> command to upgrade domains
of Application Server 8.x or 9.0 to Application Server 9.1. Use one of the
following ways to upgrade your domain:<itemizedlist>
<listitem><para>Perform an in-place upgrade of the Application Server binaries.
When you run <command>start-domain</command> on the domains pointing to the
earlier version of Applciation Server, <command>asadmin</command> invokes
the <command>asupgrade</command> command , and the domains are automatically
upgraded in-place.  </para></listitem>
<listitem><para>Perform a side-by-side upgrade of the Application Server binaries.
Run <command>start-domain</command> on the domains of your earlier installation.
The <command>asupgrade</command> command upgrades the domains to the domains
root of the latest Application Server installation. In this scenario, the
target directory for the upgrade is defined in the AS_DEF_DOMAINS_PATH in
the <filename>asenv.conf</filename>.</para></listitem>
</itemizedlist></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><title>&oper-tt;</title>
<variablelist termlength="narrow">
<varlistentry><term><option role="nodash">&Dash;&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 role="nodash">&Dash;u</option> <option role="nodash">&Dash;&Dash;user
</option></term><listitem><para>The authorized domain application server administrative
username. </para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;passwordfile</option></term>
<listitem><para>The file containing the domain application server password
associated with the administrative instance. The password is defined in the
following form: AS_ADMIN_PASSWORD=<replaceable>password</replaceable>. Where <replaceable>
password</replaceable> is the actual administrator password for the domain. 
</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;t</option><option role="nodash">&Dash;&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 role="nodash">&Dash;e</option> <option role="nodash">&Dash;&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 role="nodash">&Dash;I</option> <option role="nodash">&Dash;&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="nodash">&Dash;&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="nodash">&Dash;&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><title>&oper-tt;</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><title>&exam-tt;</title>
<example>
<title>Using the start-domain command</title>
<screen>asadmin> <userinput>start-domain domain1</userinput>
Starting Domain domain1, please wait.
Log redirected to /as9ee/b32/domains/domain1/logs/server.log.
Please enter the admin user name>admin
Please enter the admin password>
Please enter the master password>
Redirecting output to /as9ee/b32/domains/domain1/logs/server.log
Domain domain1 started.
Domain [domain1] is running [Sun Java System Application Server 9.1 (build b32)] with its configuration and logs at: [/space/programs/as9ee/b32nightly17jan/domains].
Admin Console is available at [https://localhost:4849].
Use the same port [4849] 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://sunone094:8686/jmxrmi] for domain management purposes.
<?Pub Caret>Domain listens on at least following ports for connections:
[8080 8181 4849 3700 3820 3920 8686 ].
Domain supports application server clusters and other standalone instances.

</screen>
<para>Where: <filename>domain1</filename> is the domain in the <filename>
/as9ee/b32/domains</filename> directory.</para>
</example>
</refsect1>
<refsect1><title>&exit-tt;</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><title>&also-tt;</title>
<para><link linkend="create-domain-1"><citerefentry><refentrytitle>create-domain
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="delete-domain-1"><citerefentry>
<refentrytitle>delete-domain</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="stop-domain-1"><citerefentry><refentrytitle>stop-domain</refentrytitle>
<manvolnum>1</manvolnum></citerefentry></link>, <link linkend="list-domains-1"><citerefentry>
<refentrytitle>list-domains</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000008659>
