• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS
• OPERANDS
• EXAMPLES
• EXIT STATUS
• INTERFACE EQUIVALENT
• 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 ][ --passwordfile filename ][ --secure|-s ][ --instance instance_name ] --hosts hosts--mime mime_types_file[ --httplisteners http_listeners ] [ --defaultwebmodule default_web_module ][ --configfile config_file ][ --defaultobj default_object ] [ --state on ] [ --acls acls ][ --acceptlang=false ][ --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.

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.

--passwordfile

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

--secure

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

--instance

name of the instance.

--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.

--mime

the ID of the mime element used by the virtual server.

--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.

--configfile

typically all virtual server initialization is from $INSTANCE_ROOT/config/obj.conf. This can be changed using this attribute.

--defaultobj

names the object loaded from an obj.conf file which is default. The default object is expected to have all the name translation directives for the virtual server. Any server behavior that is configured in the default object affects the entire virtual server class.

--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.

--acls

a comma-separated list of ID attributes of ACL elements. Specifies the ACL files used by the virtual server.

--acceptlang

when turned on, the server parses the Accept-Language header and sends an appropriate language version based on which language the client can accept. Set this value to ON only if the server supports multiple languages. The default setting is determined from the virtual-server-class.

--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 admin --password adminadmin --host fuyako --port 7070 --httplisteners http-listener-1 --defaultwebmodule simple --configfile config/obj.conf --defaultobj default --state on --acls acl1 --no-acceptlang --logfile server.log --property User=admin:Password=admin --hosts sample1,sample2 --mime mime1 sample_vs1
Created virtual server with id = sample_vs1

Where sample_vs1 is the virtual server created.

EXIT STATUS

0

command executed successfully

1

error in executing the command

INTERFACE EQUIVALENT

HTTP Server node, Virtual Servers page

SEE ALSO

delete-virtual-server(1), list-virtual-servers(1)