Installation of the IP-Role Mapper Web-service

Installing the IP role mapper is a walk in the park. All there is to do is to drop the .WAR file into the ../tomcat/webapps directory and that is (almost) it! However, the .WAR file must contain a proper configuration file and the dk.statsbiblioteket.iprolemapping.configurationFile context-param must be defined in the web.xml in order to make this work.

If you want to apply another configuration than the default included in the .WAR file, or if it does not include any, then you will need to modify (or add) the dk.statsbiblioteket.iprolemapping.configurationFile context-param of the ../tomcat/config/context.xml file and assign it with the file path to the (alternative) configuration file which you want the service to use. That is, this will override any default configuration specified by the web.xml file in the IP role mapper .WAR file.

Example of the <context-param> element to add to the context.xml file:

   <context-param>
        <param-name>dk.statsbiblioteket.iprolemapping.configurationFile</param-name>
        <param-value>/path/to/the/configuration/file.xml</param-value>
    </context-param>

If the IP role mapper service applies a default configuration file then the WEB-INF/web.xml file of its .WAR file will contain an entry like this:

   <context-param>
        <param-name>dk.statsbiblioteket.iprolemapping.configurationFile</param-name>
        <param-value>/WEB-INF/ipRangesAndRoles.xml</param-value>
    </context-param>