Configuring automated license registration / How do I set up automatic license registration?

Version 4


    CE Term 5.7


    Configuring Automated License Registration

    • Intro

      • How Licensing Works

      • Sample License.xml

    • Step by Step instructions on how to configure automated license registration



    The automated license registration feature allows users to register their software license(s) without having to manually type in the UserID and registration key. This capability is only available in version 5.0 and higher of our Emulators and Web Browser products.

    How Licensing Works

    When you purchase licenses, we send you license registration keys electronically. This includes a license.xml file which contains registration keys for all LicenseID's submitted for a specific order. You can configure CETerm (or one of our single emulation products) to "point" to this license.xml file. It can be placed locally on the device or on any web server. When you attempt to make the first session connection, CETerm tries to access the license.xml file, opens it and looks for the LicenseID of the device in this file. If it finds it, then it authenticates and registers the license based on the associated UserID and registration key. It writes the key value in the device registry. In subsequently launches, CETerm first looks at the device registry to authenticate the license. Only when it is not able to authenticate the license based on the information in the registry, does it access the license.xml file. For this reason, you do not necessarily have to maintain an "always available" connection to the license.xml file if it resides on a web server. This is also the reason why we recommend to place the license.xml file locally on the device in a non-volatile flash folder.

    Sample License.xml

    Here is a sample license.xml file. As you can see, it can store any number of license keys (<license> tags under the <product name>) in the same file. All information within a single <license> tag applies to the same license registration. The <id>, <user> and <key> tags are pretty self explained. Please note, the <product name> tag element (CETerm, CEVT220, CE5250 or CE3270) must match the product in use on the device.


    You can configure the setting Session -> Configure -> Options -> Advanced -> Manage -> Server URL in CETerm to store the "pointer" to the license.xml file. Once entered, the URL is saved with all other CETerm configuration settings. The following syntax may be used to specify the license file:

    If license file resides locally on the device. Notice the *three* forward slashes

    file:///license.xml(license file resides in the root folder of the device)


    file:///IPSM/license.xml (license file resides in folder "\IPSM" of the device)

    file:///Flash Store/license.xml (license file resides in folder "\Flash Store" of the device)

    Note: You do not have place the URL in double quotes if there are space in the folder name


    If license file is residing on a web server:

    http://MyWebServerAlias/license.xml (license file resides in the default root folder on "MyWebServerAlias")


    http://x.y.z.w/license.xml (license file resides in the default root folder on web server with IP address x.y.z.w)

    http://MyServer/MyFolder/license.xml (license file resides in "MyFolder" folder on "MyServer" web server)

    Step by step instructions to configure automated license registration:

    1. On the device, go to the tab Session > Configure > Options > Advanced > Manage. In the "Server URL" setting. Enter the URL to where CETerm should look for the license.xml file. Tap OK, all the way out.

    • Remember to copy the license.xml file (which you received) to this location. If you choose to maintain the license.xml file on your device, we recommend copying it to a persistent storage / flash folder.
    • The license.xml file should have a license ID and corresponding registration key for this device.

    2. Configure the host session and then select Session -> Connect to connect to your host. If there are no errors, license registration is transparent. You can see the registered user under the splash screen as shown below. You can also validate the registration by looking at the About box using File -> About. You should see your registered user name listed.