2.4.0 Migration Guide

This guide helps detail what you'll need to do and what has changed. Much of this guide only applies if you have made custom modifications to WebViewer Server.

• WebViewer Server is now composed of 4 files, embedded-server.jar,shared.jar ,blackbox.war ,demo.war
• Apache Tomcat is now used as embedded software and configuration is now declared in code. Before we merged our binaries with an Apache Tomcat install.
• To make configuration modifications now, one will need to modify various JAVA_OPTS on their system or in the container.
• By default, WebViewer Server expects the contents of the libs folder 1 level above its working directory. This contains all binaries used in WebViewer Server's operation. This can be configured via TRN\BIN\DIR
• Inside of the Docker Container
  • The root directory is now /home/tomcat/wv-server
  • The binary libraries are placed in /home/tomcat/libs
• Using the WebViewer Server Windows installer
  • Program execution now occurs in C:/ProgramData/Apryse

Logging Modifications

Internally we use log4j2 to manage our logging, and some customers may use a custom logging file for their setup. In 2.4.0 the way to overwrite this file is to now add this to your JAVA_OPTS:

Dlog4j.configurationFile=/path/to/log4j2.xml

This document will be updated if there are any more possible migration suggestions, feel free to submit any issues the new release might create for you via support.