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 34 Next »

Unix Installation and Updating Help

In this page you'll find all the necessary software you need to install LAMS 2.0.x versions using the unix installer. If you need to restore the backup created by the updater, see Revert to Other Backup.

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

Before You Run the Installer/Updater...

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)

LAMS requires the Sun JDK 5 or 6. See the Installing Java page for more details.

Wildfire Jabber Server

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

JBOSS

Version:

4.0.2

Suggested Location

D:\ (Windows) | /usr/local/jboss-4.0.2 (Unix)

Source

www.jboss.org    http://labs.jboss.com/portal/jbossas/download

Comments

4.0.3SP1 and 4.0.4 have problems running LAMS, so 4.0.2 is your best bet until we fix the problem.

 Check  that you have the latest LAMS 2 Unix installer

See the downloads page.

 If you are updating LAMS

Make sure you have the previous version of LAMS installed. You can find out what version you can update to on the downloads page

You are strongly recommended  to backup your LAMS installation before updating to prevent losing any of the data you may have saved while using your current LAMS installation. The updater will prompt you to ask whether you want an automatic backup, otherwise you can backup manually by following the steps.

  1. Backup the JBoss directory that contains your current LAMS installation
  2. Backup you repository directories. These are the directories specified by the $LAMS_DIR variable in lams.properties
  3. Backup /etc/lams2 if it exists
  4. Dump the LAMS database by using the following MySql command, filling in the fields inside the brackets.
    > mysqldump -u(database username) -p(password) (lams database name) > (backup dir)/lams.dump

Running the installer/updater

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, It  also configures some of the settings you want for the install. If you have an existing lams.properties file from a previous LAMS installation or update you can re-use it by simply copying it to the root directory of the installer/updater package. It will most likely be kept in the /etc/lams2 folder.

Most of the default configurations in lams.properties can be left, but you will 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 will not install or run properly if these are incorrect. Below is the skeleton for the lams.properties file.

Setting up the Language Locale

You will see about a quarter of the way through the lams.properties file there is a line that says: 

LOCALE=en_AU
LOCALE_DIRECTION=LTR

In LAMS you can set the defualt language of your server to be one of many languages, and more to come, see the internationalization page. Look out for unix language packs to add to your list of language locales.

The locale options for LAMS-2.0 available are listed below, simply put in your lams.properties file (under Installation Options):

LOCALE - (locale)
LOCALE_DIRECTION - (locale direction)

Language       

Locale   

Locale-Direction

English    (Australia)                  

en_AU

LTR

Español    (Spanish)

es_ES

LTR

Deutsch    (German)

de_DE

LTR

???? (Chinese Simplified)

zh_CN

LTR

Français (French)

fr_FR

LTR

Italiano (Italian)

it_IT

LTR

Norsk (Norwegian)

no_NO

LTR

Svenska    (Swedish)

sv_SE

LTR

??? (Korean)

ko_KR

LTR

Polski (Polish)

pl_PL

LTR

Português (Portuguese Brazil)

pt_BR

LTR

Ti?ng Vi?t (Vietnamese)

vi_VN

LTR

Chinese (Taiwan)

zh_TW

LTR

Arabic (????) (Jordan)

ar_JO

RTL

???????? (Greek)

el_GR

LTR

Running the Installer

Before you run the script, you need to ensure that your $JAVA_HOME is set to your java 1.5 or higher directory, also you will need to set the $PATH variable
to include the path to the java binaries. The steps to do this are listed below.
> JAVA_HOME="(path to java installation directory)"
> export JAVA_HOME
> PATH="(path to java bin directory):$PATH"
> export PATH

Once you have finished editing lams.properties file you are ready to run the
update script. Go to the root directory of the package and type:
> sudo ./install-lams.sh

The installer will ask you if you wish to set up lams as a service, this will make lams start automatically each timeyou boot your machine. The installer will attempt to detect the wrapper jar that is suitable for you, if it cannot you can choose the wrapper that is the closest to suiting your architecture

You can find out your architecture types by typing
> uname -a    to get all the inforamtion
> uname -m    to get the architecture type

wrapper-linux-ppc-64-3.2.3    Linux    PPC
wrapper-linux-x86-32-3.2.3    Linux    i386    
wrapper-linux-x86-64-3.2.3    Linix     IA64

More information about setting the wrapper up in unix can be found here.

Running the Updater

Before you run the script, you need to ensure that your $JAVA_HOME is set to your java 1.5 or higher directory, also you will need to set the $PATH variable
to include the path to the java binaries. The steps to do this are listed below.
> JAVA_HOME="(path to java installation directory)"
> export JAVA_HOME
> PATH="(path to java bin directory):$PATH"
> export PATH

Once you have finished editing lams.properties file you are ready to run the
update script. Go to the root directory of the package and type:
> sudo ./update-lams.sh

Running Lams

If you chose to installed LAMS 2.0 without the wrapper, you should be able to run LAMS 2.0.2 by simply going into the <jboss-4.0.2 dir>/bin and typing:

>sudo ./run-lams.sh

This is a new script added by LAMS 2.0.2. It was not in LAMS 2.0.

After a couple of minutes LAMS 2.0 will have started. In your browser type the server URL that you specified in the lams.configuration file, and you should be at the lams homepage.

To shutdown LAMS 2.0 go to (jboss directory)/bin and type:
> sudo ./shutdown.sh -S

LAMS 2.0 will take a few moments to shut down. To check if LAMS 2.0 has shut down correctly, type the following on Linux:
> ps -ef | grep java

Or type the following on Macintosh
> ps -A | grep Java

Using the Java Wrapper

If you chose to install the Java Service Wrapper, LAMS will start automatically when you boot your machine and stop when you turn off your machine.

You can also start and stop LAMS manually by going to the jboss-4.0.2/bin directory and using these commands.

> sudo ./lams2 start        (starts LAMS)
> sudo ./lams2 console   (start LAMS in current shell, to stop do ctrl+C)
> sudo ./lams2 stop        (stops LAMS)
> sudo ./lams2 restart    (restarts LAMS)
> sudo ./lams2 status     (tells you if LAMS is currently running)
> sudo ./lams2 dump     (send a kill -3 signal to the wrapper causing the JVM to do a full thread dump)

For more information about using the Jave Service Wrapper with LAMS, go to the web tutorial

  • No labels