EditLive! for XML Client Install

The EditLive! for XML applet is automatically deployed to users through Java's applet deployment technology. This allows users to have EditLive! for XML seamlessly installed when first running a page containing EditLive! for XML. Users are not required to physically download and install EditLive! for XML themselves. This greatly simplifies the process for the end user.

What is Required to Use EditLive! for XML

EditLive! for XML requires that the Java Runtime Environment (JRE) version 1.4 or above is installed on the user's computer. If this is not detected then EditLive! for XML will automatically deploy and install a version of the JRE. Through the LocalDeployment property developers can specify where the JRE will be deployed from. This property allows developers to specify if the JRE should be deployed from the local server or downloaded over the Web from Sun Microsystems.

Installing the JRE from the Web Application Server

This is recommended when users can be expected to access EditLive! for XML via Web applications on an intranet. In this case it will be much faster to download the JRE from the local server than from Sun Microsystems' server. To deploy the JRE from the relevant application server download an installer for the appropriate version of the JRE from Sun Microsystems and place it on your Web server. Then set the LocalDeployment property to true when instantiating EditLive! for XML and also set the JREDownloadURL property to map to the location that the JRE is available from on your Web server .

Installing the JRE from a Sun Microsystems Server

This is recommended when users can be expected to access EditLive! for XML from a machine external to the network on which EditLive! for XML is hosted (i.e accessing EditLive! for XML over the Internet). In this case download times for the JRE can be expected to be much slower than an install over an intranet. To deploy the JRE from a Sun Microsystems' server set the LocalDeployment property to false when instantiating EditLive! for XML.

Getting the Java Runtime Environment

Copies of Sun Microsystem's Java Runtime Environment can be found on the Java Web site. Developers can download JRE installers from the Java Web site for hosting on their servers for the purposes of deploying the JRE.

Installing the EditLive! for XML Client

EditLive! for XML is automatically deployed to users via the Java Applet technology using signed JAR files. All the files necessary to achieve the deployment of EditLive! for XML are included in the EditLive! for XML SDK and can easily be hosted on a Web server.

When a page containing EditLive! for XML is first accessed by a user the client machine downloads the files necessary to run EditLive! for XML and permanently caches them on the client machine. When accessing the page in future the files necessary to run EditLive! for XML will be loaded from the cache.

If the distribution of EditLive! for XML is updated on the server any updated files are automatically deployed to the client upon their first access and cached.

Dealing with a java.lang.ClassNotFound Exception

If the Java plug-in cannot locate the editlivexml.jar then a java.lang.ClassNotFound exception will be generated by the plug-in. There are two probably causes for this:

  • The path set via the DownloadDirectory property is incorrect. Ensure that the DownloadDirectory property correctly provides a URL for the location of the directory containing the EditLive! for XML source, including the editlivexml.jar and editlivexml.js files.

  • If it has been ensured that the path is valid for the deployment and the exception is still occurring the editlivexml.jar may be corrupted. Try downloading the EditLive! for XML SDK again from the Ephox Web site.