Page History
...
Wiki Markup Step one is, of course, to *back up all your data* before proceeding\!\! Include all of the contents of {{\[dspace\]}} and the PostgreSQL database in your backup.
- Get the new DSpace 1.3.x source code from the DSpace page on SourceForge and unpack it somewhere. Do not unpack it on top of your existing installation!!
Wiki Markup Copy the PostgreSQL driver JAR to the source tree. For example: _cd \[dspace\]/lib{_}{_}cp postgresql.jar \[dspace-1.2.2-source\]/lib_
- Take down Tomcat (or whichever servlet container you're using).
Wiki Markup Remove the old version of _xerces.jar_ from your installation, so it is not inadvertently later used:_rm \[dspace\]/lib/xerces.jar_
Wiki Markup Install the new config files by moving _dstat.cfg_ and _dstat.map_ from _\[dspace-1.3.x-source\]/config/_ to _\[dspace\]/config_
Wiki Markup You need to add new parameters to your _\[dspace\]/dspace.cfg_:
Code Block ###### Statistical Report Configuration Settings ###### # should the stats be publicly available? should be set to false if you only # want administrators to access the stats, or you do not intend to generate # any report.public = false # directory where live reports are stored report.dir = /dspace/reports/
Wiki Markup Build and install the updated DSpace 1.3.x code. Go to the _\[dspace-1.3.x-source\]_ directory, and run:_ant \-Dconfig=\[dspace\]/config/dspace.cfg update_
Wiki Markup You'll need to make some changes to the database schema in your PostgreSQL database. _\[dspace-1.3.x-source\]/etc/database_schema_12-13.sql_ contains the SQL commands to achieve this. If you've modified the schema locally, you may need to check over this and make alterations. To apply the changes, go to the source directory, and run: _psql \-f etc/database_schema_12-13.sql \[DSpace database name\] \-h localhost_
- Customize the stat generating statistics as per the instructions in System Statistical Reports
Wiki Markup Initialize the statistics using: _\[dspace\]/bin/stat-initial{_}_\[dspace\]/bin/stat-general{_}_\[dspace\]/bin/stat-report-initial{_}_\[dspace\]/bin/stat-report-general_
Wiki Markup Rebuild the search indexes: _\[dspace\]/bin/index-all_
Wiki Markup Copy the _.war_ Web application files in _\[dspace-1.3.x-source\]/build_ to the _webapps_ sub-directory of your servlet container (e.g. Tomcat). e.g.:_cp \[dspace-1.3.x-source\]/build/*.war \[tomcat\]/webapps_
- Restart Tomcat.
Upgrading From 1.2.1 to 1.2.2
The changes in 1.2.2 are only code and config changes so the update should be fairly simple.
Wiki Markup |
---|
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. |
- 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!!
- 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
- 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.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.
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
Wiki Markup In _\[dspace-1.2.2-source\]_ run:
Code Block ant -Dconfig= [dspace]/config/dspace.cfg update
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.
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_.
- Restart Tomcat.
Overview
Content Tools