Page History

...

Maven can be downloaded from the following location: http://maven.apache.org/download.html

...

1. Download the CNRI Handle Software: http://www.handle.net/download.html. In the tarball you'll find an INSTALL.txt with installation instructions -- follow it.
2. After installing the CNRI Handle Software you should have two directories: once that contains the CNRI software and one that contains the configuration of you local Handle Server. For the rest of this instruction we assume that the directory containing the CNRI Software is /hs/hsj-7.3.1 and the directory containing the configuration of your local server is /hs/srv_1.  (We use the same paths here as CNRIs INSTALL.txt.)
3. Download the plugin from https://github.com/DSpace/Remote-Handle-Resolver/releases.  Select a release.  You can get the source and build it yourself, or just use the JAR file included in the release.  In either case, once you have a dspace-remote-handle-resolver-VERSION.jar, copy it to the directory containing the CNRI software (/hs/hsj-7.3.1/lib). 
4. Create the directory /hs/srv_1/logs.

5. Create the following two files in /hs/srv_1.

   log4j-handle-plugin.properties

    

   log4j.rootCategory=INFO, A1 log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender log4j.appender.A1.File=/hs/srv_1/logs/handle-plugin.log log4j.appender.A1.DatePattern='.'yyyy-MM-dd log4j.appender.A1.layout=org.apache.log4j.PatternLayout log4j.appender.A1.layout.ConversionPattern=%d %-5p %c @ %m%n log4j.logger.org.apache.axis.handlers.http.HTTPAuthHandler=INFO

    

   Change the path in the third line, if necessary.

   handle-dspace-plugin.cfg

    

   dspace.handle.endpoint1 = http://example.org/dspace/handleresolver

    

   If you are using XMLUI take a look in [dspace-install]/config/dspace.cfg, change the URL above to the value of your dspace.url and add /handleresolver to the end of it. If you are using JSPUI take a look in [dspace-install]/config/dspace.cfg, change the URL above to the value of your dspace.url and add /json/hdlresolver to the end of it. If you run more than one DSpace Installation, you may add more DSpace Endpoints.  Just increase the number at the end of the key for each:  endpoint2, endpoint3....

6. Edit the file /hs/srv_1/config.dct to include the following lines in the "server_config" clause:

    

   "storage_type" = "CUSTOM" "storage_class" = "org.dspace.handle.MultiRemoteDSpaceRepositoryHandlePlugin"

   
   

7. Copy /hs/hsj-7.3.1/bin/hdl-server to /hs/srv_1/start-hdl-server.
8. Edit /hs/srv_1/start-hdl-server:
   
   1. Find the last line that begins with HDLHOME=
   2. Below that line add the following one: HDLHOME="/hs/hsj-7.3.1/"
   3. Find a line that contains exec java ... net.handle.server.Main ...
   4. Add "-Dlog4j.configuration=file:///hs/srv_1/log4j-handle-plugin.properties -Ddspace.handle.plugin.configuration=/hs/srv_1/handle-dspace-plugin.cfg" right in front of net.handle.server.Main.
9. If your handle server is running, stop it.
10. From now on you should start this handle server using /hs/srv_1/start-hdl-server

...