Installation/Helyx-OS/Ubuntu

From OpenFOAMWiki
< Installation‎ | Helyx-OS
Revision as of 18:02, 23 March 2014 by Wyldckat (Talk | contribs)

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 Helyx-OS v1.0.3

Valid versions: OF Version 21.png

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


2.1.1 Ubuntu 12.04 to 13.04

2.1.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 Helyx-OS 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 Helyx-OS where you want to install it: 
    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.3: 
    cd v1.0.3
  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.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 Helyx-OS 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 Helyx-OS where you want to install it: 
    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.3: 
    cd v1.0.3
  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.1.2 Ubuntu 11.10

2.1.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 Helyx-OS 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 Helyx-OS where you want to install it: 
    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.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 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


2.2 Helyx-OS v2.0.0

Valid versions: OF Version 22.png

In this section are the instructions meant for Helyx-OS v2.0.0.

Note: If you have the 64 bit architecture of Ubuntu, perhaps it's best to follow the official installation instructions: Download and Installation Instructions @ SF.net


2.2.1 Ubuntu 12.04 to 13.10

2.2.1.1 Ubuntu 12.04 to 13.10 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)

Steps:

  1. Install "vtk" + "vtk-java" + "OpenJDK": 
    sudo apt-get install libvtk5.8 libvtk-java openjdk-7-jre
  2. Download the binary tarball for Helyx-OS from the download section. You can also download the file through the command line, by running: 
    wget "http://sourceforge.net/projects/helyx-os/files/20131121-Engys-HELYX-OS-2.0.0--linux-x86_64-FULL.bin/download" \
-O "20131121-Engys-HELYX-OS-2.0.0--linux-x86_64-FULL.bin"
  3. Manually unpack from the file the tarball we need, by running: 
    ARCHIVE=$(awk '/^__ARCHIVE_BELOW__/ {print NR + 1; exit 0; }' 20131121-Engys-HELYX-OS-2.0.0--linux-x86_64-FULL.bin)
tail -n+$ARCHIVE 20131121-Engys-HELYX-OS-2.0.0--linux-x86_64-FULL.bin | \
tar xz ./20131121-Engys-HELYX-OS-2.0.0-linux-x86_64-GUI.tar.bz2
 
tar -xjf 20131121-Engys-HELYX-OS-2.0.0-linux-x86_64-GUI.tar.bz2
  4. Go into the folder Engys/HELYX-OS and remove the jre folder: 
    cd Engys/HELYX-OS
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 v2.0.0: 
    cd v2.0.0
  7. 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
  8. Remove the lib/vtk-5.10.jar and replace it with a symbolic link to Ubuntu's own build: 
    rm lib/vtk5.jar
ln -s /usr/share/java/vtk.jar lib/vtk5.jar
  9. That is it! You are ready to go: 
    ./HELYX-OS.sh

    ...Well... when it starts for the first time, it will complain about the missing paths to the core (i.e. OpenFOAM) and ParaView folders, as shown in the image below:

    Error message example.
  10. Therefore, start a new separate terminal window, activate the OpenFOAM shell environment (if not done automatically) and run these commands: 
    echo $WM_PROJECT_DIR
echo $ParaView_DIR

    They give you the two paths necessary for Helyx-OS.

  11. Now in Helyx-OS, go to the menu Edit -> Preferences. It should show you something like the image below:
    Example of an empty Preferences window. Notice the menu on the upper left corner of the image.
  12. Place in each edit box, the path given on the terminal window. An example is given below:
    Example with the defined paths in the Preferences window.
  13. Press on the OK button. And now you're ready to go!

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


2.2.1.2 Ubuntu 12.04 to 13.10 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.10 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 Helyx-OS from the download section. You can also download the file through the command line, by running: 
    wget "http://sourceforge.net/projects/helyx-os/files/20131121-Engys-HELYX-OS-2.0.0--linux-x86_64-FULL.bin/download" \
-O "20131121-Engys-HELYX-OS-2.0.0--linux-x86_64-FULL.bin"
  3. Manually unpack from the file the tarball we need, by running: 
    ARCHIVE=$(awk '/^__ARCHIVE_BELOW__/ {print NR + 1; exit 0; }' 20131121-Engys-HELYX-OS-2.0.0--linux-x86_64-FULL.bin)
tail -n+$ARCHIVE 20131121-Engys-HELYX-OS-2.0.0--linux-x86_64-FULL.bin | \
tar xz ./20131121-Engys-HELYX-OS-2.0.0-linux-x86_64-GUI.tar.bz2
 
tar -xjf 20131121-Engys-HELYX-OS-2.0.0-linux-x86_64-GUI.tar.bz2
  4. Go into the folder Engys/HELYX-OS and remove the jre folder: 
    cd Engys/HELYX-OS
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 v2.0.0: 
    cd v2.0.0
  7. 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
  8. Remove the lib/vtk-5.10.jar and replace it with a symbolic link to Ubuntu's own build: 
    rm lib/vtk5.jar
ln -s /usr/share/java/vtk.jar lib/vtk5.jar
  9. That is it! You are ready to go: 
    ./HELYX-OS.sh

    ...Well... when it starts for the first time, it will complain about the missing paths to the core (i.e. OpenFOAM) and ParaView folders, as shown in the image below:

    Error message example.
  10. Therefore, start a new separate terminal window, activate the OpenFOAM shell environment (if not done automatically) and run these commands: 
    echo $WM_PROJECT_DIR
echo $ParaView_DIR

    They give you the two paths necessary for Helyx-OS.

  11. Now in Helyx-OS, go to the menu Edit -> Preferences. It should show you something like the image below:
    Example of an empty Preferences window. Notice the menu on the upper left corner of the image.
  12. Place in each edit box, the path given on the terminal window. An example is given below:
    Example with the defined paths in the Preferences window.
  13. Press on the OK button. And now you're ready to go!

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

Retrieved from "https://openfoamwiki.net/index.php?title=Installation/Helyx-OS/Ubuntu&oldid=15095"
  • GNU Free Documentation License 1.3
  • Powered by MediaWiki
  • Powered by Semantic MediaWiki