Difference between revisions of "Installation/Helyx-OS/Ubuntu"
(Transfer complete) |
(→Ubuntu 16.04: Fixed the way the jre folder is linked/copie) |
||
(12 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
= Introduction = | = Introduction = | ||
− | This page is dedicated to explaining how to install [http:// | + | This page is dedicated to explaining how to install [http://engys.github.io/HELYX-OS/ Helyx-OS] in [http://www.ubuntu.com Ubuntu]. |
− | + | ||
− | + | ||
If you do not yet feel comfortable using Linux, then perhaps you better first read the page [[Installation/Working with the Shell|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. | If you do not yet feel comfortable using Linux, then perhaps you better first read the page [[Installation/Working with the Shell|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. | ||
Line 17: | Line 15: | ||
− | == | + | == Helyx-OS v2.3.1 == |
+ | {{VersionInfo}}{{version2.4}} | ||
− | + | In this section are the instructions meant for Helyx-OS v2.3.1. | |
− | ''' | + | |
+ | '''Note: If you have the 64 bit architecture of Ubuntu, perhaps it's best to follow the official installation instructions:''' [http://engys.github.io/HELYX-OS/installation/ Installation of the Latest 64 Bit Linux Binaries @ Github] | ||
+ | |||
+ | |||
+ | === Ubuntu 16.04 === | ||
− | ''' | + | ==== Ubuntu 16.04 32bit ==== |
− | + | '''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-meshing-snappyhexmesh/117183-installing-helyxos-32-64bit-linux-distributions.html Installing HelyxOS on 32 and 64bit Linux Distributions] | |
− | + | ||
Steps: | Steps: | ||
<ol> | <ol> | ||
− | <li>Install | + | <li>Install VTK 6.2 + OpenJDK: |
− | <bash>sudo apt-get install | + | <bash>sudo apt-get install vtk6 libvtk6-java openjdk-7-jre openjdk-7-jdk</bash> |
</li> | </li> | ||
− | <li>Download the binary tarball for | + | <li>Download the binary tarball for Helyx-OS from the [https://github.com/ENGYS/HELYX-OS/releases/tag/v2.3.1 release tag v2.3.1]. You can also download the file through the command line, by running: |
− | <bash> | + | <bash>wget "https://github.com/ENGYS/HELYX-OS/releases/download/v2.3.1/HELYX-OS-2.3.1-linux-x86_64.tar.bz2" \ |
+ | -O "HELYX-OS-2.3.1-linux-x86_64.tar.bz2"</bash> | ||
</li> | </li> | ||
− | <li> | + | <li>Manually unpack from the file the ''tarball'' we need, by running: |
− | <bash>tar -xjf | + | <bash>tar -xjf HELYX-OS-2.3.1-linux-x86_64.tar.bz2</bash> |
</li> | </li> | ||
− | <li>Go into the folder {{tt|Engys/ | + | <li>Go into the folder {{tt|Engys/HELYX-OS}} and remove the {{tt|jre}} folder: |
− | <bash>cd Engys/ | + | <bash>cd Engys/HELYX-OS |
rm -rf jre</bash> | rm -rf jre</bash> | ||
</li> | </li> | ||
− | <li> | + | <li>Create a symbolic link of the OpenJDK installation that Ubuntu has got: |
− | <bash> | + | <bash>ln -s /usr/lib/jvm/java-7-openjdk-i386/jre jre</bash> |
− | + | ||
− | + | ||
</li> | </li> | ||
− | <li>Go into the subfolder {{tt| | + | <li>Go into the subfolder {{tt|v2.3.1}}: |
− | <bash>cd | + | <bash>cd v2.3.1</bash> |
</li> | </li> | ||
− | <li> | + | <li>Eliminate unneeded contents from the {{tt|ext}} subfolder and get a local copy of the necessary VTK libraries: |
− | <bash> | + | <bash>rm -rf ext/lib* |
− | + | cp -a /usr/lib/i386-linux-gnu/libvtk* ext/ | |
− | + | cp -a /usr/lib/jni/libvtk* ext/</bash> | |
− | + | ||
</li> | </li> | ||
− | <li> | + | <li>Remove the {{tt|lib/vtk6.jar}}, get the one from Ubuntu, do a few tweaks and package it nicely: |
− | <bash>rm | + | <bash>rm lib/vtk6.jar |
− | + | mkdir lib/vtk6 | |
− | + | cd lib/vtk6 | |
− | + | unzip /usr/share/java/vtk6.jar | |
− | + | sed -i \ | |
− | + | -e 's=.*vtkParallelMPI4PyJava.*==' \ | |
+ | -e 's=.*vtkRenderingVolumeOpenGLNewJava.*==' \ | ||
+ | -e 's=.*vtkRenderingExternalJava.*==' \ | ||
+ | -e 's=.*vtkRenderingFreeTypeOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkRenderingVolumeAMRJava.*==' \ | ||
+ | -e 's=.*vtkRenderingContextOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkRenderingVolumeOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkRenderingOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkDomainsChemistryOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkIOADIOSJava.*==' \ | ||
+ | -e 's=.*vtkFiltersPythonJava.*==' \ | ||
+ | -e 's=.*vtkFiltersStatisticsGnuRJava.*==' \ | ||
+ | -e 's=.*vtkAcceleratorsPistonJava.*==' \ | ||
+ | -e 's=.*vtkAcceleratorsDaxJava.*==' \ | ||
+ | -e 's=.*vtkInfovisParallelJava.*==' \ | ||
+ | vtk/vtkNativeLibrary.java | ||
+ | javac vtk/vtkNativeLibrary.java | ||
+ | zip -r ../vtk6.jar * | ||
+ | cd ../.. | ||
+ | </bash> | ||
</li> | </li> | ||
<li>That is it! You are ready to go: | <li>That is it! You are ready to go: | ||
− | <bash>./ | + | <bash>./HELYX-OS.sh</bash> |
+ | ...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: | ||
+ | |||
+ | [[File:Helyx-OS_v200_error_message.png|center|frame|Error message example.]] | ||
</li> | </li> | ||
− | </ | + | <li>Therefore, start a new separate terminal window, activate the OpenFOAM shell environment (if not done automatically) and run these commands: |
+ | <bash>echo $WM_PROJECT_DIR | ||
+ | echo $ParaView_DIR</bash> | ||
+ | They give you the two paths necessary for Helyx-OS. | ||
+ | </li> | ||
+ | <li>Now in Helyx-OS, go to the menu {{tt|Edit -> Preferences}}. It should show you something like the image below: | ||
− | + | [[File:Helyx-OS_v200_Preferences.png|center|frame|Example of an empty {{tt|Preferences}} window. Notice the menu on the upper left corner of the image.<br>(Don't mind the image being from the older-no-longer-available Helyx-OS 2.0.0)]] | |
+ | </li> | ||
+ | <li>Place in each edit box, the path given on the terminal window. An example is given below: | ||
+ | |||
+ | [[File:Helyx-OS_v200_Preferences_defined.png|center|frame|Example with the defined paths in the {{tt|Preferences}} window.<br>(Don't mind the image being from the older-no-longer-available Helyx-OS 2.0.0)]] | ||
+ | |||
+ | </li> | ||
+ | <li>Press on the {{tt|OK}} button. And now you're ready to go!</li> | ||
+ | </ol> | ||
− | |||
'''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-meshing-snappyhexmesh/117183-installing-helyxos-32-64bit-linux-distributions.html#post425067 Installing HelyxOS on 32 and 64bit Linux Distributions] | '''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-meshing-snappyhexmesh/117183-installing-helyxos-32-64bit-linux-distributions.html#post425067 Installing HelyxOS on 32 and 64bit Linux Distributions] | ||
− | ''' | + | |
− | + | ==== Ubuntu 16.04 64bit ==== | |
− | + | '''Discussion thread where you can ask questions about these steps''': [http://www.cfd-online.com/Forums/openfoam-meshing-snappyhexmesh/117183-installing-helyxos-32-64bit-linux-distributions.html Installing HelyxOS on 32 and 64bit Linux Distributions] | |
Steps: | Steps: | ||
<ol> | <ol> | ||
− | <li>Install | + | <li>Install VTK 6.2 + OpenJDK: |
− | <bash>sudo apt-get install | + | <bash>sudo apt-get install vtk6 libvtk6-java openjdk-7-jre openjdk-7-jdk</bash> |
</li> | </li> | ||
− | <li>Download the binary tarball for | + | <li>Download the binary tarball for Helyx-OS from the [https://github.com/ENGYS/HELYX-OS/releases/tag/v2.3.1 release tag v2.3.1]. You can also download the file through the command line, by running: |
− | <bash> | + | <bash>wget "https://github.com/ENGYS/HELYX-OS/releases/download/v2.3.1/HELYX-OS-2.3.1-linux-x86_64.tar.bz2" \ |
+ | -O "HELYX-OS-2.3.1-linux-x86_64.tar.bz2"</bash> | ||
</li> | </li> | ||
− | <li> | + | <li>Manually unpack from the file the ''tarball'' we need, by running: |
− | <bash>tar -xjf | + | <bash>tar -xjf HELYX-OS-2.3.1-linux-x86_64.tar.bz2</bash> |
</li> | </li> | ||
− | <li>Go into the folder {{tt|Engys/ | + | <li>Go into the folder {{tt|Engys/HELYX-OS}} and remove the {{tt|jre}} folder: |
− | <bash>cd Engys/ | + | <bash>cd Engys/HELYX-OS |
rm -rf jre</bash> | rm -rf jre</bash> | ||
</li> | </li> | ||
− | <li> | + | <li>Create a symbolic link of the OpenJDK installation that Ubuntu has got: |
− | <bash> | + | <bash>ln -s /usr/lib/jvm/java-7-openjdk-amd64/jre jre</bash> |
− | + | ||
− | + | ||
</li> | </li> | ||
− | <li>Go into the subfolder {{tt| | + | <li>Go into the subfolder {{tt|v2.3.1}}: |
− | <bash>cd | + | <bash>cd v2.3.1</bash> |
</li> | </li> | ||
− | <li> | + | <li>Eliminate unneeded contents from the {{tt|ext}} subfolder and get a local copy of the necessary VTK libraries: |
− | <bash> | + | <bash>rm -rf ext/lib* |
− | + | cp -a /usr/lib/x86_64-linux-gnu/libvtk* ext/ | |
− | + | cp -a /usr/lib/jni/libvtk* ext/</bash> | |
− | + | ||
</li> | </li> | ||
− | <li> | + | <li>Remove the {{tt|lib/vtk6.jar}}, get the one from Ubuntu, do a few tweaks and package it nicely: |
− | <bash>rm | + | <bash>rm lib/vtk6.jar |
− | + | mkdir lib/vtk6 | |
− | + | cd lib/vtk6 | |
− | + | unzip /usr/share/java/vtk6.jar | |
− | + | sed -i \ | |
− | + | -e 's=.*vtkParallelMPI4PyJava.*==' \ | |
+ | -e 's=.*vtkRenderingVolumeOpenGLNewJava.*==' \ | ||
+ | -e 's=.*vtkRenderingExternalJava.*==' \ | ||
+ | -e 's=.*vtkRenderingFreeTypeOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkRenderingVolumeAMRJava.*==' \ | ||
+ | -e 's=.*vtkRenderingContextOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkRenderingVolumeOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkRenderingOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkDomainsChemistryOpenGL2Java.*==' \ | ||
+ | -e 's=.*vtkIOADIOSJava.*==' \ | ||
+ | -e 's=.*vtkFiltersPythonJava.*==' \ | ||
+ | -e 's=.*vtkFiltersStatisticsGnuRJava.*==' \ | ||
+ | -e 's=.*vtkAcceleratorsPistonJava.*==' \ | ||
+ | -e 's=.*vtkAcceleratorsDaxJava.*==' \ | ||
+ | -e 's=.*vtkInfovisParallelJava.*==' \ | ||
+ | vtk/vtkNativeLibrary.java | ||
+ | javac vtk/vtkNativeLibrary.java | ||
+ | zip -r ../vtk6.jar * | ||
+ | cd ../.. | ||
+ | </bash> | ||
</li> | </li> | ||
<li>That is it! You are ready to go: | <li>That is it! You are ready to go: | ||
− | <bash>./ | + | <bash>./HELYX-OS.sh</bash> |
+ | ...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: | ||
+ | |||
+ | [[File:Helyx-OS_v200_error_message.png|center|frame|Error message example.]] | ||
+ | </li> | ||
+ | <li>Therefore, start a new separate terminal window, activate the OpenFOAM shell environment (if not done automatically) and run these commands: | ||
+ | <bash>echo $WM_PROJECT_DIR | ||
+ | echo $ParaView_DIR</bash> | ||
+ | They give you the two paths necessary for Helyx-OS. | ||
+ | </li> | ||
+ | <li>Now in Helyx-OS, go to the menu {{tt|Edit -> Preferences}}. It should show you something like the image below: | ||
+ | |||
+ | [[File:Helyx-OS_v200_Preferences.png|center|frame|Example of an empty {{tt|Preferences}} window. Notice the menu on the upper left corner of the image.<br>(Don't mind the image being from the older-no-longer-available Helyx-OS 2.0.0)]] | ||
+ | |||
+ | </li> | ||
+ | <li>Place in each edit box, the path given on the terminal window. An example is given below: | ||
+ | |||
+ | [[File:Helyx-OS_v200_Preferences_defined.png|center|frame|Example with the defined paths in the {{tt|Preferences}} window.<br>(Don't mind the image being from the older-no-longer-available Helyx-OS 2.0.0)]] | ||
+ | |||
</li> | </li> | ||
+ | <li>Press on the {{tt|OK}} button. And now you're ready to go!</li> | ||
</ol> | </ol> | ||
Latest revision as of 01:28, 27 March 2016
1 Introduction
This page is dedicated to explaining how to install Helyx-OS in Ubuntu.
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.
Contents
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 Helyx-OS v2.3.1
In this section are the instructions meant for Helyx-OS v2.3.1.
Note: If you have the 64 bit architecture of Ubuntu, perhaps it's best to follow the official installation instructions: Installation of the Latest 64 Bit Linux Binaries @ Github
2.1.1 Ubuntu 16.04
2.1.1.1 Ubuntu 16.04 32bit
Discussion thread where you can ask questions about these steps: Installing HelyxOS on 32 and 64bit Linux Distributions
Steps:
- Install VTK 6.2 + OpenJDK:
sudo apt-get install vtk6 libvtk6-java openjdk-7-jre openjdk-7-jdk
- Download the binary tarball for Helyx-OS from the release tag v2.3.1. You can also download the file through the command line, by running:
wget "https://github.com/ENGYS/HELYX-OS/releases/download/v2.3.1/HELYX-OS-2.3.1-linux-x86_64.tar.bz2" \ -O "HELYX-OS-2.3.1-linux-x86_64.tar.bz2"
- Manually unpack from the file the tarball we need, by running:
tar -xjf HELYX-OS-2.3.1-linux-x86_64.tar.bz2
- Go into the folder Engys/HELYX-OS and remove the jre folder:
cd Engys/HELYX-OS rm -rf jre
- Create a symbolic link of the OpenJDK installation that Ubuntu has got:
ln -s /usr/lib/jvm/java-7-openjdk-i386/jre jre
- Go into the subfolder v2.3.1:
cd v2.3.1
- Eliminate unneeded contents from the ext subfolder and get a local copy of the necessary VTK libraries:
rm -rf ext/lib* cp -a /usr/lib/i386-linux-gnu/libvtk* ext/ cp -a /usr/lib/jni/libvtk* ext/
- Remove the lib/vtk6.jar, get the one from Ubuntu, do a few tweaks and package it nicely:
rm lib/vtk6.jar mkdir lib/vtk6 cd lib/vtk6 unzip /usr/share/java/vtk6.jar sed -i \ -e 's=.*vtkParallelMPI4PyJava.*==' \ -e 's=.*vtkRenderingVolumeOpenGLNewJava.*==' \ -e 's=.*vtkRenderingExternalJava.*==' \ -e 's=.*vtkRenderingFreeTypeOpenGL2Java.*==' \ -e 's=.*vtkRenderingVolumeAMRJava.*==' \ -e 's=.*vtkRenderingContextOpenGL2Java.*==' \ -e 's=.*vtkRenderingVolumeOpenGL2Java.*==' \ -e 's=.*vtkRenderingOpenGL2Java.*==' \ -e 's=.*vtkDomainsChemistryOpenGL2Java.*==' \ -e 's=.*vtkIOADIOSJava.*==' \ -e 's=.*vtkFiltersPythonJava.*==' \ -e 's=.*vtkFiltersStatisticsGnuRJava.*==' \ -e 's=.*vtkAcceleratorsPistonJava.*==' \ -e 's=.*vtkAcceleratorsDaxJava.*==' \ -e 's=.*vtkInfovisParallelJava.*==' \ vtk/vtkNativeLibrary.java javac vtk/vtkNativeLibrary.java zip -r ../vtk6.jar * cd ../..
- 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:
- 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.
- Now in Helyx-OS, go to the menu Edit -> Preferences. It should show you something like the image below:
- Place in each edit box, the path given on the terminal window. An example is given below:
- 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.1.1.2 Ubuntu 16.04 64bit
Discussion thread where you can ask questions about these steps: Installing HelyxOS on 32 and 64bit Linux Distributions
Steps:
- Install VTK 6.2 + OpenJDK:
sudo apt-get install vtk6 libvtk6-java openjdk-7-jre openjdk-7-jdk
- Download the binary tarball for Helyx-OS from the release tag v2.3.1. You can also download the file through the command line, by running:
wget "https://github.com/ENGYS/HELYX-OS/releases/download/v2.3.1/HELYX-OS-2.3.1-linux-x86_64.tar.bz2" \ -O "HELYX-OS-2.3.1-linux-x86_64.tar.bz2"
- Manually unpack from the file the tarball we need, by running:
tar -xjf HELYX-OS-2.3.1-linux-x86_64.tar.bz2
- Go into the folder Engys/HELYX-OS and remove the jre folder:
cd Engys/HELYX-OS rm -rf jre
- Create a symbolic link of the OpenJDK installation that Ubuntu has got:
ln -s /usr/lib/jvm/java-7-openjdk-amd64/jre jre
- Go into the subfolder v2.3.1:
cd v2.3.1
- Eliminate unneeded contents from the ext subfolder and get a local copy of the necessary VTK libraries:
rm -rf ext/lib* cp -a /usr/lib/x86_64-linux-gnu/libvtk* ext/ cp -a /usr/lib/jni/libvtk* ext/
- Remove the lib/vtk6.jar, get the one from Ubuntu, do a few tweaks and package it nicely:
rm lib/vtk6.jar mkdir lib/vtk6 cd lib/vtk6 unzip /usr/share/java/vtk6.jar sed -i \ -e 's=.*vtkParallelMPI4PyJava.*==' \ -e 's=.*vtkRenderingVolumeOpenGLNewJava.*==' \ -e 's=.*vtkRenderingExternalJava.*==' \ -e 's=.*vtkRenderingFreeTypeOpenGL2Java.*==' \ -e 's=.*vtkRenderingVolumeAMRJava.*==' \ -e 's=.*vtkRenderingContextOpenGL2Java.*==' \ -e 's=.*vtkRenderingVolumeOpenGL2Java.*==' \ -e 's=.*vtkRenderingOpenGL2Java.*==' \ -e 's=.*vtkDomainsChemistryOpenGL2Java.*==' \ -e 's=.*vtkIOADIOSJava.*==' \ -e 's=.*vtkFiltersPythonJava.*==' \ -e 's=.*vtkFiltersStatisticsGnuRJava.*==' \ -e 's=.*vtkAcceleratorsPistonJava.*==' \ -e 's=.*vtkAcceleratorsDaxJava.*==' \ -e 's=.*vtkInfovisParallelJava.*==' \ vtk/vtkNativeLibrary.java javac vtk/vtkNativeLibrary.java zip -r ../vtk6.jar * cd ../..
- 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:
- 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.
- Now in Helyx-OS, go to the menu Edit -> Preferences. It should show you something like the image below:
- Place in each edit box, the path given on the terminal window. An example is given below:
- 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