Virtual hosts settings

Use this page to specify virtual hosts for web modules contained in your application. Web modules can be installed on the same virtual host or dispersed among several virtual hosts.

To view this administrative console page, click Applications > Application Types > WebSphere enterprise applications > application_name > Virtual hosts. This page is the same as the Map virtual hosts for web modules page on the application installation and update wizards.

On this page, each web module must map to a previously defined virtual host, identified under Virtual host. You can see information on previously defined virtual hosts by clicking Environment > Virtual hosts in the administrative console. Virtual hosts enable you to associate a unique port with a module or application. The aliases of a virtual host identify the port numbers defined for that virtual host. A port number specified in a virtual host alias is used in the URL that is used to access artifacts such as servlets and JavaServer Pages (JSP) files in a web module. For example, the alias myhost:8080 is the host_name:port_number portion of the URL http://myhost:8080/servlet/snoop.

The default virtual host setting usually is default_host, which provides several port numbers through its aliases:

80
An internal, insecure port used when no port number is specified
9080
An internal port
9443
An external, secure port

Unless you want to isolate your web module from other modules or resources on the same node (physical machine), default_host is a suitable virtual host for your web module.

In addition to default_host, the product provides admin_host, which is the virtual host for the administrative console system application. admin_host is on port 9060. Its secure port is 9043. Do not select admin_host unless the web module relates to system administration.

To change a mapping:

  1. In the list of mappings, select the Select check box for each web module that you want mapped to a particular virtual host.
  2. From the Virtual host drop-down list, select the desired virtual host. If you selected more than one web module in step 1:
    1. Expand Apply Multiple Mappings.
    2. Select the desired virtual host from the Virtual Host drop-down list.
    3. Click Apply.
  3. Click OK.
Note: If any value is modified on this page, all of the metadata files related to the application are refreshed in the configuration repository.
Attention: If an application is running, changing an application setting causes the application to restart. On stand-alone servers, the application restarts after you save the change. On multiple-server products, the application restarts after you save the change and files synchronize on the node where the application is installed. To control when synchronization occurs on multiple-server products, deselect Synchronize changes with nodes on the Console preferences page.

Web module

Specifies the name of a web module in the application that you are installing or that you are viewing after installation.

Virtual host

Specifies the name of the virtual host to which the Web module is currently mapped.

Expanding the drop-down list displays a list of previously defined virtual hosts. To change a mapping, select a different virtual host from the list.

Do not specify the same virtual host for different web modules that have the same context root and are deployed on targets belonging to the same node even if the web modules are contained in different applications. Specifying the same virtual host causes a validation error.