Sun Java System Application Server Enterprise Edition 8.1 2005Q2 Administration Guide

- Previous: Admin Console Tasks for the HTTP Service
- Next: To edit a virtual server

## To create a virtual server

1. In the tree component, expand the Configurations node.

2. Select the instance to configure:

   - To configure a particular instance, select the instance’s config node. For example, for the default instance, `server`, select the `server-config` node.

   - To configure the default settings for future instances that use a copy of `default-config`, select the `default-config` node.

3. Expand the HTTP Service node.

4. Select the Virtual Servers node.

5. On the Virtual Servers page, click New.

   The Create Virtual Server page appears.

6. In the ID field, type a unique name for the virtual server.

   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.

7. In the Hosts field, type 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).

8. In the area opposite State, select either On, Off, or Disabled.

   The default is On.

9. Leave the HTTP Listeners 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. Since a listener must be associated with an existing virtual server when it is created, all existing listeners are used by another virtual server.

10. From the Default Web Module drop-down list, 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.

11. In the Log File field, type 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`.

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

13. Click OK to save the virtual server.

##### Equivalent asadmin command

`create-virtual-server`

- Previous: Admin Console Tasks for the HTTP Service
- Next: To edit a virtual server

- © 2010, Oracle Corporation and/or its affiliates