journals-merger

The journals-merger tool is designed to merge two Ember Journals into a single journal.

journals-merger relies on the EMBER_HOME environment variable to specify one of the journals to be merged. After tool work is finished, this journal will be named as journal-backup in the same directory.

The second journal is specified via the -mergeWith argument. Usage example:

usage: journal-merger -mergeWith <arg>
 -mergeWith <arg>   The path of another journal to be merged with

The tool result is a journal located in the EMBER_HOME directory, which contains messages from both source journals merged together in the mostly ascending messages' timestamp order.

An example of the tool output is shown below:

2026-03-20 13:05:45.621 INFO [main] Backup of the Ember journal is stored in /path/to/home/journal_backup