asadmin-create-file-user(1AS)					   User Commands				     asadmin-create-file-user(1AS)

NAME

       asadmin-create-file-user, create-file-user - createsa new file user

SYNOPSIS

       create-file-user  --user  admin_user  [--password  admin_password]  [--host localhost][--port 4848] [--secure|-s] [--passwordfile filename]
       [--terse=false] [--echo=false] [--interactive=true] [--userpassword user_password] [--groups  user_groups:[user_groups]*]  [--authrealmname
       auth_realm_name] user_name

       Creates an entry in keyfile with the specified username, userpassword, and groups. 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 default keyfile. If auth_realm_name is specified,  an  entry
       is created in the keyfile where the auth-realm name in the domain.xml file points to.

       This command is supported in remote mode only.

OPTIONS

       --user		       authorized domain application server administrative username.

       --password	       password to administer the domain application server.

       --host		       machine name where the domain application server is running.

       --port		       port number of the domain application server listening for administration requests.

       --secure 	       if true, uses SSL/TLS to communicate with the domain application server.

       --passwordfile	       file containing the domain application server password.

       --terse		       indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-
			       formatted data for consumption by a script. Default is false.

       --echo		       setting to true will echo the command line statement on the standard output. Default is false.

       --interactive	       if set to true (default), only the required password options are prompted.

       --userpassword	       password for the file user.

       --groups 	       group where the file user belongs to.

       --authrealmname	       name, in the domain.xml file, where you have different stores for file auth realm.

OPERANDS

       user_name	       name of file user to be created.

EXAMPLES

       Example 1: Using the create-file-user command

       It is assumed that an authority realm has already been created using the create-auth-realm command.

       asadmin> create-file-user --user admin1 --password adminadmin1
       --host pigeon --port 5001 --userpassword sample --groups staff:manager
       --authrealmname auth-realm1 sample_user
       Command create-file-user executed successfully

       Where: the sample_user is the file user created.

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

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

J2EE 1.4 SDK							    March 2004					     asadmin-create-file-user(1AS)