Difference between revisions of "Installation/Helyx-OS/openSUSE"

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 [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 16: Line 14:
 
# 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>
  
 
=== openSUSE 11.4 ===
 
=== openSUSE 11.4 ===
Line 261: Line 268:
  
 
'''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 openSUSE.

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


=== openSUSE 11.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]. 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 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.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.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]. 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 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.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.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]. 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 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.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.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]


==== openSUSE 12.3 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 tested on openSUSE 12.3 64bit (x86_64).

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