Installation

Note: JDK11 does not have a fonts directory inside jdk/lib directory. Hence the fonts folder has been shipped in OIPA distribution.

For tomEE and weblogic environments, fonts folder has to be placed on jdk/libs folder at OS level, i.e. /usr/java/jdk-11.0.11/lib.

For Liberty environment, fonts folder has to be placed in jdk/libs folder inside liberty environment, i.e. /scratch/oipa/IBM/WebSphere/Liberty/java/11.0/jdk-11.0.11+9/lib.

Directory Structure

Two directories must be created: one to store the templates and one for the generated documents. Each of these directories must be accessible by the application server and OIPA instance. In the example below, the Documents directory is used to store the document templates, while the GeneratedDocuments directory is used to store the generated documents.

Example:

document.documentPath=/opt/Oracle/OIPA/Documents

document.generatedDocumentRootPath=/opt/Oracle/OIPA/GeneratedDocuments

Required Libraries

OIPA expects crystal runtime libraries for Document Generator functionality. Below listed libraries from crjava-runtime_12.2.219.zip must be placed in the class loader of the application server. Each of these files is included with Crystal Reports and not included with OIPA.

commons-collections-3.1.jar	commons-configuration-1.2.jar	commons-logging.jar	commons-lang-2.1.jar
CrystalCommon2.jar	CrystalReportsRuntime.jar	DatabaseConnectors.jar	log4j.jar
logging.jar	icu4j.jar	JDBInterface.jar	keycodeDecoder.jar

Configuration Files

The CRConfig.xml configuration file is required for Crystal Reports and is included within the OIPA.war file.

OIPA Properties File

The OIPA configuration file, PAS.properties and Cycle.properties for cycle web, must be modified to include the necessary configuration. For additional information on the PAS.properties file, refer to the System Properties document available in the current release Documentation Library under Policy Administration Libraries of Oracle Help Center.

Properties	Description
document.crystalConnectionCount	Maximum concurrent connections
document.documentPath	The path of the document template directory
document.generatedDocumentRootPath	The path of the directory used to store generated documents.
document.documentGeneratorUrl	The address of the DocumentGenerator WSDL.

 

Example:

document.crystalConnectionCount=1

document.documentPath=/opt/Oracle/OIPA/Documents

document.generatedDocumentRootPath=/opt/Oracle/OIPA/GeneratedDocuments

document.documentGeneratorUrl=http://localhost:8080/PASJava/DocumentGenerator?wsdl