-
Notifications
You must be signed in to change notification settings - Fork 55
[enGrid 1.4] Installation
The recommended installation method is to use the automatic build script which can be found on the git repository for the latest updates to the script: build.bash from git
This script offers easy configuration for the following systems:
- Fedora
- Fedora 14
- Fedora 15
- Fedora 16
- Fedora 17
- openSUSE
- openSUSE 11.2
- openSUSE 11.3
- openSUSE 11.4
- openSUSE 12.1
- openSUSE 12.2
- Ubuntu
- Ubuntu 10.10
- Ubuntu 11.04
- Ubuntu 11.10
- Ubuntu 12.04
- Ubuntu 12.10
cd /home/jonny mkdir Software cd Software mv /home/jonny/Download/build.bash . source build.bashAfterwards 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 ubuntuThe 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
engrid/setup_generic.bashIMPORTANT: 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.
The build.bash scripts can also be used for the following Linux Distributions:
-
Debian 6 - Simply use the ubuntu option:
source build.bash ubuntu
-
CentOS 6 - You can use the fedora option, but you first must install the EPEL repository:
- Check the newest version of 'epel-release' for EL6.
- Use the package name given and use it the next command line for replacing PACKAGENAME:
sudo rpm -ivh http://download.fedoraproject.org/pub/epel/6/i386/PACKAGENAME
- Example for epel-release-6-7.noarch.rpm:
sudo rpm -ivh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-7.noarch.rpm
- Example for epel-release-6-7.noarch.rpm:
- Update the package manager:
sudo yum -y update
- Run the installation script as usual for Fedora:
source build.bash fedora
In order to make things a bit simpler, enGrid is now available via CAE Team's PPA at Launchpad. To install enGrid, you can simply run (one command at a time):
sudo add-apt-repository ppa:cae-team/ppa sudo apt-get update sudo apt-get install engridSupported Ubuntu versions:
- 11.10 Oneiric Ocelot
- 12.04 Precise Pangolin
- 12.10 Quantal Quetzal
sudo apt-get install engrid-docThe tutorials will then be available in the folder /usr/share/doc/engrid-doc/tutorials.
And you can also install the scripts for Blender (caution: it will also install Blender):
sudo apt-get install engrid-blenderscriptsThe scripts will then be available at /usr/share/blender/scripts/engrid/. You will need to check the script installation instructions for the installed Blender version. For example, on Blender 2.6 you can install the scripts as add-ons, as described here: Installing Add-Ons in Blender
Download and install the desired architecture version:
- enGrid 1.4.0 setup for Windows 32bit (md5sum: 7d0ce218fbea80ad67c339fc3ac71922)
- enGrid 1.4.0 setup for Windows 64bit (md5sum: 801c70f070dbe482916eecacd06fbeba)
Other custom builds are described here.
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.
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:
git subversion wget gcc-c++ vtk-qt qt-devel vtk-devel patch
- As normal user (not root), clone git repository and checkout branch release-1.4:
- You can use any single one of the following options:
git clone git://github.com/enGits/engrid.git engrid git clone https://github.com/enGits/engrid.git engrid git clone git://repo.or.cz/engrid-github.git engrid git clone http://repo.or.cz/r/engrid-github.git engrid
- Go into enGrid's folder:
cd engrid
- Checkout the release-1.4 branch:
git checkout -b release-1.4 remotes/origin/release-1.4
- You can use any single one of the following options:
- Go into the source code folder:
cd src
- Set-up the environment variables, for which you need to adjust and execute the following two commands accordingly to your VTK installation:
export VTKINCDIR=/usr/local/include/vtk export VTKLIBDIR=/usr/local/lib
- Build the NETGEN library:
scripts/build-nglib.sh
- Build enGrid library and executable:
qmake # Replace 4 with the number of cores your machine has make -j 4
- For running enGrid:
./start_engrid.bash
- 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.
- Either run from within the folder engrid this command as root:
- Install the various necessary packages, by running the following commands as root:
yum install git yum install subversion yum install wget yum install gcc-c++ yum install vtk-qt yum install qt-devel yum install vtk-devel yum install patch
- As normal user (not root), clone git repository and checkout branch release-1.4:
- You can use any single one of the following options:
git clone git://github.com/enGits/engrid.git engrid git clone https://github.com/enGits/engrid.git engrid git clone git://repo.or.cz/engrid-github.git engrid git clone http://repo.or.cz/r/engrid-github.git engrid
- Go into enGrid's folder:
cd engrid
- Checkout the release-1.4 branch:
git checkout -b release-1.4 remotes/origin/release-1.4
- You can use any single one of the following options:
- Go into the source code folder:
cd src
- Set-up the environment variables, simply by running:
source scripts/setup_pathes.bash
- Build the NETGEN library:
scripts/build-nglib.sh
- Build enGrid library and executable:
qmake # Replace 4 with the number of cores your machine has make -j 4
- For running enGrid:
./start_engrid.bash
- 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.
- Either run from within the folder engrid this command as root:
- Install the various necessary packages, by running the following commands as root:
# Make sure to set the correct version number for the repository (i.e. 11.2, 11.3, 11.4, 12.1 or 12.2) zypper addrepo http://download.opensuse.org/repositories/science/openSUSE_11.4/ science zypper install git-core patch subversion libqt4-devel make vtk-qt vtk-devel
- As normal user (not root), clone git repository and checkout branch release-1.4:
- You can use any single one of the following options:
git clone git://github.com/enGits/engrid.git engrid git clone https://github.com/enGits/engrid.git engrid git clone git://repo.or.cz/engrid-github.git engrid git clone http://repo.or.cz/r/engrid-github.git engrid
- Go into enGrid's folder:
cd engrid
- Checkout the release-1.4 branch:
git checkout -b release-1.4 remotes/origin/release-1.4
- You can use any single one of the following options:
- Go into the source code folder:
cd src
- Set-up the environment variables, simply by running:
source scripts/setup_pathes.bash
- Build the NETGEN library:
scripts/build-nglib.sh
- Build enGrid library and executable:
qmake # Replace 4 with the number of cores your machine has make -j 4
- For running enGrid:
./start_engrid.bash
- 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.
- Either run from within the folder engrid this command as root:
- Make sure that the Universe repository is enabled: https://help.ubuntu.com/community/Repositories/Ubuntu
- Install the various necessary packages, by running the following command as root:
sudo apt-get install git patch subversion g++ libvtk5-qt4-dev qt4-dev-tools
- As normal user (not root), clone git repository and checkout branch release-1.4:
- You can use any single one of the following options:
git clone git://github.com/enGits/engrid.git engrid git clone https://github.com/enGits/engrid.git engrid git clone git://repo.or.cz/engrid-github.git engrid git clone http://repo.or.cz/r/engrid-github.git engrid
- Go into enGrid's folder:
cd engrid
- Checkout the release-1.4 branch:
git checkout -b release-1.4 remotes/origin/release-1.4
- You can use any single one of the following options:
- Go into the source code folder:
cd src
- Set-up the environment variables, simply by running:
source scripts/setup_pathes.bash
- Build the NETGEN library:
scripts/build-nglib.sh
- Build enGrid library and executable:
qmake # Replace 4 with the number of cores your machine has make -j 4
- For running enGrid:
./start_engrid.bash
- 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.
- Either run from within the folder engrid this command as root:
This topic is very extensive, therefore the detailed description on how to compile enGrid on a Windows system is provided here.