Skip Headers
Oracle GlassFish Server Reference Manual
Release 3.1.2

Part Number E24938-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

create-file-user

creates a new file user

Synopsis

create-file-user [--help] [--authrealmnameauth_realm_name] 
[--target target 
[--groups user_groups[:user_groups]*] user_name

Description

The create-file-user subcommand creates an entry in the keyfile with the specified username, password, and groups. Multiple groups can be created by separating them with a colon (:). If auth_realm_name is not specified, an entry is created in the keyfile for the default realm. If auth_realm_name is specified, an entry is created in the keyfile using the auth_realm_name.

You can use the --passwordfile option of the asadmin(1M) command 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 subcommand fails if secure administration is enabled and the user being created is an administrative user.

This subcommand is supported in remote mode only.

Options

--help
-?

Displays the help text for the subcommand.

--target

This is the name of the target on which the command operates. The valid targets are config, instance, cluster, or server. By default, the target is the server.

--groups

This is the group associated with this file user.

--authrealmname

The name of the realm in which the new user is created. If you do not specify this option, the user is created in the "file" realm.

Operands

user_name

This is the name of file user to be created.

Examples

Example 1   Creating a User in the File Realm

This example creates a file realm user named sample_user. It is assumed that an authentication realm has already been created using the create-auth-realm subcommand.

asadmin> create-file-user 
--groups staff:manager 
--authrealmname auth-realm1 sample_user
Command create-file-user executed successfully

Exit Status

0

subcommand executed successfully

1

error in executing the subcommand

See Also

create-auth-realm(1), delete-file-user(1), list-file-users(1), update-file-user(1), list-file-groups(1)

asadmin(1M)