2.9.18 update-file-user

Synopsis

asadmin [asadmin-options] update-file-user [--help]
    [--groups user_groups[:user_groups]...] [--target target]
    [--authrealmname authrealm_name] username

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The update-file-user subcommand of asadmin updates an existing entry in the keyfile using the specified user name, password and groups. Multiple groups can be entered by separating them, with a colon (:).

If a new password is not provided, this subcommand fails if secure administration is enabled and the user being updated is an administrative user.

Precondition

Domain Administration Server (DAS) is running.

Files

keyfile file at domain-dir/domain_name/config directory is updated.

Arguments

--help | -?

Displays the help text for the subcommand.

--groups user_groups[:user_groups]...

Specifies the name of the group to which the file user belongs.

Type: String

The following values can be specified:

• Group names

Default value: N/A

--target target

Specifies the target on which you are updating a file user.

Type: String

The following values can be specified:

• server

  Updates the file user in the default server instance. This is the default value.

• cluster_name

  Updates the file user on every server instance in the cluster.

• instance_name

  Updates the file user on a specified sever instance.

Default value: server

--authrealmname authrealm_name

Specifies the name of the authentication realm where the user to be updated can be found.

Type: String

The following values can be specified:

• Name of the authentication realm

Default value: file

username

Specifies the name of the file user to be updated.

Type: String

The following values can be specified:

• File user name

Default value: N/A

asadmin update-file-user --target instance1 
--groups staff:manager:engineer sample_user

Exit Status

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