2.9.3 create-file-user

Synopsis

asadmin [asadmin-options] create-file-user [--help]
    [--authrealmname auth_realm_name] [--target target]
    [--groups user_groups[:user_groups]...] user_name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-file-user subcommand creates an entry in the keyfile with the following:

• Specified username

• Password

• Groups

You can create multiple groups can be created by separating them with a colon (:). If the auth_realm_name is not specified, an entry is created in the keyfile for the default realm. If the auth_realm_name is specified, an entry is created in the keyfile using the auth_realm_name.

The --passwordfile option of the asadmin command can be used to specify the password for the user. The password file entry must be of the form AS_ADMIN_USERPASSWORD=user-password. If a password is not provided, this command fails (only when secure administration is enabled and the user being created is an administrative user.)

This command is supported in remote mode only.

Precondition

The DAS should be in a running state.

Files

When the create-file-user subcommand is executed with --passwordfile option , then the password file entry must be of the form AS_ADMIN_USERPASSWORD=user-password.

Arguments

--help | -?

Displays the help text for the subcommand.

--target target

Specifies the name of the target on which the command operates.

Type: String

The following values can be specified:

• server

• configuration_name

• cluster_name

• instance_name

Default value: server

--groups user_groups[:user_groups]...

Specifies the group associated with this file user.

Type: String

The following values can be specified:

• Group name

Default value: N/A

--authrealmname auth_realm_name

Specifies the name of the realm in which the new user is created. If this option is not specified, the user is created in the file realm.

Type: String

The following values can be specified:

• Realm name

Default value: file

user_name

Specifies the name of the file user to be created.

Type: String

The following values can be specified:

• Name of user

Default value: N/A

asadmin create-file-user
--target instance1
--groups staff:manager
--authrealmname auth-realm1 sample_user

Exit Status

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