Page History
...
- Download DSpace 3.0: Either download DSpace 3.0 from DSpace.org or check it out directly from the Github repository. If you downloaded DSpace do not unpack it on top of your existing installation. Refer to Installation Instructions, Step 3 for unpacking directives.
- Merge any customizations. If you have made any local customizations to your DSpace installation they will need to be migrated over to the new DSpace. Customizations are typically housed in one of the following places:
- JSPUI modifications:
[dspace-source]/dspace/modules/jspui/src/main/webapp/
- XMLUI modifications:
[dspace-source]/dspace/modules/xmlui/src/main/webapp/
- Config modifications:
[dspace]/config
- JSPUI modifications:
Build DSpace. Run the following commands to compile DSpace:
No Format cd [dspace-source]/dspace/ mvn -U clean package
You will find the result in
[dspace-source]/dspace/target/dspace-[version]-build.dir
. Inside this directory is the compiled binary distribution of DSpace. Before rebuilding DSpace ('package'), the above command will clean out any previously compiled code ('clean') and ensure that your local DSpace JAR files are updated from the remote maven repository.- Stop Tomcat. Take down your servlet container. For Tomcat, use the
$CATALINA_HOME/shutdown.sh
script. (Many Unix-based installations will have a startup/shutdown script in the/etc/init.d
or/etc/rc.d
directories.) - Update DSpace.
Update the DSpace installed directory with the new code and libraries. Issue the following commands:
Code Block cd [dspace-source]/dspace/target/dspace-[version]-build.dir ant update
- Please run one of the following scripts to update your database:-
- PostgreSQL: [dspace-source]/dspace/etc/postgres/database_schema_18-3.sql
- Oracle: [dspace-source]/dspace/etc/oracle/database_schema_18-3.sql
- Update your DSpace Configurations.
Refresh Browse and Search Indexes. To do this, run the following command from your DSpace install directory (as the dspace user):
Code Block [dspace]/bin/dspace index-init
Refresh Discovery: If you are using Discovery (Solr) for search/browse, you will also need to refresh Discovery indexes by running the following command:
Code Block [dspace]/bin/dspace update-discovery-index -f
Deploy Web Applications. If necessary, copy the web applications files from your
[dspace]/webapps
directory to the subdirectory of your servlet container (e.g. tomcat):Code Block cp -R [dspace]/webapps/* [tomcat]/webapps/
See the installation guide for full details.
- Restart servlet container. Now restart your Tomcat/Jetty/Resin server program and test out the upgrade.