Page History

...

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.)  In your DSpace installation directory you'll find the following two files: [dspace-install]/lib/log4j-1.2.14.jar, [dspace-install]/lib/DSpace-handle-plugin.jar. Copy them into /hs/hsj-7.3.1/lib.
3. Create the directory /hs/srv_1/logs.

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

   Code Block
   title 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.

   Code Block
   title handle-dspace-plugin.cfg
   dspace.handle.endpoint1 = http://example.org/dspace/handleresolver

   Take If you are using XMLUI take a look in [dspace-install]/config/dspace.cfg. Change , 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 in 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 one by another.

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

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

6. Copy /hs/hsj-7.3.1/bin/hdl-server to /hs/srv_1/start-hdl-server
7. 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.
8. If your handle server is running, stop it.
9. From now on you should start this handle server using /hs/srv_1/start-hdl-server

...