Common issues and how to fix them.
Installation and Upgrade Issues
These issues can occur when first installing or upgrading from an earlier version of Theme Builder. You may also like to refer to the section on Licensing Issues.
A 'max_allowed_packet' error occurs when installing or upgrading
If you're using MySQL database, you may encounter the following issue:
java.lang.RuntimeException: There was a problem evicting or flushing a PluginData object
at com.atlassian.confluence.plugin.persistence.hibernate.HibernatePluginDataDao.saveOrUpdate(HibernatePluginDataDao.java:65)
caused by: net.sf.hibernate.exception.GenericJDBCException: could not insert: com.atlassian.confluence.plugin.persistence.PluginData#3375106
at net.sf.hibernate.exception.ErrorCodeConverter.handledNonSpecificException(ErrorCodeConverter.java:90)
caused by: com.mysql.jdbc.PacketTooBigException: Packet for query is too large (3063507 > 1048576). You can change this value on the server by setting the max_allowed_packet' variable.
at com.mysql.jdbc.MysqlIO.send(MysqlIO.java:2691)
To resolve this issue, simply increase the max_allowed_packet setting in your MySQL config to 4M using the command line shell as follows:
shell> mysql --max_allowed_packet=4M
See also: PacketTooBigException.
TypeError: exception is undefined (MySQL specific)
Licensing Issues
The following issues are related to plugin licensing.
"Invalid License" or "Not Licensed" appearing...
I have a community/personal licensed Confluence wiki but the plugin is requesting a license
The plugin will automatically run in FREE mode on personal, developer or community licensed confluence installs, however you do need to accept the EULA.
You should visit the license details screen and accept the EULA before attempting to use the plugin.
Note: See our Licensing FAQ for some other possible causes of this issue.