creates a new file user


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


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.



Displays the help text for the subcommand.


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.


This is the group associated with this file user.


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.



This is the name of file user to be created.


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


subcommand executed successfully


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)