Manuscript Archival and Publication System

Installation

Manu requires the following:

You should be familiar with operating Fedora.

Installation process 

The following installation process describes the process of installing Manu and ManuServices only; for information on installing Fedora or Tomcat, please see the vendor installation instructions.

Paths referenced below:

[MANU_FILES]refers to the Manu downloaded files
[FEDORA_HOME]refers to the Fedora server home (i.e.same as the system path FEDORA_HOME)
[TOMCAT_HOME]refers to the Tomcat where manu is installed

Step 1: Download Files

Download and unpack the Manu distribution file from SourceForge.

Step 2: Install the Manu Services Components

ManuServices provides the underlying functionality for the Manu application. It is desigend as a set of interfaces which define certain behavior or view which can be used in Manu or other applications.

  1. open your Fedora configuration file ([FEDORA_HOME]/server/config/fedora.fcfg).
  2. you need to change 1 Fedora setting: to the setting for "retainPIDs" you need to add the prefix "manu" to retainPIDs
    <param name="retainPIDs" value="demo test changeme fedora-bdef fedora-bmech manu "/>
  3. drop the manuServices.war file from [MANU_FILES]/misc into the FEDORA Tomcat: [FEDORA_HOME]/server/jakarta-tomcat-5.x.x/webapps/
  4. restart Fedora
  5. start up the Fedora Administrator and login to Fedora
  6. go to File >> Ingest >> Objects by Type >> From Directory...

The Manu Services component is now installed.

OPTIONAL: to see the services in action

  1. go to the WEB interface for Fedora
  2. search for the object with PID "manu:LucyLarcomDiary"
  3. go to the disseminator view and you will notice some new behavior
  4. for this object--try them out--they are various representations of a sample manuscript

Spep 3: Install the Manu Application

  1. Copy manu.war from [MANU_FILES]/manu.war to [TOMCAT_HOME]/webapps/
  2. Start Tomcat, wait for it to finish starting up, and then stop it. This will unpack the manu application so that we can edit the configuration files.
  3. Open config.properties file in directory [TOMCAT_HOME]/webapps/manu/WEB-INF/classes/. You will probably need to set the following variables:

  4. Change any other settings you need as well; each is described in that documnet.
  5. Restart Tomcat

Configuration and Customization

Other configuration

Check the config.properties file for some other settings you might want to change. For example, you can change how Manu sorts lists of manuscripts by changing the setting DUBLIN_CORE_SORT_FIELD (this sets which Dublin Core field is used to sort by, and is set by default to "title", which provides an alphabetical listing by title).

Interface Customization

Any interface files in Manu can be overridden! Files placed in the /custom/ directory will override files of the same name in the /default/ directory, giving you enormous power to customize interfaces. Copy interface files from the /default/ to the /custom/ directory and alter the HTML (and Java, if desired) code in the new file as needed as needed.

A few XSL stylesheets are also used:

Adding Your Own Stylesheets

You can add your own stylesheets to Manu ans specify which Manuscripts or Collections of Manuscripts they are to be used with. Just place the XSL in the XSL directory (in fact, the XSL can be hosted anywhere, even outside of Manu) and place an entry in the file /database.xslt.txt. That file contains tab-separated lines that look like this:

    manu:LucyLarcomDiary    xsl/tei-unclear.xsl    Highlight Unclear Text
    manu:DemoCollection    http://someurl.edu/xsl/tei-names.xsl    Highlight Proper Names

This corresponds to:

    [Fedora PID]    [URL of XSL, relative or absolute]    [friendly name]

Some notes on how this works:

Troubleshooting / support 

If you have problems with an install, please read any error messages displayed to the web browser carefully; they will often contain information with clues to what the problem is.

Common Problems