CatDV Server includes a built-in web server. For most installations this is the recommended mechanism for serving the CatDV Web Client and the REST API.

There are some situations where you might want to use an external Tomcat server instead:

  • You are already using Tomcat for other applications and you want CatDV to fit into your existing infrastructure
  • You want to use a separate physical server to serve the Web Client in order to spread load.

Using an External Tomcat Server

The CatDV Control Panel can manage an instance of Tomcat running on the same machine as CatDV Server, but if you want to use an instance of Tomcat running on a separate server then configuration of Tomcat must be performed manually.

To configure an external instance of  Tomcat perform the following actions:

  1.  Copy the catdv2.war and catdv-web2.war files from the CatDV Server installation directory into the Tomcat webapps directory. Additionally, if you want to use the CatDV home page as the root page for the site then copy ROOT.war into Tomcat’s webapps directory. You should then restart Tomcat.
    Note: If you are upgrading from a previous version of CatDV Server then you will need to overwrite any existing war files that are already in the webapps directory.
  2. In the Web Server tab of the CatDV Server Control Panel Setup Wizard you must ensure that the internal web server is disabled by un-choosing “None” the “Enable Embedded Web Server” check box.
  3. The Port field should be filled in with the port that your copy of Tomcat is using (usually 8080) so that the Control Panel can monitor the Tomcat instance.