Summary

For various reasons, when utilizing the Crowd distribution, you may need to use a context path that aligns with your business requirements instead of using the default '/crowd' context path: http://localhost:8095/crowd.

This KB outlines the steps on how to change the context path for Crowd.

Environment

Crowd

Solution

The below steps can be followed to change the context path in Crowd.

In the below example '/crowdtest' context path is updated in place of /crowd.

1. In <crowd_install>/build.properties set the crowd.url variable to the following:

   # Crowd context root
   crowd.url=http://localhost:8095/crowdtest

2. Run <crowd_install>/build.sh (UNIX) or <crowd_install>\build.bat (Windows).

3. Change your <crowd_install>/apache-tomcat/conf/server.xml file to include the following element in the Host section configuration:
   See the 'path=“/crowdtest”' part.

   <Engine defaultHost=“localhost” name=“Catalina”>
               <Host appBase=“webapps” autoDeploy=“true” name=“localhost” unpackWARs=“true”>
                   <Context debug=“0” docBase=“../../crowd-webapp” path=“/crowdtest”>
                           <Manager pathname=“”/>
                     </Context>
                   <Valve className=“org.apache.catalina.valves.ErrorReportValve” showReport=“true” showServerInfo=“false”/>
               </Host>
   </Engine>

4. Perform a backup of the crowd.xml file in <crowd_install>/apache-tomcat/conf/Catalina/localhost to another directory.
5. Start Crowd and try accessing on http://localhost:8095/crowdtest
6. After confirming it works like this, you can access it through the domain name configured and set the base URL accordingly.