WebSphere Application Server Network Deployment, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Configuring virtual hosts

For configuration purposes, a virtual host enables WebSphere Application Server to treat multiple host machines or port numbers as a single logical host (virtual host). You can combine multiple host machines into a single virtual host or assign host machines to different virtual hosts, to separate and control which WebSphere Application Server resources are available for client requests.

Before you begin

If your external HTTP server configuration uses the default port (9080), you do not have to perform these steps.

Why and when to perform this task

You must update the HTTP port numbers associated with the default virtual host. or define a new virtual host and associate it with the ports your HTTP server configuration uses if:

If you define new virtual host aliases, identify the port values that the aliases use on the HTTP transport collection page.

To create a new virtual host or change the configuration of an existing virtual host:

Steps for this task

  1. In the administrative console, click Environment > Virtual Hosts.
  2. Optional: Create a new virtual host. If you create a new virtual host, a default set of 90 MIME entries are automatically created for that virtual host.
    1. In the administrative console, click New.
    2. Enter the name of the new virtual host and click OK. The new virtual host appears in the list of virtual hosts you can configure.
  3. Select the virtual host whose configuration you want to change.
  4. Under Additional Properties, click Host Aliases.
  5. Create new host aliases or update existing host aliases to associate each of your HTTP port numbers with this virtual host.

    There must be a virtual host alias corresponding to each port your HTTP server configuration uses. There is one HTTP port associated with each Web container, and it is usually assigned to the virtual host named default_host. You can change the default assignment to any valid virtual host.

    The host aliases associated with the default_host virtual host are set to * when you install WebSphere Application Server. The * (an asterisk) indicates that the alias name does not have to be specified or that any name can be specified.

    When the URL for the application is entered into a Web browser, the port number is included. For example, if 9082 is the port number, the specified URL might look like the following:
    http://localhost:9082/wlm/SimpleServlet

    To create a new host alias:

    1. Click New.
    2. Specify a host alias name in the Host Name field and one of your HTTP ports in the Port field.

      You can specify * (an asterisk) for the alias name if you do not want to require the specification of the alias name or if you want to allow any name to be specified.

    3. Click OK and Save to save your configuration change.
    To update an existing host alias:
    1. Select an existing host alias name.
    2. Change the value specified in the Port field to one of your HTTP ports.
    3. Click OK and Save to save your configuration change.
  6. Optional: Define a MIME object type and its file name extension if you require a MIME type other than the pre-defined types.
    1. For each needed MIME entry on the MIME type collection page, click New.
    2. On the MIME type settings page, specify a MIME type and extension.
    3. Click OK and Save to save your configuration change.
  7. Regenerate the Web server plug-in configuration.
    1. Click Servers > Web servers, then select the appropriate Web server.
    2. Click Generate Plug-in, then click Propagate Plug-in.
  8. Restart the application server.



Sub-topics

Related concepts
Virtual hosts
Transports

Related tasks
Exporting applications

Task topic    

Terms of Use | Feedback

Last updated: Dec 11, 2005 4:07:15 PM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/tcws_plugin_vhost.html

© Copyright IBM Corporation 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)