Windows 7 Download and Installation

Revision as of 12:53, 29 March 2010

Preliminaries: Components needed to install the Kratos

Last visit for the links: 28 March 2010

Note that this is a specific case of possible installation of Kratos in a 64 bits computer under Windows 7, and all the different components are not compulsory for the successful use of Kratos. You can select other equivalent C++ compilers, svn, etc. or other versions of those we are presenting.

Two examples of organization of files are provided. Of course, you should select only one of them.

C++ compiler. Microsoft Visual Studio 2008

For developers using Windows, we recommend to use Microsoft Visual Studio 2005 or 2008. If you are working with a 64 bits machine, be sure that you include the 64 bits tools in your MSVS installation.

SVN

It is recommended to use RapidSVN

The latest released version: 0.12, October 2009, RapidSVN-0.12.0-8051.exe

Download and run the file:

Kratos Source Code

By using RapidSVN, the kratos source files can be downloaded by taking the following steps:

• Go to Repository->Checkout and enter the following path to the kratos repository:

        http://kratos.cimne.upc.es/svn/kratos/

• Choose a working directory where module: kratos will be created in your pc
  • example A: "C:\Kratos2010"
  • example B: "D:"
• "recursive" option have to be signed
• this will create a folder "C:\Kratos2010\kratos" or "D:\kratos" with all the required Kratos files.

Pre and Post Processor. GiD

We use GiD as our favourite pre and post-processor.

Download and install the latest version of GiD. Here we use the latest beta version for 64 bits (GiD9.2.9b-win-x64-Install.exe)

You should have to install the GiDpost External Library too (latest version, March 2010, ftp://gid.cimne.upc.es/pub/gid/Tools/gidpost1.70.zip).

Unzip the file in your kratos external libraries.

• example A: "C:\Kratos2010\kratos\external_libraries\gidpost" (already existing folder, the one by default)
• example B: "D:\external_libraries\gidpost" (independent folder outside kratos' directory tree)

To build the GiD postprocess libray:

• Open a DOS console (from Start - Programs - Microsoft Visual Studio 2008 - Visual Studio Tools - System Console
• Run vcvarsall.bat

• Change to the VC Common7\Tools directory (cd ..; cd Common7; cd Tools)
• Run vcvars32.bat

• change to the "gidpost\win" directory (remember, "C:\Kratos2010\kratos\external_libraries\gidpost" or "D:\external_libraries\gidpost")
• And depending on the version you want to compile (probably both of them) invoke:

 nmake -f Makefile.vc CFG="Release"
 nmake -f Makefile.vc CFG="Debug"

• This will create two new folders "gidpost\win\Debug" and "gidpost\win\Release" with the file gidpost.lib for the Debug or Release compilation

• Very important! Finally and only if you have selected a different directory to the default one (example B), copy the existing Jamfile file from the default folder (D:\kratos\external_libraries\gidpost) to the one you are using for the libraries (D:\external_libraries\gidpost)

Scripting Language Python. Python(x,y)

Python can be downloaded from here. At this moment the python 2.6 is supported.

Before installing Python, consider if you want to use it to plot graphics. In that case, you should check packages (python(x,y), for example) which include matplotlib or other equivalent graphic tools.

For this example, we will describe the full package Python(x,y) installation.

Download and run the installation file from http://www.pythonxy.com/ (latest version 2.6.2.0, March 2010, 426 MB, http://ftp.ntua.gr/pub/devel/pythonxy/Python(x,y)-2.6.2.0.exe)

Everything by default, but it is recommended to:

• select installation for all the users
• select the destination folders (to check the full installation process)
• select all the components to be installed
• folders:
  • example A:

general destination:	C:\Program Files (x86)\pythonxy
python(x,y) documentation:	C:\Program Files (x86)\pythonxy\doc
python kernel:	C:\Python26
eclipse:	C:\Program Files (x86)\pythonxy\eclipse
eclipse workspace:	C:\Documents\Python
mingw:	C:\Program Files (x86)\pythonxy\mingw

• • example B:

general destination:	D:\pythonxy
python(x,y) documentation:	D:\pythonxy\doc
python kernel:	D:\Python26
eclipse:	D:\pythonxy\eclipse
eclipse workspace:	D:\Simulations\Python
mingw:	D:\pythonxy\mingw

After the installation, you should check that Python has created a folder called "C:\Python26\libs" or "D:\Python26\libs".

Boost Library

Kratos uses the Boost library.

Boost provides free peer-reviewed portable C++ source libraries.

You can install and build manually the boost library or you can directly use an installer. As said in the boost webpage: "The easiest way to get a copy of Boost is to use an installer. The Boost website version of this Getting Started guide will have undated information on installers as they become available, or see Boost downloads or the installer provided by BoostPro Computing. We especially recommend using an installer if you use Microsoft Visual Studio, because the installer can download and install precompiled library binaries, saving you the trouble of building them yourself."

Download and run BoostPro Installer (latest version 1.42.0, 190K, boost_1_42_setup.exe, March 2010). You should register to freely download the file.

• select Visual C++ 9.0 (Microsoft Visual Studio 2008) and all the variants

• select all the components for VC9.0

• select "C:\Kratos2010\kratos\external_libraries\boost\boost_1_42" (example A) or "D:\external_libraries\boost\boost_1_42" (example B) as Destination Folder

• check that the following specific folders have been created: \external_libraries\boost\boost_1_42\lib and \external_libraries\boost\boost_1_42\bin

C++ Compiler

For developers using Windows, we recommend to use Microsoft Visual Studio 2005

Limited testing has been performed with Microsoft Visual Studio 2008 Express Edition freely available from Microsoft. To use Microsoft Visual Studio 2008 Express Edition, you must download Boost 1.35.0 sources, Boost build and bjam executable. You should compile Boost sources with the command:

 bjam toolset=msvc --build-type=complete stage

and correct the paths in Jamroot file.

Also, in Jamroot, the last lines should look like this:

## installation
alias install :
		/kratos-prj//kratos 
		/kratos-prj/PFEMapplication//install
		/kratos-prj/incompressible_fluid_application//install
		/kratos-prj/structural_application//install
		/kratos-prj/convection_diffusion_application//install
#		/kratos-prj/ExternalSolversApplication//install
		/kratos-prj/ULFapplication//install
		/kratos-prj/ALEapplication//install
#		/kratos-prj/FSIapplication//install
		;

ECHO $(TOP) ;

Boost Library

Kratos uses the Boost library.

Boost provides free peer-reviewed portable C++ source libraries.

Step1 - Install the building system

The compilation of both the Kratos and the Boost-library is performed using bjam which is a portable "make" like system and manages the compilation. Bjam has configuration files for many different compilers. This configuration files are contained in the "boost-build".

The following steps are needed to install the build system:

• Downlodad precompiled bjam for windows (see www.boost.org -> getting started).
• Put the bjam.exe in c:\kratosR1 (from now on we will assume that the Kratos is installed in c:\kratosR1 ... do not change this unless you know what you do)
• Download the latest release of the boost-build from Download section and extract for example in the directory "c:\boost-build\"
• Configure the environment variable (Control Panel->System->Advanced) BOOST_BUILD_PATH=c:\boost-build (set it to the installation path you choosed for boost-build).

Step2 - Install the boost library

The Kratos needs the boost library to be installed in the system. This implies that both the source files and the compiled libraries should be available on the system.

An "easy" way exists to install boost library under windows 32bit:

You can get the setup file from Boost Consulting. The setup file ask you about the components you want to install and the compiler and path to install:

1. Select the mirror you want. (the random mirror works fine for me)
2. Select:
   1. the multithread DLL and multithread debug DLL
3. do a FULL install. Verify that everything is marked!
4. Introduce the installing path. (i.e C:\kratosR1\external_libraries\boost_1_34_1\) DO NOT change this path unless you know what you do
5. include the installation path for the compiled dlls in the system path: (control panel->system->advanced ...................)

NOTE: These binaries are compiled for 32bit machines. In order to compile 64bit code (on windows 64bit) you MUST recompile the boost python library by going to the boost directory and recompile the boost python using bjam:

   bjam --toolset=msvc --libdir=lib python

Another option for the installation of the boost library is to install the source code and compile it as follows: (do this as an extreme resource ... the only way we can support is the first)

1. Go to the Download section
2. Download the following libraries:
   1. boost (last release in this moment of edition: 1.34.1, July 24, 2007, boost_1_34_1.zip)
      • to be extracted in \kratosR1\external_libraries once kratos source code is installed
3. compile and install the libraries

Kratos Source code

In this moment kratos source files can be downloaded using CVS. Using WinCvs the precedure consists of:

1. open the Menu->Admin->Login and insert the following CVSROOT :

 :pserver:user_name@kratos.cimne.upc.es:2401:/home/kratosR1

where user_name is your user name (which can be obtained contacting to Pooyan) or anonymous for readonly access.

1. Login using your password (empty for anonymous username)
2. Open the Menu->Remote->CheckoutModule
   1. Module name: kratosR1
   2. Local folder: the folder you want to copy your Kratos directory. (the default C:\ is fine)
   3. Choose the same CVSROOT as for login and press OK.

It's important to finish all these steps with ***** CVS exited normally with code 0 *****

GiDpost External Library

We strongly recommend you to use GiD as a pre and post processor.

gidpost is a set of functions (library) for writing postprocess results for GiD in ASCII or binary format.

1. Go to the library description
2. Download the zip file
3. Unzip the file in your_kratos_path\external_libraries\
4. Open a DOS console
5. Change to the "gidpost\win" directory
6. Run vcvars32.bat
7. And depending on the version you want to compile (probably both of them) invoke:

 nmake -f Makefile.vc CFG="Release"
 nmake -f Makefile.vc CFG="Debug"

Compiling Kratos

1. Copy the Common_Jamroot to Jamroot
2. In the folder KratosR1 copy Common_Jamroot to Jamroot and then open it with a text editor: select and customize the parts marked as WINDOWS INSTALLATION

Finally compiling the Kratos using bjam

   bjam toolset=msvc threading=multi -j2

the "-j2" flag is to compile using 2 processors. Omitting it implies compiling with a single processor. "-jN" to compile with N processors

Visual Studio Project

A simple interface for the compilation using Microsoft Visual Studio 2005 is provided at the link:

ProjectFile

To use it simply download the file and unpack it in the directory "kratosR1". The file treats the bjam as a makefile and allows compiling inside the visual studio environment