Running Multiple ECC Instances on One Tomcat Server

By default, only one ECC instance can run on one Apache Tomcat server. If you want to be able to have users log into more than one ECC instance at the same time, you need to modify your installation. Otherwise, anyone who tries to start a second instance while one is already running will just get an error.

Configure your Tomcat server so that all ECC instances share the same Felix class loader. You do this by moving the Apache Felix Framework that is delivered with each ECC instance to the main Tomcat library.

Steps ...

1. On your ECC server, go to your Tomcat folder.
2. Copy the org.apache.felix.main-n.n.n.jar file

   From the webapps\<ECC_Instance>\WEB-INF\lib folder of one of your ECC instances

   To to the lib folder in the top level of your Tomcat installation (<Tomcat>\lib).

   Warning: You must use the Felix JAR file that is packaged in the ECC lib folder. Do not use another downloaded version.

3. Delete the org.apache.felix.main-n.n.n.jar file from all your ECC instances (in the webapps\<ECC_Instance>\WEB-INF\lib folders).

You might need to wait a few minutes before the changes take effect and ECC users can log into different instances without a problem. To be sure, wait about 3–5 minutes and test the configuration changes yourself by trying to log into more than one of the ECC instances.