Page History

...

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.

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).

4. 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.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.

5. Wiki Markup
   You need to add a new parameter to your _\[dspace\]/dspace.cfg_ for configurable fulltext indexing

   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. Wiki Markup
   In _\[dspace-1.2.2-source\]_ run:

   Code Block
   ant -Dconfig= [dspace]/config/dspace.cfg update

7. Wiki Markup
   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.:

   Code Block
   cp [dspace-1.2.2-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. Wiki Markup
   To 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.