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.
-
If the program writes
Test connection succeeded
, or the silent OPLicMgr_s tool returns 0, follow the instructions in Activate license in OPLicMgr, online mode or Move license in OPLicMgr, online mode. -
If the program writes
Test connection failed
, or the silent OPLicMgr_s tool returns any value other that 0, follow the instructions in Activate license in OPLicMgr, offline mode or Move license in OPLicMgr, offline mode.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.
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.