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:
Download it from the MySQL downloads site according to your Operating System.
Apache Ant downloads
Getting the LAMS source
You can get this from CVS
Pre compiling steps
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.
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.
Ensure that you configure the common.properties and windows.properties or unix.properties according to your settings and operating system
Go to lams_build and run:
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:
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/).
If you have any problems, please post them in the Technical Forums in the LAMS Community