Академический Документы
Профессиональный Документы
Культура Документы
DERI Galway
IDA Business Park
Lower Dangan
Galway
IRELAND
http://www.deri.ie
Introduction. JeromeDL is a Social Semantic Digital Library. As a digital library, it allows institu-
tions to easily publish documents on the Web. It supports a variety of document formats; it allows
to store and query a rich bibliographic description of each document.
To find relevant documents in JeromeDL users can use searching and browsing features. Whole
documents content can be searched through, as well as single fields of the documents description,
like author or publish year. Users can also find documents by browsing content of subject categories
and keywords
With JeromeDL’s social and semantic services every library user can bookmark interesting books,
articles or other materials in semantically annotated directories. Users can allow others to see their
bookmarks and annotations and share their knowledge within a social network. JeromeDL can also
treat a single library resource as a blog post. Users can comment the content of the resource and
reply to others’ comments and this way create new knowledge.
This document will guide the user through the installation process and all administration tasks for
librarians. It will also present the most important features for the end users.
1
Digital Enterprise Research Institute Galway, National University of Ireland Galway
IDA Business Park, Lower Dangan, Galway, Ireland E-mail: firstname.lastname@deri.org
Acknowledgements: This work was supported by Enterprise Ireland under Grant No. *ILP/05/203*. The
authors would like to acknowledge Stefan Decker, Bill McDaniel, Corrib Group, the DERI Galway for fruitful
discussions.
c 2007 by the authors
Copyright °
DERI E LITE P ROJECT D1.1.02 I
Contents
1 JeromeDL: The Semantic Digital Library - Installation 1
1.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 Altering Look and Feel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.3 SMTP Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.4 Aggregation Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.5 HyperCuP Lightweight Implementation in JeromeDL - User Guide . . . . . . . . . . . . . . . . . . . 3
1.5.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.5.2 HyperCuP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.6 RDF Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.7 Paths, URL, etc. - Advanced Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.8 Running JeromeDL on Different Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.9 Building JeromeDL from Source Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.10 JeromeDL Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.11 Guide for upgrading JeromeDL 2.0 to version 2.0.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Prerequisites
• Have JDK 5.01 installed on your system (remember to have the JAVA_HOME variable set up on the
path to JDK5.0)
• Download JeromeDL installer2 and run it, or ...
• Download JeromeDL+Tomcat package3 and unpack it to any writable device (can be a USB stick)
startup.bat
cd PATH_TO_WHERE_JEROMEDL_IS_UNPACKED
3. execute
startup.sh
• JeromeDL/image/ folder where some of the images can be replaced with your own logos. You
can start by looking at the images in sub-folders with locale names, such as, en or de.
• JeromeDL/WEB-INF/src/org/jeromedl/i18n/ or
JeromeDL/WEB-INF/classes/org/jeromedl/i18n/ (depending on wheather you installed
JeromeDL from sources or not) - please take some time to update the following properties:
a9_contact_person = noone@no.com
jeromedl.foafmatic.adminEmail = no.one@no.com
jeromedl.foafmatic.fromEmail = no.user@no.com
jeromedl.foafmatic.smtpServer = smtp.no.com
jeromedl.foafmatic.mail.auth = false
jeromedl.foafmatic.mail.username = false
jeromedl.foafmatic.mail.password = false
DERI E LITE P ROJECT D1.1.02 3
services.amount = 2
services.name.1 = elp
services.name.2 = dfoaf
service.elp.localquery = org.jeromedl.service.elp.LocalQueryImpl
service.elp.url = http://another.library.net/services/HyperCuPService
service.elp.integrationchampion = http://another.library.net/
services/HyperCuPService
service.dfoaf.localquery = org.foafrealm.hypercup.LocalQueryImpl
service.dfoaf.url = http://another.library.net/services/HyperCuP4DFOAF
service.dfoaf.integrationchampion = http://another.library.net/
services/HyperCuP4DFOAF
From an administrator’s perspective, only four lines are important, which are responsible for setting up
the addresses. The administrator should adjust them to the library needs:
• service.dfoaf.integrationchampion=http://another.library.net/services/HyperCuP4DFOAF - The
line meaning is similar to the service.elp.integrationchampion; it informs the system about the other
dfoaf service address provided by other library which the system will connect after pressing the start
button. The administrator must replace the ’library.deri.org’ part with a correct service’s address. The
address can be same for many libraries who participate in the federated network. When the properties
file is completed, the administrator must click on the start button (See Fig. 1) in the HyperCuP panel.
Using WWW Panel It is possible to configure HyperCuP using the web panel. HyperCuP’s panel is
depicted in the (See Fig. 2) (See Tab. 1.5.2) for an explanation of the fields.
Configured libraries are able to co-operate with each other. If two librarians decide to connect their
libraries, one of them must join to the other. In order to perform this task, an administrator must fill in the
form (6) with the other libraryâĂŹs service address and press the join (7) button.
JeromeDL uses two services: dfoaf and elp; they require separate configuration.
The HyperCuP protocol [2] connects libraries using specific algorithms as a result libraries have con-
nections which are known as virtual; they are needed for maintenance reasons; such connections are listed
in the ’The peers for this service’ area (8). It is strongly recommended to use a properties file in order
to configure libraries!
Configuration Test In order to check if the provided addresses are correct, the administrator should try to
enter the parameters given in the service.elp.url and service.elp.integrationchampion to a web browser. For
instance, entering http://library.deri.ie/services/HyperCuPService or
http://library.deri.org/services/HyperCuPService should result in a web page (see
Fig. 3).
DERI E LITE P ROJECT D1.1.02 5
• Not initialized – the service still needs some steps to complete the configuration process,
• Initialized but not connected – the service is initialized. However, it is not connected to any other
service,
• Initialized and connected and – informs that the service is both configured and connected with other
service or services,
• Unknown – some unexpected problems arose.
• jeromedl.defaultLanguage - default language that JeromeDL will greet its visitors. Your can se-
lect any locale from English, Polish, German, Korean, Ukrainian, Russian, Spanish, Portuguese-
Brazilian, French, Dutch, Bulgarian and Gaelic. But be aware that JeromeDL v2.0.1 fully supports
only the first 7 of them.
5
http://www.openrdf.org/doc/sesame/users/ch03.html
DERI E LITE P ROJECT D1.1.02 7
• jeromedl.indexPath - relative or absolute path to where the fulltext index of documents should be
stored
• jeromedl.storagePath - relative or absolute path to where the binary resources should be stored
• jeromedl.resourceMaxSize - maximal allowed size for uploaded resources
• jeromedl.indexOptimizationPeriod - how often should the fulltext index be optimized
• jeromedl.search.default.distributed - indicates whether the searching should be distributed by de-
fault
• jeromedl.search.default.isConjunction - indicates whether the searching should be in conjunctive
mode by default
• jeromedl.mms.targetEndPoint - JeromeDL uses MarcOnt Mediation Services (MMS6 ) to deliver
bibliographic descriptions in different formats. If you decide to use JeromeDL in production mode -
please set up your own MMS and change this entry.
Here is an example configuration:
jeromedl.defaultLanguage = en
jeromedl.indexPath = WEB-INF/lucene/index/
jeromedl.storagePath = WEB-INF/storage/
jeromedl.resourceMaxSize = 2000000000
jeromedl.indexOptimizationPeriod = 1
6
MMS: http://mms.marcont.org
8 DERI E LITE P ROJECT D1.1.02
jeromedl.resource.URI = http://localhost:NEWPORT/jeromedl/resource/%s
jeromedl.sesame.serviceURL = http://localhost:NEWPORT/sesame/
<Service name="Catalina">
...
<Connector port="8080" maxHttpHeaderSize="8192" >
...
</Connector>
...
</Service>
to
<Service name="Catalina">
...
<Connector port="NEWPORT" maxHttpHeaderSize="8192" >
...
</Connector>
...
</Service>
Prerequisites
• JeromeDL source code7
Download the latest source code by executing:
svn co https://jeromedl.svn.sourceforge.net/svnroot/jeromedl/trunk jeromedl
• Apache Tomcat servlet container8 (version 5.5.17 or later)
• Apache Ant 9
org.jeromedl.level = ALL
java.util.logging.ConsoleHandler.level = CONFIG
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
7
http://jeromedl.svn.sourceforge.net/viewvc/jeromedl/trunk/
8
http://tomcat.apache.org/download-55.cgi
9
http://ant.apache.org/bindownload.cgi
10 DERI E LITE P ROJECT D1.1.02
mkdir JeromeDL-2.0.1
cd JeromeDL-2.0.1
tar xzvf JeromeDL-2.0.1.tar.gz
3. Copy the resources and configs from your library to the new installation:
cd previous_jeromedl_installation_directory
cp -a webapp/WEB-INF/lucene ../JeromeDL-2.0.1/JeromeDL/webapp/WEB-INF
cp -a webapp/WEB-INF/storage ../JeromeDL-2.0.1/JeromeDL/webapp/WEB-INF
cp -a webapp/WEB-INF/dwn ../JeromeDL-2.0.1/JeromeDL/webapp/WEB-INF
cp -a webapp/WEB-INF/*.properties ../JeromeDL-2.0.1/JeromeDL/webapp/WEB-INF
4. Merge any other files which you have hand edited (for example apache-tomcat/conf/server.xml)
cd JeromeDL-2.0.1/JeromeDL
./startup.sh
7. If everything is ok and you can browse and download all of you resources, you can delete the old
installation. To make things safe, make a backup of the old version installation before you delete it.
• Not registered, users without a profile in the system. They can still browse and search the digital
library. But they cannot use certain features like bookmarking11 .
• Registered users, users with an account in one of the FOAFRealm systems can make use of the
bookmarking and collaborative filtering sub-system12 .
• Community members, are users that registered themselves and are linked by some other users as
friends in their FOAF profile. These users are allowed to upload resources13 to the system.
• Administrators, users that are the most trusted friends (the trust value in the profile is set to 1.0 )
of admin@foafrealm.org user. They have full control over the system, including: approving
resources for publishing14 , reindexing and refreshing database15 , configuring P2P network16 .
Before you will register to the system you need to create new account
1. Click the register link on the shorthand in the right-hand side of the page (see Fig. 7)
3. Click submit
4. Check you email inbox for new email from the system
6. Please note that in order to gain administrative rights on the new account you need to login as admin-
istrator and set your new email as a friend of administrator with trust level = 1.0
1. REGISTER
2. fill in the empty fields:
• name, email address and password (twice) are obligatory
3. click register
4. check your email inbox and open the mail with the link
to complete the registration process
5. you can login now
• provide login (your email address) and password
6. in "My profile":
• you can add your picture
• you can change information about yourself
• you can add / remove friends
DERI E LITE P ROJECT D1.1.02 13
7. logout
8. login as admin (admin@foafrealm.org)
9. you should add your email as a friend of admin
(default trust level = \textbf{0.5}) - this will give you
more access to JeromeDL
10. log-out
11. login with your own email again
12. you have more privileges now
- e.g. you can start uploading resources
• A simple keyword-based search (with semantic query expansion based on your profile) (See Fig. 9)
• An advanced search based on schemata types (Dublin Core, MARC21, BibTeX) (See Fig. 10)
• A semantic search - where you can either provide an RDF query directly or use one of a couple of natu-
ral language templates (like: Show me all resources written by a friends of mine)
(See Fig. 11)
Simple search
Advanced search
Video presenting the search in JeromeDL using the A9.com interface (See Fig. 2.3)
1. change URI
2. select Add / Remove options to select JeromeDL search engine
3. look up JeromeDL search engine(s)
4. click more info
5. type in your search query
6. go to the JeromeDL@DERI.International
7. choose simple search
8. type in the same search query
9. you can compare the search results
• Type of publication (article, in-proceedings, etc.) (See Fig. 14 and Fig. 15)
Figure 12: Another short video presenting the search features in JeromeDL – screenshot from video
Here is a short video presenting some of the browsing features in JeromeDL (See Fig. 19)
• cover page
• abstract
• number of chapters
• number of attachments
DERI E LITE P ROJECT D1.1.02 17
Figure 13: ... and searching through the A9.com interface – screenshot from video
• keywords
• categories/topic
• additional arbitrary properties, like e.g., related conference, publication place
Figure 19: Video presenting some of the browsing features in JeromeDL – screenshot from video
If you wish you can create a new directory - providing label, description, categories and keywords (see
Fig. 28):
1. Select the ‘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 :)
You can take a look on how the bookmarking system in JeromeDL works (See Fig. 29)
1. Log as user A.
2. Select one of types of resources - e.g. Publications
3. Click on this resource
4. Open individual resource view
5. Click Your Bookmarks
6. Create new directory
(a) Give name and description
(b) Select WordNet value
(c) Select some Taxonomies
(d) Click SAVE
7. Create new bookmark in the newly created directory.
8. Add this resource to selected directory
9. You can see results of your action
10. You can choose a second resource
11. Add the second resource to the same directory.
24 DERI E LITE P ROJECT D1.1.02
You can also access and manage your bookmarks with your mobile device (See Fig. 30)
Figure 30: Manage your bookmarks with your mobile device – screenshot from video
DERI E LITE P ROJECT D1.1.02 29
1. A user stays notified on the new publications uploaded to JeromeDL library by subscribing to an RSS
channel either with one of the channels listed in the shorthand (see Fig. 31) or with an embedded link
to the RSS channel (recognized by many web browsers, e.g. Mozilla)
2. Almost every page presented to the user by JeromeDL is rendered out of the RDF information, which
the user can get access to (see Fig. 32)
3. To support different meta-data standards, JeromeDL utilized MarcOnt Mediation Services19 , which
can be invoked by selecting the RDF icon next to the publication (see Fig. 33).
19
MarcOnt Mediation Services: http://mms.marcont.org/
30 DERI E LITE P ROJECT D1.1.02
4. Since there are many ways to express semantically rich information, JeromeDL aims to support more
and more of them. Currently, users can facilitate from the information being embedded in HTML web
pages in20 :
• eRDF21
• microformats22
Take a look a the video showing how to access RSS channels in JeromeDL (See Fig. 34)
1. Click login link on the shorthand in the right-hand side of the page
2. provide login admin@foafrealm.org
3. provide password changeit!!
4. click submit and you should be registered with administrative rights
Please note that admin’s password should be changed as soon as possible after installation.
DERI E LITE P ROJECT D1.1.02 33
Figure 36: Video presenting overview of administrative features – screenshot from video
• link to the interface is located on the shorthand in the right-hand side of the page (see Fig. 37)
1. PDF – resource with a couple of chapters, each consisting of one PDF file
2. RTF – resource with a couple of chapters, each consisting of one RTF file (this resources can be
later rendered also as HTML or PDF)
3. 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
25
http://www.jeromedl.org/guide/userguide_registering.html
34 DERI E LITE P ROJECT D1.1.02
4. SCAN – resource with a couple of chapters, each consisting of many JPG or PNG images
(pages)
5. URI – resource that is not stored in the JeromeDL database, but somewhere else
• fill some basic information about the publication (see Fig. 38):
• Now you can add the new content - chapters/parts of the publication (see Fig. 39)
• Later, you can annotate the publication with keywords and categories or topics (see Fig. 40)
• Finally, you can attach some other binary resources (see Fig. 41), and provide additional annotations
using (see Fig. 42):
DERI E LITE P ROJECT D1.1.02 35
Different upload forms for different type of resource (See Fig. 43)
Figure 43: Different upload forms for different type of resource – screenshot from video
Figure 44: Support for many languages (i18n) – screenshot from video
DERI E LITE P ROJECT D1.1.02 39
1. log-out if logged
2. login as administrator (admin@foafrealm.org)
DERI E LITE P ROJECT D1.1.02 41
3.5 Maintenance
There are a couple of features restricted to the administrator, that are allowed to maintain the digital library
service. All of them can be accessed from the shorthand panel at the right-hand side on JeromeDL web
page.
26
http://www.jeromedl.org/guide/configuration_p2p.html
42 DERI E LITE P ROJECT D1.1.02
number
on the name description
Fig.
1 version id for information only. in order to connect different libraries into one network,
all libraries must have the same hypercup version.
2 keep-alive a control value which enables to check states of the connected libraries. the
interval default value is 20000 milliseconds; it means that the library checks the avail-
ability of other connected libraries every 20 seconds. if an accident occurs
or a connection is unsuccessful, the automatic repair of the connection is per-
formed.
3 restore pre- it allows an administrator to start a set of predefined connections. the properties
defined con- can be viewed by clicking on a highlighted link (4). figure 5 in section 4 shows
nections an example window which appears after clicking on the link. the button start
executes the prepared configuration file.
4 properties the location of the properties file. click on it to preview.
link
5 start a new this area allows creating new services. working with JeromeDL, an admin-
service istrator probably will never use this feature. Here is a sample configuration:
1. enter service address (D-FOAF):
http://library.deri.ie/jeromedl/services/
hypercup4dfoaf
3. localquery implementation:
org.foafrealm.hypercup.localqueryimpl
6. localquery implementation:
org.jeromedl.service.elp.localqueryimpl
The service addresses differ depending on the real installation address. After
filling in the forms, the button initialize (10) must be pressed; if everything
went correctly a new service will appear in the available services (9) area.
6 address enter the address of the library you are going to connect
7 join press it when you configure the service and are going to join.
8 peers the list of the peers who are connected to a given service
9 available this area shows a detailed overview of all configured services. Here is the
services meaning of all fields:
alias the service’s name,