1. Home
  2. Transact
  3. System Configuration
  4. User Connectivity
  5. How To: Configure Apache-Tomcat Users and Groups

How To: Configure Apache-Tomcat Users and Groups

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


1. located in 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

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


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

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

The file should have the following realm:

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

Note: If you are on another authentication type such as Microsoft Active Directory or LDAP authentication and want to revert back to Apache Tomcat, then you also need to comment out below section in server.xml .

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

Note: In Ephesoft Transact 2.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 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 Ephesoft Installation Folder\Application\WEB-INF\classes\META-INF\

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

The following settings should be set.



5. You will need to restart the Ephesoft Transact service to apply the changes.

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


< BackHow To Main Page

Was this article helpful to you? Yes No