The METS Navigator (metsnav) is a Java web application for displaying paged documents based on a METS file.
Basic installation of MetsNavigator
- Make sure an application server (Tomcat) is installed and running properly.
- Shutdown your application server, too keep it from prematurely trying to unpack MetsNavigator.
- Download the MetsNavigator package, and place the web-archive file metsnav.war in the application server webapps directory.
- Start up the servlet container, and browse to the default collection packaged with MetsNavigator:
Accessing this URL will cause the application server to unpack the web archive file, creating an metsnav sub-directory below the server's webapps directory.
- You can delete the metsnav.war file from the server's webapps directory now.
Installation of a new collection to MetsNavigator
After installing the MetsNavigator, you can add your own collections:
- Create a configuration file for you collection, based on /WEB-INF/metsnav/conf/default.xml. The filename should be [collection-name].xml.
- Copy your configuration file to the /WEB-INF/metsnav/conf directory.
- Copy your Mets documents to the directory specified in the configuration file.
- Restart the metsnav application from the Tomcat Manager, or restart the Tomcat server.
- Visit your collection at http://yourserver:port/metsnav/\[collection-name\]/welcome.do
- If this page is successfully loaded, there will be a list of Mets documents on the left part of the web page, and a welcome message in the middle-right part of the page.
Creating METS files for use with MetsNavigator
- USE tags in METS file elements must match names in metsnav config
- USE tags must all be the same within a given fileGrp
- USE tags don't have to be in the fileGrp element, but it doesn't hurt, either
- GROUPID tags must be present in all file elements, to link corresponding files across groups
For more details, see the MetsNavigator documentation (not publicly available yet).
Instructions for using MetsNavigator with Fedora
- How do we prevent people from hand-coding URLs that render objects in the wrong context? How important is this, and is it worth the effort?
- Can/should we move the page-rendering information (config file, layout, and tiles) into Fedora? This would make things more centrally managed, and we would be able to recover old versions of a rendered item. For now, we will just store the rendering info on the local filesystem as with other metsnav projects.