TomEE Server Configurations for IBSS

TomEE Installation

  1. Download Apache TOMEE 9.1.2 Plume from https://tomee.apache.org/download.html
  1. Extract the zip file.

JAVA 17

  • Check the version of installed JDK before installing TomEE 9.1.2.
  • Open command prompt and type SET JAVA_HOME

    Set Java Home

  • Make sure that the JAVA_HOME is set to JAVA 17.

IBSS Config File Path Configurations

  1. Go to Apache TomEE installation folder\conf
  2. Open the file catalina.properties to edit
  3. Add the below lines at the end of the file:

INSBRIDGE_INSTANCE_APP_DIR=c:/insbridge/logs

INSBRIDGE_APP_DIR=c:/insbridge

log_dir=c:/insbridge/logs/logs

insbridge.net.softraterconfig.xml file

  1. Change the engine_type=”tomee”
  2. Should look like below, this is a one time change:

<softrater datelastmod="2020-03-12 03:08:47 PM" engine_type="tomee" format_version="3.0" softdata_version="SoftData Version 1" version="SoftRater Version 3">

System.properties Configurations

  1. Open system.properties in the Tomee/conf folder.
  2. Add openejb.classloader.forced-load=com.oracle to load com.oracle packages.

    3. Note: TomEE does not load the package with name "Oracle" in it, Ex: com.oracle.ins.ru.sr.ejb.esi

  3. Comment tomee.serialization.class and add the next entry for listing.

#tomee.serialization.class.blacklist = *

tomee.serialization.class.whitelist = *

Catalina.properties Configuration

  • Go to Apache Tomee installation folder\conf\catalina.properties
  • Add openejb to the jars to skip list in catalina.properties
  • Under "tomcat.util.scan.StandardJarScanFilter.jarsToSkip" there will be list of jar names to be skipped during startup, here add jakartaee-*.jar,\ openejb-*.jar,\ as below:

    Add Openejb Jar

Update the Jars in TomEE Lib

Make sure the jars are in place before starting the TomEE Server.

  • Remove all jars starting with "CXF"

    • Navigate to <TomEE_Home>\lib.

    • Remove the following jars that start with "cxf-"

      Update Jars in TomEE Lib

    • (A total of 20 jars related to Apache CXF)

Remove default Email Library Reference from Lib

  1. Navigate to <TomEE_Home>\lib.
  2. Remove the following two jars from the lib directory.

    Remove jars from the lib directory

Download IBSS WAR

Download IBSS.war build from pre informed directory.

Deploy IBSS To TOMEE

  1. Stop the TomEE server if running.
  2. Delete the IBSS.war and IBSS folder under \webapps directory in Tomee Installation Folder.
  3. Copy the new WAR to the \webapps folder in TomEE installation folder.
  4. Start the TomEE server tomee\bin\startup.bat.
  5. The WAR will be extracted to the IBSS Folder under webapps
  6. IBSS can be accessed from the URL: http://localhost:8080/IBSS/index.jsp