Installing Laszlo Presentation Server Core

• Download and unpack the Core distribution. Here's what you'll find:
      LICENSE - The End User License Agreement for the LPS
      README - This file.
      credits - Credits for 3rd party contributions to the LPS
      lps-5.0.x - Expanded directory containing the LPS Root app.
      release-notes.html - Release notes
• Simply deploy the lps-5.0.x web application (war or directory) and test your installation.

Installation Issues with 5.0.x Core

General

• The LPS may not operate correctly if you have a copy of jython.jar installed in $JAVA_HOME/jre/lib/ext (%JAVA_HOME%\jre\lib\ext on Windows).

WebSphere Installation Issues

• Some documents in the lps-5.0.x web application may be reported 'Not Found' because WebSphere doesn't properly redirect URLs that end in directory names. If you run into this problem, you can use the Laszlo web-site documentation at http://www.laszlosystems.com/developers/.

WebLogic Installation Issues

• As of this writing, WebLogic comes bundled with a version of Apache's Xerces (a XML Parser) that is not compatible with LPS. Though a working version exists in the WEB-INF/lib directory, WebLogic doesn't look in there first by default. To ensure that the WEB-INF/lib/xerces.jar file is picked up:
  • If you have WebLogic Server 7.0.0.1 or lower on your computer, be sure you DO NOT ENABLE the PreferWebInfClasses flag for your Web application
  • If you have WebLogic 7.0 Service Pack 1, be sure you DO ENABLE the PreferWebInfClasses flag for your Web application The PreferWebInfClasses flag may be enabled by opening up your "WebLogic Server Console" and under the LPS web application deployment page, click on the "Configuration" tab and then click on the "Other" tab where you'll find the "Prefer Web Inf Classes" checkbox. Make sure you apply your changes and restart the server. You may also choose to directly modify your config.xml file and set PreferWebInfClasses="true|false" or modify your start script's CLASSPATH to pic up the correct xerces.jar file.

For more information on WebLogic and Xerces, consult: http://edocs.bea.com/wls/docs70/faq/xml.html#740643

Tomcat Installation Issues

If you are using your own installation of Tomcat and you have modified the set of jars, you need to make sure that the commons-logging.jar is not in the java endorsed list of jars.

If you are using your own installation of Tomcat 4.0 you will need to you will need to copy $LPS_HOME/WEB-INF/lib/jing.jar to $TOMCAT_HOME/common/lib

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

Caucho Resin Installation Issues

Under Resin 2.1.x, you will need to set the resin configuration parameter, servlet-classloader-hack, to true in $RESIN_HOME/conf/resin.conf.

     <servlet-classloader-hack>true</servlet-classloader-hack&ht;

Under Resin 3.0.x, the syntax in the resin.conf changed to:

     <class-loader>
        ...
       <simple-loader .../>
       <servlet-hack/>
        ...
     </class-loader>

The Java servlet specification and the Java specification disagree on classloader behavior. The servlet container specification makes more sense in the context of servlet containers. Setting this to true, is, in general, required for an Laszlo-enabled webapp.

Copyright © 2002-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.