Personendaten-Repositorium

PDR Allies is designed for the Apache Axis2 Web Wervice Engine, which itself can be deployed in Tomcat.

• Installation of Apache Tomcat

This description suggests deploying a Web Archive (WAR) distribution of Axis2. Go get the .war file at the Axis2 release page and detailed instructions at their installation guide. In this manual, we assume that Axis2 version 1.5.3 is used.

Tomcat will automatically install the Service as soon as we copy the file axis2.war into its webapps directory (e.g. /home/tomcat8082/tomcat1/webapps/).

We need to modify tomcat8082/tomcat1/webapps/axis2/WEB-INF/conf/axis2.xml, though:

<parameter name="userName">admin</parameter>
<parameter name="password">password</parameter>

• Further Reading: Installation of Apache Tomcat

Mapping of AJP13 connections to URL prefixes is done using the JkMount option for VirtualHost configuration in the Web Server's sites-enabled directory:

DocumentRoot /var/www
JkMount /axis2* worker1

Like this, our HTTP server lets Tomcat respond at URLs beginning with https://pdr.dariah.eu/axis2/, by serving the web services engine Axis2, which will later host PDR services.

At this point, you might want to check if everything is up and running properly. One option to do so is checking the outputs of the *Axis2 Happines Page* at e.g. http://localhost/axis2/axis2-web/HappyAxis.jsp.

Get a PDR-ALLIES package from the PDR downloads page. It contains a subfolder bin/, where you will find the cruxial components, being the compiled Web Service pdr-allies-x.x.x.aar and the underlying programming library lib-pdr-allies-x.x.x.jar.

Copy said .aar file into the services folder of previously installed Axis2, supposedly at /home/tomcat8082/tomcat1/webapps/axis2/WEB-INF/services/. Make sure there's only one version of pdr-allies-x.x.x.aar present! The library lib-pdr-allies-x.x.x.jar is going to Axis2's lib folder, e.g. /home/tomcat8082/tomcat1/webapps/axis2/WEB-INF/lib/.

The PDR Allies package contains a directory lib_aar. Copy its contents into the lib folder of Axis2, e.g. /home/tomcat8082/tomcat1/webapps/axis2/WEB-INF/lib.

Once again, you might want to check if everything went as intended. Go open the *Services* page of your Axis2 installation and check for the services *PIT Connector*, *Repository* and *Utilities* at: http://localhost/axis2/services/listServices.

PDR-ALLIES expects a config file at $PDR_HOME/.pdr/conf/pdr.conf. If you haven't set the PDR_HOME variable yet, check out the article covering the Installation of Apache Tomcat again.

pdr.conf contains credentials for PaDRe as well as base URIs for PaDRe and Solr. You can download a template file from the PDR download page. Save it in your $PDR_HOME/.pdr/conf directory.

Check the PaDRe credentials in Tomcat's webapps/padre/WEB-INF/web.xml file and set the expected variables accordingly:

	PADRE_BASE_URI=https://localhost/padre/api
	PADRE_USERNAME=padre-client
	PADRE_PASSWORD=padre_passwd
	SOLR_BASE_URI=https://localhost/solr