Skip to main content

Error while trying to disable welcome-root for JBoss in order to enable custom root page for Aurea Process BPM Portal

Aurea Support
  • Updated

Overview

When attempting to disable the default welcome-root page for Aurea Process BPM Portal implemented on a JBoss Application Server, you modified the value enable-welcome-root in the <JBOSS_HOME>/standalone/configuration/standalone.xml file to display a custom root page at the root domain but the following error is logged:

ERROR [org.jboss.as.server] (HttpManagementService-threads - 2)  
JBAS015870: Deploy of deployment "ROOT.war" was rolled back with the following failure message: 
{"JBAS014671: Failed services" => {"jboss.web.deployment.default-host./ROOT" =>"org.jboss.msc.service.StartException in service jboss.web.deployment.default-host./ROOT: Failed to start service 
Caused by: java.lang.IllegalStateException: JBAS018038: Root contexts can not be deployed when the virtual host configuration has the welcome root enabled, disable it and redeploy"}}

Prerequisites

  • Permissions to edit the portalServer.xml file in <JBOSS_HOME>/portalServer/configuration
  • Permissions to restart the JBoss Application Server for Aurea Process BPM Portal

Solution

Diagnosis

The standalone.xml file is not the configuration file used by the Aurea Process BPM Portal server, therefore modifying the value in this file has no impact for enabling custom root page.

Solution Steps

To enable a custom root page for Aurea Process BPM Portal with JBoss, you will need to do the following:

  1. Open the portalServer.xml file in a text editor.  The portalServer.xml file can be found in <JBOSS_HOME>/portalServer/configuration directory.
  2. In the portalServer.xml file set the value enable-welcome-root to false and save the file
  3. Restart your JBoss server. 

Testing

Once you have updated the portalServer.xml file and restarted your JBoss server, your custom root page should be displayed instead of the default JBoss one.