KBA-02280

How to run WorldClient, SyncML, BlackBerry Internet Service (BIS) and ActiveSync Under IIS7 and IIS7.5

This article will explain how to configure WorldClient, SyncML, BlackBerry Internet Service (BIS) and ActiveSync to run under IIS7 and IIS7.5.

Note: The setup of these services under IIS is NOT supported by Alt-N technical support.  Those who choose to run any MDaemon related protocol or service under IIS must be aware of all security issues and ramifications of running any applications under IIS. It is recommended that all patches and updates be installed on IIS before the installation of MDSyncML as an ISAPI.

  1. Install the Web Server Role with ISAPI support (for exact steps please consult your Operating System documentation)
  2. Open the IIS Manager 
    To do this:
    1. Click Start
    2. Click All Programs
    3. Click Administrative Tools
    4. Click Internet Information Services (IIS) Manager
  3. On the Connections pane, expand the [Machine_name] node
  4. Right click on Sites
  5. Click Add Web Site 
  6. Enter a Site name (i.e. 'WorldClient'). This will also create an Application Pool by the same name as the web site (do not manually create an Application Pool).
  7. Click the browse button (the button with '...') by Physical path and browse to the 'MDaemon\WorldClient\HTML' directory
  8. Set up the bindings as desired in the Binding section
  9. Click OK 
  10. Click on the WorldClient site in the Connections pane. 
  11. Double click on Default Document 
  12. Select each existing Default document name and click Remove on the Actions pane.
  13. Click Add
  14. Type 'worldclient.dll'
  15. Click OK 
  16. Click on the WorldClient site in the Connections pane 
  17. Double click on Handler Mappings 
  18. Click Edit Feature Permissions on the Actions pane. 
  19. Verify the boxes for Read and Script are selected (checked), and select (check) the box for Execute
  20. Click OK 
  21. Double click ISAPI-dll under the Enabled column
  22. Change the value for the Request Path field from '*.dll' to 'WorldClient.dll'
  23. Under Executable, click the browse button (the button with '...')
  24. Browse to 'MDaemon\WorldClient\HTML\WorldClient.dll' (on the C:\ drive by default)
  25. Click OK 
  26. Click Yes on the dialog that asks 'Do you want to allow this ISAPI extension...' 
  27. Add the MDSyncML.dll mapping
    1. On the Handler Mappings Actions menu on the right, click on 'Add Script Map...' 
    2. Under Executable, click the browse button (the button with '...')
    3. Browse to 'MDaemon\WorldClient\HTML\MDSyncML.dll' (on the C:\ drive by default)
    4. In the Name field, enter 'MDSyncML.dll'
    5. Click the Request Restictions button 
    6. Under the Access tab, select Execute
    7. ClickOK 
    8. Click OK 
    9. Click Yes on the dialog that asks 'Do you want to allow this ISAPI extension...'
  28. Add the MDBis.dll mapping
    1. On the Handler Mappings Actions menu on the right, click on 'Add Script Map...' 
    2. In the Request Path field, enter 'MDBIS.dll'
    3. Under Executable, click the browse button (the button with '...')
    4. Browse to 'MDaemon\WorldClient\HTML\MDBIS.dll' (on the C:\ drive by default)
    5. In the Name field, enter 'MDBIS.dll'
    6. Click the Request Restriction button 
    7. Under the Access tab, select Execute
    8. Click OK 
    9. Click OK 
    10. Click Yes on the dialog that asks 'Do you want to allow this ISAPI extension...'
  29. Add the MDAirSync.dll mapping
    1. On the Handler Mappings Actions menu on the right, click on 'Add Script Map...' 
    2. In the Request Path field, enter 'MDAirSync.dll'
    3. Under Executable, click the browse button (the button with '...')
    4. Browse to 'MDaemon\WorldClient\HTML\MDAirSync.dll' (on the C:\ drive by default)
    5. In the Name field, enter 'MDAirSync.dll'
    6. Click the Request Restictions button 
    7. Under the Access tab, select Execute
    8. Click OK 
    9. Click OK 
    10. Click Yes on the dialog that asks 'Do you want to allow this ISAPI extension...'
  30. Close the IIS Manager

Next, update the NTFS permissions on the MDaemon directory:

  1. Open Windows Explorer
  2. Navigate to the MDaemon directory (by default, 'C:\MDaemon'
  3. Right click on the MDaemon directory
  4. Choose Properties 
  5. Choose the Security tab
  6. Click Edit 
  7. Click Add 
  8. Type 'IUSR'
  9. Click OK to close the Select Users or Groups dialog 
  10. Enable Full control under Allow for IUSR
  11. Click Add... 
  12. Type 'Network Service'
  13. Click OK to close the Select Users or Groups dialog 
  14. Enable Full Control under Allow for Network Service
  15. Click OK to close the Permissions for MDaemon dialog and wait for the changes to take effect 
  16. Click OK to close the MDaemon Properties dialog

Disable MDaemon's own native web server:

  1. Open the MDaemon console
    1. Click Start 
    2. Click All Programs
    3. Click MDaemon
    4. Click Start MDaemon
    5. Open the Setup menu
    6. Click Web, Sync, and IM Services... 
    7. Select WorldClient runs using external webserver (IIS, Apache, etc)
    8. Click OK

To configure the Microsoft ActiveSync protocol, complete these steps:

  1. Close Internet Information Services (IIS) Manager if it's open
  2. Install Microsoft's IIS URL Rewrite 2.0
    1. Navigate to http://www.iis.net/download/URLRewrite in your favorite web browser
    2. Click on the download for x86 or x64 as is appropriate for your server 
    3. Launch the downloaded rewrite_2.0_rtw_x86.msi or rewrite_2.0_rtw_x64.msi
    4. Accept the terms of the license agreement and click Install 
    5. Click Finish
  3. Open the IIS Manager
    1. Click Start
    2. Click All Programs
    3. Click Administrative Tools
    4. Click Internet Information Services (IIS) Manager
  4. On the Connections pane, expand the [Machine_name] node 
  5. Expand the Sites node 
  6. Click on the WorldClient site in the Connections pane 
  7. Double click on URL Rewrite 
  8. On the Actions pane, click Add Rule(s)...
    1. Under Inbound Rules, select Blank Rule and click OK 
    2. Name the rule: MDAirSync.dll 
    3. Under Match URL set these settings:
      1. Requested URL: 'Matches the Pattern' (the default)
      2. Using: 'Regular Expressions' (the default)
      3. Pattern: ^Microsoft-Server-ActiveSync
      4. Ignore Case: 'Enabled' (the default)
    4. Under Action set these settings:
      1. Action type: 'Rewrite' (the default)
      2. Rewrite URL: 'mdairsync.dll'
      3. Append query string: 'Enabled' (the default)
    5. In the Actions pane, click Apply 
    6. In the Actions pane, click Back to Rules
  9. Close Internet Information Services (IIS) Manager

If using Windows Server 2008 64-bit or Windows Server 2008 R2, configure the WorldClient Application Pool:

  1. Double-click on Application Pools on the Connections pane
  2. Select the WorldClient application pool 
  3. On the Actions pane, click Advanced Settings... 
  4. In the General section, locate 'Enable 32-bit Applications'
  5. Select the field and choose True 


    If running BlackBerry Enterprise Server (BES):
    1. In the Process Model section, locate and select the field labeled Identity 
    2. Choose NetworkService
    3. Click OK 
  6. Click OK