Modify-servlet-path task fails with a SRVE0255E exception

Technote (troubleshooting)


When attempting to modify Portal's URI, the modify-servlet-path task fails during the action-install-pznauthor-portlet subtask.


The modify-servlet-path fails and in the configTrace.log, the following xmlaccess exception is noted:

[xmlaccess] <H1>SRVE0255E: A WebGroup/Virtual Host to handle /<new context root>/config has not been defined.</H1><BR><H3>SRVE0255E: A WebGroup/Virtual Host to handle <hostname>:<port> has not been defined.</H3><BR><I>IBM WebSphere Application Server</I>


This issue was encountered as the wpsContextRoot was set to the same value as the WsrpContextRoot in the and file. These values must be different

Diagnosing the problem

The root issue was that Portal failed to start and specifically, the wps application fails to initialize.

In the systemOut.log this exception was noted during wps startup:

[6/20/12 8:11:02:111 EDT] 0000001d webcontainer E addWebApplication SRVE0164E: Web
Application WPS Enterprise Application#WebSphere Portal Server WSRP
Facade uses the context root /<new context root>/*, which is already in use
by Web Application wps#WebSphere Portal Server. Web Application
WebSphere Portal Server WSRP Facade will not be loaded.
[6/20/12 8:11:02:305 EDT] 0000001d DeployedAppli W WSVR0206E: Module,
wps_facade.war, of application, wps.ear/deployments/wps, failed to start
[6/20/12 8:11:02:311 EDT] 0000001d ApplicationMg W WSVR0101W: An
error occurred starting, wps
[6/20/12 8:11:02:313 EDT] 0000001d ApplicationMg A WSVR0217I:
Stopping application: wps

The FFDC log also notes:

Caused by:
Failed to load webapp: Context root /<new context root>/* is already bound.
Cannot start application WebSphere Portal Server WSRP Facade
... 16 more

Resolving the problem

WSRP Facade is part of wps.ear and requires a unique contextroot (default: /wsrp)

To resolve this exception, either the WpsContextRoot or the WsrpContextRoot will need to be modified.

Once done, re-attempt the modify-servlet-path task.

Document information

More support for:

WebSphere Portal

Software version:

6.1, 6.1.5, 7.0, 8.0

Operating system(s):

AIX, IBM i, Linux, Solaris, Windows, z/OS

Reference #:


Modified date:


Translate my page

Content navigation