Difference between revisions of "Installation/Helyx-OS/Ubuntu"

From OpenFOAMWiki
(Added instructions for 11.10 32bit)
(Switched to more explicit instructions for version 1.0.3)
Line 31: Line 31:
 
<bash>sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre</bash>
 
<bash>sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre</bash>
 
</li>
 
</li>
<li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. For example, download the file:
+
<li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. You can also download the file through the command line, by running:
<bash>20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
+
<bash>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"</bash>
 
</li>
 
</li>
 
<li>Unpack the tarball for HelyxOS where you want to install HelyxOS:
 
<li>Unpack the tarball for HelyxOS where you want to install HelyxOS:
<bash>tar -xjf 20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
+
<bash>tar -xjf 20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2</bash>
 
</li>
 
</li>
 
<li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:
 
<li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:
Line 83: Line 83:
 
<bash>sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre</bash>
 
<bash>sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre</bash>
 
</li>
 
</li>
<li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. For example, download the file:
+
<li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. You can also download the file through the command line, by running:
<bash>20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
+
<bash>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"</bash>
 
</li>
 
</li>
 
<li>Unpack the tarball for HelyxOS where you want to install HelyxOS:
 
<li>Unpack the tarball for HelyxOS where you want to install HelyxOS:
<bash>tar -xjf 20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
+
<bash>tar -xjf 20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2</bash>
 
</li>
 
</li>
 
<li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:
 
<li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:
Line 142: Line 142:
 
<bash>sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre</bash>
 
<bash>sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre</bash>
 
</li>
 
</li>
<li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. For example, download the file:
+
<li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. You can also download the file through the command line, by running:
<bash>20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
+
<bash>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"</bash>
 
</li>
 
</li>
 
<li>Unpack the tarball for HelyxOS where you want to install HelyxOS:
 
<li>Unpack the tarball for HelyxOS where you want to install HelyxOS:
<bash>tar -xjf 20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
+
<bash>tar -xjf 20130715-Engys-HelyxOS-1.0.3-linux-x86_64-JRE.tar.bz2</bash>
 
</li>
 
</li>
 
<li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:
 
<li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:

Revision as of 18:26, 1 December 2013

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:

  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 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:

  1. Install "vtk" + "vtk-java" + "OpenJDK":
    sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre
  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 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/
  6. Go into the subfolder v1.0.1:
    cd v1.0.1
  7. 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.

  8. 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
  9. 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
  10. 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:

  1. Install "vtk" + "vtk-java" + "OpenJDK":
    sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre
  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 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/
  6. Go into the subfolder v1.0.1:
    cd v1.0.1
  7. 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.

  8. 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
  9. 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
  10. 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:

  1. 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
  2. Install "vtk" + "vtk-java" + "OpenJDK":
    sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre
  3. 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"
  4. 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
  5. Go into the folder Engys/HelyxOS and remove the jre folder:
    cd Engys/HelyxOS
    rm -rf jre
  6. Get a local copy of the OpenJDK installation that Ubuntu has got:
    cp -r /usr/lib/jvm/java-7-openjdk/jre jre
  7. Go into the subfolder v1.0.1:
    cd v1.0.1
  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 and create a symbolic link to /usr/lib/jni:
    rm -rf ext
    ln -s /usr/lib/jni ext
  10. 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
  11. 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