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

From OpenFOAMWiki
m (line break for the lengthy command)
(Going over details to try and reconstruct the instructions for Helyx-OS 2.3.1)
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 21: Line 19:
 
# 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!
 
# 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!
  
== Helyx-OS v1.0.3 ==
+
 
In this section are the instructions meant for Helyx-OS v1.0.3.
+
== 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]
 +
 
 +
 
 +
'''The following is undergoing reconstruction...'''
 +
<pre>
  
 
=== CentOS 6.4 ===
 
=== CentOS 6.4 ===
Line 152: Line 159:
  
 
'''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]
 
+
</pre>
  
 
[[Category:Installing Helyx-OS]]
 
[[Category:Installing Helyx-OS]]

Revision as of 00:58, 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 Ubuntu, perhaps it's best to follow the official installation instructions: Installation of the Latest 64 Bit Linux Binaries @ Github


The following is undergoing reconstruction...


=== 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]