Personal tools

LaszloWithWASCE

From OpenLaszlo

Contents

Installation of OpenLaszlo 4.2.0 on Centos 5.2 64-bit and IBM WebSphere Community Edition 2.1.1.1

2009-JAN-03

This gives the installation steps I used, to successfully get OpenLaszlo 4.2.0 up and running on Centos 5.2, 64 bit.

The setup it's running on is a VMware virtual machine, with 1GB ram allocated to it, and a 20GB (virtual) disk.

Centos 5.2 is a brand new installation from CD (mostly using defaults), with latest Centos updates then applied.


Install Java 5

1. Remove the gcj stuff already installed by Centos (just to be careful)


2. Download and install the Java 5 SDK (64 bit rpm version) from the Sun website

 http://java.sun.com/javase/downloads/index_jdk5.jsp


3. Create a two line script file /etc/profile.d/java.sh with the environment variables for java:

 $ echo 'export JAVA_HOME=/usr/java/jdk1.5.0_17' >> /etc/profile.d/java.sh
 $ echo 'export PATH=$PATH:$JAVA_HOME/bin' >> /etc/profile.d/java.sh


4. Make it executable

 $ sudo chmod 755 /etc/profile.d/java.sh


Install WebSphere Community Edition 2.1.1.1

1. Download the WASCE installer from the IBM website:

 http://www.ibm.com/developerworks/downloads/ws/wasce/


2. Run the installer

 $ chmod 755 wasce_setup-2.1.1.1-unix.bin
 $ sudo ./wasce_setup-2.1.1.1-unix.bin

It's installed by default in:

   /opt/IBM/WebSphere/AppServerCommunityEdition/


3. Increase the maximum java heap size to 512 MB, as the OpenLaszlo deployement fails if this isn't done (on 64 bit Centos, unsure about 32 bit)

  $ echo 'export JAVA_OPTS=-Xmx512m' >> /opt/IBM/WebSphere/AppServerCommunityEdition/bin/


4. Start WASCE

  $ sudo /opt/IBM/WebSphere/AppServerCommunityEdition/bin/startup.sh


5. Verify it's working. Use a browser to bring up the Administrative Console:

    http://hostname:8080/console/

This should display the login screen. Log in. The default username is "system", default password is "manager".


6. Change the default administrative password:

  Security -> Users and Groups -> Console Realm Users -> on the line with 'system' choose 'Edit' -> set new password -> Update


Deploy OpenLaszlo

1. Download OpenLaszlo 4.2.0, Servlet version:

 http://www.openlaszlo.org/download/form?dl_path=http://download.openlaszlo.org/4.2/openlaszlo-4.2.0-servlet.war


2. From the WASCE web console:

  Applications -> Deploy New
    Archive: Browse to the OpenLaszlo WAR file on your local PC
    Plan: Leave blank
    Start app after install: Enabled
    Redeploy application: Disabled

Click Install. It will then take a while to do the deployment, after which a (non-obvious) message is displayed above the fields you just filled out:

    The application was successfully deployed.
    The application was successfully started


3. Verify that it's functional, by browsing to:

    http://hostname:8080/openlaszlo-4.2.0-servlet/my-apps/copy-of-hello.lzx?lzr=dhtml

That URL specifies to use DHTML for the test, as it should work for everyone, even those without flash installed in their browser.


The installed path

The deployed OpenLaszlo application is under a path like:

 /opt/IBM/WebSphere/AppServerCommunityEdition/repository/default/openlaszlo-4.2.0-servlet/<instance number>/openlaszlo-4.2.0-servlet-<instance number>.war/my-apps/

For me, in my example, it was:

 /opt/IBM/WebSphere/AppServerCommunityEdition/repository/default/openlaszlo-4.2.0-servlet/1230964609907/openlaszlo-4.2.0-servlet-1230964609907.war/my-apps/

Editing files directly in there will technically work, but it's probably not the best idea. Running server side commands will likely blow that whole area away (i.e. redeploying the application)