Installation

From enGrid Wiki

(Difference between revisions)
Jump to: navigation, search
(moved Installation to InstallationDebian1.2: outdated for new release)
(Message about page move)
 
(32 intermediate revisions not shown)
Line 1: Line 1:
-
#REDIRECT [[InstallationDebian1.2]]
+
<p style="font-size:26px;">'''NOTE:''' This page has moved to the new wiki location: [https://github.com/enGits/engrid/wiki/Installation Installation]</p>
 +
The content below is kept here only for historic reasons.
 +
<hr>
 +
 
 +
__FORCETOC__
 +
 
 +
== Recommended Method for Linux ==
 +
 
 +
The recommended installation method is to use the automatic build script which can be found on the [https://sourceforge.net/projects/engrid/files/engrid SourceForge download page]. Alternatively you can use:
 +
* this direct link for the script mentioned above: [http://sourceforge.net/projects/engrid/files/engrid/1.3/build.bash/download build.bash]
 +
* this direct link to the git repository for the latest updates to the script: [http://engrid.git.sourceforge.net/git/gitweb.cgi?p=engrid/engrid;a=blob_plain;f=build.bash;hb=refs/heads/release-1.3 build.bash from git]
 +
 
 +
This script offers easy configuration for the following systems:
 +
# Fedora
 +
## Fedora 14
 +
## Fedora 15
 +
# openSUSE
 +
## openSUSE 11.2
 +
## openSUSE 11.3
 +
## openSUSE 11.4
 +
## openSUSE 12.1
 +
# Ubuntu
 +
## Ubuntu 10.10
 +
## Ubuntu 11.04
 +
## Ubuntu 11.10
 +
## Ubuntu 12.04 (use [http://engrid.git.sourceforge.net/git/gitweb.cgi?p=engrid/engrid;a=blob_plain;f=build.bash;hb=refs/heads/release-1.3 build.bash from git])
 +
 
 +
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 web browser automatically puts the script into the folder <tt>/home/jonny/Download</tt>, and you want enGrid to be in the folder <tt>/home/jonny/Software/</tt>, put the script into the folder <tt>/home/jonny/Software</tt> you need to issue the following commands to kick off the installation (provided that the folder <tt>/home/jonny/Software</tt> does not exist yet:
 +
<pre>
 +
cd /home/jonny
 +
mkdir Software
 +
cd Software
 +
mv /home/jonny/Download/build.bash .
 +
source build.bash
 +
</pre>
 +
Afterwards the script will print a list of available configurations. Assuming you are installing enGrid onto an Ubuntu system, please type the following:
 +
<pre>
 +
source build.bash ubuntu
 +
</pre>
 +
The script will then 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:
 +
 
 +
# install dependencies
 +
## VTK >= 5.4
 +
## Qt >= 4.5
 +
## standard build environment (gcc, make, ...)
 +
# fetch enGrid sources from GIT
 +
# compile Netgen library
 +
# compile enGrid library
 +
# compile enGrid executable
 +
 
 +
Afterwards an optional set-up script can be called in order to create a start script in <tt>/usr/bin</tt> and a desktop file to be able to start enGrid from the graphical menu system.
 +
<pre>
 +
engrid/setup_generic.bash
 +
</pre>
 +
'''IMPORTANT: Do not <tt>source</tt> this script -- otherwise it will not work correctly!'''
 +
 
 +
Please note that this script is the same for all Linux distributions. The dedicated scripts (e.g. <tt>setup_opensuse.bash</tt>) are intended for binary packages.
 +
 
 +
== Recommended Method for Windows ==
 +
Download and install the desired architecture version:
 +
* [http://sourceforge.net/projects/engrid/files/engrid/1.3/enGrid_1.3.0_setup_win32_MSVC2008.exe/download enGrid 1.3.0 setup for Windows 32bit]
 +
* [http://sourceforge.net/projects/engrid/files/engrid/1.3/enGrid_1.3.0_setup_win64_MSVC2008.exe/download enGrid 1.3.0 setup for Windows 64bit]
 +
 
 +
Alpha and Beta versions can be found [http://sourceforge.net/projects/wyldckat.u/files/enGrid/ here].
 +
 
 +
Other custom builds are described [[Installation/Custom Builds#Custom Builds Windows|here]].
 +
 
 +
== 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.
 +
# Install various packages as root. Keep in mind that names change depending on distribution and some you might have to build manually:
 +
## <tt>git</tt>
 +
## <tt>subversion</tt>
 +
## <tt>wget</tt>
 +
## <tt>gcc-c++</tt>
 +
## <tt>vtk-qt</tt>
 +
## <tt>qt-devel</tt>
 +
## <tt>vtk-devel</tt>
 +
## <tt>patch</tt>
 +
# As normal user (not root), clone git repository and checkout branch <tt>release-1.3</tt>:
 +
## <tt>git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid</tt><br># or if you are behind a restrictive firewall<br><tt>git clone <nowiki>http://repo.or.cz/r/engrid.git</nowiki> engrid</tt><br># or if neither work, download the tarball<br><tt>wget http://repo.or.cz/w/engrid.git/snapshot/release-1.3.tar.gz</tt><br><tt>tar -xzf engrid-release-1.3.tar.gz</tt>
 +
## <tt>cd engrid</tt>
 +
## <tt>git checkout -b release-1.3 remotes/origin/release-1.3</tt>
 +
# Set-up environment variables:
 +
## <tt>cd src</tt>
 +
## Adjust the following two commands accordingly to your VTK installation:
 +
### <tt>export VTKINCDIR=/usr/local/include/vtk</tt>
 +
### <tt>export VTKLIBDIR=/usr/local/lib</tt>
 +
# Build the NETGEN library:
 +
## <tt>scripts/build-nglib.sh</tt>
 +
# Build enGrid library and executable:
 +
## <tt>qmake</tt>
 +
## <tt>make -j 4</tt> <br>(4 is the number of cores your machine has)
 +
# For running enGrid:
 +
## <tt>./start_engrid.bash</tt>
 +
# Optional - to install an applications icon for the programs menu:
 +
#* Either run from within the folder <tt>engrid</tt> this command as root:
 +
#** <tt>./setup_generic.bash</tt>
 +
#* Or create a shortcut yourself on the desired menu, pointing to the <tt>run.bash</tt> script. An icon is provided at <tt>engrid/src/libengrid/resources/icons/G.png</tt>.
 +
 
 +
 
 +
For the older versions of enGrid, read the old instructions: [[Building/Linux]]
 +
 
 +
=== Building enGrid on a Fedora System ===
 +
# '''install various packages (as root):'''
 +
## <tt>yum install git</tt>
 +
## <tt>yum install subversion</tt>
 +
## <tt>yum install wget</tt>
 +
## <tt>yum install gcc-c++</tt>
 +
## <tt>yum install vtk-qt</tt>
 +
## <tt>yum install qt-devel</tt>
 +
## <tt>yum install vtk-devel</tt>
 +
## <tt>yum install patch</tt>
 +
# '''clone git repository and checkout branch ''release-1.3:'''
 +
## <tt>git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid</tt><br># or if you are behind a restrictive firewall<br><tt>git clone <nowiki>http://repo.or.cz/r/engrid.git</nowiki> engrid</tt><br># or if neither work, download the tarball<br><tt>wget http://repo.or.cz/w/engrid.git/snapshot/release-1.3.tar.gz</tt><br><tt>tar -xzf engrid-release-1.3.tar.gz</tt>
 +
## <tt>cd engrid</tt>
 +
## <tt>git checkout -b release-1.3 remotes/origin/release-1.3</tt>
 +
# '''setup environment variables:'''
 +
## <tt>cd src</tt>
 +
## <tt>source scripts/setup_pathes.bash fedora64</tt><br/>(or <tt>fedora32</tt>)
 +
# '''build NETGEN library:'''
 +
## <tt>scripts/build-nglib.sh</tt>
 +
# ''' build enGrid library and executable:'''
 +
## <tt>qmake</tt>
 +
## <tt>make -j 4</tt> <br>(4 is the number of cores your machine has)
 +
 
 +
=== Building enGrid on an openSUSE 11.x or 12.x system ===
 +
# '''add science repository and install various packages (as root):'''
 +
## <tt>zypper addrepo <nowiki>http://download.opensuse.org/repositories/science/openSUSE_11.4/</nowiki> science</tt><br/>Make sure to set the correct version number for the repository (i.e. 11.2, 11.3, 11.4, or 12.1)
 +
## <tt>zypper install git-core</tt>
 +
## <tt>zypper install patch</tt>
 +
## <tt>zypper install subversion</tt>
 +
## <tt>zypper install libqt4-devel</tt>
 +
## <tt>zypper install make</tt>
 +
## <tt>zypper install vtk-qt</tt>
 +
## <tt>zypper install vtk-devel</tt>
 +
# '''clone git repository and checkout branch ''release-1.3:'''
 +
## <tt>git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid</tt><br># or if you are behind a restrictive firewall<br/><tt>git clone <nowiki>http://repo.or.cz/r/engrid.git</nowiki> engrid</tt><br># or if neither work, download the tarball<br><tt>wget http://repo.or.cz/w/engrid.git/snapshot/release-1.3.tar.gz</tt><br><tt>tar -xzf engrid-release-1.3.tar.gz</tt>
 +
## <tt>cd engrid</tt>
 +
## <tt>git checkout -b release-1.3 remotes/origin/release-1.3</tt>
 +
# '''setup environment variables:'''
 +
## <tt>cd src</tt>
 +
## <tt>source scripts/setup_pathes.bash opensuse64</tt><br/>or <tt>source scripts/setup_pathes.bash opensuse32</tt> for a 32 bit system
 +
# '''build NETGEN library:'''
 +
## <tt>scripts/build-nglib.sh</tt>
 +
# ''' build enGrid library and executable:'''
 +
## <tt>qmake</tt>
 +
## <tt>make -j 4</tt> <br>(4 is the number of cores your machine has)
 +
 
 +
=== 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:'''
 +
## <tt>sudo apt-get install git</tt>
 +
## <tt>sudo apt-get install patch</tt>
 +
## <tt>sudo apt-get install subversion</tt>
 +
## <tt>sudo apt-get install g++</tt>
 +
## <tt>sudo apt-get install libvtk5-qt4-dev</tt>
 +
## <tt>sudo apt-get install qt4-dev-tools</tt>
 +
# '''clone git repository and checkout branch ''release-1.3:'''
 +
## <tt>git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid</tt><br># or if you are behind a restrictive firewall<br/><tt>git clone <nowiki>http://repo.or.cz/r/engrid.git</nowiki> engrid</tt><br># or if neither work, download the tarball<br><tt>wget http://repo.or.cz/w/engrid.git/snapshot/release-1.3.tar.gz</tt><br><tt>tar -xzf engrid-release-1.3.tar.gz</tt>
 +
## <tt>cd engrid</tt>
 +
## <tt>git checkout -b release-1.3 remotes/origin/release-1.3</tt>
 +
# '''setup environment variables:'''
 +
## <tt>cd src</tt>
 +
## <tt>source scripts/setup_pathes.bash ubuntu</tt>
 +
# '''build NETGEN library:'''
 +
## <tt>scripts/build-nglib.sh</tt>
 +
# ''' build enGrid library and executable:'''
 +
## <tt>qmake</tt>
 +
## <tt>make -j 4</tt> <br>(4 is the number of cores your machine has)
 +
 
 +
=== Building enGrid on a Windows System ===
 +
This topic is very extensive, therefore the detailed description on how to compile enGrid on a Windows system is provided [[Building/Windows|here]].

Latest revision as of 13:01, 14 July 2012

NOTE: This page has moved to the new wiki location: Installation

The content below is kept here only for historic reasons.



Contents

Recommended Method for 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 for the script mentioned above: build.bash
  • this direct link to the git repository for the latest updates to the script: build.bash from git

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
    4. openSUSE 12.1
  3. Ubuntu
    1. Ubuntu 10.10
    2. Ubuntu 11.04
    3. Ubuntu 11.10
    4. Ubuntu 12.04 (use build.bash from git)

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 web browser automatically puts the script into the folder /home/jonny/Download, and you want enGrid to be in the 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

The script will then 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.

engrid/setup_generic.bash

IMPORTANT: Do not source this script -- otherwise it will not work correctly!

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

Recommended Method for Windows

Download and install the desired architecture version:

Alpha and Beta versions can be found here.

Other custom builds are described here.

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.

  1. Install various packages as root. Keep in mind that names change depending on distribution and some you might have to build manually:
    1. git
    2. subversion
    3. wget
    4. gcc-c++
    5. vtk-qt
    6. qt-devel
    7. vtk-devel
    8. patch
  2. As normal user (not root), clone git repository and checkout branch release-1.3:
    1. git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid
      # or if you are behind a restrictive firewall
      git clone http://repo.or.cz/r/engrid.git engrid
      # or if neither work, download the tarball
      wget http://repo.or.cz/w/engrid.git/snapshot/release-1.3.tar.gz
      tar -xzf engrid-release-1.3.tar.gz
    2. cd engrid
    3. git checkout -b release-1.3 remotes/origin/release-1.3
  3. Set-up environment variables:
    1. cd src
    2. Adjust the following two commands accordingly to your VTK installation:
      1. export VTKINCDIR=/usr/local/include/vtk
      2. export VTKLIBDIR=/usr/local/lib
  4. Build the NETGEN library:
    1. scripts/build-nglib.sh
  5. Build enGrid library and executable:
    1. qmake
    2. make -j 4
      (4 is the number of cores your machine has)
  6. For running enGrid:
    1. ./start_engrid.bash
  7. Optional - to install an applications icon for the programs menu:
    • Either run from within the folder engrid this command as root:
      • ./setup_generic.bash
    • Or create a shortcut yourself on the desired menu, pointing to the run.bash script. An icon is provided at engrid/src/libengrid/resources/icons/G.png.


For the older versions of enGrid, read the old instructions: Building/Linux

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
    6. yum install qt-devel
    7. yum install vtk-devel
    8. yum install patch
  2. clone git repository and checkout branch release-1.3:
    1. git clone git://engrid.git.sourceforge.net/gitroot/engrid/engrid
      # or if you are behind a restrictive firewall
      git clone http://repo.or.cz/r/engrid.git engrid
      # or if neither work, download the tarball
      wget http://repo.or.cz/w/engrid.git/snapshot/release-1.3.tar.gz
      tar -xzf engrid-release-1.3.tar.gz
    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 fedora64
      (or fedora32)
  4. build NETGEN library:
    1. scripts/build-nglib.sh
  5. build enGrid library and executable:
    1. qmake
    2. make -j 4
      (4 is the number of cores your machine has)

Building enGrid on an openSUSE 11.x or 12.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, 11.4, or 12.1)
    2. zypper install git-core
    3. zypper install patch
    4. zypper install subversion
    5. zypper install libqt4-devel
    6. zypper install make
    7. zypper install vtk-qt
    8. 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
      # or if you are behind a restrictive firewall
      git clone http://repo.or.cz/r/engrid.git engrid
      # or if neither work, download the tarball
      wget http://repo.or.cz/w/engrid.git/snapshot/release-1.3.tar.gz
      tar -xzf engrid-release-1.3.tar.gz
    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. qmake
    2. make -j 4
      (4 is the number of cores your machine has)

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 patch
    3. sudo apt-get install subversion
    4. sudo apt-get install g++
    5. sudo apt-get install libvtk5-qt4-dev
    6. 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
      # or if you are behind a restrictive firewall
      git clone http://repo.or.cz/r/engrid.git engrid
      # or if neither work, download the tarball
      wget http://repo.or.cz/w/engrid.git/snapshot/release-1.3.tar.gz
      tar -xzf engrid-release-1.3.tar.gz
    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 ubuntu
  5. build NETGEN library:
    1. scripts/build-nglib.sh
  6. build enGrid library and executable:
    1. qmake
    2. make -j 4
      (4 is the number of cores your machine has)

Building enGrid on a Windows System

This topic is very extensive, therefore the detailed description on how to compile enGrid on a Windows system is provided here.

Personal tools