create-file-user

Creates a new file user.

Synopsis

asadmin [asadmin-options] 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 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

asadmin-options

Options for the asadmin utility. For information about these options, see the asadmin help page.

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