1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
|
# Requirements
In order to run EZTrace, you need the following software:
* CMake;
* OTF2 (which can be downloaded here [https://www.vi-hps.org/projects/score-p](https://www.vi-hps.org/projects/score-p))
# Getting EZTrace
## Building from source
* You can get the latest stable release on EZTrace website:
https://eztrace.gitlab.io/eztrace
* Current development version is available via GIT
`git clone https://gitlab.com/eztrace/eztrace.git`
```
BASE_DIR=$PWD
# First, install otf2:
wget https://perftools.pages.jsc.fz-juelich.de/cicd/otf2/tags/otf2-3.0.3/otf2-3.0.3.tar.gz
tar xf otf2-3.0.3.tar.gz
cd otf2-3.0.3/
mkdir build install
cd build
../configure --prefix=$PWD/../install PYTHON=: && make install -j
PATH=$PATH:$PWD/../install/bin
cd $BASE_DIR=$PWD
# Next, install eztrace
git clone https://gitlab.com/eztrace/eztrace.git
cd eztrace
mkdir build install
cd build
cmake .. -DCMAKE_INSTALL_PREFIX=$PWD/../install -DEZTRACE_ENABLE_MPI=ON
make install -j
```
## Spack package
[Spack](https://github.com/spack/spack/) ships a package for building
EZTrace and its dependencies. To install EZTrace, run:
```
spack install eztrace
```
To build EZTrace with the `ompt` module (that automatically instruments
OpenMP applications), you need to install `llvm`:
```
spack install eztrace %llvm@12.0.0
```
## Docker container
[Several docker images](https://hub.docker.com/u/eztrace) contain
installed version of eztrace. Some images also contain installed
versions of [ViTE](https://gitlab.inria.fr/solverstack/vite/).
To use one of these docker images:
```
docker run -v $PWD:/shared -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=$DISPLAY -h $HOSTNAME -v $HOME/.Xauthority:/root/.Xauthority -it eztrace/eztrace.mpich.vite:latest bash
```
# Checking EZTrace installation
Once EZTrace is installed, you should have several executable including `eztrace`, `eztrace_avail`, or `eztrace.preload`.
To check if everything works fine, see the [Using EZTrace](using.md) page
|
