Info |
---|
Wiki Markup | In the notes below {{\[dspace \] }} refers to the install directory for your existing DSpace installation, and _\[dspace-1.2.1-source\]_ to the source directory for DSpace 1.2.1. Whenever you see these path references, be sure to replace them with the actual path names on your local system.
|
Upgrade Steps
The changes in 1.2.1 are only code changes so the update should be fairly simple.
- Get the new DSpace 1.2.1 source code from the DSpace page on SourceForge and unpack it somewhere. Do not unpack it on top of your existing installation!!
- Copy the PostgreSQL driver JAR to the source tree. For example:
Code Block |
---|
cd [dspace]/lib
cp postgresql.jar [dspace-1.2.1-source]/lib
|
- Take down Tomcat (or whichever servlet container you're using).
Wiki Markup |
Your 'localized' JSPs (those in jsp/local) now need to be maintained in the _source_ directory. If you have locally modified JSPs in your _\[dspace\]/jsp/local_ directory, you might like to merge the changes in the new 1.2.1 versions into your locally modified ones. You can use the _diff_ command to compare the 1.2 and 1.2.1 versions to do this. Also see the version history for a list of modified JSPs. Wiki Markup |
---|
- You need to add a few new parameters to your _\[dspace\]/dspace.cfg_ for browse/search and item thumbnails display, and for configurable DC metadata fields to be indexed.
Code Block |
---|
# whether to display thumbnails on browse and search results pages
(1.2+)
webui.browse.thumbnail.show = false
# max dimensions of the browse/search thumbs. Must be <=
thumbnail.maxwidth
# and thumbnail.maxheight. Only need to be set if required to be
smaller than
# dimension of thumbnails generated by mediafilter (1.2+)
#webui.browse.thumbnail.maxheight = 80
#webui.browse.thumbnail.maxwidth = 80
# whether to display the thumb against each bitstream (1.2+)
webui.item.thumbnail.show = true
# where should clicking on a thumbnail from browse/search take the
user
# Only values currently supported are "item" and
"bitstream"
#webui.browse.thumbnail.linkbehaviour = item
##### Fields to Index for Search #####
# DC metadata elements.qualifiers to be indexed for search
# format: - search.index.[number] = [search field]:element.qualifier
# - * used as wildcard
### changing these will change your search results, ###
### but will NOT automatically change your search displays ###
search.index.1 = author:contributor.*
search.index.2 = author:creator.*
search.index.3 = title:title.*
search.index.4 = keyword:subject.*
search.index.5 = abstract:description.abstract
search.index.6 = author:description.statementofresponsibility
search.index.7 = series:relation.ispartofseries
search.index.8 = abstract:description.tableofcontents
search.index.9 = mime:format.mimetype
search.index.10 = sponsor:description.sponsorship
search.index.11 = id:identifier.*
|
Wiki Markup |
---|
- In _\[dspace-1.2.1-source\]_ run:
Code Block |
---|
ant -Dconfig= [dspace]/config/dspace.cfg update
|
Wiki Markup |
---|
- Copy the _.war_ Web application files in _\[dspace-1.2.1-source\]/build_ to the _webapps_ sub-directory of your servlet container (e.g. Tomcat). e.g.:
Code Block |
---|
cp [dspace-1.2.1-source]/build/*.war
[tomcat]/webapps
|
Wiki Markup |
---|
If you're using Tomcat, you need to delete the directories corresponding to the old _.war_ files. For example, if _dspace.war_ is installed in _\[tomcat\]/webapps/dspace.war_, you should delete the _\[tomcat\]/webapps/dspace_ directory. Otherwise, Tomcat will continue to use the old code in that directory. - Restart Tomcat.