Changing the context root in the Linux Tomcat bundle

Optionally, you can change the context root used by your Studio application. Changing the context root affects both the Studio application and any automatically deployed components and other hooks.

When you first install the bundle, it uses the default context root of "/eid", and you get access to Studio by going to http://localhost:8080/eid. If you change the context root to "sales", then the URL would be http://localhost:8080/sales.

To change the context root:

  1. Stop the server.
  2. Rename endeca-portal/tomcat-6.0.37/conf/Catalina/localhost/eid.xml file to <context root>.xml.

    For example, if your new 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.

  3. Rename the endeca-portal/tomcat-6.0.37/webapps/eid directory to endeca-portal/tomcat-6.0.37/webapps/<context root>.

    For multi-level context paths, use a multi-level path such as: endeca-portal/tomcat-6.0.37/webapps/sales#east.

  4. Restart the server.

When you change the context root of the Studio web application, any automatically deployed components are deployed to their own contexts, which are nested under the context path of the Studio application.

For example, if Studio is deployed to /mycompany/portal/, the component is automatically deployed as mycompany#portal#component-name-portlet.war, resulting in a context path of /mycompany/studio/component-name-portlet/.

If you change the context root after the first startup of Studio, then you may want to undeploy and redeploy the components.