739

MDaemon 11: How to run WorldClient under IIS7 with BlackBerry Internet Services (BIS) Integration

This article will provide basic information on how to run WorldClient under IIS7 on Windows 2008 with SyncML and BIS Integration.

  1. Install the Web Server Role with ISAPI and CGI (for exact steps please consult your Operating System documentation)
  2. Open the IISconsole
    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. Double click on Handler Mappings
  17. Click Edit Feature Permissions on the Actions pane.
  18. Verify the boxes for Read and Script are selected (checked), and select (check) the box for Execute
  19. Click OK
  20. Double click ISAPI-dll under the Enabled column
  21. Change the value for the Request Path field from '*.dll' to 'WorldClient.dll'
  22. Under Executable, click the browse button (the button with '...')
  23. Browse to MDaemon\WorldClient\HTML\WorldClient.dll (on the C:\ drive by default)
  24. Click OK
  25. Click Yes on the dialog that asks 'Do you want to allow this ISAPI extension...'
  26. 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 on the Request Restrictions... button
    7. On the Mapping tab select 'Invoke handler' only if request is mapped to:'
    8. Verify the radio button for 'File' is selected.
    9. On the Verbs tab, verify that 'All Verbs' is selected
    10. On the Access tab, select 'Execute'
    11. Click OK
    12. 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. In the Request Path field, enter 'MDBis.dll'
    3. Under Executable, click the browse button (the button with '...')
    4. Browse to MDaemon\WorldClient\HTML\MDSyncML.dll (on the C:\ drive by default)
    5. In the Name field, ener 'MDSyncML.dll'
    6. Click on the Request Restrictions... button
    7. Under the Mapping tab select 'Invoke handler' only if request is mapped to:
    8. Verify the radio button for 'File' is selected.
    9. Under the Verbs tab, verify that 'All Verbs' is selected
    10. Under the Access tab, select 'Execute'
    11. Click OK
    12. Click Yes on the dialog that asks 'Do you want to allow this ISAPI extension...'
  28. 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. Change False to True by selecting the field and clicking the down arrow
    6. Click OK
  29. Close the IIS console
  30. Open Windows Explorer
  31. Give the IUSR (Internet guest account) full control on the MDaemon directory.
  32. Open the MDaemon console
    1. Click Start
    2. Click All Programs
    3. Click MDaemon
    4. Click Start MDaemon
  33. Click Setup
  34. Click Web, Sync, and IM Services...
  35. Select WorldClient runs using external webserver (IIS, Apache, etc)
  36. Click OK

Additional Comments

Note: The setup of this program under IIS is NOT supported by tech support and those who choose to run WC 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 WorldClient as an ISAPI extension.