Changing the context root in the Linux Tomcat bundle

Optionally, you can change the context root used by your Discovery Framework application.

To change the context root:

  1. Rename endeca-portal/tomcat-6.0.18/conf/Catalina/localhost/ROOT.xml file to <context root>.xml. For example, if your context root is sales, the file name should be sales.xml. For multi-level context paths, separate the name with #. For example, for a context path of /sales/east, the file name should be sales#east.xml.
  2. Modify the XML file created in the previous step as needed:
    • For a root context: <Context path="" />
    • For a context of /sales: <Context path="/sales"/>
    • For a context of /sales/east: <Context path="/sales/east"/>
  3. Rename the endeca-portal/tomcat-6.0.18/webapps/ROOT directory to endeca-portal/tomcat-6.0.18/webapps/<context root>. For multi-level context paths, use the multi-level path here: endeca-portal/tomcat-6.0.18/webapps/ROOT directory to endeca-portal/tomcat-6.0.18/webapps/sales#east.
  4. Edit the endeca-portal/portal-ext.properties file. Find the portal.ctx property at the beginning of portal-ext.properties. Change the value of this setting to be the same context root value you used above. However, do not include a trailing slash in the portal.ctx value. For example, use this value:
    portal.ctx=/mycompany/portal

    Do not use this value:

    portal.ctx=/mycompany/portal/