IIS 7, 7.5, and 8 integration with Ephesoft tomcat server

Topic : Howto Configure IIS 7 or 7.5 integration with Ephesoft tomcat server:

Applicable Ephesoft versions:

Ephesoft Version 3.1 and up


Internet Information Services (IIS) integration with Ephesoft will be done in following two steps.

  1. Creating a new site Ephesoft in IIS manager.
  2. Configuring AJP connector to Ephesoft tomcat server works with IIS web server.

Steps to create Ephesoft site in IIS manager:

  1. Open IIS 7.5 manager on windows server by typing inetmgr in search box. A window as shown below will get opened.


  1. Select sites under IIS server in which Ephesoft needs to be configured. Right click on sites and click on Add Web site.



  1. A new pop windows as shown below will appear.



  1. Enter site name, Physical path and Host Name in input textboxes. After all the information is entered click on OK button and Ephesoft application will get configured as shown below.



  1. Now a new site Ephesoft is configured in IIS manager. Next steps it to configure tomcat AJP connector.



Steps to configure tomcat AJP connector:


  1. Download an open source IIS to tomcat connector form this link: https://github.com/Bilal-S/iis2tomcat/releases/download/1.0.41/AJP13_v1041.zip. If the link does not work, go to http://www.boncode.net/boncode-connector and download the latest version from the github link provided on this site.
  2. Extract the downloaded archive and execute Connector_Setup.exe in available in extracted package. A installation start-up pop windows as shown below will get opened.



  1. Click next on above window and select I agree radio button on agreement page and click on next.
  2. Enter Apache tomcat server host name and AJP connector port configured in server.xml of tomcat server. Default AJP port configured in Ephesoft is 8009. Default populated value i.e localhost and 8009 will work if configuration is being done on localhost and with default Ephesoft JavaApp server. Click on next.


  1. Check Enable Remote Access to Apache Tomcat and click on next.



  1. Select all the check boxes except Force Secure Sessions as shown below. Click on next.



  1. Select “let me choose specific sites” option and click on next.



  1. Check Ephesoft and uncheck default site. Click on next.



  1. Check all the three option on Handler Mapping screen and click on next.



  1. Select “Enable IIS sub configuration” and click on next.



  1. Click on install and AJP connector is ready to take requests from IIS server. Before trying accessing Ephesoft on browser, restart both IIS server and Ephesoft tomcat server.
  2. To verify successful integration of IIS server with Ephesoft tomcat server, try accessing

http://localhost/dcma on web browser(if Ephesoft site is bind with port 80, if it is bound to any other port try http://<hostname>:port/dcma ).


Troubleshooting Points:


  1. Ensure logged in user who is managing IIS server have proper file system level permission on Ephesoft\Application\* folder.
  2. Ensure no two application are running on same port. When we create a new site in IIS server, by default it binds with port 80 and also the default site available in IIS is also configured to run on port 80. In such case either change port binding of Ephesoft site or stop default site that will be running by default.
  3. image13