<!--Arbortext, Inc., 1988-2007, 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;
]>
<!--Arbortext, Inc., 1988-2007, v.4002-->
<?Pub EntList bull rArr sect>
<refentry id="change-admin-password-1">
<!-- @(#)change-admin-password.1 1.10 07/07/11 SMI; -->
<refmeta><refentrytitle>change-admin-password</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">9 Jul 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>change-master-password</primary></indexterm><indexterm><primary>changes the master password</primary></indexterm>
<refname>change-admin-password</refname><refpurpose>changes the administrator password</refpurpose></refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>change-admin-password</command> <option role="double-dash">user</option> <replaceable>admin_user</replaceable>
 [<option role="double-dash">terse</option>={true|false}] [<option role="double-dash">echo</option>={true|false}]
 [<option role="double-dash">host</option> <replaceable>hostname</replaceable>] [<option role="double-dash">port</option> <replaceable>port-no</replaceable>]
 [<option role="double-dash">secure</option> | <option>s</option>]</synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>This remote command is used to modify the admin password. <command>change-admin-password</command> is interactive in that the user is prompted for the old admin password and for the new admin password (with confirmation).</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="wholeline">
<varlistentry><term><option>u</option> <option role="double-dash">user</option></term>
<listitem><para>The authorized domain administration server administrative username.</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 the standard output. Default is false.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>H</option> <option role="double-dash">host</option></term>
<listitem><para>The machine name where the domain administration server is running. The default is <literal>localhost</literal>.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>p</option> <option role="double-dash">port</option></term>
<listitem><para>The port number of the domain administration server listening for administration requests. The default is port 4848.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>s</option> <option role="double-dash">secure</option></term>
<listitem><para>If set to true, uses SSL/TLS to communicate with the domain administration server.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>Using change-admin-password</title>
<screen>asadmin> <userinput>change-admin-password --user admin</userinput>
Please enter the old admin password>
Please enter the new admin password>
Please enter the new admin password again>
Command change-admin-password executed successfully.</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="narrow">
<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="delete-password-alias-1">delete-password-alias(1)</olink>, <olink targetdoc="asrefman" targetptr="list-password-aliases-1">list-password-aliases(1)</olink>, <olink targetdoc="asrefman" targetptr="update-password-alias-1">update-password-alias(1)</olink></para>
</refsect1>
</refentry>
<?Pub *0000004812 0>
