Latest Updates |
|
|
|
||
|
Latest Updates |
|
|
|
|
Latest Updates
|
Latest Updates |
|
|
|
||
|
Latest Updates |
|
|
|
|
An update is available for:
| • | Licence Protector - Generator and DLL - Version 3.0 |
| • | Automatic Licence Generator - Version 3.0 |
| • | Activation Server - Version 3.1 |
Update Procedure
Update eligibility
The update is free if one of the following conditions apply:
| • | You have a valid update subscription |
| • | Your update subscription expired after December 1st, 2009 |
| • | You bought an update or upgrade after December 1st, 2009 |
| • | You bought Licence Protector after December 1st, 2009 |
The update process requires a new Serial Number which is sent out by e-mail during the first week of March 2010. The Serial Number is sent to the E-Mail address used for ordering. If you are eligible for the update and you did not get the Serial Number until March 8th, contact support@mirage-systems.de.
You can find your current version number in the TAB Help, Note: Updates can only be applied if your update subscription has not expired. You find your subscription status in the TAB Help, Example for update to 3.0
Although today the Update Subscription has expired, it was not expired at the update due date. The update can be applied. This ensures that you can install an update at any time you like.
|
Subscription Expired
If your subscription has expired but you bought a subscription, check your order confirmation e-mail. You got a separate Activation Key for the update subscription. Apply this key in your currently installed Licence Protector version. If you cannot find your order confirmation e-mail or the key for the subscription, contact cs@cleverbridge.com.
Update Procedure for Licence Protector - Version 3.0
| • | If you installed a BETA version uninstall it. This step is mandatory |
| • | Download the update from the website - click here |
| • | Start the program lpudate30.exe |
| • | You have to select the folder with the old Licence Protector Version (by default this would be ..\Licence Protector\2.7). The folder is needed to retrieve the old license file with the product and modules you have bought. If you don't have an installation of Licence Protector on the PC you want to install the update, you only need an old license file. Copy the license file from a backup or another machine to a temporary folder and select this folder. |
| • | The installation of version 3.0 starts. Install the version on a new folder - e.g. ..\Licence Protector\3.0 . Keep your older versions of Licence Protector to be able to create license files in older formats |
| • | Start the License Generator. You need the new Serial Number you got to activate version 3.0 |
| • | Install the Automatic License Generator. Copy now the new, activated license file from the ..\Licence Protector\3.0 to the folder, where you installed the Automatic License Generator |
| • | Activation Server. To use the new online activation features, you have to install Activation Server 3.1 |
| • | To install on multiple PC's see chapter - License Usage and installation on multiple PC's |
Necessary Source Code changes from 2.7 to 3.0
A few DLL commands have been changed (based on version 2.7), but only a few steps are necessary to use the new DLL
| • | Add the DLL and change the ProgID, CLASSID, IID or LIBID |
| • | Correct your CRC check of the DLL - new CRC values. This step is only necessary if you implemented a CRC check of the DLL |
| • | Change parameter type in SetLanguage from integer to string |
| • | The commands using EasyGo have changed, especially the command SetRegisterSettings including new commands to modify the activation screens.Details about all new options. You have to specify the parameter workflow (cannot be left empty) in the source code to use license files, which have been made with previous versions of Licence Protector |
| • | Enable the license transfer option with SetRegisterLicTransfer |
| • | Subscribe to a newsletter - SetNewsletter |
| • | The command WebRegister was replaced with the command WebRegisterExt. For backward compatibility, WebRegister is still working |
| • | GetMailActivatorBlock now includes address information |
Changes in the project template
| • | Define the main application module TAG <MainModuleID>. Every application can have one or more modules, which can be activated with a Serial Number TAG <IsSerial> but only one main module |
| • | Specify a reseller - TAG <Reseller>. This information is sent to the Activation Server |
| • | Specify a version number for your application - TAG <AppVersion>. This information is sent to the Activation Server and the value can be retrieved with the DLL command GetVal, Token VER. See: How can I test a release number? |
| • | Define a default workflow for a module - <EasyGoWorkflow>. This default workflow can be redefined with the command SetRegisterSettings, WorkflowType |
| • | The TAG <CopyProtectionSwitchOnKey> and <CopyProtectionSwitchOffKey> replace the same values in the command SetRegisterSettings from version 2.7. They have been added for backward compatibility and are not necessary and can be left empty. The new TAG which is used from version 3.0 onwards is <ActivationStateAfterCPon>. This TAG is mandatory. |
| • | If you use the DLL 3.x to activate a license file, which was made with Licence Generator version 2.x, the TAG <ActivationStateAfterCPon> is missing in the license file. You have to use SetVal, Token SAC to add the TAG. If the license is already activated, this would not be necessary. |
Use the template demo-easygo.xml on the folder ...\EasyGo. It contains all new TAGs.
As new options in the project template are stored in the license file, a new product activation will only work with a license file created with Generator 3.0 and the new settings. Old license files are converted when the file is opened into 3.0 format, but with a one to one conversion of the existing license file definition.
See chapter: Backward compatibility below how to use the new DLL with old license files, which are not activated yet.
Modification History
New commands
| • | GetSerial Number - Retrieve the Serial Number of a module |
| • | SetLanguage = 0. Uses the language, which is configured in Windows for all EasyGo screens |
| • | To find out, how (Online, E-Mail, Fax, Phone) the product was activated, use the command GetVal, Token LAT |
| • | The date of the activation can be retrieved with GetVal, token LAM |
| • | ValidatesYes is now included in Validate / ValidateEX and no longer necessary |
| • | DeactivateModule replaces DeactivateLicence |
| • | WebRegisterExt replaces WebRegister |
| • | ValdiatesYes is included in Validate |
| • | SetCustomText replaces SetRegisterHelp and SetRegisterHelpL |
Workflows
With a workflow setting, you can define if the version starts in trial mode, is a time limited full version or if it can only be used in evaluation mode.
New workflows added in version 3.0
| • | Time limited full version (eg. if the product is sold as a subscription) - the expiry date is coded in the Serial Number |
| • | No evaluation version - a Serial Number is needed to start |
| • | A version, which is available only as an evaluation version but cannot be activated - screen: No product activation possible |
All Worklows in detail
EasyGo screens
The screens have been completely redesigned:
| • | new size to fit for more screen resolutions, especially for netbooks |
| • | each single text block on all screens can be modified |
| • | background image can be customized |
| • | new language - Turkish |
The workflow and the navigation was reworked, a lot of new screens have been added to help the user depending on the step in the activation process or when errors occur:
| • | Collect Activation Data - using one of 3 screens |
| • | E-Mail Activation. A new screen (activation in process) informs the user in case his e-mail client does not open, he could also copy and paste the e-mail content in e.g. a web mail system |
| • | Fax-Activation. A new screen (activation in process) informs the user that he has to send the fax and that he gets an Unlock Key within a few business days. |
| • | The screen - Activation completed - allows to type in additional keys. This is a very useful feature as the user can not only type in the Serial Number but also additional Activation Keys for modules during the product activation. |
| • | In case of a copy protection violation an option to reactivate the product is available |
| • | Screens to transfer a license |
| • | Error message - Network license deactivated |
| • | Error message after license transfer - license is deactivated - reactivate license |
| • | Error message - No free license available |
| • | Error message - No Internet connection |
| • | Error message - Wrong date / time during online activation |
| • | Error message - System date was tampered |
Instead of using Licence Protector Serial Numbers you can use your own IDs, e.g. 12 characters, only upper case letters like AKIP-IUZW-II31 as Serial Numbers.
Changes in the key structure
The Serial Number key information changed:
| • | Flag - Serial Number - inside the key. This allows to recognize the key as a Serial Number |
| • | A Serial Number for a Yes / No module sets the value always to Yes |
| • | The days included in the Serial Number overwrite existing values in the license file. Example: Evaluation time left is 5 days. Number of days coded in the Serial Number is 3 - the new value in the license file will be 3 (and not 8 like before). |
License Viewer
| • | The buttons of the License Viewer can be enabled / disabled before PrepareAndCheck is invoked |
| • | The Serial Number can be typed in the License Viewer. The next program start will detect this and allow a product activation |
License Generator
| • | New TAB Activation Server to upload a complete license file to the Activation Server |
The Activation Server is a main release. To use the new online options of Licence Protector 3.0, an update to Activation Server 3.1 is mandatory. It is automatically installed for hosting customers with a valid update subscription.
| • | Download Activation Server 3.1 from the website - click here |
The update process requires a new license file which is sent out by e-mail during the second week of March 2010. If you are eligible for the update and you did not get the license file until March 15th, contact support@mirage-systems.de.
As system requirements have changed, read first the complete installation instruction for updates.
General changes
| • | Customer address administration to manager customers, keys and license files |
| • | Keys, which have not been in use, can be deleted |
| • | Additional key options (expert settings) available, e.g. absolute value for a counter module |
| • | Edit a license file on the Activation Server |
| • | The functionality to transfer a license does not require an additional project. See Transfer a license |
| • | If the key generation pages are invoked through a web page, you can now restrict the access to certain IP addresses or use a password - new option Security Settings |
| • | Create Unlock Key using a web page - now officially supported. Parameters and names have changed. |
User settings
It is possible to define per user, which products he can access. The default setting is no access to any product for every user, which is not an administrator. You have to assign products for every user (which is not an administrator) after the update. Otherwise, the user will not be able to view any product.
New settings in project.config file
If you update from version 3.0 to 3.1 we recommend adding the following new configuration settings and options, although they are only necessary for projects using Licence Protector DLL 3.00 or later
Check the template demo-easygo.config on the folder ..\EasyGo\Web Activation Server\Running own Server\pconfig or ..\EasyGo\Web Activation Server\Files for Mirage Hosting\pconfig.
Changes in workflow file
If you update from version 3.0 to 3.1 we recommend adding the following new configuration settings and options, although they are only necessary for projects using Licence Protector DLL 3.00 or later
You have to rebuild your workflow files in the folder \alg. The module node has to be removed. This step is mandatory.
Check the template config-workflow-easygo.xml on the folder ..\EasyGo\Web Activation Server\Running own Server\alg or ..\EasyGo\Web Activation Server\Files for Mirage Hosting\alg.
Changes in project file
In case you do not use the TAG <IsSerial> in the project template yet, add this tag for the modules where you create a Serial Number
Backward compatibility
License File and Activation Keys
| • | The LicProtector300.DLL can read all Activation Keys from and all license files from any prior version. |
If a license file is opened, it is automatically converted into the latest file format (3.0) and it can not be opened again with an older DLL.
Example
| • | A version 2.0.x DLL can read an Activation Key, which was made with License Generator version 3.0 |
| • | A version 2.0.x DLL cannot open a license file, which was made with License Generator version 3.0 |
| • | A version 2.0.x License Generator cannot open a license file, which was made with License Generator version 3.0 |
As new options in the project template are stored in the license file, a new product activation will only work with a license file created with Generator 3.0 and the new settings. Old license files are converted when the file is opened into 3.0 format, but with a one to one conversion of the existing license file definition.
It is possible to use the new DLL with old license files (and no new functionality). This requires the following changes
Before you use the command PrepareAndCheck you need the following code sequence to update the license file
|
You have to change your workflow files in the folder \alg. In the entry for the main module you have to add <WebActivation>done</WebActivation>
Example
|
Activation Server
| • | The Activation Server 3.1 can accept activation requests from prior DLL versions |
| • | The Activation Server 3.1 supports all features from Licence Protector 3.0. It is mandatory to upgrade to Activation Server version 3.1 if the 3.0.x DLL is used |
| • | The Activation Server versions below 3.0 accept activation requests from 3.0 but some features (e.g. license transfer of a complete license file, upload/download a license file) are not supported |
If you use the Hosting Server, then the files are automatically updated if you have a valid update subscription. Never install the Activation Server update manually.
Automatic License Generator
As the Automatic License Generator creates license files and Activation Keys, see restrictions above regarding format of the file and key.
