FreeMind on Linux

From FreeMind
Revision as of 12:53, 3 December 2007 by WouterBolsterlee (talk | contribs) (Remove most of the Debian notes, it's all very simple nowadays)
Jump to navigationJump to search
 

Installation (0.8.0)

FreeMind is a Java program, hence you need Java to make it work. There is the "Java runtime engine" (JRE or J2RE) required to run (use, start) FreeMind, and there is the "Java Development Kit" (JDK or J2DK) if you want to compile FreeMind (If you don't know what compile means, then you need only the JRE. In the following lines, I will concentrate on making FreeMind run and the JRE installation).

Once Java has been installed, only then does it make sense to install FreeMind. You can use packages (.deb or .rpm), which is a bit more work to setup but much easier to update, or you can use the more simple installation from a ZIP file (as described in the UN*X section).

Installation on Debian and Ubuntu

This description should be valid for any Debian based distribution, in particular (K)ubuntu. Since Freemind is in the main repositories, you can simply install it using your package manager (e.g. Synaptic), or alternatively type (as root):

# apt-get install freemind

That's it. You can not start Freemind from your applications menu, or run

# freemind

from a terminal window.


Installation on RPM-based systems

Starting with version 0.8.0 of FreeMind, I've started to orient my packaging work towards JPackage compatibility, so that the same packages should work for all distributions with JPackage's packages, especially SuSE 9.x and 10.x, Mandrake/Mandriva 10.x, as well as Fedora Core.

Install Java the JPackage way

FreeMind only works with Sun's or Blackdown's Java.

Taking the example of Sun's Java, there are three possibilities to install Java:

  1. It already does come with your distribution, fine, nothing to do, but make sure it's really Sun's Java by checking the output of java -version.
  2. Install java-1.4.2-sun-compat or java-1.5.0-sun-compat on top of Sun's JDK
  3. Download java-1.4.2-sun or java-1.5.0-sun, build them and install the created packages.

Install JavaHelp2 the JPackage way

If you want to install freemind-plugins-help, you'll need to install JavaHelp2. For licensing reasons, JavaHelp2 can't be redistributed by OpenSource distributions, hence you'll need to build the package yourself:

  1. download
  2. build
  3. and install the created RPM file.
Note
in the mean time, JavaHelp2 has been put under GPL by Sun and can be packaged and distributed in binary form, and there is such a package coming from JPackage, to be found on a JPackage mirror. Still, the state of this package is a bit unclear, e.g. I'm not sure it's part of a repository.

Install FreeMind with RPM, the stupid and easy way ;-)

Install Sun's or Blackdown's Java the JPackage way.

Install JavaHelp2 the JPackage way if you need freemind-plugins-help.

Download all the RPMs from the Files section (don't forget jcalendar and jgoodies-forms) in a directory. Install all these RPMs using the rpm command, e.g.:

# rpm -ivh freemind*.rpm jcalendar*.rpm jgoodies-forms*.rpm

For each missing dependency, go to the JPackage site, search and download the package(s) using the same kind of rpm command. Here is a list of dependencies:

  • freemind: jakarta-commons-lang, relaxngDatatype, msv-xsdlib, jgoodies-forms, xml-commons-apis, ws-jaxme, jakarta-commons-codec
  • freemind-plugins-svg: batik, rhino, xerces-j2, xml-commons-apis
  • freemind-plugins-help: javahelp2
  • freemind-plugins-time: jcalendar >= 1.2.2
Note
search for "msv" in order to find "msv-xsdlib". All the FreeMind RPM sources can be downloaded from [1].

Install FreeMind using apt4rpm

method tested with SuSE 10.1 - work in progress

$ wget http://linux01.gwdg.de/~scorot/install-apt4suse.rpm
(become root)
# rpm -Uvh install-apt4suse.rpm
  • call as root the install-apt4suse script (wait a while). Slightly unrelated: missing key has to be loaded usng rpm --import http://repos.opensuse.org/KDE:/Backports/SUSE_Linux_10.1/repodata/repomd.xml.key
  • add the required JPackage entries as described under http://jpackage.org/apt.php and linked pages. (one need to import the Jpackage GPG keys using rpm and gpg!)
  • add eric.lavar.de etc... and the rest same as below
  • apt-get update
  • download and build javahelp2: apt source javahelp2 + download from Sun, then install with rpm.
  • apt install freemind\*

method tested with SuSE 9.2

It sounds easy but actually the first step can be a bit tricky: you first need to setup apt4rpm, as described following the links given in this Jpackage Repository page. The good news is that always more distribution are coming standard with apt on board (if you are able to call apt-get as root, you already have it).

Add the JPackage repository to your /etc/apt/sources.list file as described in the same above page. Add also the two following lines (the 2nd one is optional, for sources) to the same file:

   rpm http://eric.lavar.de/comp/linux/rpm noarch java
   rpm-src http://eric.lavar.de/comp/linux/rpm noarch java

Then call as root the two following commands:

# apt-get update
# apt-get install freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-time

(it's more comfortable because, each time you call "apt-get upgrade", you'll get automatically the new freemind package)

Some additional notes:

  1. with the repository method, you can get as well the sources for the .rpm package using "apt-get source freemind[...]".
  2. of course, you're not obliged to install the different plugins.

Install FreeMind using urpmi

method tested with Mandriva 2006

Use Easy Urpmi to setup a first set of urpmi repositories. Then add the JPackage repositories. See JPackage Project Repositories for details, but in a nutshell:

# urpmi.addmedia jpackage-1.6-generic MIRROR/1.6/generic/free with hdlist.cz
# urpmi.addmedia jpackage-1.6-generic-non-free MIRROR/1.6/generic/non-free with hdlist.cz

Install Sun's or Blackdown's Java the JPackage way.

Install JavaHelp2 the JPackage way if you need freemind-plugins-help.

Add FreeMind's repository:

# urpmi.addmedia freemind http://eric.lavar.de/comp/linux/rpm/noarch/

And then install FreeMind and its plugins:

# urpmi freemind freemind-plugins-svg freemind-plugins-time freemind-plugins-help

The Gentoo installation

Install Java the Gentoo way

Basically, simply do the following:

# emerge -av virtual/jdk

See the Gentoo Java Guide for more information and further instructions.

Install FreeMind the Gentoo way

To ensure you are up-to-date in portage:

# emerge sync (or emerge-websync)

The latest version of FreeMind in Portage may be masked. To use this "unstable" version you may have to unmask the package.

To make sure you know what is going to install, use the --ask flag to emerge. Answer `yes' if you want to emerge dependencies:

# emerge --ask app-misc/freemind

On any UN*X kind of system (also Linux)

Install Java on UN*X

It doesn't really matter, just install some Java from Sun or Blackdown. Download the Java Runtime Environment (JRE) from Sun (Linux self-extracting file), called something like j2re-1_4_2_07-linux-i586.bin or jre-1_5_0_02-linux-i586.bin, or from Blackdown.

Before doing anything though, check to see if a usable Java is already on the system. Any Solaris (version 9 or newer) has one, for example.

Install FreeMind on UN*X

straight-forward installation method

Download the file called something like freemind-bin-max-0_8_0.zip (or freemind-bin-0_8_0.zip if you don't need the plugins), create somewhere a sub-directory and unpack there the file (as normal user or root, depending where you created the sub-directory):

$ unzip .../freemind-bin-max-0_8_0.zip
$ chmod +x freemind.sh

You're done, on any system where /bin/sh is a POSIX-compliant shell. That's true on most Linux systems, but not on Solaris. On Solaris, edit the first line of freemind.sh and change /bin/sh to /bin/bash. Now you're done.

more subtile installation method

Considering you're installing FreeMind locally, you should get root and do the following:

# mkdir -p /usr/local/share/freemind
# unzip freemind*.zip -d /usr/local/share/freemind
# chmod +x /usr/local/share/freemind/freemind.sh
# ln -s /usr/local/share/freemind/freemind.sh /usr/local/bin/freemind

This will copy the contents of the zip file to /usr/local/share/freemind and create a symbolic link to the FreeMind script in the /usr/local/bin directory.

The link to the script will only work if you unzip FreeMind in a directory for which freemind.sh is searching. You can however install FreeMind in any directory (e.g. in /opt/FreeMind) if in freemind.sh you replace

freepath=$(dirname "$0")
freepath="${freepath%/bin}" # nothing happens if freemind is not installed
                           # under something/bin

by

if [ ! -n "${freepath}" ]
then
   freepath=$(dirname "$0")
   freepath="${freepath%/bin}" # nothing happens if freemind is not installed
                           # under something/bin
fi

and then set $freepath in /etc/freemind/freemind.rc resp. ~/.freemind.freemindrc like this:

# settings for freemind
#
# path to the installation of freemind
freepath="/opt/freemind/"

Starting FreeMind

Installed from RPM or DEB package

Just type "freemind" in a console or an Alt+F2 command line, you're normally done. There should also be a menu entry under "Applications" in KDE and GNOME (under Debian, in any window manager).


Installed from ZIP file

You'll need to use a console, or the Alt+F2, or create your own menu entry, using one of the following commands:

       $ /some/directory/path/freemind.sh
  • if you've used the #more_subtile_installation_method, and assuming /usr/local/bin is in your PATH variable, you can use a simple freemind command, as if installed from a package.

Frequently and less frequently Asked Questions

FreeMind aborts with an 'xcb_xlib' error

When trying to start FreeMind, it aborts with an error as follows:

java: xcb_xlib.c:52: xcb_xlib_unlock: Assertion `c->xlib.lock' failed.

This is a known Java error and one possible solution is to set the following environment variable:

export LIBXCB_ALLOW_SLOPPY_LOCK=1

(helps on SuSE 10.3)

I can't paste branches copied from FreeMind into other applications

Try to use the middle mouse button to paste the content copied from FreeMind.

Under KDE, you can use klipper and set the option "Synchronize contents of the clipboard and the selection", so that you can also use Ctrl+V or Shift+Ins to paste.

I want to add an icon for my Link to FreeMind on my Desktop. Is there one?

The icon is compressed inside the freemind.jar file you can find in the FreeMind installation directory, e.g. /usr/(local/)share/freemind. Once the file located, use a command similar to:

$ unzip $FREEMIND_BASE_DIR/lib/freemind.jar \*/FreeMindWindowIcon.png -d /tmp

This will create a folder images in the tmp directory containing the FreeMindWindowIcon.png file - your icon!

When starting FreeMind, it says "java: command not found". What's wrong?

It's a problem from Fedora Core, Mandrake and the Java Sun RPM, which neither add the java command to the PATH nor defines properly the variable JAVA_HOME.

Add the following two lines to one of the startup scripts (/etc/profile and/or /etc/bash.bashrc for all users, or $HOME/.profile and/or $HOME/.bashrc only for you):

   export PATH=$PATH:/usr/java/j2re1.4.2_04/bin
   export JAVA_HOME=/usr/java/j2re1.4.2_04

(the part in italic depends on your installation)

Note
if you've installed FreeMind from a package, you can alternatively use the solution under #How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F.

Why do I get a "No print service found" whenever I attempt to print?

At least up to version 1.4, the java runtime under Linux is using the BSD printing system (also known as the lp commands, or old lp). Most modern distributions offer the CUPS printing system, which needs a compatibility layer to work with Java:

  • Under SuSE 8.2, the package required is called cups-client
  • Under Debian, it's called cupsys-bsd. Sun's Java 6 (package sun-java6) needs the package libcupsys2. I addition to this you got to have a ServerName line in /etc/cups/client.conf.

Install this package and you should be able to print from FreeMind.

If CUPS is not installed on your system, it is easier to install the traditional lpr/lpd system. On Debian, the package is just lpr, apt-get install lpr should be enough.

Sun's Java 1.5 supports CUPS out of the box. If, however, printing still doesn't work it may be because the CUPS printer names contain '-' characters. There's a Java bug that prevents this from working properly [2], and it doesn't seem fully fixed yet (build 1.5.0_06-b05). Work-arounds are:

  1. Rename printers, e.g. from "my-printer" to "myprinter".
  2. Network printer: Add a local CUPS network printer with a simple name without '-'s in it and use the CUPS URI reported by lpstat -v for the printer you want.
  3. After executing "$ls -l /usr/lib/libcups.so" if there exists a link as "/usr/lib/libcups.so -> libcups.so.2" , try with removing the link by hand.

Small test code to regenerate the error fast: DummyPrinter.java

import java.awt.print.PrinterJob;

class DummyPrinter {
   public static void main(String[] args) {
       try {
           PrinterJob printJob=PrinterJob.getPrinterJob();
           printJob.printDialog();
           System.exit(0);
       } catch( Exception e) {
           e.printStackTrace();
       }
   }
}


SuSE 10.2 & Ubuntu Feisty: A missing file /etc/cups/client.conf might confuse java and java detects no printer. Create /etc/cups/client.conf with the content "ServerName localhost" in this case.

I get an error java.lang.NoClassDefFoundError or java.lang.NullPointerException when starting FreeMind

When trying to start FreeMind from a console, you get the following error messages and FreeMind doesn't start:

./lib/freemind.jar 
java.lang.NoClassDefFoundError: javax/swing/JFrame 
at java.lang.ClassLoader.defineClass0 (ClassLoader.java) 
at java.lang.ClassLoader.defineClass (ClassLoader.java:179) 
at java.security.SecureClassLoader.defineClass (SecureClassLoader.java:33) 
at kaffe.lang.AppClassLoader$JarSource.findClass (AppClassLoader.java:143) 
at kaffe.lang.AppClassLoader.findClass (AppClassLoader.java:291) 
at java.lang.ClassLoader.loadClass (ClassLoader.java:142) 
at java.lang.ClassLoader.loadClass (ClassLoader.java:121) 
at kaffe.jar.ExecJarName.main (ExecJarName.java:55) 
at kaffe.jar.ExecJar.main (ExecJar.java:75)

or

update UI not overwritten in class: 
javax.swing.JLayeredPane[0,0,0x0,invalid,translucent,alignmentX=0.0,alignmentY=0.0,border=,
maximumSize=java.awt.Dimension[width=2147483647,height=2147483647],minimumSize=java.awt.Dimension
[width=0,height=0],preferredSize=java.awt.Dimension[width=0,height=0]] 
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:
                                           Tried to get view without being able to get map module. 
Exception during event dispatch: 
java.lang.NullPointerException 
at javax.swing.plaf.basic.BasicComboBoxEditor.setItem(java.lang.Object) (/usr/lib/libgcj.so.6.0.0) 

This is because you use kaffe (the same applies to libgcj, sablevm and a few others), which doesn't offer all features of Sun's Java. Blackdown's Java do es as well work, I would have doubts on any other implementation (beside perhaps IBM's one). So, remove this Java version and install a version from Sun or Blackdown.

Note
if you've installed FreeMind from a package, you can alternatively use the solution under #How_can_I_make_FreeMind_use_a_specific_Java_Virtual_Machine.3F.


While installing a FreeMind package, it complains Java isn't installed, though I've installed it and Java programs do work

You've probably installed Java manually, and not from an RPM resp. DEB package. This means that the FreeMind RPM resp. DEB package can't know that Java is installed.

Three solutions (from better to worse):

  • Install Java from an RPM or DEB package and retry to install the FreeMind package.
  • Install FreeMind using the ZIP file.
  • Install the FreeMind package by ignoring the missing dependencies, e.g.:
   # rpm -Uvh -nodeps freemind....noarch.rpm


While installing a FreeMind RPM package, it complains Java isn't installed, though I've installed it from an RPM package

You've probably installed the JDK package from Sun, which provides also a JRE but doesn't say it. Your best chance is to install the dummy package j2sdk-provides-j2re-1.4.2-2.noarch.rpm. The source package is available as well.


How can I make FreeMind use a specific Java Virtual Machine?

If you've installed FreeMind from a package, you can make it use a different Java virtual machines than other programs by adding lines similar to the 2 following ones to /etc/freemind/freemindrc, for all users, or to $HOME/.freemind/freemindrc, for you, so that only FreeMind is impacted (and no other program):

   export PATH=$PATH:/usr/java/j2re1.4.2_04/bin
   export JAVA_HOME=/usr/java/j2re1.4.2_04

(the part in italic depends on your installation)


Why doesn't the rebuild of the SRPM work under Fedora Core 2

During rebuild of the RPM, lines similar to the following do appear and the build fails:

compile:
   [mkdir] Created dir: /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes
   [javac] Compiling 92 source files to /usr/src/redhat/BUILD/freemind-0.7.1/bin/classes
   [javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:38:
                                                                    error: '{' expected.
   [javac]        };
   [javac]         ^
   [javac] /usr/src/redhat/BUILD/freemind-0.7.1/freemind/freemind/modes/MindMapLinkRegistry.java:40:
                                                                                  error:
Public interface `freemind.modes.ID_Blank' must be defined in a file called `ID_Blank.java'.
   [javac]        public interface ID_Blank extends ID_BasicState {};
   [javac]                         ^

The ant package delivered with Fedora Core 2 seems to be broken (version is 1.5.2, but my ant version is 1.5.1 and it works). Installing ant (and dependencies) from the JPackage Project seems to solve the problem.

Under Fedora Core 3, Java complains in libawt.so about missing libXp.so.6

The exact error message is:

Exception in thread "main" java.lang.UnsatisfiedLinkError:
/usr/lib/jre/lib/i386/libawt.so: libXp.so.6:
cannot open shared object file: No such file or directory

In this case install the package xorg-x11-deprecated-libs-6.8.1-12.i386.rpm, e.g. using yum, this should solve the problem.

FreeMind seems broken and I have the Gtk Look&Feel

We already had quite a lot of issues with the Gtk Look&Feel, sometimes in aspects nobody would have thought relevant to the Look&Feel (e.g. hangs on file system access). Hence we strongly recommend to change your Look&Feel to something else before even trying to pin down the issue.

You can change it in the menu Tools → Preferences... → Appareance → Look and Feel. Should the problem be such that you can't even start the preferences menu (or FreeMind as a whole), edit the file ~/.freemind/user.properties to uncomment and modify the lookandfeel parameter, as in:

lookandfeel = metal

Instead of metal, other valid values are nothing (for no Look&Feel at all), default (the... default one), windows or motif; mainly a matter of taste.

Note
if the modification of ~/.freemind/user.properties doesn't seem to change anything, remove the lookandfeel parameter from the file ~/.freemind/auto.properties

And, yes, we know, Gtk looks sooo much better! (but we don't really care)

When resizing the FreeMind window, the inner field doesn't resize properly (or other GUI strangeness)

If you're using a 3D desktop (like Compiz or Beryl), that's most probably the reason for your issue. We don't have a fix yet and we even don't know if it's a FreeMind, a Java or a Compiz/Beryl issue. Hints are welcome. (This also happens with ratpoison.)

Hint:
Beryl, Kubuntu-Feisty, sun-java6-jre: problems with resizing? This works for me:
  1. open FreeMind on Beryl Window Manager
  2. set Kwin (KDE Window manager) as actual Window manager
  3. select back Beryl Window manager - resizing works now!

This problem can be circumvented at least partially by editing the $HOME/.freemind/auto.properties:

#Wed Jun 13 15:58:31 EEST 2007
lastOpened=
standardfont=SansSerif
appwindow_state=0
appwindow_height=720
appwindow_width=1260
toolbarVisible=true
leftToolbarVisible=true
antialiasEdges=true
antialiasAll=false

Set the appwindow_height and appwindow_width to as high values as possible, so that you don't have to resize at all. If all toolbar icons fit to the screen, you're on the clear :).

Another hint: setting the AWT_TOOLKIT=MToolkit environment variable seems to solve some of the problems. I had the problem that in compiz-fusion the freemind window appeared undecorated and was unmanageable (couldn't be moved, resized, etc.). Setting this environment variable before running freemind solves this problem. I found the solution here.

Troubleshooting

Most people seem to think that, because you're relatively knowledgeable, they can tell you that something doesn't work, and you will be able to find out the solution, just like this!

Well, that's not exactly like this: first, I need to understand what the problem exactly is, and then I can try to solve it, especially if I've already seen and solved the problem. Think about your mechanic at the garage, if you give him a call and tell him "my car doesn't start" or "something is wrong with my car", would you expect him to tell you right away "Oh, yes, that's the plugs!". Most probably, he will ask to come by. Well, that's exactly the same here, I can't ask you to come by, but if you want good help, you'll need to give good information.

It's easier than you might thought, just do the following steps, that should give us a good start:

  • start a console, e.g. use Alt+F2, and type xterm or konsole or rxvt.
  • in the console, type the following statements:

On an RPM based system:

       DEBUG=1 freemind
       (quit freemind)
       /usr/bin/java -version
       rpm -qa | grep -i j
       rpm -qa | grep freemind
       env | grep -i j

On a Debian based system

       DEBUG=1 freemind
       (quit freemind)
       /usr/bin/java -version
       dpkg -l \*j\*
       dpkg -l freemind\*
       env | grep -i j
Note
You should see which java command is used, e.g. "/usr/bin/java", from the debug output of the freemind command.

The result should look somewhat like this (error messages are OK, I like error messages!):

alice@wonderland:~> DEBUG=1 freemind
DEBUG:   Freemind parameters are .
DEBUG:   Using $PATH to find java virtual machine.
DEBUG:   Using '/usr/bin/java' as java virtual machine...
DEBUG:   Freemind Directory is '/usr/share/freemind'.

Looking for user properties:
/home/ericl/.freemind/user.properties

User properties not found. It will be automatically created.
Done.
Default (System) Look & Feel: javax.swing.plaf.metal.MetalLookAndFeel
[Freemind-Developer-Internal-Warning (do not write a bug report, please)]:
                   Tried to get view without being able to get map module.

alice@wonderland:~> /usr/bin/java -version
java version "1.4.2-rc1"
Java(TM) 2 Runtime Environment, Standard Edition (build Blackdown-1.4.2-rc1)
Java HotSpot(TM) Client VM (build Blackdown-1.4.2-rc1, mixed mode)
alice@wonderland:~> rpm -qa | grep -i j
eject-2.0.13-26
joystick-2002.10.30-38
libjpeg-6.2.0-530
joe-2.9.8-179
jfsutils-1.1.1-25
jpilot-devel-0.99.6-0.pm.1
jpeg-6b-530
jhead-2.0-2
taskjuggler-1.4.2-10
j2sdk-provides-j2re-1.4.2-2
libjasper-1.600.0-75
jpilot-0.99.6-0.pm.1
jakarta-ant-1.5.1-37
java2-1.4.2-0.pm.0
java2-jre-1.4.2-0.pm.0
mjpegtools-1.6.2-1
alice@wonderland:~> rpm -q freemind
freemind-0.7.1-6
alice@wonderland:~> env | grep -i j
JRE_HOME=/usr/lib/java/jre
PATH=/usr/local/bin:/usr/bin:/usr/X11R6/bin:[etc...]
JAVA_BINDIR=/usr/lib/java/bin
JAVA_HOME=/usr/lib/java
SDK_HOME=/usr/lib/java
JDK_HOME=/usr/lib/java
JAVA_ROOT=/usr/lib/java

alice@wonderland:~>
  • open a new thread in the Help Forum of the FreeMind Project,
  • putting Linux in the subject helps spot the right messages,
  • select the commands and what they output,
  • and paste the stuff using the middle button of your mouse in the message body.
  • Explain also your problem of course.
  • Add the name and version of your distribution (SuSE 8.2 or whatever).
  • If the problem is not completely specific to FreeMind, does the problem appear as well with other Java applications (we suggest JEdit because it uses the same graphical system "Swing")?
  • That should be all.