CatDV Server 6.8 includes a new 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 file from the CatDV Server installation directory into the Tomcat webapps directory, and then restart Tomcat. Note: If you are upgrading from a previous version of CatDV Server then you will need to overwrite the copy of catdv2.war that is 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.

Web Services and iOS Apps

If you want to use the REST API (eg. to support the Adobe Premiere plug-in panel or CatDV iPhone/iPad apps) then you need to do one of the following

  • Use the built-in web server rather than an external Tomcat installation
  • Rename or copy catdv2.war to ROOT.war to install the web app at the root level
  • Use an external URL-rewriting mechanism to map URLs of the form /api/* to /catdv2/api/*

Using the built-in web server is the recommended solution!