How to diagnose error "SRVE0255E: A WebGroup/Virtual Host to handle {0} has not been defined"

Body

Error SRVE0255E means that the webcontainer could not find a web group (web module) or virtual host to handle the request.

Here are the steps to diagnose this error:

1. Make sure that the URL entered at the browser is correct. Particularly, make sure that the context root from the URL matches the context root configured for the application.

2. Review the SystemOut.log to make sure that the application and server are started successfully and without any errors.

3. Verify that the application web module is mapped to the correct/intended virtual host. You can do this from the admin console by navigating to the following path:

Applications > Websphere enterprise applications > [app_name] > Virtual hosts

4. Under the virtual host that the application is mapped to (#3), make sure that there is a host alias definition for the host name and port number that this request is sent to. You can do this from the admin console by navigating to the following path:

Environment > Virtual hosts > [virtual_host_name] > Host aliases

5. Check the host alias definitions for other virtual hosts on this same server and make sure that there is no duplicate host alias definition with the same host name and port number. For example, if you have a host alias definition for host name www.example.com and port number 9080 under the virtual host default_host, you must NOT have a duplicate host alias definition, something like hostname * and port number 9080, under another virtual host such as custom_host.