Poniższa dokumentacja jest fragmentem Kofax OmniPage v20 SDK.
Fixed Volume licenses are tied to the hardware of the end user's computer, therefore they must be activated on the end user's machine.
For this type of licensing scheme, Nuance Licensing Service installation is not required starting from Nuance OmniPage Capture SDK v20. he OmniPage License Manager OPLicMgr.exe command-line tool takes the role of the formerly used Nuance Licensing Tool in the license activation. This tool has two versions:
The commands below can be performed both by OPLicMgr.exe or OPLicMgr_s.exe, but the code fragments are given with OPLicMgr only. Use OPLicMgr_s in the same way in your installer. This silent version does not display anything on screen. Your installer can learn if the commands succeeded or failed by examining the return code: 0 means success, other values mean different errors. Textual progress report and problem notification is handled by generating two log files if the following command line options are specified:
Run OPLicMgr.exe with an empty command line, or with the -h option to learn more about these, and many other options.
If you want your users to run OPLicMgr.exe, you should add code to your installer program to include the path to the OPLicMgr.exe program in the PATH environment variable. This is not necessary if your installer starts OPLicMgr_s.exe with a full path.
The following steps are required to activate your product depending on whether your users have internet connection on their machine or not. Your installer (or your users) can test if the computer has internet access to the Nuance activation site by running the OPLicMgr -test command.
If the program writes Test connection succeeded (or the silent OPLicMgr_s.exe tool returns 0), you can use the first option.
In case of Test connection failed (or non 0 return code) you can jump to the second option (Activation without internet). However, if you are sure that you have internet connection on the target computer, check with your network administrator whether there is a proxy server on your LAN. You may have to configure OPLicMgr for use of proxy; see details below at Proxy information section.
The activation process is very simple in this case; a single command is required only on your user's machine:
Where SERIALNUMBER is the 22 character long runtime license key from the Nuance Fulfillment email regarding your order. If you give your user more than one license keys, write them all in the command line following the -activate command separated with a space.
If the user's machine has internet connection but it requires use of a proxy, proxy related information can be inserted in the OPLicMgr.cfg.txt file in the user's personal folder. This file is generated the first time when OPLicMgr is run. To access this configuration file, go to the Start menu and open your Personal folder by clicking your name. Ask your system administrator to edit the configuration file.
Moving licenses is also possible, for example in case of hardware upgrade. The steps required depend on whether your user's target computer has internet access or not (the source computer does not need internet access) :
The original design of Nuance License Management system assumes that NCLS/NCLT and OpLicMgr utilities are not used on the same computers.
To avoid licensing issues in special deployment cases when both the NCLS/NCLT-activated and OpLicMgr-activated licenses are present simultaneously, we introduced the use of NLCL.cfg file in Desktop Runtime distributions (deployments), starting from version 20.3.
To ensure that your deployment works properly even if other CSDK-based applications install NCLS/NCLT, it is recommended to add a special NLCL.cfg file to your deployment.
In this case the NLCL.cfg file must contain only a single, 8-character code word: „oplicmgr”.
For the possible locations of NLCL.cfg file and further details of its entries refer to the Licensing improvements section of the Nuance OmniPage Capture SDK 20.3 Release Notes (ReadMeEng.htm).
Arhat sp.z o.o.
ul. Antoniego Józefa Madalińskiego 23 lok.7 A
02-513 Warszawa, Polska