Setting up IIS to host Datacap Web Services

Set up Datacap Web Services on Microsoft Internet Information Services (IIS) by adding the wTM website, configuring the application pool settings, and enabling the ISAPI extensions for All verbs.

About this task

Follow this procedure to set up the Datacap Web Services wTM website on Microsoft Internet Information Services (IIS).

Procedure

  1. Add the Datacap Web Services in IIS.
    1. From Start, select Administrative Tools > Internet Information Services (IIS) Manager.
    2. In the Connections pane, right-click Sites and select Add Web Site.
    3. Set Site name to wTM. The Application pool is automatically set to wTM.
    4. Set the Physical path by entering or browsing to the installation folder for Datacap Web Services. The default location is C:\Datacap\wTM.
    5. Select the IP address of the Datacap Web Services server and assign a unique Port number and click OK to close the Add Web Site dialog.
      Note: The Datacap Web Client and Datacap Web Services must be assigned different port numbers when they are installed on the same server. The Datacap Web Client does not work unless Datacap Web Services is assigned a different port number.
  2. Set up the Datacap Web Services IIS application pool.
    1. In the Connections pane, select Application Pools.
    2. In the Application Pools pane, select the wTM application pool. Select Actions > Edit Application Pool > Advanced Settings.
    3. Ensure that the .NET Framework Version is set to v4.0.
    4. Ensure that Enable 32-Bit Applications is set to True.
    5. Ensure that Managed Pipeline Mode is set to Integrated.
    6. Ensure that Start Automatically is set to True.
    7. In the Process Model section, click the Browse button next to Identity.
    8. In the Application Pool Identity window, select Custom account and click Set.
    9. In the Set Credentials window, enter the wTM domain Windows account information in the format, accountname@domainname. Enter the account password and click OK.
    10. In the Process Model section, set Load User Profile to True and click OK.
    11. In the Connections pane, select the wTM site. In the Actions pane under Manage Web Site, click Restart.
    12. Confirm that the Application Pools, Default Web Site, and wTM website are started.
  3. Enable ISAPI extensions for All verbs and for execution on the Datacap Web Services server.
    1. In the Connections pane, select the wTM site. In the wTM Home pane, double-click Handler Mappings.
    2. Scroll down, select svc-ISAPI-4.0_32bit, and ensure that it is enabled.
      Tip: For Windows Server 2012 R2, the svc-ISAPI-4.0_32bit setting might be missing. To resolve this problem, in your Windows system administrative tools, open Server Manager and click Dashboard. Click Add roles and features. In the Add Roles and Features Wizard, go to the Features section. In .NET Framework 4.5 Features > WCF Services, select the HTTP Activation check box.
    3. In the Actions pane, click Edit Feature Permissions, select Read, Script, and Execute, then click OK.
    4. In the Actions pane, click Edit, and on the Edit Script Map dialog, click Request Restrictions.
    5. On the Request Restrictions dialog, click the Verbs tab, select All verbs, click OK, then click Yes.
  4. Validate the Datacap Web Services installation by opening the Datacap Web Services help page.
    1. Open Internet Explorer and enter the following help page URL, http://<WebServerName or IP address>:<port number>/ServicewTM.svc/help.
    2. Click a link in the Method column to show detailed information about the REST API endpoint.