How To: Configure Apache-Tomcat Users and Groups

Please follow below steps to setup tomcat authentication for your Ephesoft application . Apache-Tomcat configuration is enabled in four different files:


1. located in the Ephesoft Installation Folder\Application\WEB-INF\classes\META-INF\dcma-user-connectivity\ 

This file contains the settings necessary to populate groups names in Ephesoft Batch Class Management.

The following settings should be set for Tomcat:


user.tomcatUserXmlPath=Ephesoft Installation Folder\\JavaAppServer\\conf\\tomcat-users.xml

        for example : if your Ephesoft Installation folder is in C:Drive then the value should reflect as mentioned below:


2. server.xml located in the Ephesoft Installation Folder\JavaAppServer\conf\server.xml

This file tells Ephesoft that users should be authenticated using tomcat.

The file should have following Realm:

<Realm className=”org.apache.catalina.realm.MemoryRealm”/> 

     Note: If you are on other authentication type like  Active directory or LDAP authentication and want to revert back to tomcat authentication then you also need to comment out below section in server.xml . ( Realm className=”org.apache.catalina.realm.JNDIRealm” )

NOTE: IN EPHESOFT v2.5 Realm settings are located in Ephesoft Installation Folder\JavaAppServer\conf\Catalina\localhost\dcma.xml INSTEAD OF server.xml

3. tomcat-users.xml located in the Ephesoft Installation Folder\JavaAppServer\conf\tomcat-users.xml

This file contains user groups and users.

For example a group called admin and a user called ephesoft with password demo is defined as follows:

<role rolename=”admin”/> 

<user username=”ephesoft” password=”demo” roles=”admin”/>


4. located in the Ephesoft Installation Folder\Application\WEB-INF\classes\META-INF\

This file contains settings necessary to update admin group for Tomcat.

The following settings should be set.




Please Note: In Ephesoft v4.x Tomcat Authentication is enabled by default.


< BackHow To Main Page