JeromeDL Hands-On Session @ JCDL 2006

Prerequisites

• JeromeDL+Tomcat package downloaded and unzipped on any writable device (can be a USB stick)
• JDK 5.0 installed on your system (remember to have JAVA_HOME variable set up on the path to JDK5.0)

Running JeromeDL on Windows

1. go to the directory where JeromeDL package has been unpacked
2. execute

jeromedl.bat

1. check you web browser with address http://localhost:8080/jeromedl/
2. if nothing unexpected has happened - congratulations - you have JeromeDL instance running

Running JeromeDL on Linux

1. Open console
2. go to the directory where JeromeDL package has been unpacked:

cd PATH_TO_WHERE_JEROMEDL_IS_UNPACKED

1. execute

jeromedl.sh

1. check you web browser with address http://localhost:8080/jeromedl/
2. if nothing unexpected has happened - congratulations - you have JeromeDL instance running

Prerequisites

• JeromeDL sources

Download sources by executing:

cvs -z3 -d:pserver:anonymous@jeromedl.cvs.sourceforge.net:/cvsroot/jeromedl login
cvs -z3 -d:pserver:anonymous@jeromedl.cvs.sourceforge.net:/cvsroot/jeromedl co -P applets
cvs -z3 -d:pserver:anonymous@jeromedl.cvs.sourceforge.net:/cvsroot/jeromedl co -P base
cvs -z3 -d:pserver:anonymous@jeromedl.cvs.sourceforge.net:/cvsroot/jeromedl co -P converters
cvs -z3 -d:pserver:anonymous@jeromedl.cvs.sourceforge.net:/cvsroot/jeromedl co -P elp
cvs -z3 -d:pserver:anonymous@jeromedl.cvs.sourceforge.net:/cvsroot/jeromedl co -P indexing
cvs -z3 -d:pserver:anonymous@jeromedl.cvs.sourceforge.net:/cvsroot/jeromedl co -P marcont
cvs -z3 -d:pserver:anonymous@jeromedl.cvs.sourceforge.net:/cvsroot/jeromedl co -P search
cvs -z3 -d:pserver:anonymous@jeromedl.cvs.sourceforge.net:/cvsroot/jeromedl co -P webapp
                                    

• JDK 5.0 installed on your system.
• Apache Tomcat servlet container (version 5.5.17 or later)
• Apache Ant

Installation and running JeromeDL

• JeromeDL comes with some standard configuration. You can change it by changing properties files located in base module in src directory
• Install Apache Tomcat
• Install libraries in Tomcat by copying:
  • all jar files from webapp/WEB-INF/lib/tomcat/client/lib/ to CATALINA_HOME/client/lib/
  • all jar files from webapp/WEB-INF/lib/tomcat/server/lib/ to CATALINA_HOME/server/lib/
  • file webapp/WEB-INF/lib/tomcat/cont/Catalina/localhost/jeromedl.xml to CATALINA_HOME/conf/Catalina/localhost/. docBase attribute in this file should be pointing to the webapp module path
• Modify webapp/WEB-INF/build.xml to contain proper paths
• Build the project by executing:

ant
                                    

in webapp/WEB-INF directory

• Start Tomcat

Registering to the system

• Before you will be able to upload any resource to the system you need to register first
• You can either use administrative account or create new one on administrative rights

Logging in as a administrator

1. Click login link on the shorthand in the right-hand side of the page
2. provide login

admin@foafrealm.org

1. provide password

changeit!!

1. click submit and you should be registered with administrative rights

Creating new account

1. Click register link on the shorthand in the right-hand side of the page
2. Provide name, valid e-mail address and new password (twice)
3. Click submit
4. Check you e-mail box for new email from the system
5. Click on the link provided to complete the installation
6. Please note that in order to gain administrative rights on the new account you need to login as a administrator and set you new email as a friend of administrator with trust level = 1.0

Uploading resources

• uploading interface is accessible to all registered users that are pointed by some other users as a friends
• link to the interface is located on the shorthand in the right-hand side of the page

1. first you select type of the resources you want to upload:

PDF

resource with a couple of chapters, each consisting of one PDF file

RTF

resource with a couple of chapters, each consisting of one RTF file (this resources can be later rendered also as HTML or PDF)

SWF

resource with a couple of multimedia parts, each consisting of one or two (if a smaller version of the presentation is also provided) Macromedia Flash presentations

SCAN

resource with a couple of chapters, each consisting of many JPG or PNG images (pages)

URI

resource that is not stored in the JeromeDL database, but somewhere else

1. Provide title of the resource
2. Select authors/editors etc. by providing parts of their names and drag-and-dropping them to appropriate category
3. Provide abstract of the resource
4. Select cover page of the resource

1. Start adding new chapters
2. Fill in starting and ending pages
3. Select digital resources (PDF, RTF, images) to upload in each chapter

1. Select entries in taxonomies to describe this resource
2. Select keywords from WordNet or provide your own ones

1. Select additional digital files to be uploaded with this resource as attachments
2. Provide some other descriptions like address, institution, volume title, etc.

Annotating resources with Social Semantic Collaborative Filtering

1. To annotate a resource - first click on the "individual link" to the resource

1. If you wish you can create new directory - providing label, description, categories and keywords

1. Select box next to the directory where you what to put your resource
2. Social Semantic Collaborative Filtering is a pure AJAX application - so no need to submit a page :)

Indexing resources and searching through them

Re-indexing

1. To reindex resources you need to be logged in on administrative rights
2. Click the reindex link and if re-indexing is not running at the moment (you will see it with green slider moving in the center of the page) you can click the "Re-index" button

Searching

1. JeromeDL delivers 4 ways to search for resources:
   • simple keyword-based search (with semantic query expansion based on your profile)
   • advanced search based on schemata types (Dublin Core, MARC21, BibTeX)
   • semantic search - where you can either provide RDF query directly or use one of a couple of natural language templates (like: Show me all resources written by a friends of mine)