Installing and Configuring Mart › Prepare to Use IIS with Mart

Prepare to Use IIS with Mart

If you want to use Microsoft Internet Information Services (IIS) as the web server, configure it before deploying Mart Server.

Configure IIS Web Server

The Mart Server is built using Java technology. Therefore, if you want to connect to Mart through IIS, configure IIS to use the JK ISAPI redirector plugin. Using this plugin, IIS sends servlet and JSP requests to Tomcat.

Follow these steps:

1. Help ensure that Tomcat is working properly. Open a browser and type the following in the Address bar:

   http://<servername>:18170/web-console
   

   The default Tomcat home page appears. <servername> is the name of the computer where you have installed Tomcat. 18170 is the default port number where Tomcat is running. If you are using a different port number, use that port number here. In addition, help ensure that the port number you are using is included in the server.xml file. Typically, the server.xml file is available in the <Tomcat_Home>/conf folder.

2. Install IIS.
3. Create a folder on the computer where you have installed IIS. Download the isapi_redirect.dll file for Windows from the Apache Tomcat website and copy to the new folder.
4. Create the workers.properties file in the folder that you created in the previous step.
5. Create the uniworkers.properties file in the folder that you created in Step 5.
6. Follow these steps and create an IIS filter for the DLL placed in Step 5:
   1. From the Windows Start menu, click Run, and then type inetmgr.

      The Internet Information Services (IIS) Manager window opens.

   2. Click the computer name, Sites.
   3. Click Default WebSite, right-click and select Add Virtual Directory.

      The Add Virtual Directory dialog appears.

   4. Enter the path for the isapi_redirect.dll file in the Physical Path field and click OK.
   5. Click the newly added virtual directory.

      The Default Web Site Home window opens.

   6. Double-click ISAPI filters and click Add in the top right corner.
   7. Enter the filter name. Enter the path for the isapi_redirect.dll file in the Executables field.
   8. Click OK.
7. Create the isapi_redirect.reg file to indicate the location of workers.properties files are created previously. Double-click this file and update the registry.
8. Restart the IIS web server.
9. Stop the MartServer service and start it again.

Note: See the Appendix for sample workers.properties, uniworkers.properties, isapi_redirect.reg, isapi_redirect.properties, and uriworkermap.properties files.

Back to Top

Implement SSL for IIS

If you have deployed Mart Server on IIS, you can implement SSL on IIS. SSL lets you access the Mart through a secured connection.

Follow these steps:

1. Open Internet Information Services (IIS) Manager.
2. Double-click Server Certificates and then click Create Self-Signed Certificate.
3. Enter a name for the certificate and click OK.
4. Right-click Default Web Site and click Edit Bindings.
5. Click Add and select https in the Type drop-down menu.
6. Select the certificate name that you have added in the SSL Certificate drop-down menu and click OK.
7. Select Default Web Site and then double-click SSL Settings.
8. Select the Require SSL check box and click Apply.
9. Restart IIS and then restart Tomcat.

Note: If the validity of the certificate expires, create another certificate.