EPIC client system requirements

This section describes the system requirements for running the EPIC client.

Proxy server support

EPIC synchronization can be run through a proxy server. The following table summarizes deployments known to be successful in the lab or field:

Proxy Server Working Deployment
Apache 2.2.3 xMatters Test Lab
Blue Coat 5 Field (production)
NTLM xMatters Test Lab

Java 8

Before running the EPIC client, Java version or 8 must be installed and added to the system path. The location of the Java Development Kit (JDK) or Java Runtime Environment (JRE) must be defined by the JAVA_HOME system variable or included directly on the system PATH.

Other tools (such as Pentaho ETL) may have their own Java requirements. Before running these tools on the same system as the EPIC client, verify that they use a compatible version of Java.

Versions of the EPIC client prior to 5.5.77 are not compatible with Java 8. If you are running an older version of the EPIC client you must upgrade it and install Java 8. For more information about upgrading your EPIC client, see Upgrading the EPIC client from a previous version.

You can download and install Java from http://www.oracle.com.

System memory

The EPIC client validates data in-memory before it begins the data synchronization process. The amount of memory required to perform this validation depends on the amount of data that is being synchronized to xMatters. The EPIC client requires four Megabytes of memory to validate one Megabyte of uncompressed data. (This ratio is approximate and depends on the properties of the uncompressed data.)

To calculate the amount of memory that EPIC requires, multiply the size of the uncompressed (unzipped) data by four.  To do this for ZipSync mode, unzip the ZipSync input file, calculate the total size of the CSV files, and multiply this value by four. For example, if your ZipSync input file is 6.6 Megabytes, and the combined size of the unzipped CSV files is 78.5 Megabytes, the EPIC client requires approximately 314 Megabytes of RAM.

The EPIC client sets the Java Virtual Machine (JVM) to use a maximum of 800 Megabytes of memory. If this limit is exceeded, or if your system runs out of memory, the EPIC client fails and your data is not synchronized to xMatters. If required, you can increase the amount of memory that is available to the JVM. To do this, edit the epic file (Mac/Linux) or epic.bat file (Windows) and modify the value of DEFAULT_JVM_OPTS. For more information about configuring JVM memory usage, refer to the Java documentation.