Install Adobe LiveCycle Data Services with Apache Tomcat web server

January 15, 2008

Adobe LiveCycle Data Services ES is a very nice complement to Adobe Flex if you are planning to develop Enterprise Solutions. In this blog entry I’ll describe the process to get LiveCycle working with the Apache Tomcat web server.

LiveCyle Data Services comes by default with Adobe JRun. You might wonder why we didn’t user JRun. Well, first of all, JRun is only free for the developer edition while Tomcat is completely free.

Also, even though the LiveCycle and Jrun deployment was uneventful, and all the samples ran without any problem, whenever we tried to create or modify a java class we kept getting the “major.minor version50.0 error” on the JRun server. It seems that there’s some kind of incompatibility between the JRun jars and the Flex jars.

Anyway, lets go back to the process of installing and configuring the software.

1. Download and install java JDK.

  • Remove older installations of the JDK or JRE from your system. You’ll need to do this from the Control Panel.
  • Download the java JDK from Sun’s website. We used the version 1.6.0_04.
  • Select the Download button besides JDK. Make sure you download the JDK and not just the JRE.
  • Select your platform -in our case, Windows- and select the checkbox to agree with the agreement. Then select “Continue”.
  • Select the file you want to download. In our case we selected “Windows Offline Installation. Make sure to select the link otherwise you’ll end up using Sun Download Managers.
  • Once the file is downloaded on your computer, open it.
  • Accept the License Agreement.
  • Click “next” to accept the default settings.
  • Click “next” to start installing Java JDK.
  • Click “finish” to close the installation software and you are done with the first step.

2. Download and install Apache Tomcat.

  • You’ll need to donwload the Apache Tomcat web server from the Apache’s website. We used the “Windows Service Installer” version 6 of the web server.
  • Open the installation file and click “next” on the welcome window.
  • Accept the license agreement by clicking the “I Agree” button.
  • Click the “next” button on the choose components . You might want to install the Examples if you are interested.
  • We installed the software to the C:\Tomcat folder, since the default path is too long.
  • Select the http port, if you have another web server you might want to change the default port to something like 8050 or 8060. Enter a password for the admin user and click “next”.
  • Select the path to the JDK you just installed. Make sure to select the jre folder inside the jdk installation folder. E.g.: C:\Program Files\Java\jdk1.6.0_04\jre. Select “next” to install.
  • Click the “finish” button. Make sure that the checkbox for “Run Apache Tomcat” is selected.
  • A new icon Apache Icon will show up in the notification area of the task bar. If everything went OK you’ll see a green arrow

3. Download and install Adobe LiveCycle ES Express

  • Adobe LiveCycle Data Services is available for download from the Adobe’s web site. You will need an Adobe account to download this file. If you don’t have one you can create it in a couple of minutes.
  • Select the language and platform. In our case English | Windows and then hit the “download” button.
  • Open the file you just downloaded.
  • Click “next” in the welcome screen.
  • Accept the license and click “next” again.
  • Leave the serial empty and click “next”. This will install the Express version of LCDS.
  • Choose a new folder or accept the default folder. E.g.: c:\lcds and click “next”.
  • Important: you have to select the second radio button that states “LifeCycle Data Services J2EE web application”. Then click “next”.
  • Click the “install” button.
  • Once the installation is finish click the “done” button.

4. LC data services configuration tomcat server.

  • Stop the Apache Tomcat server. You can do this by right-clicking on the Apache Tomcat tray icon and selecting “stop service”.
  • Copy the following Web Archive (war) files from the LCDS folder to the Tomcat\webapps folder (C:\Tomcat\webapps):
    • flex.war
    • flex-admin.war
    • samples.war
  • Start the Apache Tomcat server again. You can do this by right-clicking on the Apache Tomcat tray icon and selecting “start service”.
  • If you check the webapps folder you’ll see that Tomcat automatically created three new folders for the three new applications you just installed.

You are done! LiveCycle should be working now. Try opening the browser and typing: “http://localhost:8050/samples/” (Replace 8050 with the port you selected for the server). You’ll see the LiveCycle Data Services ES Samples page. Try running some of the examples and enjoy LiveCycle!

some stats

lunches with clients this year
dances in the rain this year (very rainy!)
songs in our music library
graphic pieces created this month
carafes of coffee per day
dog walks this month (and counting)