Latest revision as of 09:17, 27 March 2016

1 Introduction

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

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:

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

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

2.1.1 Fedora 23

2.1.1.1 Fedora 23 32bit

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

Steps:

1. Install VTK + OpenJDK:

   su -c 'dnf install vtk vtk-java vtk-devel java-1.8.0-openjdk java-1.8.0-openjdk-devel'

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

3. Unpack the tarball for HelyxOS where you want to install HelyxOS:

   tar -xjf HELYX-OS-2.3.1-linux-x86_64.tar.bz2

4. Go into the folder Engys/HelyxOS and remove the jre folder:

   cd Engys/HELYX-OS
   rm -rf jre

5. Link to the OpenJDK installation that Fedora has got:

   mkdir jre
   ln -s /usr/lib/jvm/jre-1.8.0-openjdk jre

6. Go into the subfolder v2.3.1:

   cd v2.3.1

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

8. 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=.*vtkRenderingParallelLICJava.*==' \
     -e 's=.*vtkRenderingVolumeOpenGL2Java.*==' \
     -e 's=.*vtkRenderingVolumeOpenGLNewJava.*==' \
     -e 's=.*vtkRenderingExternalJava.*==' \
     -e 's=.*vtkRenderingParallelJava.*==' \
     -e 's=.*vtkRenderingOpenGL2Java.*==' \
     -e 's=.*vtkRenderingContextOpenGL2Java.*==' \
     -e 's=.*vtkRenderingFreeTypeOpenGL2Java.*==' \
     -e 's=.*vtkRenderingVolumeAMRJava.*==' \
     -e 's=.*vtkRenderingMatplotlibJava.*==' \
     -e 's=.*vtkParallelMPIJava.*==' \
     -e 's=.*vtkParallelMPI4PyJava.*==' \
     -e 's=.*vtkDomainsChemistryOpenGL2Java.*==' \
     -e 's=.*vtkAcceleratorsDaxJava.*==' \
     -e 's=.*vtkAcceleratorsPistonJava.*==' \
     -e 's=.*vtkInfovisParallelJava.*==' \
     -e 's=.*vtkInfovisBoostGraphAlgorithmsJava.*==' \
     -e 's=.*vtkWebGLExporterJava.*==' \
     -e 's=.*vtkWebCoreJava.*==' \
     -e 's=.*vtkIOParallelExodusJava.*==' \
     -e 's=.*vtkIOODBCJava.*==' \
     -e 's=.*vtkIOGDALJava.*==' \
     -e 's=.*vtkIOVPICJava.*==' \
     -e 's=.*vtkIOMPIImageJava.*==' \
     -e 's=.*vtkIOADIOSJava.*==' \
     -e 's=.*vtkIOGeoJSONJava.*==' \
     -e 's=.*vtkIOMPIParallelJava.*==' \
     -e 's=.*vtkIOXdmf2Java.*==' \
     -e 's=.*vtkIOMySQLJava.*==' \
     -e 's=.*vtkIOParallelLSDynaJava.*==' \
     -e 's=.*vtkIOXdmf3Java.*==' \
     -e 's=.*vtkIOFFMPEGJava.*==' \
     -e 's=.*vtkIOPostgreSQLJava.*==' \
     -e 's=.*vtkIOParallelNetCDFJava.*==' \
     -e 's=.*vtkPythonInterpreterJava.*==' \
     -e 's=.*vtkFiltersParallelFlowPathsJava.*==' \
     -e 's=.*vtkFiltersReebGraphJava.*==' \
     -e 's=.*vtkFiltersPythonJava.*==' \
     -e 's=.*vtkFiltersParallelGeometryJava.*==' \
     -e 's=.*vtkFiltersParallelStatisticsJava.*==' \
     -e 's=.*vtkFiltersParallelMPIJava.*==' \
     vtk/vtkNativeLibrary.java
   javac vtk/vtkNativeLibrary.java
   zip -r ../vtk6.jar *
   cd ../..

9. That is it! You are ready to go:

   ./HELYX-OS.sh

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

2.1.1.2 Fedora 23 64bit

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

Steps:

1. Install VTK + OpenJDK:

   su -c 'dnf install vtk vtk-java vtk-devel java-1.8.0-openjdk java-1.8.0-openjdk-devel'

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

3. Unpack the tarball for HelyxOS where you want to install HelyxOS:

   tar -xjf HELYX-OS-2.3.1-linux-x86_64.tar.bz2

4. Go into the folder Engys/HelyxOS and remove the jre folder:

   cd Engys/HELYX-OS
   rm -rf jre

5. Link to the OpenJDK installation that Fedora has got:

   mkdir jre
   ln -s /usr/lib64/jvm/jre-1.8.0-openjdk jre

6. Go into the subfolder v2.3.1:

   cd v2.3.1

7. Eliminate unneeded contents from the ext subfolder and get a local copy of the necessary VTK libraries:

   rm -rf ext/lib*
   cp -a /usr/lib64/vtk/libvtk* ext/

8. 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/lib64/vtk/vtk.jar
   sed -i \
     -e 's=.*vtkRenderingParallelLICJava.*==' \
     -e 's=.*vtkRenderingVolumeOpenGL2Java.*==' \
     -e 's=.*vtkRenderingVolumeOpenGLNewJava.*==' \
     -e 's=.*vtkRenderingExternalJava.*==' \
     -e 's=.*vtkRenderingParallelJava.*==' \
     -e 's=.*vtkRenderingOpenGL2Java.*==' \
     -e 's=.*vtkRenderingContextOpenGL2Java.*==' \
     -e 's=.*vtkRenderingFreeTypeOpenGL2Java.*==' \
     -e 's=.*vtkRenderingVolumeAMRJava.*==' \
     -e 's=.*vtkRenderingMatplotlibJava.*==' \
     -e 's=.*vtkParallelMPIJava.*==' \
     -e 's=.*vtkParallelMPI4PyJava.*==' \
     -e 's=.*vtkDomainsChemistryOpenGL2Java.*==' \
     -e 's=.*vtkAcceleratorsDaxJava.*==' \
     -e 's=.*vtkAcceleratorsPistonJava.*==' \
     -e 's=.*vtkInfovisParallelJava.*==' \
     -e 's=.*vtkInfovisBoostGraphAlgorithmsJava.*==' \
     -e 's=.*vtkWebGLExporterJava.*==' \
     -e 's=.*vtkWebCoreJava.*==' \
     -e 's=.*vtkIOParallelExodusJava.*==' \
     -e 's=.*vtkIOODBCJava.*==' \
     -e 's=.*vtkIOGDALJava.*==' \
     -e 's=.*vtkIOVPICJava.*==' \
     -e 's=.*vtkIOMPIImageJava.*==' \
     -e 's=.*vtkIOADIOSJava.*==' \
     -e 's=.*vtkIOGeoJSONJava.*==' \
     -e 's=.*vtkIOMPIParallelJava.*==' \
     -e 's=.*vtkIOXdmf2Java.*==' \
     -e 's=.*vtkIOMySQLJava.*==' \
     -e 's=.*vtkIOParallelLSDynaJava.*==' \
     -e 's=.*vtkIOXdmf3Java.*==' \
     -e 's=.*vtkIOFFMPEGJava.*==' \
     -e 's=.*vtkIOPostgreSQLJava.*==' \
     -e 's=.*vtkIOParallelNetCDFJava.*==' \
     -e 's=.*vtkPythonInterpreterJava.*==' \
     -e 's=.*vtkFiltersParallelFlowPathsJava.*==' \
     -e 's=.*vtkFiltersReebGraphJava.*==' \
     -e 's=.*vtkFiltersPythonJava.*==' \
     -e 's=.*vtkFiltersParallelGeometryJava.*==' \
     -e 's=.*vtkFiltersParallelStatisticsJava.*==' \
     -e 's=.*vtkFiltersParallelMPIJava.*==' \
     vtk/vtkNativeLibrary.java
   javac vtk/vtkNativeLibrary.java
   zip -r ../vtk6.jar *
   cd ../..

9. That is it! You are ready to go:

   ./HELYX-OS.sh

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