How to install Magnolia

1. Install Eclipse for Magnolia

Note the Eclipse version.

Make the directory Magnolia. This is recommended, but not necessary.

Download Eclipse from ​http://www.eclipse.org/downloads Choose Eclipse RCP/Plug-in Developers 3.5 32-bit Java with 32-bit Eclipse (These choices will make sense when you see the Eclipse website.) Download the package to the newly created Magnolia directory.

Go to a terminal and move to the directory Magnolia. In a terminal unpack Eclipse by writing

tar xzvf [name of downloaded package]

You may now remove the installation files.

If you have 64-bit Linux installed on your machine, skip this next step. Otherwise (if you have 32-bit Linux) open the file eclipse.ini in the newly unpackaged directory and change

-vmargs

to

-vmargs -Xss8m

You can open the eclipse.ini file in e.g. Emacs.

If you have 64-bit Linux or a different operating system these settings will be changed later in the installation procedure.

2. Install Java for Magnolia

Download Sun Java 32-bit (choose Java SE, JDK6 and Linux platform) from ​http://java.sun.com/javase/downloads/widget/jdk6.jsp Download to the directory Magnolia.

The Sun Java site will offer you to log in, create accounts and similar. Skip these steps, which will be one of your options, and simply download the files.

Go to a terminal and move to the directory Magnolia. Install Sun Java by writing

sh [name of downloaded file]

This will result in the install program asking you to accept the licence. Flip through the licence by using the space bar, then accept the licence. You do not need to register.

You may now remove the installation files.

3. Making it work with 64-bit Linux

If you have 32-bit Linux or another operating system skip this step.

Make the following script to run Eclipse.

#! /bin/sh

export JAVA_HOME=$HOME/magnolia/jdk1.6.0_20/bin
export PATH=$JAVA_HOME:$PATH
export GDK_NATIVE_WINDOWS=1

exec $HOME/magnolia/eclipse/eclipse -vmargs -Xss8m -d32

Making a script means opening a file in an editor, e.g., Emacs and saving the file. A good name for the file in this instant might be run-eclipse. Save the file in the directory Magnolia. Add the above text to the file precisely as shown.

4. Adapting Eclipse to Rascal, Magnolia and adding some helpful tools

Start Eclipse. If you did not write a script in step 3, start Eclipse by writing in a terminal

eclipse

If you made a script in step 3, writing the name of the file you made in a terminal. For example like this:

run-eclipse

You may start Eclipse by clicking on the icon in your desktop or similar only if you did not write a script in step 3.

Now, go to the menu "Help ---> Install new software ..."

Click on the button Add in the dialogue that pops up.