Page History

...

1. Get the new DSpace 1.3.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.3.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 will need to merge the changes in the new 1.3.2 versions into your locally modified ones. You can use the _diff_ command to compare the 1.3.1 and 1.3.2 versions to do this.

5. Wiki Markup
   In _\[dspace-1.3.2-source\]_ run:

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

6. Wiki Markup
   Copy the _.war_ Web application files in _\[dspace-1.3.2-source\]/build_ to the _webapps_ sub-directory of your servlet container (e.g. Tomcat). e.g.:

   Code Block
   cp [dspace-1.3.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.

7. Restart Tomcat.

Upgrading From 1.2.x to 1.3.x

In the notes below {{\[dspace\]}} refers to the install directory for your existing DSpace installation, and _\[dspace-1.3.x-source\]_ to the source directory for DSpace 1.3.x. Whenever you see these path references, be sure to replace them with the actual path names on your local system.

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

2. 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!!

3. 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_

4. Take down Tomcat (or whichever servlet container you're using).

5. Wiki Markup
   Remove the old version of _xerces.jar_ from your installation, so it is not inadvertently later used:_rm \[dspace\]/lib/xerces.jar_

6. Wiki Markup
   Install the new config files by moving _dstat.cfg_ and _dstat.map_ from _\[dspace-1.3.x-source\]/config/_ to _\[dspace\]/config_

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

8. 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_

9. 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_

10. Customize the stat generating statistics as per the instructions in System Statistical Reports

11. Wiki Markup
    Initialize the statistics using: _\[dspace\]/bin/stat-initial{_}_\[dspace\]/bin/stat-general{_}_\[dspace\]/bin/stat-report-initial{_}_\[dspace\]/bin/stat-report-general_

12. Wiki Markup
    Rebuild the search indexes: _\[dspace\]/bin/index-all_

13. 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_

14. Restart Tomcat.