Including all the relevant information when you report a problem with Charon-PAR will facilitate the problem solution.
Please note: log files may contain sensitive information. It is the responsibility of the user to verify that the information may be shared with Stromasys support according to the regulations of the user's organization.
To include the most important information, perform the following steps described in the following sections:
Running charon-report
The charon-report tool (/opt/charon/bin/charon-report) collects important information about the Charon-PAR installation and the environment in which Charon-PAR runs. For example, it includes the host operating system version, a list of installed packages, the output of lscpu, lshw, lspci, lsusb, and dmesg, and the networking configuration.
The tool has several parameters to influence its behavior:
| Parameter | Description |
|---|---|
-h--help | Displays a short help text and a summary of the available parameters. |
-c--crash-report | Utility runs in non-interactive mode. Reports are stored in /opt/charon/reports. Without this parameter, the utility will prompt you for a short description of the problem and store the report in /tmp. |
-f PATH [PATH ...] --add-file PATH [PATH ...] | File/directory to include in report. Can be used multiple times. May contain wildcards for files/directory selection. If empty, the Charon config and log directories (/opt/charon/cfg, /opt/charon/log) will be included in the report. Important parameter to include the correct directories containing the relevant emulator configuration and log files. Please do not include vdisk or vtape container files in the report. Upload them separately if advised to do so by Stromasys support. |
| Send report on email. Default address: support@stromasys.com. It is strongly recommended to review the content of the produced report before sending it via email to make sure the content of the report can be shared externally without violating company regulations. |
| Email address to send report. Can be used multiple times. |
Collecting Additional Information
In addition to the data collected by the charon-report utility, prepare the following information:
- The Charon-PAR configuration file used and the log files showing the problem.
- A detailed problem description.
- Detailed instructions on how to reproduce the problem.
Providing the Collected Data to Stromasys Support
The data can be provided to Stromasys support via email or via an upload to a location provided by Stromasys support.
Please note: log files may contain sensitive information. It is the responsibility of the user to verify that the information may be shared with Stromasys support according to the regulations of the user's organization.