Skip to Content

Java on Jitterbit private agents

Introduction

The private agent comes with version 8 (1.8) of the OpenJDK Java Runtime Environment (JRE).

This page shows you how to do the following:

Change the default 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.

Important

While you may use an alternative JRE, Jitterbit supports only the version provided by the installation package.

Manage Java KeyStores

The host-based Jitterbit applications (private agents, Design Studio, and Data Loader) use a trusted Java KeyStore file for secure communications. The file's location is as follows:

/opt/jitterbit/jre/lib/security/cacerts

"C:\Program Files\Jitterbit Agent\jre\lib\security\cacerts"

By default, all certificates are accepted. To manage the keystore, use the keytool command, as shown in the following example commands.

List the KeyStore's certificates

Use the following command to list the keystore certificates (the default password for the keystore is changeit):

/opt/jitterbit/jre/bin/keytool -list -keystore /opt/jitterbit/jre/lib/security/cacerts

"C:\Program Files\Jitterbit Agent\jre\bin\keytool.exe" -list -keystore "C:\Program Files\Jitterbit Agent\jre\lib\security\cacerts"

Change the KeyStore password

Use the following command to change the keystore password (the default password for the keystore is changeit):

/opt/jitterbit/jre/bin/keytool -storepasswd -keystore /opt/jitterbit/jre/lib/security/cacerts

"C:\Program Files\Jitterbit Agent\jre\bin\keytool.exe" -storepasswd -keystore "C:\Program Files\Jitterbit Agent\jre\lib\security\cacerts"

Add certificates

Use the following command to add certificates (in the file CERT_FILE) to the keystore file:

/opt/jitterbit/jre/bin/keytool -importcert -trustcacerts -alias ALIAS -file CERT_FILE -keystore /opt/jitterbit/jre/lib/security/cacerts

"C:\Program Files\Jitterbit Agent\jre\bin\keytool.exe" -importcert -trustcacerts -alias ALIAS -file CERT_FILE -keystore "C:\Program Files\Jitterbit Agent\jre\lib\security\cacerts"

Validate certificates

To validate individual certificates, use the following command:

jitterbit-utils --verify-proxy-cert

JitterbitUtils.exe --verify-proxy-cert

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.