HOWTO: Install Apache-Lenya w/ Tomcat on Gentoo x86

[cjubon]

This is a short HOWTO on how to install the Lenya Content Management System version 2.0 on top of a Tomcat server on a Gentoo box. As there is no ebuild for Lenya in the portage tree (nor on o.g.o.), you'll need to install from sources. Installation generally being quite straightforward, there are, however, some caveats. Hence this how-to.

Introduction:
Lenya is a CMS originally developped for the "Neue Zürcher Zeitung", a Swiss German language quality newspaper, under the name of Wyona. In 2003 the project has been open-sourced and donated to the Apache Software Foundation. Whereas other open-source CMSs are either based on PHP (Typo3, Joomla, ...) or on Python (Zope/Plone), Lenya is based on Java. The Java framework used for Lenya, also developped by the Apache Software Foundation, is called Cocoon. In order to successfully develop a web site on Lenya, you need at least basic knowledge on how to develop web-applications in Java.

Lenya can be run as a stand-alone application, using its own built-in http server (which is called "Jetty"), or on top of the apache "Tomcat" server, a fully Java based web application server. It can even use yet other servers, but this will not be covered by this how-to. We concentrate on how to build Lenya for a tomcat environment.

Prerequisites:

• You need a clean install of Java and Apache Tomcat. This can easily be achieved on Gentoo, since everything is in portage. Note, however, that Lenya will not run on current Tomcat 6. You need to install a lower version. The ebuilds from the 5.5-branch should all work. So, first thing to do:

  Code: Select all

  # nano -w /etc/portage/package.mask
  (Add the following line:)
  >=www-servers/tomcat-6

  Now you can run

  Code: Select all

  # emerge -av tomcat

  All the dependencies of Lenya, including sun-jdk-1.4*, should be pulled in automatically. Note that the sun jdk-1.4 will have to be downloaded manually, just follow the instructions in the emerge messages. If you're new to tomcat, you can install additional documentation, an admin web interface, and examples, by activating the doc, admin, and examples USE flags, respectively. Note that there are known security issues with the admin and examples extensions, however.
• Second, you need Lenya. You can either download the release version or checkout the development version from svn. Currently, the official release will have to be patched in order to build correctly. The svn-version is already patched, but download will be approximately 212 MB instead of 55 MB for the tarball.
  If you opt for the current official release, you can get it from here: http://www.apache.org/dyn/closer.cgi/le ... src.tar.gz
  You'll need the following patch (modified from http://issues.apache.org/bugzilla/attac ... i?id=21126):

  Code: Select all

  Index: src/modules-core/ac/java/src/org/apache/lenya/ac/impl/CredentialImpl.java
  ===================================================================
  --- src/modules-core/ac/java/src/org/apache/lenya/ac/impl/CredentialImpl.java	(revision 595021)
  +++ src/modules-core/ac/java/src/org/apache/lenya/ac/impl/CredentialImpl.java	(r595021_patched)
  @@ -107,6 +107,7 @@
       }
  
       public int hashCode() {
  -        return Integer.valueOf(getAccreditable().hashCode() + getRole().hashCode()).hashCode();
  +        Integer integer = new Integer(getAccreditable().hashCode() + getRole().hashCode());
  +        return integer.hashCode();
       }
   }
  

  Copy it into your editor and save it as (e.g.) lenya-2.0-issue43859.patch in your sources directory.
  
  If you opt for svn checkout of the developer versions, just run

  Code: Select all

  svn co http://svn.apache.org/repos/asf/lenya/trunk lenya-2.0.x

  in an appropriate directory and wait . Of course, you need dev-util/subversion in order to run that command.

Patching Lenya-2.0
This step is only necessary if you decided to use the official release version 2.0. The upcoming version 2.0.1 will already contain the fix.
Unpack the tarball into your sources directory. We assume /usr/local/src/ for this in this guide, hence you need superuser priviledges. ~/programs/src/ would be another possibility.

Code: Select all

# cd /usr/local/src
# tar -xzvf /path/to/apache-lenya-2.0-src.tar.gz

Apply the patch:

Code: Select all

# cd apache-lenya-2.0
# patch -b -p0 < /path/to/lenya-2.0_issue43859.patch

Configuring Lenya for Gentoo Tomcat
This step is necessary because Tomcat on Gentoo is spread across multiple directories (in order to comply with FHS and Gentoo standards). You may read the Gentoo Tomcat guide for more information: http://www.gentoo.org/proj/en/java/tomcat-guide.xml.

Assuming you're inside the apache-lenya-2.0 source directory, fire up your favorite editor and save these lines as file local.build.properties

Code: Select all

build.properties.version=594644

web.app.server=Tomcat
tomcat.home.dir=/usr/share/tomcat-5.5
tomcat.webapps.dir=/var/lib/tomcat-5.5/webapps/lenya
tomcat.cache.dir=/var/run/tomcat-5.5/Catalina/localhost/lenya
# Comment out if you don't want allow uploads
enable.uploads=true
src.java.version=1.4

Alternatively, you can copy the file build.properties to local.build.properties, change at least the Tomcat related stuff, and make further changes according to your needs.

Installing Lenya
Now you're almost done: Still inside your lenya source directory, type

Code: Select all

./build.sh

Lenya should build now, and install it's webapp part into /var/lib/tomcat-5.5/webapps/lenya (as defined by our custom local.build.properties file).

Finally, you have to give tomcat write access to /var/lib/tomcat-5.5/webapps/lenya/WEB-INF/db. This is most conveniently be done by:

Code: Select all

# chown -R tomcat:tomcat /var/lib/tomcat-5.5/webapps/lenya

If you omit that last step, Lenya will throw an "Failure occured during job recovery" error when you launch it.

Launching Lenya
Start or restart tomcat with the usual "/etc/init.d/tomcat-5.5 (re)start" command and visit your shiny new Lenya installation at http://localhost:8080/lenya/

Have fun
cjubon

[legine]

nice work.

But i think I miss something here.

On lenya doocumentation it says to use launch.sh

When I try to go to

Code: Select all

http://localhost:8080/lenya/ 

I get the error msg:
the request source (/lenya/) is not aviable.

I did swap the ownership to tomcat:tomcat and set the mode I set to 777.

Ty
Peter

[cjubon]

Hi, it's nice to see that this post receives its first answer right after 289 visits .

On lenya doocumentation it says to use launch.sh

I cannot find that reference nor any script called "launch.sh" in the lenya sources.

I get the error msg:
the request source (/lenya/) is not aviable.

Start or restart tomcat with the usual "/etc/init.d/tomcat-5.5 (re)start" command

I did swap the ownership to tomcat:tomcat and set the mode

Code: Select all

# chown -R tomcat:tomcat /var/lib/tomcat-5.5/webapps/lenya

Or was it something different that was necessary for you?
Thank you for your help to improve this HOWTO!

cheers, cjubon

[legine]

Hi, it's nice to see that this post receives its first answer right after 289 visits .

legine hat Folgendes geschrieben:
On lenya doocumentation it says to use launch.sh

Yick!
Yes my fault. I overread it is in the stand alone section, which we dont need.

cjubon hat Folgendes geschrieben:
Code:
# chown -R tomcat:tomcat /var/lib/tomcat-5.5/webapps/lenya


Or was it something different that was necessary for you?
Thank you for your help to improve this HOWTO!

I dont have an Idea. Yes I did this. And I can not deploy lenya into my tomcat 5-5.

Thought I had first tomcat 6 installed before catching that I configured Paludis wrong way
Is there a way to increase debug output within Tomcat? I mean Tomcat just says it can not deploy, and thats a bit thin to go on. especially bc I have only installed Tomcat to look at lenya. I have no Idea about it.
Maybe I do need to sdetup a lenya user?
Or maybe I need to install cocoon? ( I am a bit naivly trying your Howto )

Well sure thing. But I bet i am just dump again and over read something. -.-
cheers

[cjubon]

Maybe I do need to sdetup a lenya user?

No.

Or maybe I need to install cocoon?

No, Cocoon is part of the lenya source package.

[mwhipple]

The problem with Tomcat 6 is seemingly the moving of the location for endorsed libraries. I've installed Lenya on Gentoo by changing the tomcat.endorsed.dir value in the local.build.properties to use '${tomcat.home.dir}/lib'. The endorsed subdirectory may also be an option (or the ideal option) but I haven't seem to had as much luck with it.