Versions Compared

Old Version 1

changes.mady.by.user Tim Donohue

Saved on

compared with

New Version 2

changes.mady.by.user Tim Donohue

Saved on

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

Info

Wiki Markup

Upgrade Steps

  1. Wiki MarkupStep 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 MarkupCopy 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 MarkupRemove the old version of _xerces.jar_ from your installation, so it is not inadvertently later used:_rm \ [dspace\]/lib/xerces.jar_
  6. Wiki MarkupInstall the new config files by moving _dstat.cfg_ and _dstat.map_ from _\[dspace-1.3.x-source\]/config/_ to _\[dspace\]/config_unmigrated-wiki-markup
  7. 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
  8. 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_unmigrated-wiki-markup
  9. 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 Reportsunmigrated-wiki-markup
  11. Initialize the statistics using: _\[dspace\]/bin/stat-initial{_}_\[dspace\]/bin/stat-general{_}_\[dspace\]/bin/stat-report-initial{_}_\[dspace\]/bin/stat-report-general_unmigrated-wiki-markup
  12. Rebuild the search indexes: _\[dspace\]/bin/index-all_
  13. Wiki MarkupCopy 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.