Skip to main content Skip to complementary content

Collecting context information about a Remote Engine issue

Use a Remote Engine specific script, talend-re-helper.sh or talend-re-helper.bat, to collect context information about the issues you encountered.

You can then use this information yourself or send it to the Talend Support team for engine troubleshooting.

Only the information stored under the <RemoteEngineInstallation> folder and its sub-folders is collected. If you have configured your Remote Engine to place some working files outside the <RemoteEngineInstallation> folder, these files cannot be collected.

Only a Remote Engine from v2.10.7 and onwards supports this script.

Procedure

  1. In your command-line terminal, go to the <RemoteEngineInstallation>/scripts folder.
  2. Run talend-re-helper.sh or talend-re-helper.bat.

    Example

    If you need help information about this script, run the script with the help parameter, for example:
    ./talend-re-helper.sh --help
    You can run this script with your engine on or off. The engine is required to be on only when you need to collect the dump files about the engine container state.

Results

This script generates an archive in the current directory with the following folders or files collected from your Remote engine machine:
  • Folders:
    /etc
/TalendJobServersFiles/jobexecutions/logs
/data/log
/data/job
/instances
  • Files:
    /karaf.pid
/version.txt
/system.txt
/TalendJobServersFiles.archiveJobs.csv
/TalendJobServersFiles.repository.csv
/lock.csv
/data.m2.csv
/data.filebuffer.csv
    • This system.txt stores the global information about Java and the system.
    • The CSV files list all the files added to this archive along with the metadata of these files, such as their paths in the Remote Engine machine, their owners and creation times.
  • Zips of dump files about the state of an engine container, such as its environment configuration and memory information. For example, a dump zip of this kind could be dump-2021-10-08_09-35-29.zip.

    If you need to collect the dump files, your engine must be up and running when you run this script.

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – let us know how we can improve!

Leave your feedback here