Use the FineReader Engine License Manager Command Line

Run the ABBYY FineReader Engine License Manager and activateFRE script from the command line on Linux and Windows to add, activate, and update licenses.

This topic applies to FRE for Linux and Windows.

Select your operating system to learn about working with the License Manager from the command line:

Linux

The License Manager and the activation script activatefre.sh can be used to activate and manage licenses via the command line.

Activation script must be run under ROOT.

Activation script command-line options

Parameter	Action
-h, --help	Displays the list of commands with short descriptions.
--serial-number <serial number>	Activates the license with the specified serial number.
--service-address <address>	The DNS name or IP address of the computer where the Licensing Service is installed. If you specify this parameter, the Licensing Service will not be installed on the workstation. Instead the Network Licenses distributed by the specified computer will be used.
--license-path <file path> --license-password <password>	The full path and the password to the Online License token file. To use the Online License, specify both parameters.
--project-id <Customer Project ID>	Specifies the Customer Project ID to which the license corresponds. The code samples will be configured to use this Customer Project ID in the functions which initialize the library.

License Manager command-line options

Run Bin/LicenseManager.Console with one of the following options to perform an action without entering interactive mode. For all options which require a serial number, please use either XXXX-XXXX-XXXX-XXXX-XXXX-XXXX or XXXXXXXXXXXXXXXXXXXXXXXX format.

Parameter	Action
--help	Displays the list of commands with short descriptions.
--listDeveloperLicenses	Shows all activated developer licenses on the workstation.
--listAvailableLicenses	Shows all activated licenses on the workstation.
--activate=<serial number>	Activates the license with the specified serial number.
--deactivate=<serial number>	Deactivates the license corresponding to the serial number you specify.
--update=<serial number>	Updates the license with the given serial number.
--showLicenseParameters=<serial number>	Lists the parameters of the license with the specified serial number: functionality subset, protection type and installation type, license expiration date, and the features supported by the license.
--activate=<serial number> --errorIfActivated	Returns a non-zero code if the specified license has already been activated on the workstation.
--saveActivationEMail=<file name>	Saves to the specified file the text of an e-mail message you need to send to ABBYY to activate the given serial number. This message is automatically generated by the program and must be sent without any modification to ensure fast response.
--loadActivationFile=<file name>	Loads the activation file which you will receive from ABBYY in reply to the activation e-mail.
--releaseOnlineLicenses	Disables and removes the Online Licenses along with the associated information.

Windows

The current version of the License Manager allows you to activate and deactivate licenses from the command line. The following command line parameters are supported:

Parameter	Action
/SilentActivation	Use this parameter to activate the license that corresponds to the serial number specified after /SN.
/SN:<serial number>	Use this parameter to specify the serial number of the license to be activated or deactivated. Specify the serial number in one of the following formats: XXXX-XXXX-XXXX-XXXX-XXXX-XXXX or XXXXXXXXXXXXXXXXXXXXXXXX.
/SaveActivationEMailToFile:<file name>	Use this parameter to save to file the text of the message generated by the program and containing the information required for activation of the number specified in the /SN parameter.
/LoadActivationFile:<file name	Loads the ABBYY License File and activates the serial number corresponding to this file.
/SilentDeactivation	Use this parameter to deactivate the license that corresponds to the serial number specified after /SN.

When launched from the command line, the License Manager may return the following return codes:

Return code	Description
-1	No command line parameters were specified.
0	No errors.
1	Invalid serial number.
2	The serial number has been already activated.
3	Unable to activate the serial number via the Internet. Try to activate it by e-mail.
5	The specified file has not been found or is unavailable.
6	Incorrect license file.
7	Unable to load the application.
8	Unable to save to file the text of the activation request.
9	Unknown command line parameter.
13	Unable to connect to Licensing Service.

See also

Activation

License Manager Utility