Welcome to the EnTrial Administrator Help System
The Two Rivers Software Registration System consists of an Administrator application and an Software Development Kit (SDK). This help file will discuss topic for the Administration software.
Basic Concepts
The EnTrial Administrator uses the EnTrial SDK for Trial to Full product conversion.
Deploying an Application: Required EnTrial Protection Files
Binaries: The Tr.Registration.dll and Tr.Registration.Resources.dll binaries must be distributed with each EnTrial-protected application.
Assuming the default installation folder, these files will be located at C:\Program Files\Two Rivers Software\EnTrial\SDK\Dot Net 2.0 and COM Binaries.
EnTrial Distribution File: The EnTrial Administrator will generate a Distribution file for each product and package. The default file extension is trr. The generated .trr file should be installed with the target application.
How to add a .trr file to a .NET project.
Trial Modes
The Administrator runs in a Trial mode until a license to use EnTrial is purchased. The EnTrial Administrator trial duration is 30 days, and when in Trail mode, the Administrator will not generate Unlock keys for the Product.
1. Use the EnTrial Administrator to generate a Distribution File (.trr file) that contains one of the following modes:
Number of Trial Days - The SDK will record the date and time that the software runs for the first time. The SDK will return to the software the remaining number of Trial Days.
Expiration Date - A date is set by the Administrator and returned via the SDK to the software. The software can stop running after this date.
Number of Runs - The EnTrial SDK will track the number of times that the software runs. The application can stop running when a pre-set run count is reached.
Demo - As with the other modes, the EnTrial SDK will return when the product has been "registered" or paid for. Based on this setting, the application can run in a "crippled" mode until registered.
2. Integrate the EnTrial SDK into a software application.
3. At runtime, get the registration status from the EnTrial SDK
Software Registration
Using the EnTrail SDK, detect when the trial version is over. Upon expire, call the EnTrail SDK to display the Registration Dialog. Text can be added to the Registration Dialog with software purchase instructions.
Personal ID
This alpha-numeric string is created by the EnTrial SDK per installation. It is a combination of both hardware and software that compose the installation computer. The Personal ID is unique for each computer. One or two "parts" of the computer can change, and the software will not require a re-registration. If the distributed software is copied to another computer, the EnTrial SDK will display the "Registration Dialog" on first run.
Generated Code
In the Basic EnTrial version, the "Generated Code" is created manually with the EnTrial Administrator. The Generated Code is "baseline" from which the "Unlock Key" is created.
Unlock Key
The Unlock Key can only be created by the EnTrial Administrator when the "Personal ID" from the installation computer is supplied. The Unlock Key is created using the Personal ID and the Generated Code.
Note: In the Basic version of EnTrial, the "Personal ID" from the software will either need to be sent from the Application to the Order System, or the software user will need to reply via email or phone with the "Personal ID". One easy way to accomplish this task is to provide instructions in a purchase confirmation email for the purchaser to reply to the confirmation email with the "Personal ID". When verification of purchase and the "Personal ID" is received, the Unlock Code and Key can be generated with the EnTrail Administrator Software.
Using RegSoft for Software Purchase Handling:
In the registration/purchase instructions to the consumer, one solution is to provide instructions to the purchaser to reply to the registration email with the EnTrial "Personal ID". The EnTrail Product ID and Package Code can also set to match the RegSoft codes.
Disclaimer: In this help file, mycompany.com is used as a generic example of a domain. "My Application" is used as a generic computer application name.