Cycle on TomEE

Create a new instance of server by changing the port numbers in server.xml file to avoid conflicts with other instances if any.

The shared folder should be created with two folders namely conf and lib where the necessary configuration files required for running the OIPA application will be placed.

The conf folder should be placed with config and properties files required for Cycle application namely, cycle-coherence-cache-config.xml, cycle-coherence-config.xml, logging.properties, Cycle.properties

The lib folder should be populated with all the necessary third party jars like

  1. jakarta.persistence-2.2.3.jar
  2. spring-instrument-5.2.9.RELEASE.jar
  3. javax.persistence-2.1.1.jar
  4. Download aspectj 1.8.10.jar from http://www.eclipse.org/downloads/download.php?file=/tools/aspectj/aspectj-1.8.10.jar  
    1. Open aspectj-1.8.10.jar with an unzipping software and retrieve aspectjrt.jar and aspectjweaver.jar from the lib folder.

    2. Copy aspectjrt.jar and aspectjweaver.jar into libs sub-directory.

  5. Download log4j-1.2.17.jar from https://archive.apache.org/dist/logging/log4j/1.2.17/log4j-1.2.17.jar and copy it to libs sub-directory and rename as log4j.jar.
  6. Copy the database drivers of your database into this directory.
    1. Oracle – The necessary driver, ojdbc8-12.2.0.1.jar, is included in the libs directory of the OIPA Media Pack.

    2. Microsoft SQL Server – download the sqljdbc4.jar library version 4.0  from https://mvnrepository.com/artifact/com.microsoft.sqlserver/sqljdbc4/4.0

    3. IBM DB2 – The necessary .jar files (db2jcc4  ) are included with the purchase of the DB2 software. These files are not available for download. Contact your IT department if you need assistance locating these files.
    4. Use a text editor to open the Cycle.properties file that you just copied to the server. The Cycle.properties file contains properties for Oracle, SQL Server and DB2 database types, with the Oracle settings active by default. The inactive settings are commented out with a '#' character at the start of each line. To change a setting, remove the '#' from the required property setting, and insert it at the beginning of the setting you want to de-activate.
    5. The properties setting must match the type of database being used. Note: Refer to the System Properties document in the Oracle Insurance Policy Administration E62439-01 Documentation Library on the OTN for a complete list of all properties and allowed values.
      1. application.databaseType
      2. jpa.databasePlatform

    6. Identify the default locale in the Cycle.properties file. The locale selected will determine the translation that is loaded in the database for Cycle when it launches.

      1. application.defaultLocale

    7. If using an Oracle or Microsoft SQL Server database, please skip this step. If using a DB2 database, you will need to modify the Cycle.properties file to include configuration for case-insensitive searching.

    8. Use a text editor to open the logging.properties file that you just copied to the server. Edit the path mention for property "java.util.logging.FileHandler.pattern" with new application log location i.e. if application log location is /home/OIPA/logs then set this value as java.util.logging.FileHandler.pattern = %h/Cycle/logs/oipa%u.log. Also same time make sure that directory is created and has r/w permission.

setenv configuration

For Windows deployment we need to create setenv.bat file in the bin folder of extracted TomEE directory.

For Linux deployment we need to create setenv.sh file in the bin folder of extracted TomEE directory.

The following configuration needs to be placed in the setenv.bat file for Windows environment

set CATALINA_OPTS=-Xms128m -Xmx1024m -XX:+UseG1GC

-Dtangosol.coherence.cacheconfig=C:/Servers/TomEE/OIPAInstance/shared/conf/cycle-coherence-cache-config.xml

-Dtangosol.pof.config=com-adminserver-pas-web-pof-config.xml

-Dtangosol.coherence.override=C:/Servers/TomEE/OIPAInstance/shared/conf/cycle-coherence-cache-config.xml

-Dtangosol.coherence.distributed.localstorage=true

For Linux env in setenv.sh

export CATALINA_OPTS=-Xms128m -Xmx1024m -XX:+UseG1GC

-Dtangosol.coherence.cacheconfig=/Servers/TomEE/OIPAInstance/shared/conf/cycle-coherence-cache-config.xml

-Dtangosol.pof.config=com-adminserver-pas-web-pof-config.xml

-Dtangosol.coherence.override=/Servers/TomEE/OIPAInstance/shared/conf/cycle-coherence-cache-config.xml

-Dtangosol.coherence.distributed.localstorage=true