This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant previous version.

Confluence Unix and X11 Dependencies

Confluence 2.8 Documentation

Index

Java X11 Dependencies

On Unix-based operating systems, the Java runtime makes use of certain parts of the platform's native X11 graphics libraries. The X Server does not have to be running, but the libraries must be available on the server. Confluence will run on a server that does not have Xlib installed, but parts of the application that manipulate graphics: PDF exports, image thumbnailing, the image gallery macro, CAPTCHA, and the resizing of profile pictures, will fail.

Mac OS X
You do not need to install X11 on Mac OS X, as it has its own graphics libraries.

If X11 is not present, you may see any of the following errors

  • "This Confluence installation can not generate thumbnails: no image support in Java runtime"
  • "Exception in thread "main" java.lang.UnsatisfiedLinkError: /usr/local/j2sdk1.4.2_09/jre/lib/i386/libawt.so: libXp.so.6: cannot open shared object file: No such file or directory" when exporting a PDF
  • "NoClassDefFoundError" when uploading a profile picture
If This Doesn't Help
If you have X11 installed and thumbnailing still does not work, please ensure that you are running Java in headless mode — see the FAQ entitled Fix 'Error using thumbnails - No image support in Java runtime'.

Specific Installation Instructions

Fedora Core

On Fedora Core, you will need to install the xorg-x11-deprecated-libs package. (https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=130239)

Fedora Core 6, RHEL 5
  • libXp
  • libXp-devel (if you wish to compile against this library)
Debian Linux

On Debian, you will need to instll the following packages (CONF-6411):

apt-get install libx11-6 libx11-dev libxt6 libxt6-dbg libxext6 libxtst-dev libxtst6 xlibs-dbg xlibs-dev

You'll only need the xlibs-dbg package if you're running an older version of Debian (3.0). It's a dummy package for smoothing the transition to a new set of graphics libraries, so if you can't locate it, you most likely don't need it.

Gentoo Linux

emerge libICE libSM libX11 libXext libXp libXt libXtst

Solaris 10

Please refer to the following forum for more information.

Ubuntu

Execute the following:

> sudo apt-get install libx11-6 libx11-dev libxt6 libxt6-dbg libxext6 libxtst-dev libxtst6 xlibs-dbg xlibs-dev

Note: 'sudo' enables you to be superuser for one operation. You will need to supply your user password.

Labels

 
  1. Mar 14

    Anonymous says:

    Any thoughts on non RH Linux?  Like Suse 10.X?

    Any thoughts on non RH Linux?  Like Suse 10.X?

  2. Mar 17

    Anonymous says:

    How about FreeBSD?

    How about FreeBSD?

    1. Apr 02

      Mei Yan Chan says:

      Hi, We haven't got specific information relating to the questions above but you...

      Hi,

      We haven't got specific information relating to the questions above but you may try checking out this link:

      Alternatively, please try our forum or mailing list for further assistance:

      Regards,
      Mei

  3. May 15

    Anonymous says:

    I tried this on ubuntu 8.04 server. root@usalwiki:# sudo i Password: root@us...

    I tried this on ubuntu 8.04 server.

    root@usalwiki:~# sudo -i
    Password: 
    root@usalwiki:~# apt-get install xlibs-dbg
    Reading package lists... Done
    Building dependency tree
    Reading state information... Done
    E: Couldn't find package xlibs-dbg

    have not figured out if this is going to cause trouble. But...

    1. Jun 03

      Tony Cheah Tong Nyee says:

      Hi there, It should be fine to exclude the {{xlibsdbg}} library. Hence, give a ...

      Hi there,

      It should be fine to exclude the xlibs-dbg library. Hence, give a try to exclude the xlibs-dbg and proceed to install other xlibs libraries. Please let us know if it works.

      Cheers,
      Tony

  4. May 29

    Anonymous says:

    Can confluence be hosted on Amazon ec2 environment? An AMI to install and run?

    Can confluence be hosted on Amazon ec2 environment? An AMI to install and run?

    1. Jul 01

      Azwandi Mohd Aris says:

      Hi there, I afraid that Confluence has not been tested on that platform. You ma...

      Hi there,

      I afraid that Confluence has not been tested on that platform. You may want to give a try on that, and perhaps share the outcome with us. Also, please take a look at the following page for information on tested/untested application servers:

      Cheers,
      Azwandi

Add Comment