Page History
...
Info |
---|
To |
...
upgrade |
...
from |
...
DSpace |
...
1.0.1 |
...
to |
...
1.1, |
...
follow |
...
the |
...
steps |
...
below. |
...
Your |
...
dspace.cfg |
...
does |
...
not |
...
need |
...
to |
...
be |
...
changed. |
...
In |
...
the |
...
notes |
...
below |
...
|
...
|
...
refers |
...
to |
...
the |
...
install |
...
directory |
...
for |
...
your |
...
existing |
...
DSpace |
...
installation, |
...
and |
...
[dspace-1.1-source |
...
] |
...
to |
...
the |
...
source |
...
directory |
...
for |
...
DSpace |
...
1.1. |
...
Whenever |
...
you |
...
see |
...
these |
...
path |
...
references, |
...
be |
...
sure |
...
to |
...
replace |
...
them |
...
with |
...
the |
...
actual |
...
path |
...
names |
...
on |
...
your |
...
local |
...
system. |
Upgrade Steps
- Take down Tomcat (or whichever servlet container you're using).
- We recommend that you upgrade to the latest version of PostgreSQL (7.3.2). Included are some notes to help you do this (see the
postgres-upgrade-notes.txt
file). Note you will also have to upgrade Ant to version 1.5 if you do this. - Make the necessary changes to the DSpace database. These include a couple of minor schema changes, and some new indexes which should improve performance. Also, the names of a couple of database views have been changed since the old names were so long they were causing problems. First run psql to access your database (e.g. psql -U dspace -W and then enter the password), and enter these SQL commands:
Code Block ALTER TABLE bitstream ADD store_number INTEGER; UPDATE bitstream SET store_number = 0; ALTER TABLE item ADD last_modified TIMESTAMP; CREATE INDEX last_modified_idx ON Item(last_modified); CREATE INDEX eperson_email_idx ON EPerson(email); CREATE INDEX item2bundle_item_idx on Item2Bundle(item_id); CREATE INDEX bundle2bitstream_bundle_idx ON Bundle2Bitstream(bundle_id); CREATE INDEX dcvalue_item_idx on DCValue(item_id); CREATE INDEX collection2item_collection_idx ON Collection2Item(collection_id); CREATE INDEX resourcepolicy_type_id_idx ON ResourcePolicy (resource_type_id,resource_id); CREATE INDEX epersongroup2eperson_group_idx on EPersonGroup2EPerson(eperson_group_id); CREATE INDEX handle_handle_idx ON Handle(handle); CREATE INDEX sort_author_idx on ItemsByAuthor(sort_author); CREATE INDEX sort_title_idx on ItemsByTitle(sort_title); CREATE INDEX date_issued_idx on ItemsByDate(date_issued); DROP VIEW CollectionItemsByDateAccessioned; DROP VIEW CommunityItemsByDateAccessioned; CREATE VIEW CommunityItemsByDateAccession as SELECT Community2Item.community_id, ItemsByDateAccessioned.* FROM ItemsByDateAccessioned, Community2Item WHERE ItemsByDateAccessioned.item_id = Community2Item.item_id; CREATE VIEW CollectionItemsByDateAccession AS SELECT collection2item.collection_id, itemsbydateaccessioned.items_by_date_accessioned_id, itemsbydateaccessioned.item_id, itemsbydateaccessioned.date_accessioned FROM itemsbydateaccessioned, collection2item WHERE (itemsbydateaccessioned.item_id = collection2item.item_id);
- Fix your JSPs for Unicode. If you've modified the site 'skin' (jsp/local/layout/header-default.jsp) you'll need to add the Unicode header, i.e.:
to the <HEAD> element. If you have any locally-edited JSPs, you need to add this page directive to the top of all of them:Code Block <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
(If you haven't modified any JSPs, you don't have to do anything.)Code Block <%@ page contentType="text/html;charset=UTF-8" %>
- Copy the required Java libraries that we couldn't include in the bundle to the source tree. For example:
Code Block cd [dspace]/lib cp *.policy activation.jar servlet.jar mail.jar [dspace-1.1-source]/lib
Wiki Markup - Compile up the new DSpace code, replacing _\[dspace\]/config/dspace.cfg_ with the path to your current, LIVE configuration. (The second line, _touch `find .`_, is a precaution, which ensures that the new code has a current datestamp and will overwrite the old code. Note that those are back quotes.)
Code Block cd [dspace-1.1-source] touch `find .` ant ant -Dconfig= [dspace]/config/dspace.cfg update
- Update the database tables using the upgrader tool, which sets up the new >last_modified date in the item table:
Code Block Run [dspace]/bin/dsrun org.dspace.administer.Upgrade101To11
- Run the collection default authorization policy tool:
Code Block unmigrated-wiki-markup[dspace]/bin/dsrun org.dspace.authorize.FixDefaultPolicies
- Fix the OAICat properties file. Edit _\[dspace\]/config/templates/oaicat.properties_. Change the line that says
Code Block Identify.deletedRecord=yes
This is needed to fix the OAI-PMH 'Identity' verb response. Then run _\[dspace\]/bin/install-configs_.Code Block unmigrated-wiki-markupIdentify.deletedRecord=persistent
- Re-run the indexing to index abstracts and fill out the renamed database views:
Code Block [dspace]/bin/index-all
- Restart Tomcat. Tomcat should be run with the following environment variable set, to ensure that Unicode is handled properly. Also, the default JVM memory heap sizes are rather small. Adjust -Xmx512M (512Mb maximum heap size) and -Xms64M (64Mb Java thread stack size) to suit your hardware.
Code Block JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"