Installation

From enGrid Wiki

(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
 +
__FORCETOC__
 +
== Recommended Method (Linux) ==
== Recommended Method (Linux) ==
Line 47: Line 49:
Building enGrid is somewhat easy, but it's useful that the user already has some background in compiling and building software. The instructions provided here will not inform the user about every single aspect of building enGrid.
Building enGrid is somewhat easy, but it's useful that the user already has some background in compiling and building software. The instructions provided here will not inform the user about every single aspect of building enGrid.
-
Since information about building enGrid can extend considerably, this subject will be divided into various topics, as described in section [[#Topics|Topics]].
+
Since information about building enGrid can extend considerably, this subject will be divided into various topics.
 +
 
 +
=== Building enGrid on a Generic Linux System ===
 +
This explains the general process of building enGrid on a Linux system; the information provided here is out of date and requires a serious revision.<br/>[[Building/Linux|read more]]
 +
 
 +
=== Building enGrid on a Fedora System ===
 +
# '''install various packages (as root):'''
 +
## yum install git
 +
## yum install subversion
 +
## yum install wget
 +
## yum install gcc-c++
 +
## yum install vtk-qt
 +
# '''clone git repository and checkout branch ''release-1.3:'''
 +
## git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid
 +
## cd engrid
 +
## git checkout -b release-1.3 remotes/origin/release-1.3
 +
# '''setup environment variables:'''
 +
## cd src
 +
## source scripts/setup_pathes.bash fedora-15-64<br/>''(or fedora-15-32, fedora-14-64, fedora-14-32)
 +
# '''build NETGEN library:'''
 +
## scripts/build-nglib.sh
 +
# ''' build enGrid library and executable:'''
 +
## cd libengrid
 +
## qmake
 +
## make
 +
## cd ..
 +
## qmake
 +
## make
 +
 
 +
=== Building enGrid on an openSUSE 11.x system ===
 +
# '''add science repository and install various packages (as root):'''
 +
## zypper addrepo <nowiki>http://download.opensuse.org/repositories/science/openSUSE_11.4/</nowiki> science<br/>Make sure to set the correct version number for the repository (i.e. 11.2, 11.3, or 11.4)
 +
## zypper install git-core
 +
## zypper install subversion
 +
## zypper install libqt4-devel
 +
## zypper install make
 +
## zypper install vtk-qt
 +
## zypper install vtk-devel
 +
# '''clone git repository and checkout branch ''release-1.3:'''
 +
## git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid
 +
## cd engrid
 +
## git checkout -b release-1.3 remotes/origin/release-1.3
 +
# '''setup environment variables:'''
 +
## cd src
 +
## source scripts/setup_pathes.bash opensuse64<br/>or source scripts/setup_pathes.bash opensuse32 for a 32 bit system
 +
# '''build NETGEN library:'''
 +
## scripts/build-nglib.sh
 +
# ''' build enGrid library and executable:'''
 +
## cd libengrid
 +
## qmake
 +
## make
 +
## cd ..
 +
## qmake
 +
## make
 +
 
 +
=== Building enGrid on an Ubuntu system ===
 +
# '''make sure that the ''universe'' repository is enabled:'''<br/>See [https://help.ubuntu.com/community/Repositories/Ubuntu https://help.ubuntu.com/community/Repositories/Ubuntu].
 +
# '''install various packages:'''
 +
## sudo apt-get install git
 +
## sudo apt-get install subversion
 +
## sudo apt-get install libvtk5-qt4-dev
 +
## sudo apt-get install qt4-dev-tools
 +
# '''clone git repository and checkout branch ''release-1.3:'''
 +
## git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid
 +
## cd engrid
 +
## git checkout -b release-1.3 remotes/origin/release-1.3
 +
# '''setup environment variables:'''
 +
## cd src
 +
## source scripts/setup_pathes.bash
 +
# '''build NETGEN library:'''
 +
## scripts/build-nglib.sh
 +
# ''' build enGrid library and executable:'''
 +
## cd libengrid
 +
## qmake
 +
## make
 +
## cd ..
 +
## qmake
 +
## make
-
=== Topics ===
+
=== Building enGrid on a Windows System ===
-
These are the topics currently available:
+
This is a detailed description how to compile enGrid on a Windows system.<br/>* [[Building/Windows|read more]]
-
* [[Building/Linux|Building enGrid on a Linux system]]<br/>This explains the general process of building enGrid on a Linux system; the information provided here is out of date and requires a serious revision.
+
-
* [[Building/Fedora-15|Building enGrid on an Fedora 15 system]]<br/>A list of steps to compile enGrid on Fedora 15
+
-
* [[Building/openSUSE-11.x|Building enGrid on an openSUSE 11.x system]]<br/>A list of steps to compile enGrid on openSUSE 11.x
+
-
* [[Building/Ubuntu-11.04|Building enGrid on an Ubuntu 11.04 system]]<br/>A list of steps to compile enGrid on Ubuntu 11.04
+
-
* [[Building/Windows|Building enGrid on a Windows system]]<br/>This is a detailed description how to compile enGrid on a Windows system.
+

Revision as of 17:09, 22 July 2011


Contents

Recommended Method (Linux)

The recommended installation method is to use the automatic build script which can be found on the SourceForge download page; alternatively you can use this direct link: build.bash.

This script offers easy configuration for the following systems:

  1. Fedora
    1. Fedora 14
    2. Fedora 15
  2. openSUSE
    1. openSUSE 11.2
    2. openSUSE 11.3
    3. openSUSE 11.4
  3. Ubuntu
    1. Ubuntu 10.10
    2. Ubuntu 11.04

Put the script into the folder where you want to install enGrid. When you execute the script, it will create a sub-folder named engrid where all sources, binaries, and scripts will be installed. For example: If your webrowser automatically put the script into the folder /home/jonny/Download, and you want enGrid to be inthe folder /home/jonny/Software/, put the script into the folder /home/jonny/Software you need to issue the following commands to kick off the installation (provided that the folder /home/jonny/Software does not exist yet:

cd /home/jonny
mkdir Software
cd Software
mv /home/jonny/Download/build.bash .
source build.bash

Afterwards the script will print a list of available configurations. Assuming you are installing enGrid onto an Ubuntu system, please type the following:

source build.bash ubuntu

Afterwards the script will ask you for the root password, because it needs to launch the system's package manager in order to install the required dependencies. The steps performed by this script are:

  1. install dependencies
    1. VTK >= 5.4
    2. Qt >= 4.5
    3. standard build environment (gcc, make, ...)
  2. fetch enGrid sources from GIT
  3. compile Netgen library
  4. compile enGrid library
  5. compile enGrid executable

Afterwards an optional set-up script can be called in order to create a start script in /usr/bin and a desktop file to be able to start enGrid from the graphical menu system.

source engrid/setup_generic.bash

Please not that this script is the same for all Linux distributions. The dedicated script (e.g. setup_opensuse.bash) are intended for binary packages.

General Building Instructions

Building enGrid is somewhat easy, but it's useful that the user already has some background in compiling and building software. The instructions provided here will not inform the user about every single aspect of building enGrid.

Since information about building enGrid can extend considerably, this subject will be divided into various topics.

Building enGrid on a Generic Linux System

This explains the general process of building enGrid on a Linux system; the information provided here is out of date and requires a serious revision.
read more

Building enGrid on a Fedora System

  1. install various packages (as root):
    1. yum install git
    2. yum install subversion
    3. yum install wget
    4. yum install gcc-c++
    5. yum install vtk-qt
  2. clone git repository and checkout branch release-1.3:
    1. git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid
    2. cd engrid
    3. git checkout -b release-1.3 remotes/origin/release-1.3
  3. setup environment variables:
    1. cd src
    2. source scripts/setup_pathes.bash fedora-15-64
      (or fedora-15-32, fedora-14-64, fedora-14-32)
  4. build NETGEN library:
    1. scripts/build-nglib.sh
  5. build enGrid library and executable:
    1. cd libengrid
    2. qmake
    3. make
    4. cd ..
    5. qmake
    6. make

Building enGrid on an openSUSE 11.x system

  1. add science repository and install various packages (as root):
    1. zypper addrepo http://download.opensuse.org/repositories/science/openSUSE_11.4/ science
      Make sure to set the correct version number for the repository (i.e. 11.2, 11.3, or 11.4)
    2. zypper install git-core
    3. zypper install subversion
    4. zypper install libqt4-devel
    5. zypper install make
    6. zypper install vtk-qt
    7. zypper install vtk-devel
  2. clone git repository and checkout branch release-1.3:
    1. git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid
    2. cd engrid
    3. git checkout -b release-1.3 remotes/origin/release-1.3
  3. setup environment variables:
    1. cd src
    2. source scripts/setup_pathes.bash opensuse64
      or source scripts/setup_pathes.bash opensuse32 for a 32 bit system
  4. build NETGEN library:
    1. scripts/build-nglib.sh
  5. build enGrid library and executable:
    1. cd libengrid
    2. qmake
    3. make
    4. cd ..
    5. qmake
    6. make

Building enGrid on an Ubuntu system

  1. make sure that the universe repository is enabled:
    See https://help.ubuntu.com/community/Repositories/Ubuntu.
  2. install various packages:
    1. sudo apt-get install git
    2. sudo apt-get install subversion
    3. sudo apt-get install libvtk5-qt4-dev
    4. sudo apt-get install qt4-dev-tools
  3. clone git repository and checkout branch release-1.3:
    1. git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid
    2. cd engrid
    3. git checkout -b release-1.3 remotes/origin/release-1.3
  4. setup environment variables:
    1. cd src
    2. source scripts/setup_pathes.bash
  5. build NETGEN library:
    1. scripts/build-nglib.sh
  6. build enGrid library and executable:
    1. cd libengrid
    2. qmake
    3. make
    4. cd ..
    5. qmake
    6. make

Building enGrid on a Windows System

This is a detailed description how to compile enGrid on a Windows system.
* read more

Personal tools