Index
Downloads
Documentation
Technologies
Architecture
Screenshots
Release Notes
API Docs
Install
Installation on JServ
Installation on Tomcat
Installation on Resin
Code Repository
Mail Lists
Live Demo
Credits
SourceForge Logo
Sourceforge Project Page

Requirements

Caucho Resin installation

 

Requirements

This document describes the webEditor installation procedure under the Caucho Technologies Servlet Engine Resin

webEditor has been tested with the latest stable release of Resin, 1.2. If you successfully install webEditor under another version of Resin, please, make us know.

For generic recommendations, please, read the webEditor generic installation document

 

Caucho Resin installation

First at all, you have to download the webEditor latest release from our web site http://sourceforge.net/projects/webeditor

webEditor now comes with a war (Web Application archive) file, ready to install in any J2EE compatible engine, for example in Resin. Once you download webEditor.war file you should place it under the webapps Tomcat directory, typically in $TOMCAT_HOME/webapps.

If Resin is runnig, it will detect the existence of a new war file, and will uncompress this new file under a new webapp directory called webEditor. When Resin finish with the decompression, you should go to the directory webapps/webEditor/WEB-INF and move the file called resin-web.xml to web.xml.

In order to set up webEditor properly, you must edit the servlet descriptor file, placed in WEB-INF/web.xml:

<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE web-app
    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
    "http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">

<web-app>
<servlet-mapping url-pattern="/servlet/*" servlet-name="invoker"/>

<servlet>
  <servlet-name>wEd</servlet-name>
  <servlet-class>webEditor.wEd</servlet-class>
  <init-param>
   <param-name>wEd_root</param-name>
   <param-value>[$RESIN_HOME]/webapps/webEditor/editor_1</param-value>
  </init-param>
</servlet>
</web-app>

Then, change $RESIN_HOME for the proper value for your system.

The last step is to change the webEditor main configuration file. You will find this in $RESIN_HOME/webapps/webEditor/editor_1/general.xml:

<!-- Sample configuration file for the example editor -->

<general>

<category name="directories">

<!-- General name of the editor-->

<data code="editorName">editor_1</data>

<!-- Web Server primary document directory-->

<!-- Please, change this parameter to your proper value-->

<data code="serverRoot">/usr/local/resin-1.2/webapps</data>

<!-- Name of the Web Server in whitch you want to PUBLISH-->

<!-- note that this is not necesary your edition server -->

<data code="serverName">localhost</data>

<!-- Editor primary directory (Relative to the root directory) -->

<data code="docRoot">webEditor/myNews</data>

<!-- Related images directory (Relative to the root directory) -->

<data code="imgDir">webEditor/myNews/images</data>

<!-- Temporal Directory in whitch to store the uploaded images -->

<data code="tmpDir">/tmp</data>

<!-- Editor data directory (Relative to the root directory) -->

<data code="dataDir">data</data>

<!-- XSL templates directory (relative to the data directory) -->

<data code="tplDir">templates</data>

<!-- File with the list of the xml files taht forms the Home Page -->

<data code="homePage">homePage.xml</data>

</category>

</general>

There, you should change the variables named serverRoot, docRoot, imgDir and tmpDir for values that match with your system settings. As a general rule, serverRoot must be the webapps directory of Resin.

Don't forget to grant write access to the news directory for your webEditor SO user!!.

Well, that's all. You only have to restart Resin and take a look the webEditor main URL:

http://localhost/webEditor

If everything is ok, you will see this pretty cool page: