1 Introduction

This page is dedicated to explaining how to install Helyx-OS in Ubuntu.

Note: Many of these instructions were copied (with permission) from the original HelyxOS (Unofficial instructions) written by User:Wyldckat.

If you do not yet feel comfortable using Linux, then perhaps you better first read the page Working with the Shell and train a bit with the shell/terminal environments, so you can have a better perception of the steps shown below.

2 Copy-Paste steps

A few notes before you start copy-pasting:

Lines that start with # don't have to be copy-pasted. They are just comments to let you know what's going on.
One wrong character is enough for breaking this guide, so make sure you can read the characters properly or that the installed language system does not break the copied characters!

2.1 Ubuntu 12.04 to 13.04

2.1.1 Ubuntu 12.04 to 13.04 32bit

Discussion thread where you can ask questions about these steps: Installing HelyxOS on 32 and 64bit Linux Distributions

Note: These instructions have been tested on:

Ubuntu 12.04 32bit (i686)
Ubuntu 13.04 32bit (i686)

Steps:

Install "vtk" + "vtk-java" + "OpenJDK":

sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre

Download the binary tarball for HelyxOS from the download section. For example, download the file:
```
20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2
```
Unpack the tarball for HelyxOS where you want to install HelyxOS:
```
tar -xjf 20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2
```
Go into the folder Engys/HelyxOS and remove the jre folder:
```
cd Engys/HelyxOS
rm -rf jre
```

Get a local copy of the OpenJDK installation that Ubuntu has got:

cp -r /usr/lib/jvm/java-7-openjdk-i386/jre jre
find jre -type l -delete
cp -r /usr/lib/jvm/java-7-openjdk-common/jre/* jre/

Go into the subfolder v1.0.1:
```
cd v1.0.1
```

Edit the file bin/launcher.conf (e.g. with nano or gedit) and search for the following line:

LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"

Replace it with this one:

LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/i386:$HELYXHOME/../jre/lib/i386/xawt:$LD_LIBRARY_PATH"

Save and close the file.

Eliminate the contents of the ext subfolder and create a symbolic link to /usr/lib/jni:
```
rm -rf ext
ln -s /usr/lib/jni ext
```
Remove the lib/vtk-5.10.jar and replace it with a symbolic link to Ubuntu's own build:
```
rm lib/vtk-5.10.jar
ln -s /usr/share/java/vtk.jar lib/vtk-5.10.jar
```
That is it! You are ready to go:
```
./helyxOS.sh
```

Discussion thread where you can ask questions about these steps: Installing HelyxOS on 32 and 64bit Linux Distributions

2.1.2 Ubuntu 12.04 to 13.04 64bit

Discussion thread where you can ask questions about these steps: Installing HelyxOS on 32 and 64bit Linux Distributions

Note: These instructions have been tested on:

Ubuntu 12.04 64bit (x86_64)
Ubuntu 13.04 64bit (x86_64)

Steps:

Install "vtk" + "vtk-java" + "OpenJDK":

sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre

Download the binary tarball for HelyxOS from the download section. For example, download the file:
```
20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2
```
Unpack the tarball for HelyxOS where you want to install HelyxOS:
```
tar -xjf 20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2
```
Go into the folder Engys/HelyxOS and remove the jre folder:
```
cd Engys/HelyxOS
rm -rf jre
```

Get a local copy of the OpenJDK installation that Ubuntu has got:

cp -r /usr/lib/jvm/java-7-openjdk-amd64/jre jre
find jre -type l -delete
cp -r /usr/lib/jvm/java-7-openjdk-common/jre/* jre/

Go into the subfolder v1.0.1:
```
cd v1.0.1
```

Edit the file bin/launcher.conf (e.g. with nano or gedit) and search for the following line:

LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"

Replace it with this one:

LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"

Save and close the file.

Eliminate the contents of the ext subfolder and create a symbolic link to /usr/lib/jni:
```
rm -rf ext
ln -s /usr/lib/jni ext
```
Remove the lib/vtk-5.10.jar and replace it with a symbolic link to Ubuntu's own build:
```
rm lib/vtk-5.10.jar
ln -s /usr/share/java/vtk.jar lib/vtk-5.10.jar
```
That is it! You are ready to go:
```
./helyxOS.sh
```

Discussion thread where you can ask questions about these steps: Installing HelyxOS on 32 and 64bit Linux Distributions

2.2 Ubuntu 11.10

2.2.1 Ubuntu 11.10 32bit

Discussion thread where you can ask questions about these steps: Installing HelyxOS on 32 and 64bit Linux Distributions

These instructions have been tested on Ubuntu 11.10 32bit (i686).

Note: These instructions rely on a PPA (for more information click here), because Ubuntu 11.10 by default only provides VTK 5.6, which is not compatible with Helyx-OS. On the other hand, Gijs Molenaar has got a PPA with a backported VTK 5.8, which is compatible with Helyx-OS (at least for the basic features).

Steps:

Add the aforementioned PPA to apt-get's repository and update the respective cache:
```
sudo add-apt-repository ppa:gijzelaar/vtk
sudo apt-get update
```

Install "vtk" + "vtk-java" + "OpenJDK":

sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre

Download the binary tarball for HelyxOS from the download section. For example, download the file:
```
20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2
```
Unpack the tarball for HelyxOS where you want to install HelyxOS:
```
tar -xjf 20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2
```
Go into the folder Engys/HelyxOS and remove the jre folder:
```
cd Engys/HelyxOS
rm -rf jre
```
Get a local copy of the OpenJDK installation that Ubuntu has got:
```
cp -r /usr/lib/jvm/java-7-openjdk/jre jre
```
Go into the subfolder v1.0.1:
```
cd v1.0.1
```

Edit the file bin/launcher.conf (e.g. with nano or gedit) and search for the following line:

LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"

Replace it with this one:

LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/i386:$HELYXHOME/../jre/lib/i386/xawt:$LD_LIBRARY_PATH"

Save and close the file.

Eliminate the contents of the ext subfolder and create a symbolic link to /usr/lib/jni:
```
rm -rf ext
ln -s /usr/lib/jni ext
```
Remove the lib/vtk-5.10.jar and replace it with a symbolic link to Ubuntu's own build:
```
rm lib/vtk-5.10.jar
ln -s /usr/share/java/vtk.jar lib/vtk-5.10.jar
```
That is it! You are ready to go:
```
./helyxOS.sh
```

Discussion thread where you can ask questions about these steps: Installing HelyxOS on 32 and 64bit Linux Distributions

Installation/Helyx-OS/Ubuntu

1 Introduction

Contents

2 Copy-Paste steps

2.1 Ubuntu 12.04 to 13.04

2.1.1 Ubuntu 12.04 to 13.04 32bit

2.1.2 Ubuntu 12.04 to 13.04 64bit

2.2 Ubuntu 11.10

2.2.1 Ubuntu 11.10 32bit