<!-- Fragment document type declaration subset:
ArborText, Inc., 1988-1999, v.4002
<!DOCTYPE BOOK PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!ENTITY Dash "&ndash;">
]>
-->
<?Pub UDT _bookmark _target>
<?Pub Inc>
<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 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;H</option> <option role="nodash">&Dash;&Dash;host
</option></term><listitem><para>The machine name where the domain administration
server is running. The default value is localhost.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;p</option> <option role="nodash">&Dash;&Dash;port
</option></term><listitem><para>The HTTP/S port for administration. This is
the port to which you should point your browser in order to manage the domain.
For example, <literal>http://localhost:4848</literal>.</para>
<para>The default port number for Platform Edition is 4848. The default port
number for Enterprise Edition is 4849.</para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;s</option> <option role="nodash">&Dash;&Dash;secure
</option></term><listitem><para>If set to true, uses SSL/TLS to communicate
with the domain administration server.</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><?Pub Caret>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;&Dash;help</option></term>
<listitem><para>Displays the help text for the command.</para>
</listitem></varlistentry>
<?Pub *0000004782>
