2.9.1 change-master-password

Synopsis

asadmin [asadmin-options] change-master-password [--help]
    [--nodedir node-dir] [--domaindir domain-dir]
    [--savemasterpassword={false|true}] [domain-name|node-name]

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The change-master-password subcommand of asadmin is used to modify the master password. This command is interactive such that the user is prompted for both the old and new master passwords.

This command will not work unless the server is stopped. In a distributed environment, this command must be executed on each machine in the domain.

Precondition

The DAS or server instance must be stopped before executing the change-master-password subcommand.

Environment variable

AS_DEF_DOMAINS_PATH

Files

If the --savemasterpassword option of change-master-password subcommand is set to true, then the master password is changed and written to the master-password file in the domains/domain-dir directory).

Arguments

--help | -?

Displays the help text for the subcommand.

--nodedir node-dir

Specifies the name of the directory containing the node instance, for which the password will be changed. If this option is excluded, the change is applied to the entire domain.

Type: String

The following values can be specified:

• File path of a directory where the node resides

Default value: N/A

--domaindir domain-dir

Specifies the name of the domain directory used for this operation. By default, the --domaindir option is $AS_DEF_DOMAINS_PATH, which is an environment variable defined in the asenv.bat or asenv.conf file.

Type: String

The following values can be specified:

• Domain directory name

Default value: $AS_DEF_DOMAINS_PATH (which is an environment variable)

--savemasterpassword={false|true}

Indicates whether the master password should be written to the file system.

This is necessary so that the start-domain subcommand can start the server without having to prompt the user.

Type: Boolean

The following values can be specified:

• true

• false

Default value: false

domain-name | node-name

Specifies the name of the domain or node for which the password will be changed. If there is a single domain, this is optional.

Type: String

The following values can be specified:

• Name of a domain or a node

Default value: N/A

asadmin change-master-password domain44ps

Exit Status

Exit Status	Explanation
0	command executed successfully.
1	error in executing the command.