Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0
Tip
titleLAMS 2.3 Deb Package

On Debian/Ubuntu systems, you can get LAMS 2.3 up and running by downloading and running the package found here.
This is the quickest way to get LAMS running on your system.

Unix Installation and Updating Help

...

MySQL Database Server

See the Installing MySQL page. You can install MySQL on another server to the one running LAMS - the Unix/Linux installer will install LAMS on one server with MySQL running on another server.

...

Version:

4.0.2

Suggested Location

/usr/local/jboss-4.0.2

Source

www.jboss.org    http://labswww.jboss.comorg/portal/jbossas/downloaddownloads.html

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.

...

This will install Sun Java JDK 1.5, Ant and MySQL 5.0 Server

Code Blocknoformat
titlePackages required for LAMS2
borderStylesolid
apt-get install ant sun-java5-jdk  mysql-server-5.0

Now, let's get JBoss Appserver

Code Blocknoformat
titleGet JBoss
borderStylesolid
cd /usr/local 
wget http://superb-west.dl.sourceforge.net/sourceforge/jboss/jboss-4.0.2.tar.gz tar xvzf  jboss-4.0.2.tar.gz

Wildfire Jabber server:

Code Blocknoformat
titleGet JBoss
borderStylesolid
cd /usr/local 
wget http://www.igniterealtime.org/builds/wildfire/wildfire_2_6_2.tar.gz tar xvzf wildfire_2_6_2.tar.gz

...

Check that you have the latest LAMS 2 Unix installer

See the downloads page.

Anchor
mysql
mysql

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.
No Format

> mysqldump \-u(database username) \-p(password) (lams database name) > (backup dir)/lams.dump

Running the installer/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. >

No Format

# JAVA_HOME="(path to java installation directory)"

...


# export JAVA_HOME

...


# PATH="(path to java bin directory):$PATH"

...


# export PATH

If you are running MySQL on a separate server, then you will need to set up the database before doing the installation. See "Setting up MySql on a Different Server" in the readme file for the details on creating the database and setting up the appropriate privileges.

...

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

No Format

> 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 time you 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

No Format

> uname

...

 \-a    to get all the information
> 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    Linux     IA64

...

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.

No Format

> JAVA_HOME="(path to java installation directory)"

...


> export JAVA_HOME

...


> PATH="(path to java bin directory):$PATH"

...


> export PATH

Check that you still have your lams.properties file in \etc\lams2. If you do, you do not need to modify the lams.properties file in the installation directory. If the lams.properties file is not in \etc\lams2, then you will need to edit the lams.properties file that comes with the upgrader.

Go to the root directory of the package and type:

No Format

> sudo ./update-lams.sh

The installer will ask you whether you want to stop LAMS before updating. Unless you have already done so yourself, it is HIGHLY RECOMMENDED that you let the updater run the shutdown script for LAMS, otherwise the update will not run correctly. Also it is recommended that you backup LAMS before the upgrade, the upgrade script gives you this option, or you are also free to do so yourself.

...

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:

No Format

>sudo ./run-lams.sh

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

...

To shutdown LAMS 2.0 go to (jboss directory)/bin and type:

No Format

> sudo ./shutdown.sh \-S

LAMS 2.0 x will take a few moments to shut down. To check if LAMS 2.0 has shut down correctly, type the following on Linux:

No Format

> ps \-ef \| grep java

Or type the following on Macintosh

No Format

> 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.

No Format

> sudo ./lams2

...

 start&nbsp;&nbsp; &nbsp;&nbsp;&nbsp;&nbsp; (starts LAMS)
> sudo ./lams2 console&nbsp;&nbsp; (start LAMS in current shell, to stop do ctrl+C)
> sudo ./lams2 stop &nbsp;&nbsp; &nbsp;&nbsp;&nbsp; (stops LAMS)
> sudo ./lams2 restart&nbsp;&nbsp; &nbsp;(restarts LAMS)
> sudo ./lams2 status&nbsp;&nbsp; &nbsp; (tells you if LAMS is currently running)
> sudo ./lams2 dump &nbsp;&nbsp; &nbsp;(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

...

For further help on general installations and specifically for Solaris installations, visit Daniel Schneider's wiki on LAMS installations.  It contains lots of helpful tips and ideas for installations for linux, Windows and Solaris. We thank Daniel Schneider for his help and tips on this subject.

Help with Ubuntu Installation

by Eric Evans Elek Tech Solutions:

Help with CentOS 5.2

All other Unix flavours

During the testing phase we installed LAMS in a large variety of scenarios. If you need help you might find a solution in there.

...