#### To create a Virtual Server

1. Expand the Configuration node and the HTTP Service node.

2. Select the Virtual Servers node.

3. Click New.

4. Define the Virtual Server settings as follows:

   - ID: This value is used to identify the virtual server internally. It is not exposed to HTTP clients. The host names that are exposed to HTTP clients must be specified in the Hosts field.

   - Hosts: Enter the host name or names for the machine on which the server is running. Use either actual or virtual host names that are registered with the DNS server for your network (and, on a UNIX system, in your `/etc/hosts` file).

   - State: Select the desired state for the virtual server. The default is On.

   - HTTP Listeners: Leave this field empty. It is filled in automatically when you create an HTTP listener and associate it with this server.

     Use of this field requires that you specify an existing HTTP listener. You must not, however, specify a listener that is used by another virtual server; if you do, an error appears in the server log when you restart the server. Since a listener must be associated with an existing virtual server when it is created, all existing listeners are used by another virtual server.

   - Default Web Module: Choose the deployed web module (if any) that is to respond to all requests that cannot be mapped to other web modules deployed to the virtual server. If a Default Web Module is not specified, the web module that has an empty context root is used. If there is no web module with an empty context root, a system default web module is created and used.

   - Log File: Enter the path name of the file where logging messages from this virtual server will appear. Leave this field empty to send logging messages to the default server log, domain-dir`/logs/server.log`.

5. In the Additional Properties area, click Add Property to add a property for the virtual server.

   Whether you specify properties or not, the new server has the default properties `docroot` and `accesslog`, set to default values.

   The following table lists the available virtual server properties.

   Property Name | Description
   --- | ---
   `docroot` | Absolute path to root document directory for server. Default is domain-dir`/docroot.`
   `accesslog` | Absolute path to server access logs. Default is domain-dir`/logs/access`.

   `sso-enabled`

   If false, single sign-on is disabled for this virtual server, and users must authenticate separately to every application on the virtual server.

   Single sign-on across applications on the Application Server is supported by servlets and JSP pages. This feature allows multiple applications that require the same user sign-on information to share this information, rather than have the user sign on separately for each application.

   Default is true.

   `sso-max-inactive-seconds`

   Specifies the number of seconds after which a user's single sign-on record becomes eligible for purging if no client activity is received. Since single sign-on applies across several applications on the same virtual server, access to any of the applications keeps the single sign-on record active.

   Default is 300 seconds (5 minutes). Higher values provide longer single sign-on persistence for users at the expense of more memory use on the server.

   `sso-reap-interval-seconds` | Specifies the number of seconds between purges of expired single sign-on records. Default is 60.

   `allowLinking`

   If true, resources that are symbolic links will be served for all web applications deployed on this virtual server. Individual web applications may override this setting by using the `sun-web-app` property `allowLinking` in the `sun-web.xml` file:

       <sun-web-app>
          <property name="allowLinking"
             value="{true|false}"/>
       </sun-web-app>

   Default is true.

6. Click OK to save the virtual server.

7. Stop and restart the Application Server.

##### More Information
Equivalent asadmin command

`create-virtual-server`

##### See Also

- To create an HTTP listener

- To edit a virtual server

- To delete a Virtual Server