Added by Anastasia Cheetham, last edited by Anastasia Cheetham on Jul 06, 2009  (view change)

Labels:

Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.
This page is in draft format, awaiting a final review.

Overview

This page describes the process for installing and setting up the Hello World application on a web server. It assumes that you have a web server such as Tomcat (and know how to use it).
On This Page

Source Code

  1. Create a folder for the Application Layer source code. In that folder, check out the Application source from SVN:
  2. Create a folder for the UI Layer source code. In that folder, check out the UI source from SVN:

Application Layer Setup

  1. Create two directories, writable by the Tomcat user, that will be used by the Application Layer to store object data and the UI Specification. You may call the folders by any name, but the names must match the contents of the properties file described in the next step:
    • .../store
    • .../schema
  2. Create a properties file called chain.properties to configure the Application Layer with these folder locations:
    1. Define the following properties, referencing the folders created in the previous step:
    2. Place the chain.properties file in the classpath for Tomcat (e.g. in shared/classes on Tomcat 5.5).
  3. Copy the test data from the UI Layer source code checkout into the folders you created:
    1. Copy the UI Specification file into the schema folder:
    2. Copy the object data files into the store folder:
  4. Build the Application Layer war file: In the folder where the source code was checked out, execute

    This will create a war called chain.war in /tmp (alter the pom to put it elsewhere, eg on a windows box).

  5. Deploy the war file to your Tomcat instance.

To verify that the Application Layer is working, create a file called "x" inside your schema directory (created above) containing just {} (those two characters) and then browse to

and it should serve you those {}'s back to you.

UI Layer Setup

  1. Modify the source code to reference the Application Layer deployment:
    NOTE that this modification of the source code will NOT be necessary in future versions.
    1. Edit src/main/webapp/js/objEntrySetup.js:
      • Uncomment the following option block:
      • Edit the baseUrl to reference the URL of your Application Layer deployment, if it is not localhost.
  2. Build the UI Layer war file: In the folder where the source code was checked out, execute

    This will create a war called cspace-ui.war in target.

  3. Deploy the war file to your Tomcat instance.

Integration

With both the Application Layer and UI Layer deployed, the integration should work.

  1. Navigate to

    and choose any of the options.

For more information about this demo, see http://www.collectionspace.org/current_release