Page History
...
Note |
---|
If you will be building the Mirage 2 theme, you will need Maven 3.1 3.9 or above. |
Maven can be downloaded from the following location: http://maven.apache.org/download.html
...
- 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. - 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.) - 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
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
...