Installing Your EditLive! License

This tutorial is designed to describe the process for installing a license file into a EditLive! for Java. Before you begin this process make sure you have received your license file from Ephox. Licenses are normally sent to your primary contact via email.

Open Your License in a Text Editor

When you purchased EditLive you should have received an email file is the default Configuration File provided by Ephox. The default name of the license file is “editlive.lic”. When you open this license in a text editor you will find a simple XML file that looks like this:

<ephoxLicenses>
       <license
            accountID="123456789100"
            activationURL="http://www.ephox.com/…"
            domain="MY.SERVER.COM"
            expiration="NEVER"
            forceActive="false"
            key="8FFF-FFFF-FFFF-FFFF"
            eqEditor="true"
            licensee="ME"
            product="EditLive for Java"
            release="5.0"
            type="UNLIMITED"
       />
</ephoxLicenses>

The <license> section of this file is the portion that we need to “deploy” to your EditLive implementation.

Open the sample_eljconfig.xml Configuration File

When you first downloaded EditLive for Java it included a sample configuration file named sample_eljconfig.xml. This configuration file is the one EditLive uses by default to load the license.

Open the sample_eljconfig.xml configuration file using a text editor.

Your developer(s) may have created configuration files with different names. If you are not the person who developed the solution that uses EditLive check with the developer to determine the name of the configuration file or files in use by your application. The remainder of these instructions will use the name sample_eljconfig.xml. If you have one or more configuration files under other names please substitute appropriately.

Locate the <ephoxLicenses> element in the configuration file. By default it will look similar to this:

    <!-- 
    Add your Ephox-provided license key here 
    -->
    <ephoxLicenses>
        <license 
            accountID="BB56B8DD47EF"
            activationURL="http://www.ephox.com/…"
            domain="LOCALHOST" 
            expiration="NEVER"
            forceActive="false" 
            key="6FFF-966C-C34A-3688"
            licensee="For Evaluation Only"
            product="EditLive! for Java" 
            release="5.0" 
            seats="" 
            type="Evaluation License"
            eqEditor="true"
        />
    </ephoxLicenses>

This default license provides you access to the editor when using the host name “localhost”. This license is provided for free and never expires – but limits access to the “localhost” domain.

Add the <license> Element to the Configuration File

Your editlive.lic file will contain a <licences> element. To add your license to the configuration file, copy the <licences> element from the editlive.lic file into the <ephoxLicenses> element, under the current <licences> element.

For example, if your editlive.lic file contained the following:

<ephoxLicenses>
       <license
            accountID="123456789100"
            activationURL="http://www.ephox.com/…"
            domain="MY.SERVER.COM"
            expiration="NEVER"
            forceActive="false"
            key="8FFF-FFFF-FFFF-FFFF"
            eqEditor="true"
            licensee="ME"
            product="EditLive for Java"
            release="5.0"
            type="UNLIMITED"
       />
</ephoxLicenses>

The <ephoxLicenses> element in your configuration file should appear as follows:

    <!-- 
    Add your Ephox-provided license key here 
    -->
    <ephoxLicenses>
        <license 
            accountID="BB56B8DD47EF"
            activationURL="http://www.ephox.com/…"
            domain="LOCALHOST" 
            expiration="NEVER"
            forceActive="false" 
            key="6FFF-966C-C34A-3688"
            licensee="For Evaluation Only"
            product="EditLive! for Java" 
            release="5.0" 
            seats="" 
            type="Evaluation License"
            eqEditor="true"
        />
     <license
            accountID="123456789100"
            activationURL="http://www.ephox.com/…"
            domain="MY.SERVER.COM"
            expiration="NEVER"
            forceActive="false"
            key="8FFF-FFFF-FFFF-FFFF"
            eqEditor="true"
            licensee="ME"
            product="EditLive for Java"
            release="5.0"
            type="UNLIMITED"
        />
    </ephoxLicenses>