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:

Lines that start with # don't have to be copy-pasted. They are just comments to let you know what's going on.
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:

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

Note: If you have the 64 bit architecture of openSUSE, perhaps it's best to follow the official installation instructions: Installation of the Latest 64 Bit Linux Binaries @ Github

2.1.1 openSUSE 42.1

2.1.1.1 openSUSE 42.1 32bit

Discussion thread where you can ask questions about these steps: Installing HelyxOS on 32 and 64bit Linux Distributions

Steps:

Install VTK 6.3 + OpenJDK 1.8.0:

sudo zypper install vtk vtk-java java-1_8_0-openjdk java-1_8_0-openjdk-devel

Download the binary tarball for HelyxOS from the download section. You can also download the file through the command line, by running:

wget "https://github.com/ENGYS/HELYX-OS/releases/download/v2.3.1/HELYX-OS-2.3.1-linux-x86_64.tar.bz2" \
-O "HELYX-OS-2.3.1-linux-x86_64.tar.bz2"

Unpack the tarball for HelyxOS where you want to install HelyxOS:
```
tar -xjf HELYX-OS-2.3.1-linux-x86_64.tar.bz2
```
Go into the folder Engys/HelyxOS and remove the jre folder:
```
cd Engys/HELYX-OS
rm -rf jre
```
Link to the OpenJDK installation that openSUSE has got:
```
ln -s /usr/lib/jvm/java-1.8.0-openjdk/jre jre
```
Go into the subfolder v2.3.1:
```
cd v2.3.1
```
Eliminate unneeded contents from the ext subfolder and get a local copy of the necessary VTK libraries:
```
rm -rf ext/lib*
cp -a /usr/lib/vtk/libvtk* ext/
```

Remove the lib/vtk6.jar, get the one from Fedora, do a few tweaks and package it nicely:

rm lib/vtk6.jar
mkdir lib/vtk6
cd lib/vtk6
unzip /usr/lib/vtk/vtk.jar
sed -i \
  -e 's=.*vtkIOParallelExodusJava.*==' \
  -e 's=.*vtkIOGeoJSONJava.*==' \
  -e 's=.*vtkIOMySQLJava.*==' \
  -e 's=.*vtkIOXdmf2Java.*==' \
  -e 's=.*vtkIOVPICJava.*==' \
  -e 's=.*vtkIOGDALJava.*==' \
  -e 's=.*vtkIOExportJava.*==' \
  -e 's=.*vtkIOADIOSJava.*==' \
  -e 's=.*vtkIOParallelLSDynaJava.*==' \
  -e 's=.*vtkIOXdmf3Java.*==' \
  -e 's=.*vtkIOFFMPEGJava.*==' \
  -e 's=.*vtkIOPostgreSQLJava.*==' \
  -e 's=.*vtkIOODBCJava.*==' \
  -e 's=.*vtkAcceleratorsPistonJava.*==' \
  -e 's=.*vtkAcceleratorsDaxJava.*==' \
  -e 's=.*vtkDomainsChemistryJava.*==' \
  -e 's=.*vtkDomainsChemistryOpenGL2Java.*==' \
  -e 's=.*vtkRenderingVolumeJava.*==' \
  -e 's=.*vtkRenderingFreeTypeJava.*==' \
  -e 's=.*vtkRenderingContextOpenGLJava.*==' \
  -e 's=.*vtkRenderingOpenGL2Java.*==' \
  -e 's=.*vtkRenderingOpenGLJava.*==' \
  -e 's=.*vtkRenderingLICOpenGL2Java.*==' \
  -e 's=.*vtkRenderingImageJava.*==' \
  -e 's=.*vtkRenderingContext2DJava.*==' \
  -e 's=.*vtkRenderingLabelJava.*==' \
  -e 's=.*vtkRenderingExternalJava.*==' \
  -e 's=.*vtkRenderingMatplotlibJava.*==' \
  -e 's=.*vtkRenderingVolumeOpenGLJava.*==' \
  -e 's=.*vtkRenderingLODJava.*==' \
  -e 's=.*vtkRenderingVolumeOpenGL2Java.*==' \
  -e 's=.*vtkRenderingQtJava.*==' \
  -e 's=.*vtkRenderingCoreJava.*==' \
  -e 's=.*vtkRenderingLICJava.*==' \
  -e 's=.*vtkRenderingVolumeAMRJava.*==' \
  -e 's=.*vtkRenderingParallelJava.*==' \
  -e 's=.*vtkRenderingContextOpenGL2Java.*==' \
  -e 's=.*vtkRenderingParallelLICJava.*==' \
  -e 's=.*vtkRenderingAnnotationJava.*==' \
  -e 's=.*vtkViewsContext2DJava.*==' \
  -e 's=.*vtkViewsInfovisJava.*==' \
  -e 's=.*vtkViewsGeovisJava.*==' \
  -e 's=.*vtkInfovisParallelJava.*==' \
  -e 's=.*vtkInfovisBoostGraphAlgorithmsJava.*==' \
  -e 's=.*vtkFiltersReebGraphJava.*==' \
  -e 's=.*vtkFiltersParallelStatisticsJava.*==' \
  -e 's=.*vtkFiltersPythonJava.*==' \
  -e 's=.*vtkFiltersParallelFlowPathsJava.*==' \
  -e 's=.*vtkTestingRenderingJava.*==' \
  -e 's=.*vtkPythonInterpreterJava.*==' \
  -e 's=.*vtkWebGLExporterJava.*==' \
  -e 's=.*vtkWebCoreJava.*==' \
  -e 's=.*vtkGeovisCoreJava.*==' \
  -e 's=.*vtkInteractionStyleJava.*==' \
  -e 's=.*vtkInteractionWidgetsJava.*==' \
  -e 's=.*vtkParallelMPI4PyJava.*==' \
  -e 's=.*vtkChartsCoreJava.*==' \
  -e 's=\(VTKPARALLELCORE.*\),=\1;=' \
  vtk/vtkNativeLibrary.java
javac vtk/vtkNativeLibrary.java
zip -r ../vtk6.jar *
cd ../..

That is it! You are ready to go:
```
./HELYX-OS.sh
```