Skip to main content

Issue Reporting

Issue Reporting

When an issue is reported pertaining to JavaPOS, the following pieces of information are required in addition to the description of the problem.

Information Required

  • Description of the issue
  • Log files from POS system
  • Is the issue reproducible in the field?
    • If yes, what are the steps to reproduce the issue?
    • If yes, change logging level to trace and provide log file with reproduced issue
  • A list of steps taken to diagnose the issue.
  • A description of the affected hardware.
  • Was the system working previously?
    • If yes, what changed? (E.g. hardware, JavaPOS version, OS Version, etc...)

Essential Information

Operating System and Version

It is important to know which version of an operating system JavaPOS is being run on. For example: Windows 11, or Ubuntu 18.04. Specific version information can be helpful in troubleshooting the JavaPOS API.

Version of JavaPOS

Determine the version of the JavaPOS API being used. This information can be obtained from the beginning of the log file or by launching the JavaPOSTest application and observing the title bar.

Version of Java

Determine the version of the Java Virtual Machine (JVM) that the JavaPOS API is being run with. Determine whether the JVM is the Oracle or OpenJVM version. This version of the JVM can be determined by executing java –version in a command prompt.