LEADTOOLS For .NET Class Library Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.28
LEADTOOLS WCF IIS Setup Tool Troubleshooting Guide

LEADTOOLS WCF IIS Setup Tool Troubleshooting Guide

For example, the file CSImageProcessingClientDemo_Original.exe.config in the WCF image processing client demo contains the following entries:

  
             <endpoint
             address="http://localhost/LEADTOOLSWCFServices/RasterService.svc"
             binding="basicHttpBinding"
             bindingConfiguration="BasicHttpBinding_IRasterService"
               contract="IRasterService" name="BasicHttpBinding_IRasterService" />
             

Use the LEADTOOLS RasterService WCF component hosted at localhost in the LEADTOOLSWCFServices virtual directory.

Default Configuration

The LEADTOOLS WCF IIS Setup Tool will create the following configuration on your machine.

Property

Value

Machine

localhost

Name

LEADTOOLSWCFServicesAppPool

.NET Framework Version

v2.0 (or v4.0 if you selected the use .NET 4 version of LEADTOOLS option)

Enable 32-Bit Application

(Valid only for 64-Bit Operation Systems) True if hosting the LEADTOOLS 32-Bit assemblies, False otherwise.

Identity

LocalSystem

Table 1. Application Pool

Property

Value

Machine

localhost

Sites

Default Web Site

Name

LEADTOOLSWCFServices

Physical Path

>LEADTOOLS_ROOT_DIR<\LEADTOOLS_WCF_HOST

ApplicationPool

LEADTOOLSWCFServicesAppPool

Table 2. Virtual Directory

Other properties are all set to their default values. Once the application pool and virtual directory are created, the LEADTOOLS WCF IIS Setup Tool will copy the required LEADTOOLS for .NET assemblies to the Virtual Directory physical path. The runtime version (x86 or x64) of the LEADTOOLS assemblies copied depend on your selection in the setup tool.

Troubleshooting

LEADTOOLS does not require more than the normal prerequisites for hosting and consuming a .NET 3.5 WCF components in IIS. If you are experiencing difficulties using the LEADTOOLS WCF components (either by the demos or the Test tab in the LEADTOOLS WCF IIS Setup Tool interface), then you might find the following guide on setting up IIS with .NET 3.5 helpful.

OS Prerequesites

Windows XP 32-Bit

Prerequisites:

Steps:

  
             @REM Add ASPNet as Administrator user on current machine
             net localgroup Administrators <computer_name>\ASPnet /add
             @REM Register IIS
             SYSTEMROOT\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i
             @REM Use this line if you are going to use .NET 4 runtime
             @REM SYSTEMROOT\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i
             @REM Reset IIS
             iisreset
             

Windows Server 2003 32-Bit

Prerequisites:

Steps:

  
             @REM Register IIS
             SYSTEMROOT\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i
             @REM Use this line if you are going to use .NET 4 runtime
             @REM SYSTEMROOT\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i
             @REM Enable ASP.NET extensions
             CScript SYSTEMDRIVE\WINDOWS\system32\iisext.vbs /EnFile "SYSTEMDRIVE\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll"
             @REM Reset IIS
             iisreset
             

Windows XP 64-Bit and Windows Server 2003 64-Bit

Prerequisites:

If hosting 32-Bit version of LEADTOOLS WCF Services:

Steps:

  
             @REM Enable hosting 32-Bit applications on 64-Bit IIS
             SYSTEMDRIVE\WINDOWS\system32\cscript SYSTEMDRIVE\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 1
             @REM Register IIS
             SYSTEMROOT\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i
             @REM Use this line if you are going to use .NET 4 runtime
             @REM SYSTEMROOT\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i
             @REM Enable ASP.NET extensions
             CScript SYSTEMDRIVE\WINDOWS\system32\iisext.vbs /EnFile "SYSTEMDRIVE\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll"
             @REM Use this line if you are going to use .NET 4 runtime
             @REM CScript SYSTEMDRIVE\WINDOWS\system32\iisext.vbs /EnFile "SYSTEMDRIVE\WINDOWS\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll"
             @REM Reset IIS
             iisreset
             

If hosting 64-Bit version of LEADTOOLS WCF Services:

Steps:

  
             @REM Register IIS
             SYSTEMROOT\Microsoft.NET\Framework64\v2.0.50727\aspnet_regiis.exe -i
             @REM Enable ASP.NET extensions
             CScript SYSTEMDRIVE\WINDOWS\system32\iisext.vbs /ENFile "SYSTEMDRIVE\WINDOWS\Microsoft.NET\Framework64\v2.0.50727\aspnet_isapi.dll"
             @REM Reset IIS
             iisreset
             

Note: If hosting 64-Bit version on XP 64-Bit that has 32-Bit hosted before, you need to do the following steps first:

Steps:

    
             @REM Disable ASP.NET 32-bit Extensions
             CScript SYSTEMDRIVE\WINDOWS\system32\iisext.vbs /disFile "SYSTEMDRIVE\WINDOWS\Microsoft.NET\Framework\v2.0.50727\aspnet_isapi.dll"
             @REM Use this line if you are going to use .NET 4 runtime
             @REM CScript SYSTEMDRIVE\WINDOWS\system32\iisext.vbs /disFile "SYSTEMDRIVE\WINDOWS\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll"
             @REM Unregister IIS with the .NET Framework 2.0 32-Bit
             SYSTEMROOT\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -u
             @REM Use this line if you are going to use .NET 4 runtime
             @REM SYSTEMROOT\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -u
             @REM Disable hosting 32-Bit applications on 64-Bit IIS
             cscript SYSTEMDRIVE\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 0
             

  

Windows Vista and Windows 7 32-Bit

Prerequisites:

Steps:

  
             @REM Register IIS
             SYSTEMROOT\Microsoft.NET\Framework\v2.0.50727\aspnet_regiis.exe -i
             @REM Use this line if you are going to use .NET 4 runtime
             @REM SYSTEMROOT\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i
             @REM Enable Microsoft Windows Communication Foundation Activation
             SYSTEMROOT\Microsoft.NET\Framework\v3.0\"Windows Communication Foundation"\ServiceModelReg -i
             @REM Reset IIS
             iisreset
             @REM Set the Application Pool identity
             @ECHO Set the application pool identity to LocalSystem
             

Windows Vista and Windows 7 64-Bit

Prerequisites:

Steps:

  
             @REM Register IIS
             SYSTEMROOT\Microsoft.NET\Framework64\v2.0.50727\aspnet_regiis.exe -i
             @REM Use this line if you are going to use .NET 4 runtime
             @REM SYSTEMROOT\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -i
             @REM Enable Microsoft Windows Communication Foundation Activation
             SYSTEMROOT\Microsoft.NET\Framework\v3.0\"Windows Communication Foundation"\ServiceModelReg -i
             @REM Reset IIS
             iisreset
             @REM Set the Application Pool identity
             @ECHO Set the application pool identity to LocalSystem
             @REM Setup the Application Pool to host 32-Bit components (if required)
             @ECHO For hosting 32-Bit applications in 64-Bit Operating System, you must
             @ECHO the [Enable32BitAppOnWin64] property in the application pool to TRUE