Synchronize user data with EPIC

The  (Export Plus Import Controller) data synchronization utility is a command-line tool that allows you to automatically synchronize user data with xMatters.

You can use EPIC to synchronize xMatters with an external system, such as an LDAP database of employee names. This enables you to manage users in an external system and have them automatically updated in xMatters.

To use EPIC, you must have the appropriate licensing. For more information about your licensing options or to get started using EPIC, contact Customer Support.

EPIC versions

You must run a version of the EPIC client that works with your version of xMatters. Contact your xMatters representative to learn which version of the EPIC client to use with your system.

When you replace an older version of the EPIC client with a newer one, it is recommended that you edit the new configuration files instead of copying the old ones. The new configuration files may contain additional properties or set version information differently.

EPIC Modes

As of March 31, 2019, ZipSync is the only supported mode for synchronizing external system data with xMatters. We no longer support our previous CloudSync mode for synchronizing premises data with xMatters On-Demand.

ZipSync is our process for allowing you to create files from any system for the purpose of synchronizing data with our on demand system. ZipSync allows clients to export data from any system into a predefined format which is then zipped up and synchronized with xMatters On-Demand.

When there are several files queued for a given Company, only the most recent file will be processed at the time the EPIC batch job is run (the other files are ignored).

ZipSync mode: External System data to xMatters On-Demand

EPIC ZipSync mode synchronizes data from external systems with xMatters On-Demand. Data is transmitted to xMatters securely over an HTTPS connection.

For example, an organization may want to synchronize data from its HR, LDAP, Active Directory, or other corporate system. In this run mode, data synchronization is done through CSV (comma-separated value) files.

To run ZipSync mode, you must first prepare and format your data. For details, see ZipSync mode CSV File Content.

Additionally, a manifest file allows synchronization options to be configured for the type of synchronization to perform, and which Device names to ignore (for details, see The manifest.xml file).