SynaMan » SynaMan KB

Document information

Document ID:1999
Subject:Integrating SynaMan With IIS 7
Creation date:3/20/12 2:57 PM
Last modified on:6/20/12 6:29 AM


Integrating SynaMan With IIS 7



Overview

In this short tutorial we're going to enable IIS 7 in Windows via the Control Panel, make a new site, create some ISAPI filters, a virtual directory, and point IIS 7 to the isapi redirect file we're about to download.



Preparing Synaman for IIS 7

  • First, download the necessary 32-bit files or 64-bit files
  • Create a sub folder under C:\SynaMan called IISConnector
  • Unzip the downloaded file and extract all files to c:\SynaMan\IISConnector
  • Stop SynaMan if it is running.
  • Download ajp.jar from here and save this file in the C:\SynaMan\lib folder.

Configuring Synaman

  • With Synaman still stopped, navigate to the Synaman installation directory. We are going to open a configuration file and add a line to allow IIS and Synaman to work. The AppConfig.xml file is located here:
  • %INSTALLATION_DIRECTORY\Synaman\config
  • Open AppConfig.xml in any text editor and add the following line:
    <parameter name="ajpEnabled" type="4" value="true"></parameter>

Here is our example

AppConfig Edits

Turn on the Synaman service.

Test Synaman on telnet

From a command prompt, use telnet to connect to localhost on port 6061 just as below.

Telnet commands

If you see a blank screen after connecting, this actually means everything is working properly.

Telnet commands2

Preparing Windows

Turn on Windows 7 features via

  • Start > Control Panel > Programs > Programs and Features > (Left hand column) Turn Windows features on or off.

IMPORTANT:

When enabliing (IIS) Internet Information Services, expand out to the Application Development Features and enable the ISAPI Filters. To do this complete the following:



Internet Information Services > World Wide Web Services > ISAPI Filters

Win Services Enabled

Start the IIS Manager and Create a Site



To manage IIS open the Start Menu and enter "inetmgr" in the search bar and select it from the list. Next you will create a site by right clicking on the Sites folder as the image below shows.


Add a New Site

Enter the information below, substituting the host name suffix "MyCompany" with your own.

Site Information Dialog

Adding an ISAPI Filter

Next you will add an ISAPI Filter for the Synaman site. In features view choose ISAPI Filters and enter the following information:

Adding an ISAPI Fillter

After you've selected the ISAPI Filters feature, right click to add a filter:

Right Click to Add ISAPI Filter

When Selecting the ISAP executable path, choose the isapi_redirect.dll file in the IIS Connector directory we had previously made in the Synaman installation directory: %INSTALLATION_DIRECTORY\Synaman\IISConnector\isapi_redirect.dll


Point IIS to IISConnector In Synaman Install Directory

Adding a Virtual Directory

Next create a virtual directory for Synaman by right clicking the Synaman Website listing in the left hand pane. Then, choose Add Virtual Directory.

Create Virtual Directory Screen

The physical path will also point to the IISConnector directory we have created in Synaman's isntallation directory.

Create Virtual Directory Dialogue

Next, we want to enable the the isapi_redirect.dll in the handler mappings feature list so that IIS 7 knows to allow requests to be redirected to the isapi file.

In order to do that we're going to enable the execute handler from the site level.

Enabling Handler Mappings to Execute via ISAPI

While the site is selected choose "Handler Mappings" from the feature list.

Adding an ISAPI Handler Mapping

Choose "Edit Feature Permissions" to make the site recognize that there is an ISAPI handler waiting for requests:

Edit Feature Permissions

Enable the "Execute" option.

Handler Execute option

In the following screen the ISAPI dll should now be visible.

ISAPI Handler is enabled

Once the ISAPI Handler is visible, we can now make the server aware of the ISAPI as a global setting. The following step replaces adding a web extension in IIS 6.

Adding an ISAPI/CGI Restriction (a.k.a web extension from IIS 6)

Select the server from the left hand connections pane and locate the ISAPI and CGI Restrictions feature.


 ISAPI CGI Restriction Feature

Once selected, right-click and choose "add.." from the drop down:

Adding an ISAPI extension

When choosing the ISAPI/CGI path, choose the isapi_redirect.dll file we previously placed in the %INSTALLATION_DIRECTORY\Synaman\IISConnector directory

IMPORTANT:

Be sure to enable the "Allow extension path to execute" option for this restriction.

Execute ISAPI Extension

Simply restart the site via IIS Manager:

Restarting the Site

and SynaMan is now configured with IIS 7.

Size limitation

By default, IIS does not allow file uploads greater than 30 MB. Refer to this page to change this behavior.


User comments

Posted by Brad on 1/2/17 9:38 AM

I have tried this configuration in Server 2012 with no luck, has anyone been able to get Synaman to work with this information?

Posted by irfan on 11/7/16 10:02 AM

extension_uri setting in "C:\SynaMan\IISConnector\isapi_redirect.properties" file must be changed as below extension_uri=/synaman/isapi_redirect.dll --> extension_uri=/IISConnector/isapi_redirect.dll


Add a comment to this document

Do you have a helpful tip related to this document that you'd like to share with other users? Please add it below. Your name and tip will appear at the end of the document text.
Your name:
Your email:
Hide my email address
Verification code:
Enter the verification code you see above more submitting your tip
Tip:Please limit tips to 1000 characters

Navigation

Social Media

Powered by 10MinutesWeb.com