
Administration Commands                 change-master-password(1)

NAME
     change-master-password - changes the master password

SYNOPSIS
     change-master-password  [--domaindir domain_path | --agentdir node-agent_path]
     [--savemasterpassword=false] [domain_name | node_agent_name]

DESCRIPTION
     This local command is used to modify  the  master  password.
     change-master-password  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  com-
     mand  must  run on each machine in the domain, with the node
     agent stopped.

OPTIONS
     --domaindir                 This option specifies the direc-
                                 tory  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.

     --agentdir                  Like  a  DAS,  each  Node  Agent
                                 resides in a top level directory
                                 named
                                 <agentdir>/<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.

     --savemasterpassword        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.

Java EE 5           Last change: 30 Jan 2007                    1

Administration Commands                 change-master-password(1)

                                 NOTE: if  savemasterpassword  is
                                 not  set,  the  master  password
                                 file,  if  it  exists,  will  be
                                 deleted.

OPERANDS
     domain_name                 This is the  domain  name  whose
                                 password  is  to  be changed. If
                                 there is only a  single  domain,
                                 this is optional.

     node_agent_name             This is the  name  of  the  node
                                 agent  whose  password  is to be
                                 changed.

EXAMPLES
     Example 1 Using the change-master-password command

     This example assumes that you have used  the  asadmin  login
     command before using the change-master-password command.

       asadmin>change-master-password domain44ps
       Please enter the new master password>
       Please enter the new master password again>
       Master password changed for domain44ps

EXIT STATUS
     0                           command executed successfully

     1                           error in executing the command

SEE ALSO
     delete-password-alias(1), list-password-aliases(1),  update-
     password-alias(1)

Java EE 5           Last change: 30 Jan 2007                    2

