Sun Java System Web Server 6.1 SP12 Administrator's Guide

Setting Up Virtual Servers

To set up virtual servers, follow these steps

ProcedureTo set up virtual server

  1. Create a listen socket

  2. Create a class of virtual servers

  3. Configure the services for the class

  4. Create the virtual servers in a virtual server class

  5. Configure virtual servers

    Please note that you must enter an existing virtual server in the default virtual server field when you create a listen socket. You can use the virtual server created when you installed the server, and then go back and change it after you’ve created additional virtual servers.

Creating a Listen Socket

To create a listen socket, perform the following steps:

ProcedureTo create a listen socket

  1. From the Server Manager, click the Preferences tab.

  2. Click Add Listen Socket.

  3. Fill in the fields.

    Listen sockets must have a unique combination of port number and IP address. You can use either IPV4 or IPV6 addresses. If you want to create a listen socket for IP-address-based virtual servers, the IP address must be 0.0.0.0, ANY, any or INADDR_ANY, meaning it listens on all IP addresses on that port.

    You can also enable security (SSL) for this listen socket.

    The Server Name field specifies the host name in the URLs the server sends to the client. This field affects URLs the server automatically generates. It does not affect the URLs for directories and files stored in the server. This name should be the alias name if your server uses an alias.

  4. Click OK.

Creating a Virtual Server Class

To create a virtual server class, perform the following steps:

ProcedureTo create a virtual server class

  1. From the Server Manager, click the Virtual Server Class tab.

  2. Click Add Class.

  3. Name the class.

  4. Insert a document root for the class.

    The directory must already exist. All virtual servers for this class will have document roots in this absolute path, unless you specify otherwise. If you use /$id as the last part of the path, a document root folder named for the virtual server ID is automatically created within the class’ document root path.

  5. Click OK.

    Once you have created a class of virtual servers, choose the services associated with the class. For more information, see Chapter 17, Content Management.

Editing or Deleting a Virtual Server Class

To edit a virtual server class’s settings, perform the following steps:

ProcedureTo edit a virtual server class's settings

  1. From the Server Manager, click the Virtual Server Class tab.

  2. Click Edit Classes.

  3. From the drop-down list next to the class you want, choose Edit or Delete.

    You cannot delete the default class.

  4. Use the Document Root field to change to absolute path to the class’ default document root.

    The document roots for virtual servers in this class are created within this directory by default.

  5. Enter On in the Accept Language field if you wish this class of virtual servers to use accept language header parsing.

    The default is Off.

  6. If you want to change the CGI defaults associated with a class, click Advanced.

    A window with the CGI defaults appears. Edit the fields and click OK to return to the Edit a Class window. The Reset button rolls back your changes.

  7. Click OK. The class is changed or deleted.

Specifying Services Associated with a Virtual Server Class

Some of the characteristics that differentiate one class of virtual servers from another are the services that are enabled for that class of virtual servers. For example, one class of virtual servers might have CGIs enabled while another doesn’t. For more information on setting up services, see Chapter 17, Content Management.

Creating a Virtual Server

Once you have set up a virtual server class, you can create a virtual server. Because virtual servers are members of a particular virtual server class, you create virtual servers on the Class Manager.

For more information, see Creating a Virtual Server.

Specifying Settings Associated with a Virtual Server

You can override some class settings at the virtual server level and also configure additional settings. You configure these settings in the Class Manager.

For more information, see Creating a Virtual Server.