Topic
  • No replies
SystemAdmin
SystemAdmin
73 Posts

Pinned topic My success in running Task Modeler in Eclipse on Linux (Intel)

‏2008-03-28T20:07:50Z |
I have managed to run Task Modeler in Eclipse 3.2.2 on Linux (Intel).

I haven't put Task Modeler through all of its actions on Linux. The actions attempted and completed so far are:
a. Brought up Eclipse and changed to the DITA Modeling perspective.
b. Created a new DITA map, using the base DITA map template.
c. Looked at the DITA map loaded in its view. (:-)
d. Shut down Eclipse.
(
To get Task Modeler up and running in Eclipse 3.2.2 on Linux/Intel, here are the steps I used:

a. Get and install IBM JDK 1.4.2 (or JRE 1.4.2) appropriate for your
target Linux system. Make sure you know how to set the appropriate
paths and environment variables so that when you run Eclipse 3.2.2,
it'll be using this JRE (vs some other one you might have.)

You can get the IBM JDK for Linux from developerWorks:
http://www.ibm.com/developerworks/java/jdk/linux/download.html)

b. Get Eclipse 3.2.2:
http://archive.eclipse.org/eclipse/downloads/drops/R-3.2.2-200702121330/index.php

I chose the Linux (x86/GTK 2) flavor because that's what Eclipse.org
tests on RHEL and SuSE on Intel/x86:
http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_2.html#TargetOperatingEnvironments

c. Get the Eclipse 3.2.2 up and running on your Linux machine. Pay special
attention to the Linux requirements for the Eclipse 3.2 platform and
how your system meets them:
http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_2.html#TargetOperatingEnvironments

For the package I chose, Eclipse 3.2.2 uses the GTK window
system, and it requires GTK2 and its associated libraries (GLib,
Pango). For my Linux system, I had to go get the GTK2 stuff. If you are using a standard, up-to-date Linux distribution, it probably meets this already.

TM running in Eclipse seems to use the SWT HTML viewer, and that requires
Mozilla 1.4GTK2. (Or Firefox GTK2--basically, the Firefox on your
Linux distro needs to be a GTK2 one).

(See also the Eclipse SWT FAQ portion "What do I need to run SWT on
Linux/GTK?": http://www.eclipse.org/swt/faq.php#gtkstartup)

(See also the portion "What do I need to run the SWT Browser inside
Eclipse on Linux/GTK or Linux/Motif?":
http://www.eclipse.org/swt/faq.php#browserlinux)

d. On a Windows machine, download IBM Task Modeler 5 from alphaWorks
and install it on the Windows machine.

If you use the choice that also installs its own Eclipse, TM got
installed to C:\Program Files\IBM\TaskModeler 5 directory. Its plugins
are named com.ibm.eou.tmtool.* in the eclipse\plugins directory under
the \TaskModeler 5 directory.

e. Grab all of those com.ibm.eou.tmtool.* from the eclipse\plugins
directory and bring them over to your Eclipse 3.2.2 on Linux and put
them into the eclipse\plugins directory there.

Note:
There is something mentioned in the Eclipse SWT FAQ about the SWT
Browser and the IBM 1.4 VM and a MOZILLA_FIVE_HOME error:
http://www.eclipse.org/swt/faq.php#browserlinuxibm

Because one of my earlier attempts resulted in a
MOZILLA_FIVE_HOME error and this is using the IBM 1.4 VM, I did set
the MOZILLA_FIVE_HOME environment variable to point to where I had my
Firefox GTK2 installed. (Just to be sure).

f. Start up your Eclipse 3.2.2 installation on your Linux machine, using
the -clean parameter on the startup command (to refresh things and let
Eclipse know that you've got the .tmtool. plug-ins from step (e).

According to the Eclipse docs, you should be able to use the -vm
parameter in the start up command to specify the JRE to use for that
session, by giving it the path to the JRE. You would put in the IBM
1.4.2 JRE that you got.

I also used the -vmargs -Xj9 parameter, because I read about it
being related to the IBM JRE. I don't know if it really matters for this
situation.

g. Once the Eclipse workbench comes up, open the DITA Modeling
perspective by using the Window menu (Window->Open Perspective->Other)
to get the list of available perspectives. Choose DITA Modeling from
that list, and OK, and the workbench should open up to the Task
Modeler views for that perspective.

Once the DITA Modeling perspective is opened, celebrate--you are
running TM in Eclipse on Linux! :-)

Note: Whenever I work in Eclipse, I usually have the Error Log view
open also so that I can keep an eye on any errors thrown. I think that
view comes from the PDE, so that's needed to see the Error Log view.
To open that view, do Window->Show View->Other and choose Error Log
under the "PDE Runtime" section. You might find this helps to see if
errors are being thrown if TM doesn't seem to be displaying.

Hope this helps those of you who were asking about getting Task
Modeler to run on Linux. I'd love to hear back if someone else gets
this to work as well.

--Lee Anne Kowalski