IBM Support

WebGroup/Virtual Host to handle index.jsp has not been defined

Technote (troubleshooting)


You are unable to browse store pages when using port 80. You attempt to access the home page for one of the WebSphere Commerce starter stores (for example, ConsumerDirect) and an error message displays. An example of the error message follows:

A WebGroup/Virtual Host to handle /webapp/wcs/stores/servlet/ConsumerDirect/index.jsp has not been defined.


The virtual host definitions in the WebSphere Application Server is not functioning properly.

Diagnosing the problem

To verify this situation, attempt to access the starter store's home page using port 8000 instead of port 80. For example, if ConsumerDirect was published, try to access the store using https://localhost:8000/webapp/wcs/stores/servlet/ConsumerDirect/index.jsp. If port 8000 was successful, then the virtual host definitions need to be updated. If you are not able to access the store with port 8000, you may want to check the console logs and verify that the WebSphere Commerce application started properly.

Resolving the problem

To change the virtual host definitions:

  1. Start the WebSphere Commerce Test Server using either the Rational Application Developer interface or using the startWCServer.bat script.
  2. Access the WebSphere Application Server Administrative Console.
  3. Select Environment >Virtual Hosts.
  4. Select the default_host entry.
  5. From the "additional properties" section select Host Aliases.
  6. Delete the references to port 80 and 443.
  7. Save your change to the master configuration.
  8. Restart the server.

You should now be able to access the starter stores using port 80.

Document information

More support for: WebSphere Commerce Developer Enterprise

Software version: 6.0

Operating system(s): Windows

Software edition: All Editions

Reference #: 1230161

Modified date: 12 May 2006

Translate this page: