Building LAMS 2.4.x

Building LAMS 2.4+

From version 2.3.1+ we have done some important upgrades with JBoss. We are using now the JBoss 5.1.0 GA.

Installing pre-required software

Sun Java JDK

We strongly suggest you use Sun Java JDK version 6. You need the Java SE Development Kit (JDK). When I wrote this page, the latest JDK 6 was update 14, so get that one or higher (within version 6 though).

JBoss 5.1.0 GA

You can download JBoss 5.1.0 from the JBoss website. Make sure you get JBoss 5.1.0 GA version and not other. If there's a JDK6 specific version for your platform, make sure you get that one.

Unzip, rename the server directory to "jboss-5.1". For LAMS, the default path for Windows is "D:\jboss-5.1" and for Linux is "/usr/local/jboss-5.1". However, you can change this in the lams_build/unix.properties or lams_build/windows.properties.

On jboss-5.1/bin make sure that you modify your JAVA_OPTS variable on run.conf or run.conf.bat to include an extra JVM parameter as follow "-Dfile.encoding=UTF-8". This will ensure that all Unicode characters are handled properly. So your final JAVA_OPTS should look like:

JAVA_OPTS="-server -Xms256m -Xmx512m -XX:MaxPermSize=256m -XX:NewSize=128m -XX:MaxNewSize=128m -XX:SurvivorRatio=95 -Dfile.encoding=UTF-8"  

MySQL 5.1.x

Download it from the MySQL downloads site according to your Operating System.

Apache Ant

Apache Ant downloads

Getting the LAMS source

You can get this from CVS

 cvs -z3 -Q -d :pserver:anonymous@code.lamsfoundation.org:/usr/local/cvsroot co -P  all

Pre compiling steps

Adjusting settings

There are a few settings you would need to change in the file insert_lams_unix_config_data.sql under lams_common/db/sql/ directory. Some important that you want to review are: ServerURL, EARDir, TempDir, DumpDir. Note that if you are compiling this on Windows you will need to modify the insert_lams_windows_config_data.sql file instead.

MySQL settings

You will need to create a LAMS database. See the instructions on how to create the Database Setup. If you use some other database user configuration, you can change the user settings in the mysql-ds.xml under lams_build/conf/unix/jboss/service/mysql-ds.xml or lams_build/conf/windows/jboss/service/mysql-ds.xml respectively.

Configuration Files

Ensure that you configure the common.properties and windows.properties or unix.properties according to your settings and operating system

Compiling LAMS

Go to lams_build and run:

export ANT_OPTS="-Xms64m -Xmx1024m -XX:MaxPermSize=512m"
ant lams-cruise

JBoss5 does have a lot of libraries that we won't need in LAMS, so you would need to run the following ant task only once:

ant slim-jboss

If you didn't get any errors on any of these ant tasks, then you are set to go. Go into your jboss-5.1 directory and start it (from jboss-5.1/bin/).

Problems?

If you have any problems, please post them in the Technical Forums in the LAMS Community





Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.