Differences between revisions 5 and 6
Revision 5 as of 2010-11-22 13:20:04
Size: 1738
Comment:
Revision 6 as of 2010-12-16 12:16:39
Size: 2303
Comment:
Deletions are marked like this. Additions are marked like this.
Line 3: Line 3:
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. 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 provide a IP role mapping and Log4J configuration file.
Line 5: Line 5:
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. KILL!!! 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.

You will need to modify (or add) the {{{dk.statsbiblioteket.doms.iprolemapper.webservice.IPRoleMapperService.configurationFile context-param}}} of the context configuration for the WAR (e.g. the file {{{../tomcat/config/context.xml}}}) and assign it with the file path to the IP role mapper configuration file which you want the service to use.

KILL!!! However, the serv That is, this will override any default configuration specified by the {{{web.xml}}} file in the IP role mapper {{{.WAR}}} file.
Line 10: Line 14:
   <context-param>
       <param-name>dk.statsbiblioteket.iprolemapping.configurationFile</param-name>
        <param-value>/path/to/the/configuration/file.xml</param-value>
    </context-param>
   <Parameter name="dk.statsbiblioteket.doms.iprolemapper.webservice.IPRoleMapperService.configurationFile"
              value="/path/to/the/ip-rolemapper/configuration/file.xml override="false"/>
Line 15: Line 17:

The <code>override</code> attribute in the above ensures that the parameter cannot be overridden by the {{{WEB-INF/web.xml}}} file in the {{{.WAR}}} file.

You will also need to provide a Log4J configuration file in order to enable the service to produce a meaningful log output. However, it will use the default logging mechanism and configuration provided by Tomcat if you fail to do so.

Setting up the log configuration is just as easy as setting up the IP rolemapper itself. All you need to do is to add

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 provide a IP role mapping and Log4J configuration file.

KILL!!! 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.

You will need to modify (or add) the dk.statsbiblioteket.doms.iprolemapper.webservice.IPRoleMapperService.configurationFile context-param of the context configuration for the WAR (e.g. the file ../tomcat/config/context.xml) and assign it with the file path to the IP role mapper configuration file which you want the service to use.

KILL!!! However, the serv 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:

   <Parameter name="dk.statsbiblioteket.doms.iprolemapper.webservice.IPRoleMapperService.configurationFile"
              value="/path/to/the/ip-rolemapper/configuration/file.xml override="false"/>

The <code>override</code> attribute in the above ensures that the parameter cannot be overridden by the WEB-INF/web.xml file in the .WAR file.

You will also need to provide a Log4J configuration file in order to enable the service to produce a meaningful log output. However, it will use the default logging mechanism and configuration provided by Tomcat if you fail to do so.

Setting up the log configuration is just as easy as setting up the IP rolemapper itself. All you need to do is to add

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>

and thus, the .WAR file will obviously also contain the file WEB-INF/ipRangesAndRoles.xml.

IPRoleMapperInstallation (last edited 2011-03-22 12:51:13 by jrg)