CLARIN Virtual Collection Registry
----------------------------------
* DATABASE CONNECTION *
The connection to the database is configured using JNDI using the
name "jdbc/VirtualCollectionStore".
When using Apache Tomcat add the following to the context configuration
of the web application (by either modifying "server.xml" or providing an
appropiate context configuration, e.g. like
"$CATALINA_HOME/conf/Catalina/localhost/VirtualCollectionRegistry.xml";
if in doubt, please check the Apache Tomcat documentation):
This will configure a DBCP data source for the virtual collection registry.
Customize $dbuser, $dbpass and $dbname to match your local settings.
NOTE: currently only MySQL is supported.
* CONTEXT PARAMETERS *
PUBLIC APPLICATION URL:
Add the following context parameter (typically to the global context.xml file)
and substitute the value with the correct *public* base location of the VCR:
Add no trailing slash. You can verify this by checking the service links in the
help page of the running application.
ADMINISTRATOR USERS:
Add the following context parameter:
Add the username of each user that should get administrator rights to the
referenced file, one username per line.
* PID PROVIDER *
You need to choose, which persistent identifier provider you want to use.
You can either use a dummy provider or the GWDG handle provider.
a) For using the dummy provider add the following:
b) For using the GWDG handle provider add following and customize the
values for $gwdg_user and $gwdg_password:
c) For using the EPIC API v2 handle provider add following and customize the
values for $epic_user and $epic_password:
Add the following parameter to configure a custom PID 'infix'. The example below
configures the default behaviour, i.e. '{prefix}/VCR-{id}'.
* AUTHENTICATION *
The application has two alternative authentication configuration represented by two
versions of the web.xml file. The default web.xml assumes Tomcat UserDatabaseRealm,
which is useful for testing purposes.
To shibbolize this application, the following steps are required:
1. Use the shibboleth version of web.xml called 'web-shib.xml' instead of
the default one by renaming it to and overwriting web.xml (you can make a
backup of the original web.xml). If the package was built for a production
environment, it should already have the right web.xml in place.
2. Add the following to the relevant Apache configuration:
ProxyPass ajp://localhost:8009/vcr
AuthType shibboleth
ShibRequireSession Off
ShibUseHeaders On
Satisfy All
Require shibboleth
ShibRequireSession On
Adjust locations to the desired and relevant local alternatives. The second
block is required to make the virtual collection form submit service work
with POSTs (current versions of SHHAA do not support this).
3. Configure the right SSO and SLO locations in WEB-INF/shhaa.xml:
...
https://shib-host/Shibboleth.sso/Login
https://shib-host/Shibboleth.sso/Logout
* OAI PROVIDER *
Collection display name:
Add the following to the Tomcat context.xml file to set a custom collection display name
(MdCollectionDisplayName header element) for the CMDI representations provided by the
built-in OAI provider:
Change the value of the 'value' attribute if desired. If this parameter is not set,
the default value "CLARIN Virtual Collection Registry" will be used as a collection name.