Troubleshooting

Error reporting

Internal errors typically leave messages of the form

java.lang.NullPointerException

at pmclass.applications.pmgateway.PMgatewayDefaults.getConvertionSettings(PMgatewayDefaults.java:143)
at pmclass.applications.pmgateway.PMgatewayFrame.convert(PMgatewayFrame.java:854)
at pmclass.applications.pmgateway.PMgatewayFrame.run(PMgatewayFrame.java:911)
at java.lang.Thread.run(Thread.java:484)

in the command window.

To allow PMOD Technologies tracking the problem please open a support call as described above.

License Errors

Some of the most likely license errors are:

• If the license file has not been copied to the right directory, you will see a message
  
  Please copy pstarter.lcs to Pmod3.3/properties/system/lcs
• If the license file has been modified somehow, you will see a message
  License Error. Invalid license file (2)
  Please try to extract pstarter.lcs again from your e-mail without any modifications.
• If the USB key cannot be read because it is not connected or because the driver installation is not up to date, you will see an error message Hardware license key not accessible with additional details.
  Please make sure that the USB key is connected and the installation was done as described. The installation may have to be repeated after an operating system upgrade.
• In order to be able to run PMOD with the USB key, the JNI must be found during startup. To this end the environment variable LD_LIBRARY_PATH must contain the path /usr/lib. The most appropriate location to define it would be in a global definition file, eg /etc/csh.cshrc. If not already defined so, add
  setenv LD_LIBRARY_PATH /usr/lib

Generation of Quicktime Movies fails

In some installation the generation of Quicktime movies fails because of library problems. It is therefore recommended to install the Java Media Framework (JMF) which can be downloaded from:
http://java.sun.com/products/java-media/jmf/2.1.1/download.html

Reading of Compressed DICOM images fails

In some installation the reading of compressed DICOM data fails because of library problems. It is therefore recommended to install the Java Advanced Image I/O Tools which can be downloaded from:
https://jai-imageio.dev.java.net/binary-builds.html

Additional Solutions

For checking additional solutions please consult the Q&A area of the PMOD website.