Integrating SynaMan With IIS 7
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.
Here is our example
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.
If you see a blank screen after connecting, this actually means everything is working properly.
Turn on Windows 7 features via
- Start > Control Panel > Programs > Programs and Features > (Left hand column) Turn Windows features on or off.
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
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.
Enter the information below, substituting the host name suffix "MyCompany" with your own.
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:
After you've selected the ISAPI Filters feature, right click to add a 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
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.
The physical path will also point to the IISConnector directory we have created in Synaman's isntallation directory.
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.
Choose "Edit Feature Permissions" to make the site recognize that there is an ISAPI handler waiting for requests:
Enable the "Execute" option.
In the following screen the ISAPI dll should now be visible.
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.
Once selected, right-click and choose "add.." from the drop down:
When choosing the ISAPI/CGI path, choose the isapi_redirect.dll file we previously placed in the %INSTALLATION_DIRECTORY\Synaman\IISConnector directory
Be sure to enable the "Allow extension path to execute" option for this restriction.
Simply restart the site via IIS Manager:
and SynaMan is now configured with IIS 7.
By default, IIS does not allow file uploads greater than 30 MB. Refer to this page to change this behavior.