Docker Container Licensing

ClearImage Container Licensing

The ClearImage Container Licensing provides access to ClearImage barcode recognition and image processing engines for applications operating inside Docker container within AWS EC2 instance.

Prerequisites

  • Docker Host: AWS EC2 Instance with Windows Server (IaaS) with EC2 Container Service
    Not supported: Auto Scaling , Elastic Beanstock (PaaS)
  • Minimum Docker Image: microsoft/windowsservercore with .NET Framework 3.5 or higher
  • ClearImage License(s) registered on a Docker Host for for one or more of the following products:
    • ClearImage Reader 1D (Server License)
    • ClearImage Reader 2D (Server License)
    • ClearImage Reader 1D+2D (Server License)
    • ClearImage Driver License Reader (Server License)
    • ClearImage IP (Server License)
  • Your application using ClearImage .NET API written in C#, VB or any other language supporting by .NET Framework.
    NOTE: .Net Core is not supported.

Installation and Licensing

1 – Install ClearImage on the Docker Host

  • Evaluation Version: Install ClearImage SDK.
  • Production Version: Install ClearImage PDK and register ClearImage Licenses(s)

2 – Modify your application to use ClearImage Container License

Add the following line to your code before any other calls to ClearImage API:

C#


VB


Put ClearImageNet.70.dll to your Application’s folder from (where X_X_XXXX is a ClearImage version to be used):.

  • Production version: C:\Program Files (x86)\Inlite\ClearImage PDK.X_X_XXXX folder
  • Evaluation version: C:\Program Files (x86)\Inlite\ClearImage SDK.X_X_XXXX folder
    Container License is supported only in SDK’s Evaluation Mode.

Add ClearImageNet.70.dll to your application Docker Image

To test your application on the Host with a Container License:

  • Remove ClearImageNet assembly from GAC
    Start Inlite Control Center. Select Versions tab. Click Remove from GAC button (if button is availbale) .

3 – Activating ClearImage License on Docker container

ClearImage Evaluation or Production licenses should be installed in a container prior being used by you applications.
The following methods update ClearImage Licences on all "created" or "running" containers:

  • Inlite Controls Center executes any licensing actions in Licensing tab or Product Activation in Versions tab.
    CiContainerUpdate task is schedules Windows Task Scheduler to run once every day.
  • Windows Task Scheduler executes CiContainerUpdate task. It is confgured by ICC to run once every day.
  • Script to launch your container executes "%CommonProgramFiles(x86)%\Inlite\InliteControlCenter.exe" -k