Documentation‎ > ‎

Troubleshooting

Installing license in .lic or .licenses format

1. A valid license is installed, but JExcel does not load displaying the message "JExcel license not found."
Cause: The license file is not installed in the same directory with the native code library or its name is incorrect. The license file should be named jexplorer.lic and located in the same directory as the JNIWrapper native library (jniwrap.dll on Win32 or libjniwrap.so on Linux). If any of these conditions is not met JNIWrapper will be unable to find the license file.

Solution: Make sure that the license file is named and placed properly.

2. A valid license jexcel.lic is installed, but JExcel does not load displaying the message "JNIWrapper license not found."
Cause: The JNIWrapper license file is not installed in the same directory with the native code library or its name is incorrect.

Solution: Make sure that the license file is named and placed properly.

3. JNIWrapper, ComfyJ and JExcel licenses are installed, but JExcel does not load displaying the message "JNIWrapper license not found. Checked licenses: [..\jexplorer.lic - not valid product]"
Cause: The jexcel.lic license file is not valid for the product that you use.

Solution: Make sure that you use the correct license for JExcel product.


Installing license in .jar format


If you can see the "JNIWrapper license check failed: No valid license found" or "JExcel license check failed: No valid license found" message, it is recommended to perform the following actions:

  1. Make sure that the proper license JAR is added to the class path of your application. Remove all the other licenses that may appear there.
  2. Run your Java application with the licence debug info enabled. The information about all found licences will be printed out to the Java console. In many cases this information will help to resolve the issue.

    There are a few ways to enable the debug information printing:
    1. Pass -Dteamdev.license.info=true as a VM argument when starting your Java application.
    2. Add System.setProperty("teamdev.license.info", "true"); call before creating any JExcel objects. The call will have no effect if performed after creating the very first object related to JExcel functionality. 
  3. Clean and rebuild your project. It is possible that there is an outdated licence cached somewhere.