All of my development work lately has been using Oracle databases. My development tool of choice for interacting with the databases is Oracle SQL Developer. It is the sole reason I have Java installed on my laptop.
I was disconcerted to find out that after my upgrade to Ubuntu 7.10 (Gutsy Gibbon) that I wasn’t able to use SQL Developer successfully. Issues Included:
- Windows not appearing correctly;
- I was unable to type into text fields;
- Oddly I could paste into text fields, but couldn’t type into them; or
- Buttons appear to be inactive, you could click on them but nothing would happen.
It turns out that there is a known issue with the Java and the Compiz / Beryl window systems. The bug is outlined in this bug report on the Sun Developer Network website. Unfortunately the bug is marked as closed, and yet there are multitple calls to re-open it again and there are numerous posts around about this issue already.
Compiz is the system that the Ubuntu 7.10 uses to provide the nice eye candy for windows and the user interface in general. Although some of it, like the wobbly windows, can be a bit much after a while. These screenshots give you some idea of what Compiz can do, including the one feature that everyone seems to know about, having multiple desktops on a rotating cube.
The way I fixed my problem is to add this line to the sqldeveloper.sh as the second line in the file.
export AWT_TOOLKIT="MToolKit"
or
export AWT_TOOLKIT="MToolkit"
See the comment from devnull below.
There are reports that this can fix other Java based applications, and there are also reports that this doesn’t work at all so YMMV.
It is also possible to export this variable as a global environment variable. However I’ll not detail that here as I’ve not tried it, I have only one Java application on my system.
Perhaps it will work for you as well.






November 29, 2007 at 11:18 pm
I use the AMD64 distribution of Gutsy and I find that SQL Developer also needs the 32-bit Java 1.5 runtime environment to run properly, so I also have to run:
update-java-alternatives -s ia32-java-1.5.0-sun
November 30, 2007 at 7:31 am
@ratchet,
Thanks for the comment. I’ve never used a 64bit OS and so hadn’t come across that issue.
I trust your tip will prove useful to others.
April 15, 2008 at 12:37 am
I’ve rolled an Ubuntu package for SQL Developer; see http://blog.kizoom.com/2008/04/packaging-oracle-sql-developer-for.html
I’d be interested in knowing how this works for you. Might it be worth trying to incorporate the various changes and dependencies required to make it work on your individual machines a single package?
April 15, 2008 at 8:36 am
@Robin,
Packaging SQL Developer up is an excellent idea. Unfortunately in recent months I’ve moved to projects that don’t use Oracle, currently using MySQL and its native tools, so I’ve not had SQL Developer on my machine for a while now.
If I ever need it though, I’ll definitely look into using your package.
August 12, 2008 at 10:43 pm
lowercase k in Toolkit
use export AWT_TOOLKIT=MToolkit