Page History

...

1. Download the CNRI Handle Software: http://www.handle.net/download.html. In the tarball you'll find a INSTALL.txt with an installation instruction, 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 pathes 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 second line, if necessary.

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

   Take a look in [dspace-install]/config/dspace.cfg. Change the URL above to point on the value of your dspace.url and add /handleresolver to the end of it. If you run more then 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 that contains exec java ... net.handle.server.Main ...
   4. Add -Dlog4j.configuration=log4j-handle-plugin.properties 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