<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY metainfo SYSTEM "metainfo.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-appserv-1">
<refmeta><refentrytitle>start-appserv</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="start-appserv">start-appserv &mdash;
starts the domains in the specified domains directory</primary></indexterm>
<indexterm><primary sortas="starts the domains in the specified domains directory">
starts the domains in the specified domains directory &mdash; start-appserv
</primary></indexterm><refname>start-appserv</refname><refpurpose>starts the
domains in the specified domains directory</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>start-appserv</command><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;user <replaceable>
admin_user</replaceable></arg><arg>&Dash;&Dash;passwordfile <replaceable>
passwordfile</replaceable></arg><arg choice="opt">&Dash;&Dash;domaindir <replaceable>
install_dir</replaceable>/domains</arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</title>
<para>This command is deprecated. Use the <command>start-domain</command>
command instead. Use the <command>start-appserv</command> command to start
the domains in specified domain directory. If the domain directory is not
specified the domains in the default <filename><replaceable>install_dir</replaceable>/domains
</filename> directory are started. The <command>start-appserv</command> command
requires that the user has set  up an <filename>AS_ADMIN_USER</filename> environment
variable and that all domains have the same administration user. You are prompted
for the master password for each domain (unless the <option role="nodash">&Dash;&Dash;savemasterpassword
</option> option was specified at the domain creation time).</para>
<para>The <command>start-appserv</command> command functions correctly if
every domain is created with <option role="nodash">&Dash;&Dash;savemasterpassword
</option>. If <option role="nodash">&Dash;&Dash;savemasterpassword</option>
is not specified, then you are prompted for the master password for every
domain.</para>
<para>This command is supported in local mode only.</para>
</refsect1>
<refsect1><title>&opts-tt;</title>
<variablelist termlength="medium">
<varlistentry><term><option role="nodash">&Dash;&Dash;domaindir</option></term>
<listitem><para>The directory where the domains are 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;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;u</option> <option role="nodash">&Dash;&Dash;user
</option></term><listitem><para>The authorized domain administration server
administrative username.</para>
<para>If you have authenticated to a domain using the asadmin login command,
then you need not specify the <command>--user</command> option on subsequent
operations to this particular domain.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;passwordfile</option></term>
<listitem><para>The <option role="nodash">&Dash;&Dash;passwordfile</option>
option specifies the name of a file containing the password entries in a specific
format. The entry for the password must have the <literal>AS_ADMIN_</literal>
prefix followed by the password name in uppercase letters.</para>
<para>For example, to specify the domain administration server password, use
an entry with the following format: <command>AS_ADMIN_PASSWORD</command>=<replaceable>
password</replaceable>, where <replaceable>password</replaceable> is the actual
administrator password. Other passwords that can be specified include <literal>
AS_ADMIN_MAPPEDPASSWORD</literal>, <literal>AS_ADMIN_USERPASSWORD</literal>,
and <literal>AS_ADMIN_ALIASPASSWORD</literal>.</para>
<para>All remote commands must specify the admin password to authenticate
to the domain administration server, either through <option role="nodash">&Dash;&Dash;passwordfile
</option> or <command>asadmin login</command>, or interactively on the command
prompt. The <command>asadmin login</command> command can be used only to specify
the admin password. For other passwords, that must be specified for remote
commands, use the <option role="nodash">&Dash;&Dash;passwordfile</option>
or enter them at the command prompt. </para>
<para>If you have authenticated to a domain using the <command>asadmin login
</command> command, then you need not specify the admin password through the <option
role="nodash">&Dash;&Dash;passwordfile</option> option on subsequent operations
to this particular domain. However, this is applicable only to <command>AS_ADMIN_PASSWORD
</command> option. You will still need to provide the other passwords, for
example, <literal>AS_ADMIN_USERPASSWORD</literal>, as and when required by
individual commands, such as <command>update-file-user</command>.</para>
<para>For security reasons, passwords specified as an environment variable
will not be read by <command>asadmin</command>. </para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</title>
<example>
<title>Using the start&mdash;appserv command<?Pub Caret></title>
<screen>asadmin> <userinput>start-appserv --user admin</userinput>
Command start-appserv is deprecated.
Starting all the domains in /opt/SUNWappserver90/domains, please wait.
Starting Domain domain1, please wait.
Log redirected to /opt/SUNWappserver90/domains/domain1/logs/server.log.
Please enter the admin password>
Domain domain1 started.</screen>
</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="start-domain-1"><citerefentry><refentrytitle>start-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>, <link linkend="stop-appserv-1"><citerefentry>
<refentrytitle>stop-appserv</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000008468>
