Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Apache Tomcat 5.5 or later. Tomcat can be downloaded from the following location: http://tomcat.apache.org.
    • Note that DSpace will need to run as the same user as Tomcat, so you might want to install and run Tomcat as a user called 'dspace'. Set the environment variable TOMCAT_USER appropriately.
    • You need to ensure that Tomcat has a) enough memory to run DSpace and b) uses UTF-8 as its default file encoding for international character support. So ensure in your startup scripts (etc) that the following environment variable is set: JAVA_OPTS="-Xmx512M -Xms64M -Dfile.encoding=UTF-8"
    • Wiki Markup
      *Modifications in* *_\[tomcat\]/conf/server.xml{_}*:  You also need to alter Tomcat's default configuration to support searching and browsing of multi-byte UTF-8 correctly. You need to add a configuration option to the _<Connector>_ element in _\[tomcat\]/config/server.xml_: _URIEncoding="UTF-8"_ e.g. if you're using the default Tomcat config, it should read:
      Code Block
      <!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
      <Connector port="8080"
                    maxThreads="150"
                    minSpareThreads="25"
      	          maxSpareThreads="75"
                    enableLookups="false"
                    redirectPort="8443"
      	          acceptCount="100"
                    connectionTimeout="20000"
      	          disableUploadTimeout="true"
                    URIEncoding="UTF-8"/>
      
      You may change the port from 8080 by editing it in the file above, and by setting the variable CONNECTOR_PORT in server.xml.
  • Jetty or Caucho Resin DSpace will also run on an equivalent servlet Engine, such as Jetty (http://www.mortbay.org/jetty/index.html) or Caucho Resin (http://www.caucho.com/). Jetty and Resin are configured for correct handling of UTF-8 by default.

...

  1. DSpace Configuration for Accessing SOLRSolr. In the dspace.cfg file review the following fields to make sure they are uncommented:
    Code Block
    solr.log.server = ${dspace.baseUrl}/solr/statistics
    solr.dbfile = ${dspace.dir}/config/GeoLiteCity.dat
    solr.spiderips.urls = http://iplists.com/google.txt, \
                          http://iplists.com/inktomi.txt, \
                          http://iplists.com/lycos.txt, \
                          http://iplists.com/infoseek.txt, \
                          http://iplists.com/altavista.txt, \
                          http://iplists.com/excite.txt, \
                          http://iplists.com/misc.txt, \
                          http://iplists.com/non_engines.txt
    
  2. DSpace logging configuration for Solr. If your DSpace instance is protected by a proxy server, in order for Solr to log the correct IP of the user, rather of the proxy, it must be configured to look for the X-Forwarded-For header.  This feature can be enbled by ensuring the following setting is uncommented in the logging sesction of dspace.cfg:
    Code Block
    useProxies = true
  3. DSpace configuration for fields indexed into Solr Event records for search. In the dspace.cfg file, review the following property keys to make sure they are uncommented:
    Code Block
    statistics.items.dc.1=dc.identifier
    statistics.items.dc.2=dc.date.accessioned
    statistics.items.type.1=dcinput
    statistics.items.type.2=date
    statistics.default.start.datepick = 01/01/1977
  4. Configuration Control. In the dspace.cfg set the following property key:_statistics.item.authorization.admin=true_This will require the user to sign on to see that statistics. Setting the statistics to "false" will make them publicly available. 
  5. Final steps. 
    • Perform the following step:¬†
      Code Block
      cd [dspace-source]/dspace
      mvn package
      cd [dspace-source]/dspace/target/dspace-<version>-build.dir
      ant -Dconfig=[dspace]/config/dspace.cfg update
      cp -R [dspace]/webapps/* [TOMCAT]/webapps
      
      Wiki Markup
      If you only need to build the statistics, and don't make any changes to other web applications, you can replace the copy step above with: _cp \-R \[dspace\]/webapps/solr \[TOMCAT\]/webapps_
    • Restart your webapps (Tomcat/Jetty/Resin)¬†

...