asadmin-create-auth-realm(1AS)					   User Commands				    asadmin-create-auth-realm(1AS)

NAME

       asadmin-create-auth-realm, create-auth-realm - adds the new authorized realm

SYNOPSIS

       create-auth-realm  --user  admin_user  [--password admin_password] [--host localhost] [--port 4848] [--secure|-s] [--passwordfile filename]
       [--terse=false] [--echo=false] [--interactive=true] --classname realm_class [--property (name=value)[:name=value]*] auth_realm_name

       Adds the named authorized realm. 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.

       --classname	       Java class which implements this realm.

       --property	       optional attributes name/value paris of provider implementation specific attributes.

OPERANDS

       auth_realm_name	       name of this realm.

       Example 1: Using create-auth-realm

       asadmin> create-auth-realm --user admin1 --password adminadmin1
       --host pigeon --port 5001 --classname com.iplanet.ias.security.auth.realm.DB.Database
       --property defaultuser=admin:Password=admin db
       Command create-auth-realm executed successfully

       Where db is the auth realm created.

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

       asadmin-delete-auth-realm(1AS), asadmin-list-auth-realms(1AS)

J2EE 1.4 SDK							    March 2004					    asadmin-create-auth-realm(1AS)