<!--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-master-password-1">
<!-- @(#)change-master-password.1 1.10 07/04/25 SMI; -->
<refmeta><refentrytitle>change-master-password</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">30 Jan 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-master-password</refname><refpurpose>changes the master password</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>change-master-password</command>  [<option role="double-dash">domaindir</option> <replaceable>
domain_path | </replaceable><option role="double-dash">agentdir</option> <replaceable>node-agent_path</replaceable>]
 [<option role="double-dash">savemasterpassword</option>=<replaceable>false</replaceable>] [<replaceable>
domain_name | node_agent_name</replaceable>]</synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>This local command is used to modify the master password. <command>change-master-password
</command> is interactive in that the user is prompted for the old master
password, as well as the new master password. This command will not work unless
the server is stopped. In a distributed environment, this command must run
on each machine in the domain, with the node agent stopped.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">
<varlistentry><term><option role="double-dash">domaindir</option></term>
<listitem><para>This option specifies the directory used for this operation.
By default, the domaindir is $AS_DEF_DOMAINS_PATH, which is an environment
variable defined in asenv.bat/conf. Both the domaindir and the agentdir options
should not be passed together; use one or the other.</para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">agentdir</option></term>
<listitem><para>Like a DAS, each Node Agent resides in a top level directory
named &lt;agentdir>/&lt;nodeagent_name>. If the agentdir is not specified,
then $AS_DEF_DOMAINS_PATH/../nodeagents is used. Both the domaindir and the
agentdir options should not be passed together; use one or the other. </para>
</listitem>
</varlistentry>
<varlistentry><term><option role="double-dash">savemasterpassword</option></term>
<listitem><para>This option indicates whether the master password should be
written to the file system. This is necessary so that start-domain can start
the server without having to prompt the user. WARNING: saving the master password
on disk is extremely dangerous and should be avoided. </para>
<para>NOTE: if <command>savemasterpassword</command> is not set, the master
password file, if it exists, will be deleted.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>domain_name</replaceable></term>
<listitem><para>This is the domain name whose password is to be changed. If
there is only a single domain, this is optional. </para>
</listitem>
</varlistentry>
<varlistentry><term><replaceable>node_agent_name</replaceable></term>
<listitem><para>This is the name of the node agent whose password is to be
changed. </para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>Using the change-master-password command</title>
<para>This example assumes that you have used the <command>asadmin login</command> command
before using the <command>change-master-password</command> command.</para>
<screen>asadmin><userinput>change-master-password domain44ps</userinput>
Please enter the new master password>
Please enter the new master password again>
Master password changed for domain44ps</screen>
</example>
</refsect1>
<refsect1 role="exit-status"><title></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 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 *0000005300 0>
