Manu requires the following:
You should be familiar with operating Fedora.
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 |
Download and unpack the Manu distribution file from SourceForge.
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.
The Manu Services component is now installed.
OPTIONAL: to see the services in action
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).
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:
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:
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 ProblemsDon't forget to start Fedora! You won't be able to get very far if Manu cannot connect to Fedora, so make sure the Fedora server is running.
Fedora Resource Index not enabled. Manu uses Fedora's native system for object-to-object relationships to track and display collections. In order to work, the Fedora Resource Index must be enabled. The Resource Index "level" in the [FEDORA_HOME]/config/fedora.fcfg file must be set to 1 or 2. The section of the file should look like this:
<module role="fedora.server.resourceIndex.ResourceIndex"
class="fedora.server.resourceIndex.ResourceIndexModule">
...
<param name="level" value="1"/>
...
</module>
Check that the Manu Services components are working. See the instructions from Step 2 above on how to do this.
Check the logs The most useful information about problems encountered will be in the Tomcat logs under (by default: [TOMCAT_HOME]/logs), where Manu records all problems encountered. Check the server logs for details if you encounter issues. Look for log entries labeled "WARN" or "ERROR"; entries labeled DEBUG and INFO can usually be ignored, although they can help to diagnose where and why a problem is occurring.
Note that Manu logs fairly aggressively. To turn down logging, edit the file [TOMCAT_HOME]/webapps/manu/WEB-INF/classes/log4j.properties. Change the line:
log4j.rootLogger=DEBUG,A1
to
log4j.rootLogger=WARN,A1
For questions, please contact Eric Jansson at the National Institute for Technology and Liberal Education: eric.jansson(AT)nitle.org