asadmin-create-instance(1AS)											      asadmin-create-instance(1AS)

y"; "User Commands"

NAME

       asadmin-create-instance, create-instance - creates an application server instance with the specified instance name

SYNOPSIS

       create-instance	  [--user  admin_user]	[-password  admin_password]  [--host  localhost]  [--port  4848]  [--sysuser  sys_user]  [--domain
       domain_name] [--local=false] [--passwordfile filename] [--secure|-s]--instanceport instanceportinstance_name

       You can create a new instance on a local or remote machine. If on the remote machine an administration server is already  running  for  the
       specified  hostname,  then  the	system	defaults  to the local hostname.  To create the instance locally, not requiring the administration
       server to be up and running, specify the --local option.  The named instance must not exist within that domain.

OPTIONS

       --user		       administrative user associated for the instance.

       --password	       administrative password corresponding to the administrative user.

       --host		       host name of the machine hosting the administrative instance.

       --port		       administrative port number associated with the administrative host.

       --sysuser	       owner of the domain directory.

       --domain 	       name of the domain.

       --local		       determines if the command should delegate the request to administrative instance or run locally.

       --passwordfile	       file containing passwords appropriate for the command (e.g., administrative instance).

       --secure 	       if true, uses SSL/TLS to communicate with the administrative instance.

       --instanceport	       port where the instance listens for requests.

OPERANDS

       instance_name		name of the instance to be created.

       Example 1: Using create-instance in local mode

       asadmin> create-instance --domain domain1 --instanceport 8967 --sysuser adminuser server4
       Created Instance server4 successfully

       Where: the server4 instance is created under the domain1 domain.

       Example 2: Using create-instance in remote mode

       asadmin> create-instance --sysuser adminuser --user admin
       --password adminadmin --host localhost --port 4848 --instanceport 8967 server4
       Created Instance server4 successfully

       Where: the server4 instance is created on the remote server for the associated user, password, host, and port.

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

INTERFACE EQUIVALENT

       Application Server instances page

       asadmin-delete-instance(1AS), asadmin-start-instance(1AS), asadmin-stop-instance(1AS), asadmin-restart-instance(1AS)

J2EE 1.4 SDK/refmiscinfo>					    March 2004					      asadmin-create-instance(1AS)