Sun Microsystems Documentation
Begin Tab Sub LinksActive Sub LinkView this Book Download this Book

Sun Java System Web Server 7.0 Update 2 >> Sun Java System Web Server 7.0 Update 2 CLI Reference Manual >> User Commands >> create-virtual-server(1) – creates a new virtual server

create-virtual-server(1)

NAME | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also

NAME

    create-virtual-server – creates a new virtual server

Synopsis

    create-virtual-server <connect_options> [--echo|-e] [--no-prompt|-Q] 
    [--verbose|-v] [--http-listener-name|-l lsid] [--host-pattern|-t
     pattern1, pattern2 ...] [--canonical-server-name|-n hostname] 
    [--log-file|-f path] [--document-root|-d path] 
    --config|-c name virtual-server-name
    

Description

    Use this command to create a new virtual server. The settings for virtual servers are stored in the server.xml file in the server_root/server_ID/config directory. All virtual servers have an HTTP listener specified. When a new request comes in, the Web Server determines which virtual server to send it to based on the configured HTTP listener.

Options

    For connect_options description, see help(1).

    --echo|-e

    Specify this option to print this command on the standard output before executing. This option also prints the default value for all the non-mandatory options that you do not provide in the command.

    --no-prompt|-Q

    If you specify this option, wadm will not prompt you for passwords while executing this command. Use this option if you have defined all passwords in a password file and specified the file using the --password-file connect_option.

    --verbose|-v

    Specify this option to display a verbose output.

    --http-listener-name|-l

    Specify the name of an HTTP listener associated with one or more of the virtual server's host names.

    --host-pattern|-t

    Define a list of hosts to be added to the new virtual server. To specify multiple URLs, separate them by a comma (,).

    --canonical-server-name|-n

    Specify a canonical host name of the virtual server. Requests that use a different host name will be redirected to this host name.

    --log-file|-f

    Specify a log file for the ACL file that controls access to the virtual server.

    --document-root|-d

    Specify the document root for the virtual server.

    --config|-c

    Specify the configuration where you want to create a new virtual server.

Operands

    virtual-server-name

    Specify the name of the virtual server.

Examples


    wadm create-virtual-server --user=admin --host=serverhost
    --password-file=../admin.passwd --port=8989 --ssl=true --no-prompt 
    --rcfile=null --config=config1 --host-pattern=eas157,eas156 
    --canonical-server-name=oldiws --log-file=log-file 
    --document-root=../docs vs
    

Exit Status

    The following exit values are returned:

    0

    command executed successfully

    >0

    error in executing the command

See Also

SJS Web Server  Last Revised March 2007

NAME | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also

ContactAbout SunNewsEmploymentSite MapPrivacyTerms of UseTrademarksCopyright Sun Microsystems, Inc.