Skip to main content
Version: 10.3

Activate OCR license

caution

  • Starting from v10.1.4.1, Windows OCR is no longer supported. You can have Windows-based OCR only if you upgrade from earlier product versions with Windows OCR installed. You can use the instructions to increase the number of OCR licenses (the number of documents for OCR processing) in your environment.

  • Starting from 10.3, ABBYY FineReader (FRE) 11 is no longer supported.

WorkFusion provides the license with all supported languages. For the full list of these languages, visit the ABBYY FineReader page.

Activate license​

FRE SDK is located in the following directory:

  • Linux: INSTALL_DIR/ABBYY_FRE12
  • Windows: INSTALL_DIR/FineReaderEngine

The license_request.txt file appears on the Master server, in the INSTALL_DIR/ocr/ directory.

To activate the license, follow the steps below:

  1. Create a Service Desk ticket and attach license_request.txt to it. The template for creating a ticket is as follows:

    Please provide an OCR license according to the following requirements:

    Company name: ___
    Number of pages to include: ___ *)

    Platform type:___(Linux/Windows)

    Status of the server (Production, nonProduction) ____
    Attach the license_request.txt file.

    * The number of OCR pages must be estimated during POC based on the customer workload. For example, if 1,000 pages are processed per day, the monthly amount is 30,000 pages. As stated further, non-prod licenses have predefined values of 10K, 50K, 100K pages, depending on the complexity of the customer workload. Wherever practical, request the minimum possible license. The account manager is always aware of the number of pages included in the contract—it’s within the scope of negotiations with the customer.

    The license cost depends on the number of pages and its category. Make sure your contract with WorkFusion covers it.

    The same single license is used for all OCR servers if you have several of them.

  2. In response to your ticket, WorkFusion sends you the license_response.txt file. Copy the file to the directory with license_request.txt on the Master server, for example, /opt/workfusion/ocr.

    caution

    Mind that license_response.txt is valid for three days only and must be activated within this period. If you failed to activate the license within the term, request the WorkFusion Support team to reissue the license response file.

  3. On the Master server, go to the INSTALL_DIR/ocr/ directory and run activate_wf.sh (or activate_ocr.bat in <fre_sdk_dir> for Windows):

    $ cd /opt/workfusion/ocr
    $ ./activate_wf.sh

    If everything is good, the command returns a success result:

    {"message":{"content":"License Activation Succeeded"}}
note

Mind that the newly activated license complements the previous one and adds new OCR pages to the remaining amount.

Verify license​

To check the state of a license after activation, connect to the Master server via SSH and then use the activeLicense API.

If authentication is disabled (the auth-disabled profile is configured), no authentication header is needed, and the command is as follows:

$ curl -s http://localhost:9002/api/v1/cloud/activeLicense | python -m json.tool

If authentication is enabled, the command is as follows:

$ curl -s -H "Authorization: <credentials>" http://localhost:9002/api/v1/cloud/activeLicense | python -m json.tool

Replace <credentials> with your credentials according to the OCR Service configuration. The header can look like this:

  • Authorization: Basic your_username_pwd_base64 for basic authentication
  • Authorization: Bearer your_jwt_token for JSON Web Token (JWT) authentication