OPLicMgr application

The OmniPage License Manager is an application for activation and managing of Seat licenses and for activation of OEM licenses. Technically the application has following appearances:

  • OPLicMgr is a regular command-line tool that either the integrator or the end user can use to activate or move the licenses. The user must launch a command prompt from the Start menu by typing cmd and use the commands documented below.

    If you create a CSDK-based application, where the end user needs to activate the CSDK, describe the license handling processes in your documentation.

  • OPLicMgr_s is a silent command-line tool that displays no user interface and does not start a command prompt. It can be used by the application of the integrating product to activate the license keys of the end user, and perform other license handling tasks, without user intervention. This tool is recommended, if the machine of the end user has internet connection, since by executing this tool, the installer can make the activation process much simpler for the end users.

  • OPLicMgrUI is a user interface over the OPLicMgr application. After the installation of the OmniPage CSDK it is accessible from the Start menu. This application can handle only Seat licenses and the below described processes can be performed by pressing buttons.

The commands below can be performed both by OPLicMgr or OPLicMgr_s, but the code fragments are given with OPLicMgr only. Use OPLicMgr_s in the same way in your installer. The 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. Two files can be created to follow the progress and the problem notification by the following command line options:

  • -o <filename>: generates a log file with all the messages about the result of the operation

  • -e <filename>: generates an error log file with important error messages

Run OPLicMgr with an empty command line, or with the -h option to get more information about the options.

If you want your users to run OPLicMgr, 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.

You can test if the target computer has internet access with the OPLicMgr -test command.

Proxy information

If the target machine has internet connection, but it requires use of a proxy, proxy related information can be inserted to the OPLicMgr.cfg.txt file, which in the personal folder of the user. This file is generated when OPLicMgr runs for the irst time. To access this configuration file, go to the Start menu, open your Personal folder by clicking your name, and navigate to the OmniPage\CSDK21 folder. Ask your system administrator to edit the configuration file.