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.2-source\]_ to the source directory for DSpace 1.2.2. 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.2 are only code and config changes so the update should be fairly simple.

  1. Get the new DSpace 1.2.2 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.2-source]/lib
    
  3. Take down Tomcat (or whichever servlet container you're using).unmigrated-wiki-markup
  4. 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.2 versions into your locally modified ones. You can use the _diff_ command to compare the 1.2.1 and 1.2.2 versions to do this. Also see the version history for a list of modified JSPs.unmigrated-wiki-markup
  5. You need to add a new parameter to your _\[dspace\]/dspace.cfg_ for configurable fulltext indexing unmigrated-wiki-markup
    Code Block
    ##### Fulltext Indexing settings #####
    # Maximum number of terms indexed for a single field in Lucene.
    # Default is 10,000 words - often not enough for full-text indexing.
    # If you change this, you'll need to re-index for the change
    # to take effect on previously added items.
    # -1 = unlimited (Integer.MAX_VALUE)
    search.maxfieldlength = 10000
    
  6. In _\[dspace-1.2.2-source\]_ run:
    Code Block
    ant -Dconfig= [dspace]/config/dspace.cfg update
    
    Wiki Markup
  7. Copy the _.war_ Web application files in _\[dspace-1.2.2-source\]/build_ to the _webapps_ sub-directory of your servlet container (e.g. Tomcat). e.g.: unmigrated-wiki-markup
    Code Block
    cp  [dspace-1.2.2-source]/build/*.war
    	[tomcat]/webapps
    
    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. Wiki MarkupTo finalize the install of the new configurable submission forms you need to copy the file _\[dspace-1.2.2-source\]/config/input-forms.xml_ into _\[dspace\]/config_.
  9. Restart Tomcat.