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

Sun Java System Application Server | Go To Top | Last Changed 24 Dec 2003

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