Configure a DataSource application’s JVM

To configure the Java virtual machine (JVM) for a C-based DataSource application, or for a Java module within the application, use the appropriate dfw commands and then set up any additional configuration items as defined on the Java (JVM) configuration reference page.

Configuring a Java DataSource’s JVM

The Deployment Framework starts a Java DataSource application by using the start-jar.sh script packaged with the Java DataSource.

The start-jar.sh script requires the java command to be in the executable PATH. The Deployment Framework will log a warning to the console if it cannot find a valid java command.

To pass configuration options to the JVM used to run a Java DataSource application, edit the application’s start-jar.sh script and change the parameters passed to the java command used to run the application. For an example, see Configuring a Java DataSource’s JVM heap.

Configuring a C DataSource’s embedded JVM

The functionality of a C DataSource application can be extended with Java modules hosted in an embedded JVM. Examples of Java modules include Transformer’s Refiner module and the JMX monitoring modules of both Liberator and Transformer.

A C DataSource application loads an embedded JVM when the application’s jvm-location configuration item is set to the location of a JVM library. Deployment kits for Java modules set their host application’s jvm-location to the Deployment Framework macro JVM_LOCATION:

jvm-location       "${JVM_LOCATION}"

The Deployment Framework automatically derives the value of the JVM_LOCATION macro from the JAVA_HOME environment variable. If the Deployment Framework fails to correctly derive a value for JVM_LOCATION, you can set it explicitly using the Deployment Framework command dfw java.

To configure a C DataSource application’s embedded JVM, follow the steps below:

  1. Ensure that the correct version of Oracle Java is installed and that the Caplin Deployment Framework can detect it. For more information, see Installing the Deployment Framework and Installing Java.

  2. Add or edit Embedded JVM configuration items in the appropriate file:

    Task Configuration file location

    Developing a C-based adapter blade

    The blade’s DataSource/etc/java.conf file

    Configuring an existing C-based adapter blade

    The Deployment Framework’s global_config/overrides/<blade-name>/DataSource/java.conf file

    Developing a Liberator Permissioning Service blade

    The blade’s Liberator/etc/java.conf file

    Configuring a Liberator Permissioning Service blade

    The Deployment Framework’s global_config/overrides/<blade-name>/Liberator/etc/java.conf file

    Developing a Transformer Service blade

    The blade’s Transformer/etc/java.conf file

    Configuring an existing Transformer Service blade

    The Deployment Framework’s global_config/overrides/<blade-name>/Transformer/etc/java.conf file


See also: