Skip to end of metadata
Go to start of metadata

Upgrading LAMS 2.3.5 to 2.4 Linux

Be Careful

Before performing any upgrades, please make sure all your data is backed up properly in case you need to revert to previous versions.

This instructions are for a manual upgrade from LAMS 2.3.5 to 2.4 in Linux.

Stop your LAMS 2.3.5 server

Find the LAMS 2.3.5 server process and kill it

Read the /etc/lams2/

The file contains all of the settings that we will need to upgrade LAMS and it should look something like this:

You might have modified this file according to your previous installation needs. Just make sure you keep this file handy as we will use some of these settings for the upgrade.

Download the LAMS v2.4 upgrade file

Copy the new jboss-5.1 folder to /usr/local

Copy 2.3.5 files to 2.4

There are some files that you need to copy as follow. In your you'll find where jboss-4.0.2 is installed (as you can see above, it my case is JBOSS_DIR=/usr/local/jboss-4.0.2).

Copy uploaded files

Copy news.html file

Copy Pixl folder pics

Create a user you will use to run LAMS as

Previews versions of LAMS run it as root, which is not a really good idea. So for 2.4, we create a user called lams instead.

set the permission for jboss-5.1 folder:

and also the other directories that LAMS uses, in my case the "LAMS_DIR=/var/opt/lams" as it shows in my file

Edit mysql connector

Edit the /usr/local/jboss-5.1/server/default/deploy/mysql-ds.xml file and enter the db name, user and password as configured in your file


Deploy new tools.

LAMS 2.4 has three new tools: Wookie, IMS Common Cartridge/Basic LTI and Webconferencing.

Go to your lams-unix-upgrade-2.4.0 folder and find the _new-tools_folder.

In there you should be able to see:

Get into bbb-deploy and configure the deploy.xml file. If you left all the settings by default, you shouldn't need to do anything here. However, if you have changed settings, then you'll need to edit a few lines in there with the settings you have in

Once you know everything is alright, then execute the script and you should get the following output:

Do the same for the other two tools imscc-deploy and wookie-deploy.

If all outputs look like the one above, you have deployed all new tools properly!

Manual db configuration update

There's only one small configuration update you will need to do manually on the database and it goes like this:

Now you are ready to start LAMS 2.4!

Start LAMS 2.4

When starting LAMS 2.4 for the first time, you will be able to see that LAMS runs quite a few db upgrade scripts automatically. So this first LAMS 2.4 boot might take a bit longer than usual. However, if you see the output without any errors, you have successfully upgraded LAMS 2.4!

For further details, please check out the Sysadmin Guide

Need help?

Check out the technical forums in the LAMS Community

  • No labels