Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0
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.

Info

Wiki Markup

Upgrade Steps

The changes in 1.2.1 are only code changes so the update should be fairly simple.

  1. 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!!
  2. 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
    
  3. Take down Tomcat (or whichever servlet container you're using).
  4. Wiki MarkupYour '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
  5. 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
  6. In _\[dspace-1.2.1-source\]_ run:
    Code Block
    ant -Dconfig= [dspace]/config/dspace.cfg update
    
    Wiki Markup
  7. 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.
  8. Restart Tomcat.