Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 6 Next »

Unix Installation Help

In this page you'll find all the necessary software you need to install LAMS 2.0 using the windows installer.

If you want to build LAMS from source, you can follow the instructions in Building LAMS.

Before You Run the Installer...

Make sure you have the software LAMS needs! If you are unsure of what software is needed to run LAMS, go to the Development Environmentpage.

MySQL Database Server

See the [Installing MySQL] page.

Java SE Development Kit (JDK)

Sun JAVA JDK is available from the Sun Java site. 5.0 or 6.0 will work, you can get the one that says:

JDK 5.0 Update 9

The Java SE Development Kit (JDK) includes:

  • the Java Runtime Environment (JRE)
  • command-line development tools, such as compilers and debuggers, that are necessary or useful for developing applets and applications

This is about 50 MB. See the installation instructions.

Note: Java 1.4.x won't work.

Wildfire Jabber Server

For our Chat tool, we use the Wildfire Jabber Server. See the [Installing Wildfire] page.

 Check  that you have the latest LAMS 2 Unix installer

See the downloads page.

Running the installer

Once you have your installer, extract it into any desired location eg: /usr/local. 

Editing the lams.properties File

The lams.properties file outlines where and how you will install LAMS 2.0, It  also configures some of the settings you want for the install. Most of the defualt configurations can be left, but you wiil need to change some to suit the setup of your personal machine. The lams.properties file comes with directions on what you need to alter and what needs to be left unchanged. Pay particular attention to "Essential Settings" section because LAMS 2.0 will not install or run properly if these are incorrect. Below is the skeleton for the lams.properties file.

{

 #   Copyright (C) 2005 LAMS Foundation (http://lamsfoundation.org)
#   License Information: http://lamsfoundation.org/licensing/lams/2.0/
#
#   This program is free software; you can redistribute it and/or modify
#   it under the terms of the GNU General Public License version 2.0
#   as published by the Free Software Foundation.
#
#   This program is distributed in the hope that it will be useful,
#   but WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#   GNU General Public License for more details.
#
#   You should have received a copy of the GNU General Public License
#   along with this program; if not, write to the Free Software
#   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
#   USA
#
#   http://www.gnu.org/licenses/gpl.txt
#
#   Author: Luke Foxton

#########################################################################################
# Installation Options                                    #
#########################################################################################

# The lamshome directory, will contain repository, temp and dump files
# Make sure this location has suffiecient disk space as several files will be stored
# here during run time
LAMS_DIR=/var/opt/lams

# Username and password for the system admin for LAMS
LAMS_USER=sysadmin
LAMS_PASS=sysadmin

# Default language locale and text direction for LAMS, see section 3 of the readme
LOCALE=en_AU
LOCALE_DIRECTION=LTR

# Yes if you wish to include the jsMath in your install, no otherwise
# jsMath is a project used for displaying mathematical symbols on a webpage
# See http://wiki.lamsfoundation.org/display/lamsdocs/jsMath for details on jsMath
INCLUDE_JSMATH=no

# Database name, username and password for your LAMS database
DB_NAME=lams2
DB_USER=lams2
DB_PASS=lamsdemo

# Wildfire configuration, used for chat tools. see the documentation under
# "Configuring the Chat Server" at:
# http://wiki.lamsfoundation.org/display/lams/Building+LAMS
WILDFIRE_DOMAIN=localhost
WILDFIRE_CONFERENCE=conference.localhost
WILDFIRE_USER=admin
WILDFIRE_PASS=

# Choose yes if you wish to install LAMS 2.0 as a Service
# You need to also put in your architecture type which you can find by typing
# >$ arch -k    or
# >$ uname -m
# In your console, your architecture type should be either 'i386', 'PPC' or 'IA64'
INSTALL_SERVICE=no
ARCH_TYPE=i386

#########################################################################################

#########################################################################################
# Essential Settings                                    #
# These setting must be correct in order for the install to complete successfully    #
#########################################################################################

# The port through which you want jboss to run
LAMS_PORT=8080

# The url you intend to use to run LAMS
# NOTE: Make sure the URL ends with a "/" or you will have problems running LAMS
SERVER_URL=http://localhost:8080/lams/

# The home directory of jboss-4.0.2
JBOSS_DIR=/usr/local/jboss-4.0.2

# The directory that contains your JDK. (Must be 1.5 or higher)
JDK_DIR=/usr/lib/jvm/java-1.5.0-sun-1.5.0.06

# The location of your mysql executable (Must be 5.0 or higher)
SQL_DIR=/usr/bin

# The URL that you jdbc driver will be running through
SQL_URL=jdbc:mysql://localhost/$

Unknown macro: {DB_NAME}

?characterEncoding=utf8

# The default character encoding for your database. LAMS languages require utf8
SQL_ENCODING=utf8

# The root password for MySql
DB_ROOT_PASSWORD=

#########################################################################################

#########################################################################################
# Installation Settings - DO NOT CHANGE                            #
# DO NOT CHANGE unless you require more disk space for repository, temp or dump dir    #
#########################################################################################

# Locations of the repository, temporary, and dump directories
# Used as storage locations for LAMS files
REPOSITORY_DIR=$

Unknown macro: {LAMS_DIR}

/repository
TEMP_DIR=$

/temp
DUMP_DIR=$

Unknown macro: {LAMS_DIR}

/dump

# Execution directiories must be within the jboss-4.0.2 directory structure
BINDIR=$

Unknown macro: {JBOSS_DIR}

bin
TOMCATDIR=$

Unknown macro: {DEPLOY_DIR}

/jbossweb-tomcat55.sar
DEPLOY_DIR=$

/server/default/deploy
SERVER_DIR=$

Unknown macro: {JBOSS_DIR}

/server
DEFAULT_DIR=$

/server/default
EAR_DIR=$

Unknown macro: {DEPLOY_DIR}

/lams.ear

# Location of installation files within the package
LAMS_BUILD=$

Unknown macro: {basedir}

/lams_build
CONF_DIR=$

/conf/unix
JBOSS_CONF=$

Unknown macro: {CONF_DIR}

/jboss
AUTH_CONF=$

/authentication

# Drivers for MySql during installation
SQL_DRIVER=com.mysql.jdbc.Driver
SQL_JAR=mysql-connector-java-3.1.12-bin.jar

#########################################################################################

Running the Ant script 

Intalling LAMS 2.0 using the binary pack is easy, it is simply a matter of typing in the install options you want in the lams.properties file (located in the root directory of the extracted package) and then running the ant script by typing:
>$ sudo ant/bin/ant install

NOTE: It is suggested that you use the included ant executable instead of your own to ensure that the database configuration runs correctly.

  • No labels