SUNScholar/Install DSpace/S08

NEXT - STEP 9

PLEASE NOTE:

1. *** This procedure is completely different from the official DSpace documentation, in that it applies best system admin practice for Unix based systems ***
2. This procedure does NOT require "mod_jk" or Apache2 port re-direction with firewall rules or the Apache2 server.

Step 8. Enable the DSpace Java webapps on the Java Tomcat webapp server

The DSpace webapps have been compiled in the $HOME/webapps folder but Tomcat only serves up webapps in the /var/lib/tomcatX/webapps folder. So, how do we get all the files into the Tomcat webapps folder?

There are several methods. I chose the "automatic linkage" method: if you change anything in the DSpace $HOME/webapps folder and then re-compile, the changes automatically occur in the Tomcat /var/lib/tomcatX/webapps folder. This method also saves you from constantly copying webapps after a compile, which is always a tricky business. It also saves you from having to change the Tomcat server configuration files, which is very definitely not recommended by the Debian/Ubuntu software package maintainers.

Requirements

Please make sure that Tomcat is listening on port 80 first, before setting this up. See link below.
http://wiki.lib.sun.ac.za/index.php/SUNScholar/Prepare_Ubuntu/S05

References

• http://rspproject.wordpress.com/2011/03/22/running-dspace-on-a-root-url/
• https://wiki.duraspace.org/display/DSDOC5x/Installing+DSpace#InstallingDSpace-Installation
• https://wiki.duraspace.org/display/DSDOC4x/Installing+DSpace#InstallingDSpace-Installation

Check SOLR webapp operation

If you have problems with the SOLR webapp, then complete the following to check its operation.

Install the "lynx" application.

sudo apt-get install lynx

Then type the following in the console:

lynx http://localhost/solr

You should get the following:

If not debug the solr webapp until you can.

Remember to restart the Tomcat server for each change you make to a webapp configuration.

SOLR Help

General

• https://wiki.duraspace.org/display/DSPACE/Solr
• http://lucene.apache.org/solr
• http://wiki.apache.org/solr

Maintaining SOLR

• https://wiki.duraspace.org/display/DSDOC6x/SOLR+Statistics+Maintenance
• https://wiki.duraspace.org/display/DSDOC5x/SOLR+Statistics+Maintenance

DSpace Settings

• https://github.com/DSpace/DSpace/blob/master/dspace-api/src/main/java/org/dspace/core/Constants.java#L20

Querying the SOLR DB

• https://wiki.duraspace.org/display/DSDOC5x/SOLR+Statistics#SOLRStatistics-CustomReporting-QueryingSOLRDirectly
• https://wiki.duraspace.org/display/DSDOC4x/DSpace+Statistics#DSpaceStatistics-CustomReporting-QueryingSOLRDirectly
• https://wiki.duraspace.org/display/DSDOC3x/DSpace+Statistics#DSpaceStatistics-CustomReporting-QueryingSOLRDirectly

Tips

• http://kim-shepherd.blogspot.com/2010/11/discovering-discovery-dspace-solr-tips.html
• http://www.scottphillips.com/2011/10/merging-two-dspace-solr-based-data-sets-together

PREVIOUS - STEP 7