Dwell is where DSpace meets Longwell, a way to embed longwell-based metadata-generic faceted browsing directly inside a DSpace installation, using javascript injection to minimize the impact on the existing DSpace code.DWell is UI plug-in for DSpace providing Longwell's faceted browsing the catalog of your DSpace.

How to Try it out

• Check out http://simile.mit.edu/repository/longwell/trunk/ as longwell2
• Check out http://simile.mit.edu/repository/longwell-demos/dwell/ as dwell
• Check out http://simile.mit.edu/repository/RDFizers/oai2rdf as oai2rdf
• Do mvn package in each of those directories

• In the oai2rdf directory, make a data subdirectory
• In the oai2rdf directory, do:

oai2rdf -m rdf http://hedwig.mit.edu:8080/dwell-oai/request data

• In longwell2/src/main/webapp/WEB-INF/longwell.properties, make sure longwell.url is not specified.
• In the longwell2 directory, do

longwell /p ../dwell /c dwell /d tmp/db_hedwig /r ../oai2rdf/data

• Note that you should remove the /r ../oai2rdf/data in subsequent runs.

• Point your browser to http://localhost:8080/default?command=ui

How to Provide DSpace data to Dwell

The sample data above allows you to explore the user interface, but you will doubtless want your own DSpace metadata. To become a provider:

• You must be running a recent (1.4.1+) version of DSpace
• Your installation must be configured to be an OAI-PMH provider
• Apply the patch 'dwell-oai-only.patch' available from the DSpace patch queue at SourceForge
• It adds the java file RDFCrosswalk.java to your source tree at org/dspace/app/oai/
• It also adds the line Crosswalks.rdf=org.dspace.app.oai.RDFCrosswalk to [dspace]/config/templates/oaicat.properties
• Rebuild and update the code and the configuration on your server
• You may now use your DSpace installation instead of the test server above:

oai2rdf -m rdf http://yourserver.edu:8080/dwell-oai/request data

How to Embed Dwell in DSpace

You may embed the Dwell UI in the DSpace web user interface. As an illustration, these directions (and code) replace the 'Advanced Search' page with Dwell. The setup described involves proxying the dwell requests to the server used in the previous step; as such it presupposes that an Apache Http server is in front of your DSpace application server to manage the proxy redirects. To embed:

• Apply the patch 'dwell.patch' available from the DSpace patch queue at Sourceforge
• This patch includes the OAI Crosswalk used in the previous section, but also changes the JSPs so that the 'Advanced search' page is replaced with DWell
• Remember that if you have customized any of the JSPs, you must merge these customizations with the patched versions
• Rebuild and redeploy your DSpace server
• The JSP expects the proxy point to be '/dwell/proxy': proxy this URL pattern to the URL on the Longwell server responding to DWell requests