Administration Tool: Virtual Hosts

Panel Description

Documentation Contents

/ Documentation Index

/ Glossary

/ Administration Tool Help

Purpose

If your machine is set up with a single interface card and IP address, you can configure your system to add additional host names by using the Virtual Hosts Setup panel. (The primary host name must already have been entered on the Network Setup panel.) To the user, each virtual host on Java Web Server appears as if it were a separate machine with its own document root.

You can also take advantage of the abilities of a Domain Name Server (DNS) to assign separate domain names to each of your virtual hosts. Having previously mapped both primary and virtual host names to the same IP address in your Domain Name Server, you could then assign the host names to domain names. For example:

primary virtual

host name:port muddy:8080 zebop:8080

domain name www.companyA.com www.companyB.com

	primary	virtual
host name:port	muddy:8080	zebop:8080
domain name	www.companyA.com	www.companyB.com

Note: In Java Web Server, virtual hosting defines only separate document roots -- it does not separate environments in any other way. It is implemented using the HTTP/1.1 HOST header. For more information on the use of virtual hosts with Java Web Server, see the Configuring Virtual Hosts online document.

Location of panel in Administration Tool:

Log In	-->		Service name	-->	Manage	-->	Setup
							\|_ Virtual Hosts

Fields

Host
The host name as it would appear in the URL that is used to locate the page (for example, zebop or muddy).

Document Root
The primary document directory that contains the documents you want to serve for this host. You can enter either an absolute path name or a relative path name. An absolute path name begins with a slash / and indicates a top-level directory (root) of the device. A relative path name has no beginning slash and indicates a subdirectory relative to the server root (that is, a directory under the one in which Java Web Server was installed).

Note: You cannot set up individual cgi-bin directories for virtual hosts. All CGI scripts must be run from the Java Web Server cgi-bin directory, server_root/cgi-bin.

Buttons

Add
Adds a new alias path name to your alias list.

Modify
Selects a field and allows you to modify the selected alias path name.

Remove
Removes the selected alias from the alias list.

Save
Writes your changes to Java Web Server and changes the settings.

Revert
Returns to the last saved settings for all fields in the screen. Use this button to undo changes you have not yet saved.

Note: If you Add, Modify, or Remove a host, you must Save before the changes take affect.

Procedures

To Add a New Virtual Host

To Modify a Virtual Host Entry

To Remove a Virtual Host Entry

Top

java-server-feedback@java.sun.com