DLESE: Digital Lib. for Earth System Ed.

File Release Notes and Changelog

Release Name: ddsws v1.0 examples - v2.5

Notes:
The DDSWebService client template and examples show how
to use the DDS web service (ddsws v1.0) in a JSP client. 

To install and run the template and examples you must have the following:
  
1. search.war - the JSP web service client template and examples.
2. Java2 platform v1.4 or later. 
3. Apache Tomcat 5 or later or other JSP 2.0 compliant JSP container.

Download the template and examples from: 
http://sourceforge.net/project/showfiles.php?group_id=23991&package_id=123037
After downloading, unzip the archive to get the search.war file

------- Installing the examples in Tomcat -------

Step 1: Download and install the Tomcat (Tomcat 5 or later required). 
To install Tomcat, follow the instructions available from Apache at
http://jakarta.apache.org/tomcat/index.html 
(see the 'User Guide' in the Tomcat 5 documentation area). If installing on 
Windows, be sure to follow Tomcat's instructions for enabling
JSP compiling by copying the JDK lib\tools.jar to your Tomcat common\lib 
directory.
You must install a Java2 SDK v1.4 (or later) prior to installing Tomcat. 
Java2 is available from Sun at:
http://java.sun.com/j2se/
For Mac OSX (Jaguar or later): Java2 comes pre-installed or may be installed
using software update.

Step 2: Place the file 'search.war' into the 'webapps' directory found in    
your Tomcat installation.
Tomcat will automatically unpack the 'search.war' archive, creating a directory and 
application context named 'search'. 

Step 3: The template and examples should now be ready to view. Launch a
web browser and type in the URL to the web service servlet context, which will
have the following form: http://localhost:8080/search/ or 
http://www.myserver.edu:8080/search/
- The address will use the context path created in step 3 ('search'). 
If the domain name to your server is http://www.myserver.edu and Tomcat 
was been installed using the default port (8080), the URL to the examples
software will be http://www.myserver.edu:8080/search/
- Alternatively you may access the software using the localhost domain
shortcut: http://localhost:8080/search/.
- If there are errors accessing the software try repeating or verifying    
steps 1 and 2.
- Tip: Check the Tomcat logs for error messages located in the 'logs' 
directory of your Tomcat installation if there are problems.
  
Step 4 (optional): Edit and modify the JSP pages 
located in webapps/search as desired. See comments included at the top of the 
JSP page for details. 
Tip: You may edit the HTML, CSS and JavaScript in each JSP page as desired to provide 
a custom look and feel for your search interface and rename, duplicate or move the JSP
files within the Tomcat context as needed. 

Additional support is available by e-mailing support@dlese.org.


Changes:
Changes in the web service search JSP client template and examples

v2.5

- Created separate CSS classes for all elements in the template
so that they can be defined separatly from other styles
used by sites that incorporate the template

- Added xalan.jar for compatibility with Tomcat 5.5

- Improved the response time performance for rendering the page.
Vocabs stored and cached in a HashMap for rapid look-up for 
display.

- Simplified the default display of search results.

- Disabled ability to search within the smart links - this behavior
was confusing for users

- Changed the page layout and display and created more usable example
menus and smart links

- Added additional documentation for developers

v2.4

- Added a JavaScript proxy configuration to the distribution 
and a static HTML page for displaying the search template.
The JavaScript proxy makes it possible to serve any page in 
this client using a static HTML page. With this technique, any
dynamic page (search, etc.) can be made available via a
static web site

- Added subjects to the brief display

- Added unique variable names for the check box menus. It is
now possible to install multiple search contexts in a single
Tomcat/JVM without possible variable name collisions with 
the menus.

- Added some additional instructions for using the template

v2.3

- Updated the links for annotations to accomodate
comments and the display of multiple annotations
for a single resource

- Template now uses UserSearch request instead of Search
because of it's simplified query language and 
automatic support for boosting

v2.2

- Updated the link for submitting reviews to the CRS 

- Added grade levels and type of resource to the brief search 
results page

v2.1

- Changed the link to submit a teaching tip to one for
submitting comments or teaching tips

- Smart link menu added that is edited and defined through an
XML configuration file. The file defines the menus and the 
search queries that are associated with each menu item 
in the menu.

v2.0

- Added links to the CRS annotation service in the JSP template for
both reading and submitting reviews and teaching tips

- Added stemming to the default query used in the JSP template
and boosting for records with matching terms in their title 
(highest boost) or description (next)

- Revamped the look-and-feel of the JSP template page a bit