Using the Offline Command Line
|
●
|
When you order a Neo License, Euresys sends you a Ticket ID required to activate the license on your system. |
|
□
|
A Ticket ID is made of 5 groups of 5 alphanumeric characters separated by a dash. |
For example: TT5YY-HYAGN-Q2PBU-U7K7J-DKJJQ
|
□
|
You can activate your license either directly on the computer, as a software license, or on a Neo USB Dongle, that you can buy from Euresys. |
|
●
|
In the case of the software container, the license is strongly linked to a single computer system, while with a dongle you can move it easily from computer to computer. |
When to use the offline activation
Use the offline activation when the system on which you want to activate the license is not connected to the Internet. Nevertheless, to activate the license, you must have access to another computer that is connected to the Internet.
|
□
|
The system that needs a license and is not connected is called the target system. |
|
□
|
The connected system is the online system. |
|
□
|
Both systems need to have the Neo License Manager installed. |
Neo USB Dongle activation
This procedure works for activating both dongles and software containers. However, it is much easier to connect a dongle directly to the online system and use the online procedure.
Select a container
|
1.
|
To select a license container, use the ListContainers command of the Neo License Manager. |
All the containers compatible with Euresys licenses are listed:
> NeoLicenseManagerCL.exe ListContainers
Container list:
130-3613949292 (software)
|
□
|
A software container appears in the list with a serial number starting with 130-. |
|
□
|
A dongle appears in the list with a serial number starting with 3-. This serial number is also written on the dongle itself. |
|
2.
|
To create a software container, use the CreateSoftwareContainer command of the Neo License Manager. |
> NeoLicenseManagerCL.exe CreateSoftwareContainer
Software container 130-3245488904 has been created.
If you already have a software container on your system:
|
□
|
We highly recommended you to use that one. |
|
□
|
Create a new software container only if the old one is broken for any reason. The old license container unavailable for activation purposes. |
|
3.
|
Copy the serial number of the container you want to use for the next step. |
Activate a license
The offline license activation is a 3 steps procedure:
|
1.
|
On the target system, retrieve the fingerprint: |
|
a.
|
To retrieve the identification information, also called the fingerprint, use the GetFingerprint command of the Neo License Manager. |
> NeoLicenseManagerCL.exe GetFingerprint -sn 130-3245488904 -path "myfingerprintfile.fgp"
This command generates a fingerprint file.
|
b.
|
Copy this file to the online system. |
|
2.
|
On the online system, request a license activation file: |
|
a.
|
To generate the license activation file, use the RequestLicenseFile command of the Neo License Manager. |
|
b.
|
Use this command with the Ticket ID and the fingerprint file of the target system. |
> NeoLicenseManagerCL.exe RequestActivationFile -fingerprintPath "myfingerprintfile.fgp" -t TT5YY-HYAGN-Q2PBU-U7K7J-DKJJQ -outPath "mylicensefile.lif"
|
c.
|
Copy this file to the target system. |
|
3.
|
On the target system, apply the license. |
|
a.
|
To activate the license in the chosen container use the ApplyLicense command of the Neo License Manager. |
|
b.
|
Use this command with the license activation file. |
> NeoLicenseManagerCL.exe ApplyLicense -path "mylicensefile.lif"
Check the Neo License presence
|
1.
|
To check the presence of the license, use the ListLicenses command of the Neo License Manager. |
The new license appears under the serial number of the license container.
> NeoLicenseManagerCL.exe ListLicenses
Licenses on container 130-3613949292 (software):
Open eVision EasyOCR
Troubleshooting
Command line help
|
●
|
To get help about the syntax and the usage of the command line, use the Help command: |
> NeoLicenseManagerCL.exe Help
Here are the available commands and their arguments:
ListContainers [-filter (dongle|software)]
Print the list of the containers currently available.
ListLicenses [-sn SERIAL]
Print the list of the licenses currently available.
ApplyLicense -path PATH
Apply the given activation file to the software container of your computer.
CreateSoftwareContainer
Create a new software container on the computer. It will only work if none were present.
GetFingerprint -sn SERIAL -path PATH
Save the fingerprint file of the given container at the specified location.
CheckOEMKeyReadiness -sn SERIAL
Check if the OEM key feature is available in the given container.
PrepareForOEMKey -sn SERIAL
Activate the OEM key feature on the given container.
CheckStatus
Do a global check-up of the neo licensing system and print it.
Report -path PATH
Save the output of the CheckStatus command to the specified location.
DumpLog
Print the contents of the log file.
Activate -t NEO_TICKET_ID -sn SERIAL
Activate a neo ticket ID on the given container.
Reactivate -t NEO_TICKET_ID -sn SERIAL
Reactivate a neo ticket ID on the given container.
RequestActivationFile -fingerprintPath PATH -outPath PATH -t NEO_TICKET_ID
Generate an activation file using the given neo ticket ID and container fingerprint file. This file can then be used to proceed to an offline activation.
RequestReactivationFile -fingerprintPath PATH -outPath PATH -t NEO_TICKET_ID
Generate an reactivation file using the given neo ticket ID and container fingerprint file. This file can then be used to proceed to an offline reactivation.
RequestEmergencyActivation
Activate one of the three emergency licenses packages. It has a 8 days duration.
Emergency licenses
If you need a license for a limited time (for instance while waiting for some support), use an emergency license.
|
1.
|
To activate an emergency license , use the RequestEmergencyActivation command: |
|
□
|
These licenses activate all Euresys products. |
|
□
|
They are valid for 8 days. |
|
□
|
You can repeat this a maximum of 3 times. |
|
□
|
For security reasons, you cannot activate emergency licenses on virtual machines. |
> NeoLicenseManagerCL.exe RequestEmergencyActivation
License recovery with a software container
If you have to reinstall the system and lost your licenses:
|
1.
|
Create a software container. |
|
2.
|
Activate the license with the old Ticket ID to try to recover all the licenses associated to the container where you first activated this Ticket ID. |
This only works if:
|
□
|
It is done in a new, empty container. |
|
□
|
The system is recognizable (the hardware is more or less the same). |
|
3.
|
If this does not work, perform a reactivation. |
Reactivation
If the recovery does not work or if you lost your licenses and the system has changed significantly (for instance after the failure and replacement of a hardware component), you need to perform a reactivation.
|
□
|
This transfers your lost license on a container on the new system. |
|
□
|
By default, the reactivation is disabled. |
|
1.
|
Contact the support to obtain a reactivation authorization for the corresponding Ticket ID. |
|
2.
|
Once the reactivation is authorized, follow the license activation procedure described above but use the Reactivate command instead of Activate. |
Error reporting
If anything fails, the Neo License Manager returns an error and information about it in stderr.
|
1.
|
To recover the stderr log in the command line, you can use 2> redirection, as follows: |
NeoLicenseManagerCL.exe Activate -t TT5YY-HYAGN-Q2PBU-U7K7J-DKJJQ -sn 130-3245488904 2>c:\tmp\error.log
|
2.
|
If you need more information, use the Memento tool from Euresys. |
|
3.
|
To check the status of the licensing system on your computer at any time, use the CheckStatus command of the Neo License Manager. |
> NeoLicenseManagerCL.exe CheckStatus
** Starting List Product Item for box 130-3613949292 and firm code 6001261 **
Found Productcode (Dependency: 0x7): 4305
Text (#=20, Dependency 0x00): "Open eVision EasyOCR"
Extended Protected Data (#=16, Type 136, Dependency 0x07): 6c 63 64 63 00 01
9b 05 00 00 00 00 00 00 01 00
** List Product Item finished without errors **
|
4.
|
To check the log of the licensing system on your computer at any time, use the DumpLog command of the Neo License Manager. |
> NeoLicenseManagerCL.exe DumpLog
** L.M version 23.08.0 09/07/23 14:25:02 : Emergency activation was requested.
L.M version 23.08.0 09/07/23 14:25:03 : Emergency activation was successful. There is (are) 2 emergency license(s) remaining. **