...
The Handle server you use must be dedicated to resolve Handles from DSpace. You cannot use a Handle server that is in use with other software already. You can use CNRIs CNRI's Handle Software , -- all you have to do, is to use a plugin for it, that gets is shipped with DSpace. The following instruction was instructions were tested with CNRIs CNRI's Handle software version 7.3.1. You can do the following steps on another machine then the machine DSpace runs on, but you have to copy some files from the machine on which DSpace is installed.
- Download the CNRI Handle Software: http://www.handle.net/download.html. In the tarball you'll find a an INSTALL.txt with an installation instruction, instructions -- follow it.
- 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 We use the same pathes 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.
- Create the directory /hs/srv_1/logs.
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 third 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 than one DSpace Installation, you may add more DSpace Endpoints, just . Just increase the number at the end of the key one by another.
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"
- Copy /hs/hsj-7.3.1/bin/hdl-server to /hs/srv_1/start-hdl-server
- Edit /hs/srv_1/start-hdl-server:
- Find the last line that begins with HDLHOME=
- Below that line add the following one: HDLHOME="/hs/hsj-7.3.1/"
- Find a line that that contains exec java ... net.handle.server.Main ...
- 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.
- If your handle server is running, stop it.
- From now on you should start this handle server using /hs/srv_1/start-hdl-server
Please pay attention: The Handle Server will only start, if it is able to connect to at least on one running DSpace InstallationsInstallation. It only resolves the handles of the DSpace Installations that were running when it was started.