Web API Barcode Reader Server Installation

Web API Barcode Reader (WaBR) Server Installation

The following components and steps are ALL required.  If certain components and features are already installed and activated on your server, then skip the corresponding steps below

  1. .NET 4.0 Framework. This can be any 4.0-compatible version, such as 4.0, 4.5, 5.0. By default this framework is installed on Windows Server 2012.
    If not installed on the target system, download it from the Microsoft web site.

  2. .NET 2.0 Framework. This can be any 2.0-compatibale version, such as 2.0, 3.0, 3.5
    Note: Version 3.5 is typically installed, but not activated on Windows Server 2012
    To activate .NET Framework 3.5 on Windows Server 2012:
    • Open Server Manager
    • Select Add roles and features
    • Select Features
    • Check .NET Framework 3.0/3.5 Features.

  3. ClearImage PDK or ClearImage SDK version 8.3 or later.
    • ClearImage SDK is used for development and testing in conjunction with WaBR evaluation license file (See Licensing below)
    • ClearImage PDK is used for production in conjunction with registered licences (see Licensing below)
      Note: Both SDK and PDK can be installed on the same system and it is easy to switch between them using Inlite Control Center.

  4. Intranet Information Server 7.0 or later
    To activate and configure IIS on Windows Server 2012:
    • Open Server Manager
    • Select Add roles and features
    • Select Server Roles
    • Check Web Server (IIS). Follow installation instructions
    • Select Web Server(IIS)
    • Select Web Server
    • Select Application Development
    • Check ASP.NET 4.5. Follow installation instructions
      This will also install .NET Extensibility 4.5, ISAPI Extensions, ISAPI Filters

  5. Web API Barcode Reader Web Site
    • Download install WaBR from http://www.inliteresearch.com/wabr
      It instals server components into to c:\inetpub\wwwroot\wabr folder.
    • Start the IIS Manager
      On Windows Server 2012:
      • Open Server Manager
      • In Tools menu click Internet Information Services (IIS) Manager
    • Create wabr Web Site
      • Select virtual directory wabr. under Default Web Site
      • Right-click on it and click Convert to Application
        NOTE: Application Pool for the Web Site should be .NET 4.0
    • Enable writing to Temp folder:
      • Right-click on Temp sub-folder and click Edit Permissions
      • On Security tab click Edit button
      • Select IIS_IUSRS in Group or user names
      • Check Modify in Permissions for IIS_IUSRS

  6. Licensing:
    • The use of WaBR for development and testing requires WaBR evaluation license file. This files, supplied by Inlite Sales and named WABR.date.eval, should be placed in C:\ProgramData\Inlite folder. date value indicates an expiration date of evaluation license.
    • The use of WaBR in production requires the purchase of (1) a Server licenses for the Web API Barcode Reader and (2) a Server license for the specific ClearImage Barcode Recognition Engine

  7. Optional Authentication and SSL. After WaBR server is tested use the IIS Manager to configure the Authentication and SSL settings for your Web Site.

Troubleshooting

HTTP Error 500.19

Symptom: 500.19 error with the following text:

"Config Error: This configuration section cannot be used at this path. This happens when the section is locked at a parent level. Locking is either by default (overrideModeDefault="Deny"), or set explicitly by a location tag with overrideMode="Deny" or the legacy allowOverride="false".

Solution:

Make sure that in step 4 the following features are installed
Web Server(IIS) -> Web Server -> Application Development -> ASP.NET 4.5.