LAMS: Difference between revisions

The educational technology and digital learning wiki
Jump to navigation Jump to search
Line 29: Line 29:
== Installation tips ==
== Installation tips ==


=== Installation on a Windows XP PC ===
=== LAMS 2RC2 Windows XP PC ===


Do not try to install LAMS if you lack basic installation experience and technical '''reading skills'''. Here are just a few remarks in addition to the [http://wiki.lamsfoundation.org/display/lamsdocs/Windows+Installer+Help LAMS installation instructions]. I also strongly suggest to look at the [http://lamscommunity.org/dotlrn/clubs/technicalcommunity/forums/forum-view?forum_id=4929 Problems Installing LAMS] Forum.
Do not try to install LAMS if you lack basic installation experience and technical '''reading skills'''. Here are just a few remarks in addition to the [http://wiki.lamsfoundation.org/display/lamsdocs/Windows+Installer+Help LAMS installation instructions]. I also strongly suggest to look at the [http://lamscommunity.org/dotlrn/clubs/technicalcommunity/forums/forum-view?forum_id=4929 Problems Installing LAMS] Forum.
Line 54: Line 54:
* Has an installer and if you got the above right it will install without problems. You may have a firewall. In this case make sure to open the necessary ports. Also pay attention to popup blockers in your navigator. LAMS worked fine with both IE 6 and Firefox 1.5x.
* Has an installer and if you got the above right it will install without problems. You may have a firewall. In this case make sure to open the necessary ports. Also pay attention to popup blockers in your navigator. LAMS worked fine with both IE 6 and Firefox 1.5x.


=== On Solaris ===
=== Lams 2.0 on On Solaris ===


{{under construction}}
Lams 2.0 was released on december 6 2006.


First, read the instructions in [http://wiki.lamsfoundation.org/display/lams/Building+LAMS Building LAMS] '''and'' [http://wiki.lamsfoundation.org/display/lams/Development+Environment Development Environment]
First, read the instructions in [http://wiki.lamsfoundation.org/display/lams/Building+LAMS Building LAMS] '''and'' [http://wiki.lamsfoundation.org/display/lams/Development+Environment Development Environment]
Line 72: Line 72:
  cp /usr/local/jboss-4.0.2/server/all/lib/jboss-cache.jar /usr/local/jboss-4.0.2/server/default/lib/
  cp /usr/local/jboss-4.0.2/server/all/lib/jboss-cache.jar /usr/local/jboss-4.0.2/server/default/lib/
  cp /usr/local/jboss-4.0.2/server/all/lib/jgroups.jar /usr/local/jboss-4.0.2/server/default/lib/
  cp /usr/local/jboss-4.0.2/server/all/lib/jgroups.jar /usr/local/jboss-4.0.2/server/default/lib/
; LAMS source file download
* [http://lamscommunity.org/2.0/tarballs/lams2.0.tar.gz UK]
* [http://saturn.melcoe.mq.edu.au/installers/lams2.0.tar.gz Australia]


; LAMS pre-build configuration
; LAMS pre-build configuration


I configured (roughly) the following entries in the following files. Most entries are related to file paths.
I configured the following entries in the following files. Most entries are related to file paths.


In lams_build directory:
In lams_build directory:


  lams/lams_build/shared.properties
  File: lams/lams_build/shared.properties
  (nothing to change)
    
    
  lams/lams_build/common.properties
  File: lams/lams_build/common.properties
   osPropertiesName=unix
   osPropertiesName=unix
   db.password=XXXX
   db.password=XXXX


  lams/lams_build/unix.properties
  File: lams/lams_build/unix.properties
   contentrepository.directory=/usr/local/lams/repository
   contentrepository.directory=/usr/local/lams/repository


Change this in '''three''' locations !!
Change this in '''three''' locations !!
  lams_build/conf/unix/jboss/service/mysql-ds.xml
  File: lams_build/conf/unix/jboss/service/mysql-ds.xml
     <password>XXXX</password>
     <password>XXXX</password>


In lams_common directory:
In lams_common directory:


  lams/lams_common/db/sql/insert_unix_config_data.sql
  File: lams/lams_common/db/sql/insert_unix_config_data.sql
   ('ServerURL','http://tecfasun1.unige.ch:8080/lams/');
   ('ServerURL','http://tecfasun1.unige.ch:8080/lams/');
   ('TempDir','/usr/local/lams/temp');
   ('TempDir','/usr/local/lams/temp');
   ('DumpDir','/usr/local/lams/dump');
   ('DumpDir','/usr/local/lams/dump');
  ('EARDir','/usr/local/jboss-4.0.2/server/default/deploy/lams.ear');
   ('SMTPServer','mail.tecfa.unige.ch');
   ('SMTPServer','mail.tecfa.unige.ch');
   ('LamsSupportEmail','webmaster@tecfa.unige.ch');
   ('LamsSupportEmail','webmaster@tecfa.unige.ch');
Line 105: Line 109:


... Don't miss the port number for the server URL (e.g. 8080) !
... Don't miss the port number for the server URL (e.g. 8080) !
In the same directory you may change the admin login and password (not tested !)
File: lams/lams_common/db/sql/insert_users.sql 


Note: I did not find an LamsHome property in any file (''this conflicts with the installation instructions'').
Note: I did not find an LamsHome property in any file (''this conflicts with the installation instructions'').


 
; Make directories for lams (they must match the above of course)
; Make directories
  mkdir /usr/local/lams
  mkdir /usr/local/lams
  mkdir /usr/local/lams/temp
  mkdir /usr/local/lams/temp
Line 119: Line 125:


; Build
; Build
Type the following commands (you don't need Ecplise to build LAMS). But stop the JBOSS server when you do this.
Type the following commands ''in this order''. (You don't need Ecplise to build LAMS). But stop the JBOSS server when you do this.
  cd /src/lams/lams_build
  cd /src/lams/lams_build


Line 138: Line 144:
See [http://www.lamsinternational.com/documentation/advanced_p.php?g=configure Configuring your LAMS Server].
See [http://www.lamsinternational.com/documentation/advanced_p.php?g=configure Configuring your LAMS Server].


* Java may not have enough heap space (it runs out of memory). Replace the 256 with something bigger.
* Java may not have enough heap space (it runs out of memory). Replace the 256 with something bigger. I think that the run.sh has to be fixed.


  JAVA_OPTS="$JAVA_OPTS -Xms256m -Xmx256m -Dprogram.name=$PROGNAME"
File: /usr/local/jboss-4.0.2/bin/run.sh
Around line 150 insert:
  JAVA_OPTS="$JAVA_OPTS -Xms500m -Xmx500m -Dprogram.name=$PROGNAME"
# Display our environment


; Debug
; Debug

Revision as of 20:23, 6 December 2006

Definition

Learning Activity Management System (LAMS) is a learning design system (software).

Description

LAMS provides:

  • a visual authoring interface to design and create learning sequences from a list of building blocks of individual or collective activities
  • a monitoring tool through which teachers can track students' progress through an activity sequence.

According to a LAMS website, LAMS includes environments for user administration, student run-time delivery of sequences, teacher run-time monitoring of student sequences and, most importantly, teacher authoring/adaptation of sequences. LAMS is inspired by, and heavily based on, IMS Learning Design and EML. Originally, LAMS was not designed to be a reference implementation of either specification - however LAMS is expected to be IMS Learning Design conformant in the future.

According to Krann (2003), “The heart of the system is a visual editor that allows educators to choreograph a whole learning activity around a particular topic. By dragging and dropping acts like synchronous discussion (chat), web polls, students posting material and structured debates, a series of online lessons can be planned much like a conventional lesson. The player part of the system then allows a group of students to take part in all these activities, and presents the right tools at the right time, and divides the group into smaller groups, if that's what the teacher designed.”

The LAMS 2 environment

This article or section is currently under construction

In principle, someone is working on it and there should be a better version in a not so distant future.
If you want to modify this page, please discuss it with the person working on it (see the "history")

Authoring

Basically, an author has to do the following tasks:

  • Assemble a learning sequence
  • Assign these to groups (administrator must give him the rights)

Members and courses

This part was least obvious to me :)

Installation tips

LAMS 2RC2 Windows XP PC

Do not try to install LAMS if you lack basic installation experience and technical reading skills. Here are just a few remarks in addition to the LAMS installation instructions. I also strongly suggest to look at the Problems Installing LAMS Forum.

Other Software

To run it on windows you need to install other software.

  • Java JSE 5.0 (update 9), not just the JRE. Get it from Sun.
  • MySQL: Get it directly from MySQL and take the Installer version (not the zip installation).
    • Install it and remember the password
    • I suggest not installing/using a WAMP environment for LAMS 2RC 2. The LAMS installer 2Rc2 could not find MySQL in my WampServer environment even if it was told where to look for in the LAMS installer.
    • Hack would be to manually edit the registry with this information from MySQL AB and this posting and picture by Ernie Ghiglione. Bascially one needs to reproduce the MySQL entry from the official MysQL AB installer:
HKEY_LOCAL_MACHINE
  SOFTWARE
    MySQL AB
      MySQL Server 5.0  
                         Location c:\wamp\mysql
                         Version  5.0.27

... but this still didn't work for me.

MySQL
  • If you use a WAMP package you must know where MySQL sits. E.g. c:\wamp\mysql if you work with "WampServer" (but see above that I failed, rather work with an "official MySQL installer from MySQL AB). If you use the official MySQL installer, there will be no problem.
LAMS
  • Has an installer and if you got the above right it will install without problems. You may have a firewall. In this case make sure to open the necessary ports. Also pay attention to popup blockers in your navigator. LAMS worked fine with both IE 6 and Firefox 1.5x.

Lams 2.0 on On Solaris

Lams 2.0 was released on december 6 2006.

First, read the instructions in Building LAMS 'and Development Environment

Other software
  • Solaris 10 ought to have the right java + ant installed.
  • Make sure that you also have a MySQL 5.x and create a lams database with a lams user
  • JBOSS (Java application server)
    • Unpackage into /usr/local
gtar xzf jboss-4.0.2.tar.gz -C /usr/local 
  • Copy some jar files
cp /usr/local/jboss-4.0.2/server/all/lib/jboss-cache.jar /usr/local/jboss-4.0.2/server/default/lib/
cp /usr/local/jboss-4.0.2/server/all/lib/jgroups.jar /usr/local/jboss-4.0.2/server/default/lib/
LAMS source file download
* UK
* Australia
LAMS pre-build configuration

I configured the following entries in the following files. Most entries are related to file paths.

In lams_build directory:

File: lams/lams_build/shared.properties
  (nothing to change)
 
File: lams/lams_build/common.properties
  osPropertiesName=unix
  db.password=XXXX
File: lams/lams_build/unix.properties
  contentrepository.directory=/usr/local/lams/repository

Change this in three locations !!

File: lams_build/conf/unix/jboss/service/mysql-ds.xml
   <password>XXXX</password>

In lams_common directory:

File: lams/lams_common/db/sql/insert_unix_config_data.sql
  ('ServerURL','http://tecfasun1.unige.ch:8080/lams/');
  ('TempDir','/usr/local/lams/temp');
  ('DumpDir','/usr/local/lams/dump');
  ('SMTPServer','mail.tecfa.unige.ch');
  ('LamsSupportEmail','webmaster@tecfa.unige.ch');
  ('ContentRepositoryPath','/usr/local/lams/repository');   

... Don't miss the port number for the server URL (e.g. 8080) !

In the same directory you may change the admin login and password (not tested !)

File: lams/lams_common/db/sql/insert_users.sql  

Note: I did not find an LamsHome property in any file (this conflicts with the installation instructions).

Make directories for lams (they must match the above of course)
mkdir /usr/local/lams
mkdir /usr/local/lams/temp
mkdir /usr/local/lams/dump
mkdir /usr/local/lams/repository

I don't know who runs jboss, so I just deproteced

chmod -R 777 /usr/local/lams
Build

Type the following commands in this order. (You don't need Ecplise to build LAMS). But stop the JBOSS server when you do this.

cd /src/lams/lams_build
ant rebuild-db
ant assemble-ear
ant deploy-ear
ant deploy-tools
ant copyfiles
Run it
cd /usr/local/jboss-4.0.2/bin/
./run.sh &

The sysadmin login password is in the SQL file below. You may change it before you build, I was quite frustrated not to able to log in ;)

/src/lams/lams_common/db/sql/insert_users.sql
Server configuration

See Configuring your LAMS Server.

  • Java may not have enough heap space (it runs out of memory). Replace the 256 with something bigger. I think that the run.sh has to be fixed.
File: /usr/local/jboss-4.0.2/bin/run.sh

Around line 150 insert:

JAVA_OPTS="$JAVA_OPTS -Xms500m -Xmx500m -Dprogram.name=$PROGNAME"
# Display our environment
Debug

Look at files in:

/usr/local/jboss-4.0.2/server/default/log/

Then stop jboss,

cd /usr/local/jboss-4.0.2/bin/shutdown -S &

Repair misconfigurations above, rebuild with ant and run it again :) I don't know if global cleaning up is an efficient idea, but I do it anyhow as a last resort when I get stuck, e.g.:

  1. Execute ant clean
  2. Drop the lams database (and don't forget to create it again)
  3. Empty the jboss server/default/deploy/lams.ear/ directory ?
Things I did wrong
  • Forget to specif the os
  • Forgot to add the port number of the server URL
  • Forgot to create the lams directory
  • Only changed password in one location in lams_build/conf/unix/jboss/service/mysql-ds.xml
Current problem

Lams is deployed and the login screen is there, but not enough heap space (fixing it now)

Moodle - LAMS integration

  • We will try it with LAMS 2RC2 (not done yet)
Documentation

Evaluation

Masterman and Lee (2005:4) who ran an evaluation with 34 participants in the UK reported the following findings:

i) LAMS is capable of supporting a range of pedagogical approaches, in that designers can select those activities that match their preferred style. However, the lack of support for images and graphics can be a hindrance to the design of appropriate learning tasks. The adoption of LAMS within an institution would almost certainly entail an increased workload for teachers, but with time and experience this load could be expected to lessen.

ii) LAMS appears neither to have compromised learning outcomes in comparison with the existing learning environment nor to have resulted in dramatic improvements in achievement. However, using LAMS to raise the level of learning outcomes was not a prime consideration for practitioners. Rather, they perceived its benefits to lie in increasing learners' motivation and in encouraging participation by more reticent students. Feedback obtained directly or indirectly from learners suggests that some appreciated the independence and freedom to work at their own pace, while others did not like the linearity of LAMS sequences or wanted more direct feedback on their progress.

iii) Several participants engaged in some form of reflective activity either while designing a LAMS sequence or afterwards. However, while they recognised the importance of sharing their practice with others, technical and cultural barriers need to be overcome.

Links

Software and downloads

Installation of LAMS does need installation skills ! If you just want to play with LAMS we suggest getting a demo account with LAMS International.

  • LAMS 1.0x (free for Win, MacOS X and Linux, Source code in GPL
    • Requirements: Java SKD 1.4.2, MySQL
  • LAMS is, will or may be integrated into various platforms such as Blackboard (commercial), Sakkai or Moodle. DSchneider does not know if LAMS 2 Beta already works with Moodle (LAMS 1.x does).

General links

  • LAMS Foundation, includes manuals, downloads, etc. This site is slow (dec 2006.)
  • LAMS Wiki (Technical discussion and development of the new version of LAMS (Learning Activity Management System and dwoload information)

References

  • Dalziel, James, Implementing Learning Design: The Learning Activity Management System (LAMS), Macquarie E-learning Centre of Excellence (MELCOE), PDF
  • Kraan Wilbert, (2003). Learning Design inspiration, CETIS article, HTML
  • David Jennings (2005), Evaluation of Learning Activity Management Systems, HTML
  • Liz Masterman, Stuart D. Lee (2005), Evaluation Of The Practitioner Trial Of Lams: Final Report, Learning Technologies Group, Oxford University Computing Services HTML