Skip to Content

Java on Jitterbit private agents

Introduction

The private agent Tomcat server uses version 8 (1.8) of the OpenJDK Java Runtime Environment (JRE). This is provided by the agent installation package.

You can use an alternative JRE, but Jitterbit supports only the bundled one.

This page shows you how to do the following:

Change the default JRE

The provided JRE is in JITTERBIT_HOME/jre. To use an alternative, follow these steps:

  1. Install your JRE.

  2. Set the JRE_HOME environment variable. How you do this depends on the private agent's platform type:

    In /etc/sysconfig/jitterbit, set JRE_HOME to the full path of your JRE.

    Add a system environment variable JRE_HOME. Set its value to the full path of your JRE.

  3. Restart the private agent.

Manage Java KeyStores

The host-based Jitterbit applications (private agents, Design Studio, and Data Loader) use a trusted Java KeyStore file, JITTERBIT_HOME/jre/lib/security/cacerts, for secure communications. By default, all certificates are accepted. To manage the keystore, use the keytool command, as shown in the following example commands (where JITTERBIT_HOME is the private agent installation location):

  • List the KeyStore's certificates:

    $JRE_HOME/bin/keytool -list \
-keystore JITTERBIT_HOME/jre/lib/security/cacerts

    Tip

    The default password is changeit.

  • Validate certificates:

    jitterbit-utils --verify-proxy-cert

    JitterbitUtils --verify-proxy-cert

  • Change the default KeyStore password to PASSWORD:

    $JRE_HOME/bin/keytool -storepasswd PASSWORD \
-keystore JITTERBIT_HOME/jre/lib/security/cacerts

  • Add certificates from CERT_FILE:

    $JRE_HOME/bin/keytool -importcert -trustcacerts \
-alias ALIAS -file CERT_FILE \
-keystore JITTERBIT_HOME/jre/lib/security/cacerts

Tomcat heap memory

To set the Tomcat server's heap memory, follow these steps:

  1. Set the JAVA_OPTS environment variable. How you do this depends on the private agent's platform type:

    In /etc/sysconfig/jitterbit, set JAVA_OPTS to the desired minimum and maximum heap memory sizes using the Java command line options -Xms and -Xmx. In the following example, the minimum size is 512 MB, and the maximum is 2048 MB:

    Example
    export JAVA_OPTS="-Xms512m -Xmx2048m"

    1. Open the Registry Editor and find the following key:

      HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Apache Software Foundation\Procrun 2.0\Jitterbit Tomcat Server\Parameters\Java

    2. Open the Options subkey.

    3. In the Value data field, change the Java options for -Xms and -Xmx.
    4. Click Ok.

  2. Restart the agent.