Mura CMS Documentation - How to Add a Servlet Mapping for Your SiteID to Tomcat

How to Add a Servlet Mapping for Your SiteID to Tomcat

When depoying Mura with Tomcat you must ensure that the required web.xml servlet mappings exist. If you use the Mura installer there are two mappings already created within the default {tomcat}/conf/web.xml. These mappings are available to all Mura instances running on this instance of Tomcat.

<servlet-mapping>
       <servlet-name>CFMLServlet</servlet-name>
       <url-pattern>/index.cfm/*</url-pattern>
   </servlet-mapping>
   
   <servlet-mapping>
       <servlet-name>CFMLServlet</servlet-name>
       <url-pattern>/default/index.cfm/*</url-pattern>
   </servlet-mapping>

If you are not using the Default site and need to run Mura with Tomcat and include siteIDs in your URLs you will need to explicitly add the mapping for your siteID.

    <servlet-mapping>
       <servlet-name>CFMLServlet</servlet-name>
       <url-pattern>/youreSiteID/index.cfm/*</url-pattern>
   </servlet-mapping>

In addition, since any changes to the {tomcat}/conf/web.xml are global for that Tomcat instance you may want to add you custom siteID mappings to your site's local WEB-INF/web.xml instead. That way your custom mapping will only be available for the your current web context.

It is also very important to note that any changes to your web.xml files will not take effect until you restart Tomcat.