Revision as of 18:33, 1 December 2013

1 Introduction

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

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:

1. Lines that start with # don't have to be copy-pasted. They are just comments to let you know what's going on.
2. 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 Helyx-OS v1.0.3

In this section are the instructions meant for Helyx-OS v1.0.3.

2.1.1 openSUSE 11.4

2.1.1.1 openSUSE 11.4 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 openSUSE 11.4 32bit (i586).

Steps:

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

   sudo zypper install vtk vtk-java java-1_6_0-openjdk

2. Download the binary tarball for HelyxOS from the download section. You can also download the file through the command line, by running:

   wget "http://sourceforge.net/projects/helyx-os/files/20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2/download" -O "20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2"

3. Unpack the tarball for HelyxOS where you want to install HelyxOS:

   tar -xjf 20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2

4. Go into the folder Engys/HelyxOS and remove the jre folder:

   cd Engys/HelyxOS
   rm -rf jre

5. Get a local copy of the OpenJDK installation that openSUSE has got:

   cp -r /usr/lib/jvm/java-1.6.0-openjdk-1.6.0/jre jre

6. Create a symbolic loophole for the "xawt" subfolder:

   ln -s ../xawt jre/lib/i386/xawt/xawt

7. Go into the subfolder v1.0.3:

   cd v1.0.3

8. 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.

9. Eliminate the contents of the ext subfolder:

   rm ext/*

10. Create a symbolic link list to the actual VTK libraries:

    for a in /usr/lib/vtk/lib*.so.5.10.0; do
        b=${a%*.5.10.0}
        ln -s $a ext/${b##*/}
    done

    Or if you prefer a single line of code:

    for a in /usr/lib/vtk/lib*.so.5.10.0; do b=${a%*.5.10.0}; ln -s $a ext/${b##*/}; done 
     

11. Remove the lib/vtk-5.10.jar and replace it with a symbolic link to openSUSE's own build:

    rm lib/vtk-5.10.jar
    ln -s /usr/lib/vtk/java/vtk.jar lib/vtk-5.10.jar

12. 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.1.2 openSUSE 11.4 64bit

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

Note: These instructions have been written for openSUSE 11.4 64bit (x86_64).

Steps:

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

   sudo zypper install vtk vtk-java java-1_6_0-openjdk

2. Download the binary tarball for HelyxOS from the download section. You can also download the file through the command line, by running:

   wget "http://sourceforge.net/projects/helyx-os/files/20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2/download" -O "20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2"

3. Unpack the tarball for HelyxOS where you want to install HelyxOS:

   tar -xjf 20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2

4. Go into the folder Engys/HelyxOS and remove the jre folder:

   cd Engys/HelyxOS
   rm -rf jre

5. Get a local copy of the OpenJDK installation that openSUSE has got:

   cp -r /usr/lib64/jvm/java-1.6.0-openjdk-1.6.0/jre jre

6. Create a symbolic loophole for the "xawt" subfolder:

   ln -s ../xawt jre/lib/amd64/xawt/xawt

7. Go into the subfolder v1.0.3:

   cd v1.0.3

8. 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.

9. Eliminate the contents of the ext subfolder:

   rm ext/*

10. Create a symbolic link list to the actual VTK libraries:

    for a in /usr/lib64/vtk/lib*.so.5.10.0; do
        b=${a%*.5.10.0}
        ln -s $a ext/${b##*/}
    done

    Or if you prefer a single line of code:

    for a in /usr/lib64/vtk/lib*.so.5.10.0; do b=${a%*.5.10.0}; ln -s $a ext/${b##*/}; done 
     

11. Remove the lib/vtk-5.10.jar and replace it with a symbolic link to openSUSE's own build:

    rm lib/vtk-5.10.jar
    ln -s /usr/lib64/vtk/java/vtk.jar lib/vtk-5.10.jar

12. 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 openSUSE 12.3

2.1.2.1 openSUSE 12.3 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 openSUSE 12.3 32bit (i586).

Steps:

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

   sudo zypper install vtk vtk-java java-1_7_0-openjdk

   Note: this assumes that you have already added the Science repository to YaST. If you have not yet done this, run the following command:

   sudo zypper ar -fr http://download.opensuse.org/repositories/science/openSUSE_12.3/science.repo

2. Download the binary tarball for HelyxOS from the download section. You can also download the file through the command line, by running:

   wget "http://sourceforge.net/projects/helyx-os/files/20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2/download" -O "20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2"

3. Unpack the tarball for HelyxOS where you want to install HelyxOS:

   tar -xjf 20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2

4. Go into the folder Engys/HelyxOS and remove the jre folder:

   cd Engys/HelyxOS
   rm -rf jre

5. Get a local copy of the OpenJDK installation that openSUSE has got:

   cp -r /usr/lib/jvm/java-1.7.0-openjdk-1.7.0/jre jre

6. Create a symbolic loophole for the "xawt" subfolder:

   ln -s ../xawt jre/lib/i386/xawt/xawt

7. Go into the subfolder v1.0.3:

   cd v1.0.3

8. 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.

9. Eliminate the contents of the ext subfolder:

   rm ext/*

10. Create a symbolic link list to the actual VTK libraries:

    for a in /usr/lib/vtk/lib*.so.5.10.1; do
        b=${a%*.5.10.1}
        ln -s $a ext/${b##*/}
    done

    Or if you prefer a single line of code:

    for a in /usr/lib/vtk/lib*.so.5.10.1; do b=${a%*.5.10.1}; ln -s $a ext/${b##*/}; done 
     

11. Remove the lib/vtk-5.10.jar and replace it with a symbolic link to openSUSE's own build:

    rm lib/vtk-5.10.jar
    ln -s /usr/lib/vtk/java/vtk.jar lib/vtk-5.10.jar

12. 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.2 openSUSE 12.3 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 openSUSE 12.3 64bit (x86_64).

Steps:

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

   sudo zypper install vtk vtk-java java-1_7_0-openjdk

   Note: this assumes that you have already added the Science repository to YaST. If you have not yet done this, run the following command:

   sudo zypper ar -fr http://download.opensuse.org/repositories/science/openSUSE_12.3/science.repo

2. Download the binary tarball for HelyxOS from the download section. You can also download the file through the command line, by running:

   wget "http://sourceforge.net/projects/helyx-os/files/20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2/download" -O "20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2"

3. Unpack the tarball for HelyxOS where you want to install HelyxOS:

   tar -xjf 20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2

4. Go into the folder Engys/HelyxOS and remove the jre folder:

   cd Engys/HelyxOS
   rm -rf jre

5. Get a local copy of the OpenJDK installation that openSUSE has got:

   cp -r /usr/lib64/jvm/java-1.7.0-openjdk-1.7.0/jre jre

6. Create a symbolic loophole for the "xawt" subfolder:

   ln -s ../xawt jre/lib/amd64/xawt/xawt

7. Go into the subfolder v1.0.3:

   cd v1.0.3

8. 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.

9. Eliminate the contents of the ext subfolder:

   rm ext/*

10. Create a symbolic link list to the actual VTK libraries:

    for a in /usr/lib64/vtk/lib*.so.5.10.1; do
        b=${a%*.5.10.1}
        ln -s $a ext/${b##*/}
    done

    Or if you prefer a single line of code:

    for a in /usr/lib64/vtk/lib*.so.5.10.1; do b=${a%*.5.10.1}; ln -s $a ext/${b##*/}; done 
     

11. Remove the lib/vtk-5.10.jar and replace it with a symbolic link to openSUSE's own build:

    rm lib/vtk-5.10.jar
    ln -s /usr/lib64/vtk/java/vtk.jar lib/vtk-5.10.jar

12. 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