Installing Your EditLive! License

May 26, 2009

This tutorial is designed to describe the process for installing a license file into a EditLive! for Java and Editlive for ILWCM. 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.

Locate your Configuration XML 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.

Your developer(s) may have created configuration XML files with different names. If you are not the person who developed the solution that uses EditLive check with the developer(s) to determine the name of the configuration file(s) 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.

The location of your configuration XML file can vary depending on how Editlive! was integrated with your system. The following are some common locations of the Editlive Configuration XML.

Editlive for Java
../redistributables/editlivejava

Editlive for ILWCM 6.0
C:/Program Files/IBM/PortalServer/installedApps/WCM_Authoring_UI_PA_dmpc04g.ear/PA_dmpc04g.war

Editlive for ILWCM 6.1+
C:/Program Files/IBM/Websphere/wp_profile/installedApps/portal61/PA_WCM_Authoring_UI.ear/ilwwcm-authoring.war
For ILWCM 6.1+, you may choose to update the xml file(s) at the location above, or update the license XML in the Editlive EAR file, and then redeploy.

If you are the Editlive ILWCM role-based configuration feature, you must update the configuration file used for each role. Check with the developer(s) to determine the configuration file(s) in use by your application.

Open the Configuration XML File

Open the configuration XML file (sample_eljconfig.xml) using a text editor.

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 XML 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>

Back to Hints & Tips