Error: F_JT0E0E: LZ4 Decompress Error: ERROR_decompressionFailed

Issue

Integrate fails with the following error:

F_JT0E0E: LZ4 decompress error: ERROR_decompressionFailed.

Environment

HVR 5

Resolution

This error indicates that the Integrate job could not uncompress (decompress) HVR's router (TX) files. This may occur when we cannot read the files, possibly because they are corrupted.

You must skip the corrupted transaction router files to resolve this issue with minimal data loss. Do the following:

1. In the HVR GUI, edit the Integrate action for the applicable channel and define the parameter CycleByteLimit=1.
2. Initialize HVR with "Jobs" to take effect and wait for the above error to appear.
3. When the error appears, use the command line to change directory to $HVR_HOME/bin.
4. Run hvrrouterview command on the oldest router file (available in the $HRV_CONFIG/router/hvrhub/channel/loc_source/loc_target/ directory) and print the output into a file. For example, if your oldest router file is t6078ab40_w6078ab40_zRsfn.tx_snow then run the following command,

hvrrouterview myhub mychn $HRV_CONFIG/router/myhub/mychn/loc_mysource/loc_mytarget/t6078ab40_w6078ab40_zRsfn.tx_snow > D:\temp\t6078ab40_w6078ab40_zRsfn.tx_snow.output

5. If the router file is corrupted, the command will output the LZ4 decompress error. Repeat step 4 on the next-oldest file until the hvrrouterview command runs without an error and successfully prints the output into a file.
6. Locate the output file's capture timestamp and table name in the output file.
7. In the capture log, locate the transaction (and associated table) that occurred before the successfully processed router file.

   NOTE: You will need to refresh this table after you have successfully skipped the corrupted router file.

8. With Integrate suspended, delete the corrupted router file(s).

   NOTE: If you saved the router file to a different location as a precaution, and the Integrate job continues to provide an error with the same file size, your operating system may be redirecting Integrate to the backed-up router file. Either delete the file or save it elsewhere and delete it on the OS.

9. Re-Initialize with Jobs, State Tables, and Change Tables.
10. Start Integrate.

Once you have followed the steps above and successfully circumvented the corrupted files, do the following:

11. Remove the CycleByteLimit=1 parameter that was added to the Integrate action in step 1.
12. When Integrate is caught up, refresh the table that you skipped at step 8.