The changes in DSpace 1.5 are significant and wide spread involving database schema upgrades, code restructuring, completely new user and programatic interfaces, and new build system.
+ +In the notes below [dspace]code> refers to the install directory for your existing DSpace installation,
+ and [dspace-source] to the source directory for DSpace 1.5. Whenever you see these path references,
+ be sure to replace them with the actual path names on your local system.
First and foremost, make a complete backup of your system, including:
+[dspace]/assetstore by default)Get the new DSpace 1.5 source code either as a download from SourceForge or check it out directly from the SVN code repository. If you downloaded DSpace do not unpack it on top of your existing installation.
+The build process has radically changed for DSpace 1.5. With this new release the build system has moved to a maven-based system enabling the various projects (JSPUI, XMLUI, OAI, and Core API) into separate projects. See the Installation section for more information on building DSpace using the new maven-based build system. Run the following commands to compile DSpace.
++ cd [dspace-source]/dspace; + mvn package ++
You will find the result in [dspace-source]/dspace/target/dspace-1.5-build.dir/; inside this directory is the compiled binary distribution of DSpace.
Take down your servlet container, for Tomcat use the bin/shutdown.sh script.
+
dspace.cfg
+Serveral new parameters need to be added to your [dspace]/config/dspace.cfg. While it is advisable to start with a fresh DSpace 1.5 dspace.cfg configuration file here are the minimum set of parameters that need to be added to an old DSpace 1.4.2 configuration.
+ +#### Stackable Authentication Methods ##### +# +# Stack of authentication methods +# (See org.dspace.authenticate.AuthenticationManager) +# Note when upgrading you should remove the parameter: +# plugin.sequence.org.dspace.eperson.AuthenticationMethod +plugin.sequence.org.dspace.authenticate.AuthenticationMethod = \ + org.dspace.authenticate.PasswordAuthentication + +###### JSPUI item sytle plugin ##### +# +# Specify which strategy use for select the style for an item +plugin.single.org.dspace.app.webui.util.StyleSelection = \ + org.dspace.app.webui.util.CollectionStyleSelection + + +###### Browse Configuration ###### +# +# The following configuration will mimic the previous +# behavior exhibited by DSpace 1.4.2. For alternative +# configurations see the manual. + +# Browse indexes +webui.browse.index.1 = dateissued:item:dateissued +webui.browse.index.2 = author:metadata:dc.contributor.*:text +webui.browse.index.3 = title:item:title +webui.browse.index.4 = subject:metadata:dc.subject.*:text + +# Sorting options +webui.itemlist.sort-option.1 = title:dc.title:title +webui.itemlist.sort-option.2 = dateissued:dc.date.issued:date +webui.itemlist.sort-option.3 = dateaccessioned:dc.date.accessioned:date + +# Recent submissions +recent.submissions.count = 5 + +# Itemmapper browse index +itemmap.author.index = author + +# Recent submission processor plugins +plugin.sequence.org.dspace.plugin.CommunityHomeProcessor = \ + org.dspace.app.webui.components.RecentCommunitySubmissions +plugin.sequence.org.dspace.plugin.CollectionHomeProcessor = \ + org.dspace.app.webui.components.RecentCollectionSubmissions + +#### Content Inline Disposition Threshold #### +# +# Set the max size of a bitstream that can be served inline +# Use -1 to force all bitstream to be served inline +# webui.content_disposition_threshold = -1 +webui.content_disposition_threshold = 8388608 + +#### Event System Configuration #### +# +# default synchronous dispatcher (same behavior as traditional DSpace) +event.dispatcher.default.class = org.dspace.event.BasicDispatcher +event.dispatcher.default.consumers = search, browse, eperson + +# consumer to maintain the search index +event.consumer.search.class = org.dspace.search.SearchConsumer +event.consumer.search.filters = Item|Collection|Community|Bundle+Create|Modify|Modify_Metadata|Delete:Bundle+Add|Remove + +# consumer to maintain the browse index +event.consumer.browse.class = org.dspace.browse.BrowseConsumer +event.consumer.browse.filters = Item+Create|Modify|Modify_Metadata:Collection+Add|Remove + +# consumer related to EPerson changes +event.consumer.eperson.class = org.dspace.eperson.EPersonConsumer +event.consumer.eperson.filters = EPerson+Create ++ + + +
xmlui.xconf Manakin configuration
+The new Manakin user interface available with DSpace 1.5 requires an extra configuration file that you will need to manually copy over to your configuration directory.
++cp [dspace-source]/dspace/config/xmlui.xconf [dspace]/config/xmlui.xconf ++
The database schema needs updating. SQL files contain the relevant updates are provided, note if you have made any local customizations to the database schema you should consult these updates and make sure they will work for you.
+psql -U [dspace-user] -f [dspace-source]/dspace/etc/database_schema_14-15.sql [database-name]
[dspace-source]/dspace/etc/oracle/database_schema_142-15.sql contains the
+commands necessary to upgrade your database schema on oracle.
If you have made any local customizations to your DSpace installation they will need to be migrated over to the new DSpace. Commonly these modifications are made to "JSP" pages located inside the [dspace 1.4.2]/jsp/local directory. These should be moved
+[dspace-source]/modules/dspace-jspui/src/main/webapp/ in the new build structure. See Customizing the JSP Pages for more information.
+
Update the DSpace installed directory with new code and libraries. Inside the [dspace-source]/dspace/target/dspace-1.5-build.dir/ directory run:
+cd [dspace-source]/dspace/target/dspace-1.5-build.dir/; +ant -Dconfig=[dspace]/config/dspace.cfg update ++
One of the major new features of DSpace 1.5 is the browse system which necessitates that the indexes be recreated. To do this run the following command from your DSpace installed directory:
++[dspace]/bin/index-init ++
Copy the webapplications files from your [dspace]/webapps directory to the subdirectory of your servlet container (e.g. Tomcat):
++cp [dspace]/webapps/* [tomcat]/webapps/ ++
Restart your servlet container, for Tomcat use the bin/startup.sh script.