Projet

Général

Profil

Install the platform » Historique » Version 12

Damien Gratadour, 12/11/2013 09:21

1 1 Damien Gratadour
h1. Install the platform
2
3
The COMPASS platform is distributed as a single bundle of CArMA and SuTrA libraries and YoGA and its AO extension for Yorick. 
4
5
h2. Hardware requirements
6 2 Damien Gratadour
7 10 Damien Gratadour
The system must contain at least an x86 CPU and a CUDA capable GPU. list of compatible GPUs can be found here http://www.nvidia.com/object/cuda_gpus.html. Specific requirements apply to clusters (to be updated).
8 1 Damien Gratadour
9
h2. Environment requirements
10 2 Damien Gratadour
11 11 Damien Gratadour
The system must be running a 64 bit distribution of Linux or Mac OS with the latest NVIDIA drivers and "CUDA toolkit":https://developer.nvidia.com/cuda-downloads. The installation of the corresponding version of the "CULA tools":http://www.culatools.com/downloads/dense/ is also required. The following installation instructions are valid if the default installation paths have been selected for these components.
12 1 Damien Gratadour
13 5 Damien Gratadour
Additionally, to benefit from the user-oriented features of the platform, Yorick should be installed as well as the latest version of Python and the associated pygtk module. 
14 1 Damien Gratadour
15 3 Damien Gratadour
To install Yorick, download the latest version from the github repository:
16
<pre>
17
git clone https://github.com/dhmunro/yorick.git yorick.git
18
</pre>
19
then cd onto the created directory and install:
20
<pre>
21
./configure && make && make install
22
</pre>
23
once Yorick is locally installed, you will have to add this directory : yorick.git/relocate/bin to your PATH to have an easy access to the yorick executable. You may want to add support for command history by using rlwrap and alias the yorick executable as :
24
<pre>
25 4 Damien Gratadour
alias yorick='rlwrap path_to_yorick_executable/yorick'
26 3 Damien Gratadour
</pre>
27 1 Damien Gratadour
28 3 Damien Gratadour
29 1 Damien Gratadour
h2. Installation process
30
31
First check out the latest version from the svn repository :
32
<pre>
33 3 Damien Gratadour
svn co https://version-lesia.obspm.fr/repos/compass compass
34 1 Damien Gratadour
</pre>
35
then go in the newly created directory and then trunk:
36
<pre>
37
cd compass/trunk
38
</pre>
39
once there, you need to modify system variables in the define_var.sh executable :
40
<pre>
41
emacs define_var.sh
42
</pre>
43
in this file define properly CUDA_ROOT, CULA_ROOT and YoGA path. Note that for the latter, as YoGA is distributed with SUTrA you should just point to the newly created trunk directory. On a Linux system you should normally have:
44
<pre>
45
export CUDA_ROOT=/usr/local/cuda
46
export CULA_ROOT=/usr/local/cula
47
export YOGA_DIR=/home/MyUserName/path2compass/trunk
48
</pre>
49 12 Damien Gratadour
in this file, you also have to indicate the proper architecture of your GPU so as the compiler will generate the appropriate code. Modify the following line:
50
<pre
51
export GENCODE="arch=compute_12,code=sm_12"
52
</pre>
53
and change both 12 to your architecture : for instance a Tesla Fermi will have 3.0 computing capabilities so change 12 to 30, a Kepler GPU will have 3.5 computing capabilities, change 12 to 35
54 1 Damien Gratadour
55
Once this is done, you're ready to compile the whole library. First run define_var.sh to define the system variables that will be used during the compilation process:
56
<pre>
57
./define_var.sh
58
</pre>
59
60
then identify the absolute path to your Yorick executable using: 
61
<pre>
62
which yorick
63
</pre>
64
and run the compilation script:
65
<pre>
66 6 Damien Gratadour
./reinstall absolute_path_to_yorick
67 1 Damien Gratadour
</pre>
68
69 7 Damien Gratadour
If you did not get any error, CArMA, SuTrA and YoGA are now installed on your machine. You can check that everything is working by launching a GUI to test a simulation:
70 1 Damien Gratadour
<pre>
71
yorick -i yoga_ao/ywidgets/widget_ao.i
72
</pre>