Installing OpenLaszlo Server

This page steps you through installing the OpenLaszlo server (formerly called Laszlo Presentation Server (LPS)) and verifying that it is installed properly by running a Laszlo application.

Java

To run the LPS you must have the Java SDK (sometimes called the JDK, J2SDK, or J2SE SDK), not just the JRE, 1.5 or greater. It's available at:
    http://java.sun.com/j2se/1.5/

Note: Mac OS X users do not have to install the SDK, as it is installed with OS X by default.

Windows
Unix/Linux
Mac OS X

Windows

To install the OpenLaszlo Server:

• If you already have a copy of Tomcat (or any other service that is running on port 8080), please make sure that it is stopped.
• Download the OpenLaszlo Server for Windows.
• Run the installer executable, which will be called something like: lps-5.0.x-windows.exe.
• Now test your installation.

Unix/Linux

• Download the OpenLaszlo Server for Unix/Linux.
• Use tar zxvf to unzip and untar the distribution from /usr/local (or wherever you want it to go; you can even use your home directory for safety).
• For SWF9 development on Unix, you will need to manually chmod 755 all the binaries in WEB-INF/server/bin/ before you can compile. This is true for both the .war and .gz distributions.
• DON'T just copy the Tomcat folder into /usr/local. Keep the whole distribution together. So if you put it in /usr/local, it would look something like this:
• /usr/local/lps-5.0.x/     ...with Server/tomcat-5.0.24 as a subdirectory of lps-5.0.x
• Make sure that JAVA_HOME is set correctly. If the instructions below don't work, see the instructions that come with the Java SDK.
• You can check which version of java you have by typing:
    $ echo $JAVA_HOME
    and you should see something like:
    /usr/java/j2sdk1.4.0
    if not, type:
    which java to find Java on your machine. If no value is returned check installation of Java.
    Export JAVA_HOME by typing:
    export JAVA_HOME=(location of Java on your machine)
• and you should see something like:
      /usr/java/j2sdk1.4.0
• Make sure that you have the version 5 or greater of the Macromedia Flash browser plugin installed.
• Finally run the
      /lps-3.3/Server/tomcat-5.0.24/bin/startup.sh
    script, and you're ready to go. This script will set the following environment variables:
    CATALINA_BASE
    CATALINA_HOME
    CATALINA_TMDIR
    JAVA_HOME - note that JAVA_HOME must be set before running the script
• Now test your installation.
• http://www.laszlosystems.com/lps-3.3/docs/installation/run.html
• Link to hello.lzx brings you to http://localhost:8080/lps-3.3/examples/hello.lzx

Linux Notes

On some installations of RedHat 7.2 Linux, you may need the XFree86-libs RPM from
    http://updates.redhat.com/7.2/en/os/i386/.

In order to access JSP pages, you may need to copy $JAVA_HOME/jre/lib/tools.jar to lps-5.0.x/Server/tomcat-5.0.24/common/lib.

Mac OS X

Package installation

• Download the lps-5.0.x-macosx.dmg file. You can save it to your desktop.
• Double-click the lps-5.0.x-macosx file to install it.
• Now test your installation.

If this fails, you should install the file manually:

Manual installation:

• Log in as yourself.
• Download the tar.gz file for Unix.
• If stuffit tries to open the file, hit cancel
  The file we'll be working with is the lps-5.0.x-unix.tar.gz
  Stuffit might have created another folder on your desktop (lps-5.0.x-macosx). If it has, delete it.
• Open up a terminal shell. This should put you in your home directory.
  Next move the file to the the this directory:
   mv Desktop/lps-5.0.x-unix.tar.gz ~
• Now extract the file:
   gunzip lps-5.0.x-unix.tar.gz
• And untar it:
   gnutar -xvf lps-5.0.x-macosx.tar
• This will create a folder called lps-5.0.x.
• To run the Tomcat Servlet container, type:
  lps-5.0.x/Server/tomcat-5.0.24/bin/startup.sh
• ** Note that JAVA_HOME must be set. To find out if it's set:
   echo $JAVA_HOME
     should output something like:
   /Library/Java/Home/
• If it's not set, (using tsch, the default OSX shell):
   setenv JAVA_HOME /Library/Java/Home/
     or  export JAVA_HOME /Library/Java/Home/
     if you use the bash shell.
• Note that you will have to do this every time you start the Tomcat server. You can add this to your startup script to have it done automatically.
• To get to the lps folder via the GUI, double-click the hard disk on your desktop. Then click the Home button in the dialog box.
  Double-click the lps-5.0.x folder
• Now test your installation.

Copyright 2006-2008 Laszlo Systems, Inc. All Rights Reserved. Unauthorized use, duplication or distribution is strictly prohibited. This is the proprietary information of Laszlo Systems, Inc. Use is subject to license terms.