Difference between revisions of "Installation/Helyx-OS/CentOS SL RHEL"

From OpenFOAMWiki
(Switched to more explicit instructions for version 1.0.3)
(Can't easily have Helyx-OS on CentOS :()
 
(4 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:
+
This page is dedicated to explaining how to install [http://engys.github.io/HELYX-OS/ Helyx-OS] in:
 
* Community ENTerprise Operating System, aka '''CentOS'''.
 
* Community ENTerprise Operating System, aka '''CentOS'''.
 
* Red Hat Enterprise Linux, aka '''RHEL'''.
 
* Red Hat Enterprise Linux, aka '''RHEL'''.
 
* Scientific Linux, aka '''SL'''.
 
* Scientific Linux, aka '''SL'''.
  
In '''theory''', all of the above follow the same versioning. Therefore, at the time this page was first written, RHEL, CentOS and SL were all at version {{tt|6.4}}.
+
In '''theory''', all of the above follow the same versioning. Therefore, at the time this page was first written, RHEL, CentOS and SL were all at version {{tt|6.7}}.
 
+
'''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 22: Line 20:
  
  
== CentOS 6.4 ==
+
== Helyx-OS v2.3.1 ==
 
+
{{VersionInfo}}{{version2.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.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.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.
+
In this section are the instructions meant for Helyx-OS v2.3.1.
  
Steps:
+
'''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]
<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.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.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]
+
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.
  
  
 
[[Category:Installing Helyx-OS]]
 
[[Category:Installing Helyx-OS]]

Latest revision as of 08:53, 27 March 2016

1 Introduction

This page is dedicated to explaining how to install Helyx-OS in:

  • Community ENTerprise Operating System, aka CentOS.
  • Red Hat Enterprise Linux, aka RHEL.
  • Scientific Linux, aka SL.

In theory, all of the above follow the same versioning. Therefore, at the time this page was first written, RHEL, CentOS and SL were all at version 6.7.

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 v2.3.1

Valid versions: OF Version 24.png

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

Note: If you have the 64 bit architecture of CentOS/RHEL/SL, perhaps it's best to follow the official installation instructions: 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:

  1. The EPEL repositories for CentOS/RHEL/SL 6.x only provide VTK 5.8 and Helyx-OS requires at least VTK 6.1.
  2. 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.