# Federated Runtime Monitoring (FRM)¶

The installation of the FRM component is here listed.

## Proxy¶

The proxy component has been developed as a servlet filter in order to be compatible with the DS servlets. It is released ad a .jar dependency in such a way to be totally integrate in the Tomcat Server. The proxy consists of two Java source files, named ProxyFilter.java and CachedServletRequest.java under the sunfish.frm.proxy package.

The supplied pom.xml file contains the maven depency code snippet for the required libraries.

The supplied web.xml file, located under the src/main/webapp/WEB-INF directory, contains the servlet mapping for the servlet filter.

A config.json file, located under the src/main/webapp/WEB-INF directory, contains configuration directives.

There additional libraries supplied in the src/main/webapp/WEB-INF/lib directory need to be properly added into the java path during the deployment.

### Installation guide¶

The following steps are required to deploy and/or integrate the proxy with each DS component.

N.B. The following instructions refer to the dockerised setup of the SUNFISH Data Security Enforcement Infrastructure. Follow the doc for the deployment.

1. Download the last release of the Proxy Infrastructure tenant from the Releases tab in the GitHub repository release.

2. Once loaded the preconfigured docker containers demotenant.tar and infra.tar open the infrastructure folder and copy from the Federation-Monitoring/install/ds-infrastructure/ folder the following elements:

• ./params.json this contains the configuration params for the ProxyFilter
• ./web.xml this contains a new version of the configuration for Tomcat. It enables the filter-mapping.
• ./deploy.sh this is the modified script to launch the instrastructure tenant. It load all required dependencies and configurations in Tomcat.
3. Copy ProxyFilter-1.0-release.jar download at 1. in Federation-Monitoring/install/ds-infrastructure/dependencies/

4. Copy the dependencies/ inside the infrastructure folder.

Once finished you should have inside the DS module infrastructure and the tenant folders. Your infrastructure folder should looks like this: