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

User Commands | create-virtual-server(1)

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

## SEE ALSO

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

| Go To Top | Last Changed April 2004

Company Info | Contact | Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.