|
|
| (6 intermediate revisions by the same user not shown) |
| Line 1: |
Line 1: |
| | = Introduction = | | = Introduction = |
| − | This page is dedicated to explaining how to install [http://sourceforge.net/p/helyx-os/wiki/Home/ Helyx-OS] in [http://www.opensuse.org openSUSE]. | + | This page is dedicated to explaining how to install [http://engys.github.io/HELYX-OS/ Helyx-OS] in [http://www.opensuse.org openSUSE]. |
| − | | + | |
| − | '''Note''': Many of these instructions were copied (with permission) from the original [http://sourceforge.net/u/wyldckat/helyxos/wiki/Home/ HelyxOS (Unofficial instructions)] written by [[User:Wyldckat]].
| + | |
| | | | |
| | 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: |
| | | | |
| | | | |
| − | == openSUSE 11.4 == | + | == Helyx-OS v2.3.1 == |
| − | | + | {{VersionInfo}}{{version2.4}} |
| − | === openSUSE 11.4 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#post425067 Installing HelyxOS on 32 and 64bit Linux Distributions]
| + | |
| − | | + | |
| − | '''Note''': These instructions have been tested on openSUSE 11.4 32bit (i586).
| + | |
| − | | + | |
| − | Steps:
| + | |
| − | <ol>
| + | |
| − | <li>Install "vtk" + "vtk-java" + "OpenJDK":
| + | |
| − | <bash>sudo zypper install vtk vtk-java java-1_6_0-openjdk</bash>
| + | |
| − | </li>
| + | |
| − | <li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. For example, download the file:
| + | |
| − | <bash>20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
| + | |
| − | </li>
| + | |
| − | <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>
| + | |
| − | </li>
| + | |
| − | <li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:
| + | |
| − | <bash>cd Engys/HelyxOS
| + | |
| − | rm -rf jre</bash>
| + | |
| − | </li>
| + | |
| − | <li>Get a local copy of the OpenJDK installation that openSUSE has got:
| + | |
| − | <bash>cp -r /usr/lib/jvm/java-1.6.0-openjdk-1.6.0/jre jre</bash>
| + | |
| − | </li>
| + | |
| − | <li>Create a symbolic loophole for the "xawt" subfolder:
| + | |
| − | <bash>ln -s ../xawt jre/lib/i386/xawt/xawt</bash>
| + | |
| − | </li>
| + | |
| − | <li>Go into the subfolder {{tt|v1.0.1}}:
| + | |
| − | <bash>cd v1.0.1</bash>
| + | |
| − | </li>
| + | |
| − | <li>Edit the file {{tt|bin/launcher.conf}} (e.g. with {{tt|nano}} or {{tt|gedit}}) and search for the following line:
| + | |
| − | <bash>LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"</bash>
| + | |
| − | Replace it with this one:
| + | |
| − | <bash>LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/i386:$HELYXHOME/../jre/lib/i386/xawt:$LD_LIBRARY_PATH"</bash>
| + | |
| − | Save and close the file.
| + | |
| − | </li>
| + | |
| − | <li>Eliminate the contents of the {{tt|ext}} subfolder:
| + | |
| − | <bash>rm ext/*</bash>
| + | |
| − | </li>
| + | |
| − | <li>Create a symbolic link list to the actual VTK libraries:
| + | |
| − | <bash>for a in /usr/lib/vtk/lib*.so.5.10.0; do
| + | |
| − | b=${a%*.5.10.0}
| + | |
| − | ln -s $a ext/${b##*/}
| + | |
| − | done</bash>
| + | |
| − | Or if you prefer a single line of code:
| + | |
| − | <bash>for a in /usr/lib/vtk/lib*.so.5.10.0; do b=${a%*.5.10.0}; ln -s $a ext/${b##*/}; done</bash>
| + | |
| − | </li>
| + | |
| − | <li>Remove the {{tt|lib/vtk-5.10.jar}} and replace it with a symbolic link to openSUSE's own build:
| + | |
| − | <bash>rm lib/vtk-5.10.jar
| + | |
| − | ln -s /usr/lib/vtk/java/vtk.jar lib/vtk-5.10.jar</bash>
| + | |
| − | </li>
| + | |
| − | <li>That is it! You are ready to go:
| + | |
| − | <bash>./helyxOS.sh</bash>
| + | |
| − | </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]
| + | |
| − | | + | |
| − | | + | |
| − | === openSUSE 11.4 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#post425067 Installing HelyxOS on 32 and 64bit Linux Distributions]
| + | |
| − | | + | |
| − | '''Note''': These instructions have been written for openSUSE 11.4 64bit (x86_64).
| + | |
| − | | + | |
| − | Steps:
| + | |
| − | <ol>
| + | |
| − | <li>Install "vtk" + "vtk-java" + "OpenJDK":
| + | |
| − | <bash>sudo zypper install vtk vtk-java java-1_6_0-openjdk</bash>
| + | |
| − | </li>
| + | |
| − | <li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. For example, download the file:
| + | |
| − | <bash>20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
| + | |
| − | </li>
| + | |
| − | <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>
| + | |
| − | </li>
| + | |
| − | <li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:
| + | |
| − | <bash>cd Engys/HelyxOS
| + | |
| − | rm -rf jre</bash>
| + | |
| − | </li>
| + | |
| − | <li>Get a local copy of the OpenJDK installation that openSUSE has got:
| + | |
| − | <bash>cp -r /usr/lib64/jvm/java-1.6.0-openjdk-1.6.0/jre jre</bash>
| + | |
| − | </li>
| + | |
| − | <li>Create a symbolic loophole for the "xawt" subfolder:
| + | |
| − | <bash>ln -s ../xawt jre/lib/amd64/xawt/xawt</bash>
| + | |
| − | </li>
| + | |
| − | <li>Go into the subfolder {{tt|v1.0.1}}:
| + | |
| − | <bash>cd v1.0.1</bash>
| + | |
| − | </li>
| + | |
| − | <li>Edit the file {{tt|bin/launcher.conf}} (e.g. with {{tt|nano}} or {{tt|gedit}}) and search for the following line:
| + | |
| − | <bash>LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"</bash>
| + | |
| − | Replace it with this one:
| + | |
| − | <bash>LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"</bash>
| + | |
| − | Save and close the file.
| + | |
| − | </li>
| + | |
| − | <li>Eliminate the contents of the {{tt|ext}} subfolder:
| + | |
| − | <bash>rm ext/*</bash>
| + | |
| − | </li>
| + | |
| − | <li>Create a symbolic link list to the actual VTK libraries:
| + | |
| − | <bash>for a in /usr/lib64/vtk/lib*.so.5.10.0; do
| + | |
| − | b=${a%*.5.10.0}
| + | |
| − | ln -s $a ext/${b##*/}
| + | |
| − | done</bash>
| + | |
| − | Or if you prefer a single line of code:
| + | |
| − | <bash>for a in /usr/lib64/vtk/lib*.so.5.10.0; do b=${a%*.5.10.0}; ln -s $a ext/${b##*/}; done</bash>
| + | |
| − | </li>
| + | |
| − | <li>Remove the {{tt|lib/vtk-5.10.jar}} and replace it with a symbolic link to openSUSE's own build:
| + | |
| − | <bash>rm lib/vtk-5.10.jar
| + | |
| − | ln -s /usr/lib64/vtk/java/vtk.jar lib/vtk-5.10.jar</bash>
| + | |
| − | </li>
| + | |
| − | <li>That is it! You are ready to go:
| + | |
| − | <bash>./helyxOS.sh</bash>
| + | |
| − | </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]
| + | |
| − | | + | |
| − | | + | |
| − | == openSUSE 12.3 ==
| + | |
| − | | + | |
| − | === openSUSE 12.3 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#post425067 Installing HelyxOS on 32 and 64bit Linux Distributions]
| + | |
| − | | + | |
| − | '''Note''': These instructions have been tested on openSUSE 12.3 32bit (i586).
| + | |
| − | | + | |
| − | Steps:
| + | |
| − | <ol>
| + | |
| − | <li>Install "vtk" + "vtk-java" + "OpenJDK":
| + | |
| − | <bash>sudo zypper install vtk vtk-java java-1_7_0-openjdk</bash>
| + | |
| − | '''Note''': this assumes that you have already added the Science repository to YaST. If you have not yet done this, run the following command:
| + | |
| − | <bash>sudo zypper ar -fr http://download.opensuse.org/repositories/science/openSUSE_12.3/science.repo</bash>
| + | |
| − | </li>
| + | |
| − | <li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. For example, download the file:
| + | |
| − | <bash>20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
| + | |
| − | </li>
| + | |
| − | <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>
| + | |
| − | </li>
| + | |
| − | <li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:
| + | |
| − | <bash>cd Engys/HelyxOS
| + | |
| − | rm -rf jre</bash>
| + | |
| − | </li>
| + | |
| − | <li>Get a local copy of the OpenJDK installation that openSUSE has got:
| + | |
| − | <bash>cp -r /usr/lib/jvm/java-1.7.0-openjdk-1.7.0/jre jre</bash>
| + | |
| − | </li>
| + | |
| − | <li>Create a symbolic loophole for the "xawt" subfolder:
| + | |
| − | <bash>ln -s ../xawt jre/lib/i386/xawt/xawt</bash>
| + | |
| − | </li>
| + | |
| − | <li>Go into the subfolder {{tt|v1.0.1}}:
| + | |
| − | <bash>cd v1.0.1</bash>
| + | |
| − | </li>
| + | |
| − | <li>Edit the file {{tt|bin/launcher.conf}} (e.g. with {{tt|nano}} or {{tt|gedit}}) and search for the following line:
| + | |
| − | <bash>LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"</bash>
| + | |
| − | Replace it with this one:
| + | |
| − | <bash>LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/i386:$HELYXHOME/../jre/lib/i386/xawt:$LD_LIBRARY_PATH"</bash>
| + | |
| − | Save and close the file.
| + | |
| − | </li>
| + | |
| − | <li>Eliminate the contents of the {{tt|ext}} subfolder:
| + | |
| − | <bash>rm ext/*</bash>
| + | |
| − | </li>
| + | |
| − | <li>Create a symbolic link list to the actual VTK libraries:
| + | |
| − | <bash>for a in /usr/lib/vtk/lib*.so.5.10.1; do
| + | |
| − | b=${a%*.5.10.1}
| + | |
| − | ln -s $a ext/${b##*/}
| + | |
| − | done</bash>
| + | |
| − | Or if you prefer a single line of code:
| + | |
| − | <bash>for a in /usr/lib/vtk/lib*.so.5.10.1; do b=${a%*.5.10.1}; ln -s $a ext/${b##*/}; done</bash>
| + | |
| − | </li>
| + | |
| − | <li>Remove the {{tt|lib/vtk-5.10.jar}} and replace it with a symbolic link to openSUSE's own build:
| + | |
| − | <bash>rm lib/vtk-5.10.jar
| + | |
| − | ln -s /usr/lib/vtk/java/vtk.jar lib/vtk-5.10.jar</bash>
| + | |
| − | </li>
| + | |
| − | <li>That is it! You are ready to go:
| + | |
| − | <bash>./helyxOS.sh</bash>
| + | |
| − | </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]
| + | |
| | | | |
| | + | In this section are the instructions meant for Helyx-OS v2.3.1. |
| | | | |
| − | === openSUSE 12.3 64bit ===
| + | '''Note: If you have the 64 bit architecture of openSUSE, 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] |
| − | '''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] | + | |
| | | | |
| − | '''Note''': These instructions have been tested on openSUSE 12.3 64bit (x86_64).
| |
| | | | |
| − | Steps:
| + | === openSUSE 42.1 === |
| − | <ol>
| + | |
| − | <li>Install "vtk" + "vtk-java" + "OpenJDK":
| + | |
| − | <bash>sudo zypper install vtk vtk-java java-1_7_0-openjdk</bash>
| + | |
| − | '''Note''': this assumes that you have already added the Science repository to YaST. If you have not yet done this, run the following command:
| + | |
| − | <bash>sudo zypper ar -fr http://download.opensuse.org/repositories/science/openSUSE_12.3/science.repo</bash>
| + | |
| − | </li>
| + | |
| − | <li>Download the binary tarball for HelyxOS from the [http://sourceforge.net/projects/helyx-os/files/ download section]. For example, download the file:
| + | |
| − | <bash>20130122-Engys-HelyxOS-1.0.1-linux-x64-JRE.tar.bz2</bash>
| + | |
| − | </li>
| + | |
| − | <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>
| + | |
| − | </li>
| + | |
| − | <li>Go into the folder {{tt|Engys/HelyxOS}} and remove the {{tt|jre}} folder:
| + | |
| − | <bash>cd Engys/HelyxOS
| + | |
| − | rm -rf jre</bash>
| + | |
| − | </li>
| + | |
| − | <li>Get a local copy of the OpenJDK installation that openSUSE has got:
| + | |
| − | <bash>cp -r /usr/lib64/jvm/java-1.7.0-openjdk-1.7.0/jre jre</bash>
| + | |
| − | </li>
| + | |
| − | <li>Create a symbolic loophole for the "xawt" subfolder:
| + | |
| − | <bash>ln -s ../xawt jre/lib/amd64/xawt/xawt</bash>
| + | |
| − | </li>
| + | |
| − | <li>Go into the subfolder {{tt|v1.0.1}}:
| + | |
| − | <bash>cd v1.0.1</bash>
| + | |
| − | </li>
| + | |
| − | <li>Edit the file {{tt|bin/launcher.conf}} (e.g. with {{tt|nano}} or {{tt|gedit}}) and search for the following line:
| + | |
| − | <bash>LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"</bash>
| + | |
| − | Replace it with this one:
| + | |
| − | <bash>LD_LIBRARY_PATH="$HELYXHOME/ext:$HELYXHOME/../jre/lib/amd64:$HELYXHOME/../jre/lib/amd64/xawt:$LD_LIBRARY_PATH"</bash>
| + | |
| − | Save and close the file.
| + | |
| − | </li>
| + | |
| − | <li>Eliminate the contents of the {{tt|ext}} subfolder:
| + | |
| − | <bash>rm ext/*</bash>
| + | |
| − | </li>
| + | |
| − | <li>Create a symbolic link list to the actual VTK libraries:
| + | |
| − | <bash>for a in /usr/lib64/vtk/lib*.so.5.10.1; do
| + | |
| − | b=${a%*.5.10.1}
| + | |
| − | ln -s $a ext/${b##*/}
| + | |
| − | done</bash>
| + | |
| − | Or if you prefer a single line of code:
| + | |
| − | <bash>for a in /usr/lib64/vtk/lib*.so.5.10.1; do b=${a%*.5.10.1}; ln -s $a ext/${b##*/}; done</bash>
| + | |
| − | </li>
| + | |
| − | <li>Remove the {{tt|lib/vtk-5.10.jar}} and replace it with a symbolic link to openSUSE's own build:
| + | |
| − | <bash>rm lib/vtk-5.10.jar
| + | |
| − | ln -s /usr/lib64/vtk/java/vtk.jar lib/vtk-5.10.jar</bash>
| + | |
| − | </li>
| + | |
| − | <li>That is it! You are ready to go:
| + | |
| − | <bash>./helyxOS.sh</bash>
| + | |
| − | </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] | + | Unfortunately it's not possible to provide simple instructions for it, because there are several missing Java wrapper libraries from the RPM installation packages. Therefore, VTK will not work properly and will result in Helyx-OS crashing soon after launching it. |
| | | | |
| | | | |
| | [[Category:Installing Helyx-OS]] | | [[Category:Installing Helyx-OS]] |
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.
Unfortunately it's not possible to provide simple instructions for it, because there are several missing Java wrapper libraries from the RPM installation packages. Therefore, VTK will not work properly and will result in Helyx-OS crashing soon after launching it.
