These instructions are for UNIX and UNIX-like operating systems. Unpack the Lenya source distribution somewhere. Copy $LENYA_SRC_HOME/build.properties
to $LENYA_SRC_HOME/local.build.properties
. I changed the name of my original build.properties file after creating the copy to make sure it doesn't get used but this isn't required. Edit local.build.properties
and make the following changes:
Place a comment in front of the following entries: web.app.server=Jetty, web.app.server.jetty.port=8888
, and web.app.server.jetty.admin.port=8889
. Remove the comment in front of web.app.server=Tomcat
.
Set the value of tomcat.home.dir
so that it matches your tomcat home directory destination.
Tomcat 6 is different from previous versions of tomcat in that the /common/endorsed directory has been removed from default installations. I'm not really sure why this was done and I'm not really sure what the "correct" location should be for common, shared libraries but I'm going to write them to $CATALINA_HOME/lib so the value of tomcat.endorsed.dir
in local.build.properties will be changed to ${tomcat.home.dir}/lib
. I am tempted to write them to ${tomcat.home.dir}/webapps/lenya/WEB-INF/lib
and may update this article later if that works but since the directory does not yet exist within my tomcat installation, I'm afraid I'm going to get a build error.
Change the value of src.java.version
to 1.5. Save the file, then you're ready to build Lenya.
Run $LENYA_SRC_HOME/build.sh. On my non-pro macbook, build time was 81 seconds.
The build script places 5 jars in $CATALINA_HOME/lib: xml-apis-1.3.04.jar, xercesImpl-2.9.1.jar, xalan-2.7.1.jar, jakarta-regexp-1.5.jar, and jakarta-bcel-20040329.jar. All binaries and files that would normally be included in a war file have been written to $CATALINA_HOME/webapps/lenya.
Start tomcat 6 up, point your browser to http://host:port/lenya/ and you should see the Lenya start page.