How to integrate Helical Insight application deployed in tomcat with IIS server

Prerequisite :

  1. IIS server version 6+ is installed and running.
  2. Make sure “ISAPI Extensions”, “ISAPI Filters” and ”CGI” are checked. To verify go to Control Panel -> Programs and Features -> Turn on Windows Features. Check “Internet Information Services” inside that you will find all these 3 modules.
  3. Apache Tomcat 9+ is installed.

Testing Environment :

    Operating System we have tested on are :

  1. Windows 8.1, 64-bit OS, x64-based processor.
  2. Windows 10, 64-bit OS, x64-based processor.

Click Here to Download Attachment Contains Sample Configuration Files. Please modify these files according to your details.

Introduction:

Helical Insight is Java based application. Since IIS server doesn’t host Java applications, there are couple of methods to configure IIS server in order to access applications which are hosted inside apache-tomcat. This document contains detailed steps of one of the method on how to integrate Helical Insight application which is deployed in apache-tomcat with Microsoft IIS server using ISAPI redirector.

Below are the steps to follow :

Configure for ISAPI Redirector :

1. Create a directory with name “isapi” inside Apache Tomcat folder. Refer below screenshot :

Picture1

2. Allow the IIS process to create the ISAPI redirector log file. Modify the path as necessary if the log file is to be written to a different directory. Enter the following at a command prompt:

Note : Open command prompt with Administrator privilege.

Icacls.exe”Your relative Path of isapi folder” /grant “IIS APPPOOL\DefaultAppPool”:(OI)(CI)M

Example : icacls.exe”C:\apache-tomcat-9.0.7\isapi” /grant “IIS APPPOOL\DefaultAppPool”:(OI)(CI)M

3.Download the appropriate (32 bit or 64 bit) isapi_redirect.dll for your operating system and place it in “isapi” folder.

Example : C:\apache-tomcat-9.0.7\isapi\isapi_redirect.dll

You can download isapi_redirect.dll from this URL :

If 32 bit :

https://archive.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/win32/jk-1.2.31/

If 64 bit :

https://archive.apache.org/dist/tomcat/tomcat-connectors/jk/binaries/win64/jk-1.2.31/amd64/

picture2

4.Create “isapi_redirect.properties” file inside “isapi” folder. The content of this properties file will be as below :

Example : C:\apache-tomcat-9.0.7\isapi\isapi_redirect.properties

Note : Modify the paths according to your paths.

picture3

Picture4

5. Create “workers.properties” file to configure the tomcat instance that requests will be passed to. The content of this file will be as below :

Example : C:\apache-tomcat-9.0.7\isapi\workers.properties

Picture5

Note : Modify details according to your details if necessary.

Picture6

6. Create “uriworkermap.properties” file to configure which requests will be passed to tomcat. The content of this file will be as below :

Example : C:\apache-tomcat-9.0.7\isapi\uriworkermap.properties

Picture7

Picture8

7. Open IIS Manager. Add a new virtual directory to your IIS web site. In a clean install, this will be the “Default Web Site” . Keep the name of virtual directory as “jakarta”. Its physical path should be the directory where you placed “isapi_redirect.dll”.

Picture9

8. Select the newly created virtual directory in the management console and then double-click Handler Mappings. Select the (currently disabled) ISAPI-dll entry and then click Edit Feature Permissions in the action panel. In the dialog box that opens, select Execute so all three permissions are selected. Click OK and ISAPI-dll should now be in the enabled state.

Picture10

9. Again using the IIS management console, add the ISAPI redirector as a filter to your web site. Select your web site and then double-click ISAPI Filters. From the action panel, click Add. For the filter name use tomcat and the executable should be the full path to isapi_redirect.dll. Once configured, click OK.

Picture11

10. Still using the IIS management console, configure the ISAPI redirector as allowed. Select your server (not the web site) and then double-click on ISAPI and CGI Restrictions. From the action panel, click Add. Select the isapi_redirect.dll, add a descripion (e.g. tomcat) and select the Allow extension path to execute and then click OK.

Picture12

11. Enable directory browsing for Virtual Directory.

a)Select the virtual directory node (in this case “jakarta”)

b)Double click on “Directory Browsing” icon.

c)Click “Enable” in actions panel.

Picture13

12. Edit anonymous authentication credentials :

a)Select the virtual directory node.

b)Double click the “Authentication” icon.

c)Click to select “Anonymous Authentication” item.

d)Click “Edit” in actions panel.

e)A dialogue will prompt out.

f)Checked “Application Pool Identity” and press OK button to commit changes.

Picture14

13. Enable ISAPI modules

a)Click on the root node (your server)

b)Double click on “ISAPI and CGI Restrictions” icon.

c)Click “Edit Feature Setting” in actions panel.

d)Check “Allow unspecified ISAPI modules” and “Allow unspecified CGI modules”options. This option allow any ISAPI dll to be executed under IIS. If you don’t use this option, you will need to specify a list of ISAPI DLLs explicitly.

Picture15

14. Edit permission for virtual directory

a)Select the virtual directory node (in this case “jakarta”)

b)Right click on the node and click “Edit Permission” of popup menu.

c)A properties dialog prompt out.

d)Switch to “Security” page.

e)Click edit button to show permission dialog.

f)Add “IIS_IUSRS” into the permission list.

Picture16

15. Enable 32 bits ISAPI DLL on IIS

This is only require if you are using IIS7 x64 and would like to run 32 bits ISAPI DLL on the IIS. If your ISAPI DLL and IIS7 is both x86 or both x64, you may skip this step.

a)Click “Application Pools” node.

b)Click “DefaultAppPool” item.

c)Click “Advanced Settings” from actions panel.

d)Set “Enable 32-bits Application” to True

e)Click OK button to commit changes.

f)Right click on “DefaultAppPool” item and click “Recycle” item.

Picture17

Picture18
16. Restart IIS (stop + start IIS service)

Picture19

17. Try accessing application on tomcat.

Example : http://localhost/hi-ee/

Picture20

For more detailed information, refer below blogs :

References :

1.https://tomcat.apache.org/connectors-doc/webserver_howto/iis.html

2.http://chee-yang.blogspot.in/2009/10/configure-windows-7-iis7-for-isapi-dll.html

You May Also Like

Helical Insight’s self-service capabilities is one to reckon with. It allows you to simply drag and drop columns, add filters, apply aggregate functions if required, and create reports and dashboards on the fly. For advanced users, the self-service component has ability to add javascript, HTML, HTML5, CSS, CSS3 and AJAX. These customizations allow you to create dynamic reports and dashboards. You can also add new charts inside the self-service component, add new kind of aggregate functions and customize it using our APIs.
Helical Insight’s self-service capabilities is one to reckon with. It allows you to simply drag and drop columns, add filters, apply aggregate functions if required, and create reports and dashboards on the fly. For advanced users, the self-service component has ability to add javascript, HTML, HTML5, CSS, CSS3 and AJAX. These customizations allow you to create dynamic reports and dashboards. You can also add new charts inside the self-service component, add new kind of aggregate functions and customize it using our APIs.
Helical Insight, via simple browser based interface of Canned Reporting module, also allows to create pixel perfect printer friendly document kind of reports also like Invoice, P&L Statement, Balance sheet etc.
Helical Insight, via simple browser based interface of Canned Reporting module, also allows to create pixel perfect printer friendly document kind of reports also like Invoice, P&L Statement, Balance sheet etc.
If you have a product, built on any platform like Dot Net or Java or PHP or Ruby, you can easily embed Helical Insight within it using iFrames or webservices, for quick value add through instant visualization of data.
If you have a product, built on any platform like Dot Net or Java or PHP or Ruby, you can easily embed Helical Insight within it using iFrames or webservices, for quick value add through instant visualization of data.
Being a 100% browser-based BI tool, you can connect with your database and analyse across any location and device. There is no need to download or install heavy memory-consuming developer tools – All you need is a Browser application! We are battle-tested on most of the commonly used browsers.
Being a 100% browser-based BI tool, you can connect with your database and analyse across any location and device. There is no need to download or install heavy memory-consuming developer tools – All you need is a Browser application! We are battle-tested on most of the commonly used browsers.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
We have organization level security where the Superadmin can create, delete and modify roles. Dashboards and reports can be added to that organization. This ensures multitenancy.
A first-of-its-kind Open-Source BI framework, Helical Insight is completely API-driven. This allows you to add functionalities, including but not limited to adding a new exporting type, new datasource type, core functionality expansion, new charting in adhoc etc., at any place whenever you wish, using your own in-house developers.
A first-of-its-kind Open-Source BI framework, Helical Insight is completely API-driven. This allows you to add functionalities, including but not limited to adding a new exporting type, new datasource type, core functionality expansion, new charting in adhoc etc., at any place whenever you wish, using your own in-house developers.
It handles huge volumes of data effectively. Caching, Pagination, Load-Balancing and In-Memory not only provides you with amazing experience, but also and does not burden the database server more than required. Further effective use of computing power gives best performance and complex calculations even on the big data even with smaller machines for your personal use. Filtering, Sorting, Cube Analysis, Inter Panel Communication on the dashboards all at lightning speed. Thereby, making best open-source Business Intelligence solution in the market.
It handles huge volumes of data effectively. Caching, Pagination, Load-Balancing and In-Memory not only provides you with amazing experience, but also and does not burden the database server more than required. Further effective use of computing power gives best performance and complex calculations even on the big data even with smaller machines for your personal use. Filtering, Sorting, Cube Analysis, Inter Panel Communication on the dashboards all at lightning speed. Thereby, making best open-source Business Intelligence solution in the market.
With advance NLP algorithm, business users simply ask questions like, “show me sales of last quarter”, “average monthly sales of my products”. Let the application give the power to users without knowledge of query language or underlying data architecture
With advance NLP algorithm, business users simply ask questions like, “show me sales of last quarter”, “average monthly sales of my products”. Let the application give the power to users without knowledge of query language or underlying data architecture
Our application is compatible with almost all databases, be it RDBMS, or columnar database, or even flat files like spreadsheets or csv files. You can even connect to your own custom database via JDBC connection. Further, our database connection can be switched dynamically based on logged in users or its organization or other parameters. So, all your clients can use the same reports and dashboards without worrying about any data security breech.
Our application is compatible with almost all databases, be it RDBMS, or columnar database, or even flat files like spreadsheets or csv files. You can even connect to your own custom database via JDBC connection. Further, our database connection can be switched dynamically based on logged in users or its organization or other parameters. So, all your clients can use the same reports and dashboards without worrying about any data security breech.
Our application can be installed on an in-house server where you have full control of your data and its security. Or on cloud where it is accessible to larger audience without overheads and maintenance of the servers. One solution that works for all.
Our application can be installed on an in-house server where you have full control of your data and its security. Or on cloud where it is accessible to larger audience without overheads and maintenance of the servers. One solution that works for all.
Different companies have different business processes that the existing BI tools do not encompass. Helical Insight permits you to design your own workflows and specify what functional module of BI gets triggered
Different companies have different business processes that the existing BI tools do not encompass. Helical Insight permits you to design your own workflows and specify what functional module of BI gets triggered