PreservationIdentifier-Server

A webservice that for a given system context model and a set of resources under risk generates alternative system context models
where resources under risk are replaced by other (compatible) resources.
At the moment the only supported resources are tools.

Usage

There are two ways to publish this webservice

1. in a tomcat. all you need to do is copy/symlink the project root into your tomcat/webapps folder
2. using the java endpoint, by running PreservationIdentifierServer (e.g. by ant PreservationIdentifierServer)
   you can modify the service URL by passing a CLI argument with the URL

Dependencies

• JDK >= 1.7
• JAX-WS 2.2.8, http://jax-ws.java.net/2.2.8/, embedded in WEB-INF/lib
• kblib, http://olymp.ifs.tuwien.ac.at:8080/archiva/browse/org.sba_research.timbus.kb/kblib/1.0-SNAPSHOT, embedded in WEB-INF/lib

Supported individuals

The affectedResource can be specified as IRI or fragment. The fragment or label of this individual needs to match
to individuals of the kblib, which can be checked in http://kronos.ifs.tuwien.ac.at:8080/kbserver/.
- individuals of type SystemSoftware that are defined in the passed ontology or in direct imports thereof
- individuals of type File that are defined in a TIMBUS compliant way, i.e. specifying an objectCharacteristics property,
which specifies a Format that in turn specifies a FormatRegistry that contains the Pronom ID of the format

FAQ

• Alternatives are not returned for every risk.

  Only individuals of type SystemSoftware that are defined in the passed ontology or in direct imports thereof are considered.
  Risks are silently skipped if the individual could not be found.

• The knowledgebase is unavailable.

  Have a look at the kbgen project to rebuild the knowledgebase or obtain a copy.

• The query runs forever and stops eventually with an exception.

  Make sure that no self-signed certificates are imported in the ontology that is passed.
  If there are such:

  • download the certificate (e.g. in firefox)
  • create a keystore:
    keytool -import -file [cacert.pem] -alias [alias] -keystore [keystore.ts] -storepass [password]
  • load the keystore:
    System.setProperty("javax.net.ssl.trustStore", "/tmp/pi/keystore.ts");