<!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="change-admin-password-1">
<refmeta><refentrytitle>change-admin-password</refentrytitle><manvolnum>1
</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="change-master-password">change-master-password &mdash;
changes the master password</primary></indexterm><indexterm><primary sortas="changes the master password">
changes the master password &mdash; change-master-password</primary></indexterm>
<refname>change-admin-password</refname><refpurpose>changes the administrator
password</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>change-admin-password</command><arg choice="plain">&Dash;&Dash;user <replaceable>
admin_user</replaceable></arg><arg choice="opt">&Dash;&Dash;terse=<replaceable>
false</replaceable></arg><arg>&Dash;&Dash;echo=<replaceable>false</replaceable></arg>
<arg>&Dash;&Dash;host <replaceable>localhost</replaceable></arg><arg choice="opt"><?Pub Caret>&Dash;&Dash;port <replaceable>
4848 | 4849</replaceable></arg><arg choice="opt">&Dash;&Dash;secure | &Dash;s
</arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</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><title>&opts-tt;</title>
<variablelist termlength="medium">
<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>
</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 the standard output. Default is false.</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. </para>
</listitem></varlistentry>
<varlistentry><term><option role="nodash">&Dash;p</option> <option role="nodash">&Dash;&Dash;port
</option></term><listitem><para>The port number of the domain administration
server listening for administration requests. </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>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</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><title>&exit-tt;</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><title>&also-tt;</title>
<para><link linkend="delete-password-alias-1"><citerefentry><refentrytitle>
delete-password-alias</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link
linkend="list-password-aliases-1"><citerefentry><refentrytitle>list-password-aliases
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>, <link linkend="update-password-alias-1"><citerefentry>
<refentrytitle>update-password-alias</refentrytitle><manvolnum>1</manvolnum>
</citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000004909>
