create-virtual-server.1


sun.com \| docs.sun.com		How To Buy \| My Sun \| Worldwide Sites

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
OPERANDS
EXAMPLES
EXIT STATUS
SEE ALSO

NAME

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 filename ] [ --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

DESCRIPTION

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.

EXAMPLES

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