The installation process for the filter is very similar to Installing the Sentinel VoLTE Provisioning Module, with some changes for the Sentinel Authentication Gateway.

For completeness, the entire process is described here.

Note The Sentinel VoLTE Provisioning module is part of Sentinel VoLTE and includes the Sentinel VoLTE XCAP server. Check the Sentinel Authentication Gateway Compatibility Guide for the required version of REM, installed with Apache Tomcat.

Prerequisites

You’ll need these files to install the Sentinel VoLTE Provisioning module:

apache-tomcat-<version>.zip
rhino-element-manager-<version>.zip
volte-sentinel-element-manager-<version>.jar
sentinel-gaa-em-<version>.em.jar

Below are steps to:

Set up Tomcat

See Running REM on Apache Tomcat in the REM Guide.

Tip See the Tomcat 8 - SSL How-To docs for help setting up SSL in Apache Tomcat.

Install the REM plugins

To install the REM plugins for the Sentinel VoLTE Provisioning and NAF Authentication Filter modules:

1

Copy volte-sentinel-element-manager-<version>.jar and sentinel-gaa-em-<version>.em.jar into apache-tomcat-<version>/rem_home/plugins.

2

Edit the Filter Configuration if necessary.

Customize plugin logging

1

Unzip log4j.properties from rem.war:

cd apache-tomcat-<version>
mkdir rem-tmp
cd rem-tmp
unzip ../webapps/rem.war WEB-INF/classes/log4j.properties

2

Edit WEB-INF/classes/log4j.properties with this content:

log4j.rootLogger=INFO, FILE, CONSOLE

log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{ABSOLUTE} %-5p <%t> [%c] %m%n

log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=${rem.home}/rem.log
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} %-5p <%t> [%c] %m%n

log4j.logger.rem=INFO
log4j.logger.openjpa=INFO
log4j.logger.org.apache.wink=INFO
# Logging from NAF authentication filter
log4j.logger.sentinel.gaa=INFO

# Uncomment for subscriberdata cache eviction logging
#log4j.logger.rem.server.sentinel.subscriberdata.cache=TRACE

log4j.logger.sentinel.audit=INFO, AUDIT
log4j.additivity.sentinel.audit=false

log4j.appender.AUDIT=org.apache.log4j.FileAppender
log4j.appender.AUDIT.File=${rem.home}/sentinel-audit.log
log4j.appender.AUDIT.layout=org.apache.log4j.PatternLayout
log4j.appender.AUDIT.layout.ConversionPattern="%d{yyyy-MM-dd HH:mm:ss,SSS}", "%c{1}", %m%n
Tip See Configuring NAF Authentication Filter logging for more information on logging configuration.

3

Replace WEB-INF/classes/log4j.properties in rem.war:

zip ../webapps/rem.war WEB-INF/classes/log4j.properties

4

Remove temporary files:

cd ..
rm -rf rem-tmp

Import Rhino trust certificate

This can also be done using the REM web UI.

1

Import a Rhino Trust Certificate into REM:

"${JAVA_HOME}/bin/keytool" -importcert -file ${RHINO_HOME}/rhino-trust.cert -keystore "${TOMCAT_HOME}/rem_home/rhino-ems.ks" -storepass changeit -noprompt

Restart Tomcat

To restart Tomcat (as needed), run these commands:

cd $TOMCAT_HOME
./bin/catalina.sh stop
./bin/catalina.sh start
Tip Use catalina.sh run to run Tomcat in the foreground. This can be useful for debugging.
Previous page Next page