Page History
...
- 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. - Download the plugin from https://github.com/DSpace/Remote-Handle-Resolver. TBS: how to build it or use a compiled JAR and copy it to the resolver.
- 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 - 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
). - Create the directory
/hs/srv_1/logs
. Create the following two files in
log4j-handle-plugin.properties/hs/srv_1
.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.cfgIf you are using XMLUI take a look in
[dspace-install]/config/dspace.cfg
, change the URL above to the value of yourdspace.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
....Edit
the
file/hs/srv_1/config.dct
file to include the following lines in the "server_config"
clause:"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 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 ofnet.handle.server.Main
.
- Find the last line that begins with
- 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 note: The Handle Server will only start if it is able to connect to at least one running DSpace Installation. It only resolves the handles of the DSpace Installations that were running when it was started.
...