asadmin-create-virtual-server(1AS)				   User Commands				asadmin-create-virtual-server(1AS)

NAME

       asadmin-create-virtual-server, create-virtual-server - adds the named virtual server

SYNOPSIS

       create-virtual-server  --user  admin_user  [--password admin_password] [--host localhost] [--port 4848] [--secure|-s] [--passwordfile file-
       name]  [--terse=false]	[--echo=false]	 [--interactive=true]	--hosts   hosts   [--httplisteners   http_listeners]   [--defaultwebmodule
       default_web_module] [--state on] [--logfile log_file] [--property (name=value)[:name=value]*] virtual_server_id

       Creates the named virtual server. Virtualization in the Application Server allows multiple URL domains to be served by the same HTTP server
       process which is listening on multiple host addresses. If the application is available at two virtual servers, they still  share  the  same
       physical resource pools.

       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.

       --hosts		       a comma separated (,) list of values allowed in the host request header to select the current virtual server.  Each
			       virtual server that is configured to the same connection group must have a unique hosts value for that group.

       --httplisteners	       optional;  a  comma  separated  (,)  list  of HTTP listener IDs. Required only for a virtual server that is not the
			       default virtual server.

       --defaultwebmodule      standalone web module associated with this virtual server by default.

       --state		       determines whether a virtual server is active (on) or inactive (off or disabled).  Default  is  active  (on).  When
			       inactive, the virtual server does not service requests.

       --logfile	       name of the file where the log has to be written to.

       --property	       optional attributes name/value pairs for configuring the connection pool.

OPERANDS

       virtual_server_id       identifies the unique ID for the virtual server to be created. This virtual server ID cannot begin with a number.

       Example 1: Using create-virtual-server

       asadmin> create-virtual-server --user admin1 --password adminadmin1
       --host pigeon --port 5001 --httplisteners http-listener-1 --defaultwebmodule simple
       --state on --logfile server.log --property User=admin:Password=admin
       --hosts sample1,sample2 sample_vs1
       Command create-virtual-server executed successfully

       Where sample_vs1 is the virtual server created.

EXIT STATUS

       0		       command executed successfully

       1		       error in executing the command

       asadmin-delete-virtual-server(1AS), asadmin-list-virtual-server(1AS)

J2EE 1.4 SDK							    March 2004					asadmin-create-virtual-server(1AS)