|
|
Line 25: |
Line 25: |
| In this section are the instructions meant for 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:''' [http://engys.github.io/HELYX-OS/installation/ Installation of the Latest 64 Bit Linux Binaries @ Github] | + | '''Note: If you have the 64 bit architecture of CentOS/RHEL/SL, 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] |
| | | |
| + | As for 32-bit, it's not possible to provide simple instructions for it, due to the following reasons: |
| + | # The EPEL repositories for CentOS/RHEL/SL 6.x only provide VTK 5.8 and Helyx-OS requires at least VTK 6.1. |
| + | # The EPEL repositories for CentOS/RHEL/SL 7.x provide VTK 6.1, but i686 is not in the primary tier for supported architectures, therefore the EPEL repositories are only available for 64-bit platforms. |
| | | |
− | '''The following is undergoing reconstruction...'''
| |
− | <pre>
| |
− |
| |
− | === CentOS 6.4 ===
| |
− |
| |
− | ==== CentOS 6.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 written for CentOS 6.4 32bit (i686) (based on the ones for Fedora 17 and CentOS 6.4 x86_64). They might work on CentOS 6.3.
| |
− |
| |
− | Steps:
| |
− | <ol>
| |
− | <li>Install the EPEL repository, which will provide VTK 5.8 with Java bindings:
| |
− | <bash>su -c 'rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm'</bash>
| |
− | Details about EPEL:
| |
− | * [http://fedoraproject.org/wiki/EPEL Main page about EPEL]
| |
− | * [http://fedoraproject.org/wiki/EPEL/FAQ Frequently asked Questions about EPEL]
| |
− | * [http://download.fedoraproject.org/pub/epel/6/i386/repoview/epel-release.html Page where it's indicated the name of the latest EPEL package for installing the repository]
| |
− | </li>
| |
− | <li>Install "vtk" + "vtk-java" + "OpenJDK":
| |
− | <bash>su -c 'yum install vtk vtk-java java-1.7.0-openjdk'</bash>
| |
− | </li>
| |
− | <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>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>Unpack the tarball for HelyxOS where you want to install HelyxOS:
| |
− | <bash>tar -xjf 20130715-Engys-HelyxOS-1.0.3-linux-x86_64-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 CentOS has got:
| |
− | <bash>mkdir jre
| |
− | cp -r /usr/lib/jvm/jre-1.7.0-openjdk/* jre/</bash>
| |
− | </li>
| |
− | <li>Go into the subfolder {{tt|v1.0.3}}:
| |
− | <bash>cd v1.0.3</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.8.0; do
| |
− | b=${a%*.5.8.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.8.0; do b=${a%*.5.8.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 CentOS'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]
| |
− |
| |
− |
| |
− | ==== CentOS 6.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 CentOS 6.4 64bit (x86_64). They might work on CentOS 6.3.
| |
− |
| |
− | Steps:
| |
− | <ol>
| |
− | <li>Install the EPEL repository, which will provide VTK 5.8 with Java bindings:
| |
− | <bash>su -c 'rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm'</bash>
| |
− | Details about EPEL:
| |
− | * [http://fedoraproject.org/wiki/EPEL Main page about EPEL]
| |
− | * [http://fedoraproject.org/wiki/EPEL/FAQ Frequently asked Questions about EPEL]
| |
− | * [http://download.fedoraproject.org/pub/epel/6/i386/repoview/epel-release.html Page where it's indicated the name of the latest EPEL package for installing the repository]
| |
− | </li>
| |
− | <li>Install "vtk" + "vtk-java" + "OpenJDK":
| |
− | <bash>su -c 'yum install vtk vtk-java java-1.7.0-openjdk'</bash>
| |
− | </li>
| |
− | <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>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>Unpack the tarball for HelyxOS where you want to install HelyxOS:
| |
− | <bash>tar -xjf 20130715-Engys-HelyxOS-1.0.3-linux-x86_64-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 CentOS has got:
| |
− | <bash>mkdir jre
| |
− | cp -r /usr/lib/jvm/jre-1.7.0-openjdk.x86_64/* jre/</bash>
| |
− | </li>
| |
− | <li>Go into the subfolder {{tt|v1.0.3}}:
| |
− | <bash>cd v1.0.3</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.8.0; do
| |
− | b=${a%*.5.8.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.8.0; do b=${a%*.5.8.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 CentOS'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]
| |
− | </pre>
| |
| | | |
| [[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.
In this section are the instructions meant for Helyx-OS v2.3.1.
As for 32-bit, it's not possible to provide simple instructions for it, due to the following reasons: