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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
This is ViTE version 1.4.
ViTE is a C++ Visual Trace Explorer using Qt for viewing.
# Installing ViTE
## Using Windows installer
Run the installer provided.
## Using Debian/Ubuntu package manager
Since ViTE is already in Debian official repository, you can install the stable version with:
```
sudo apt-get install vite
```
If you prefer to rebuild it from scratch, install all required dependencies with:
```
sudo apt-get build-dep vite
```
## Using Spack installer
Building ViTE from source without root permission (eg. on a cluster)
can be tedious because of its dependencies (eg. QT). A spack package
from ViTE automates the compilation of ViTE and its dependencies. This
package comes with two *variants*: `otf2` (to enable support for OTF2
traces) and `tau` (to enable support for Tau traces).
```
spack install vite
or
spack install vite+otf2
```
## Building from source
### Dependencies
If you do not have Qt please visit: https://www.qt.io/ and download the development files for your operating system.
For Debian users, you may need to install several packages:
```
apt-get install qtbase5-dev qt5-qmake qttools5-dev libqt5charts5-dev libqt5svg5-dev
apt-get install libglm-dev libglew-dev
```
### Compiling ViTE
Then, after Qt development files have been installed, you can compile ViTE:
```
cmake -DCMAKE_INSTALL_PREFIX:PATH=. .
```
or
```
ccmake
```
(which allows you to choose the directories and library for tau, otf2, etc.)
will configure your Makefile depending on your OS.
You can also use one of the `config.XXXX` scripts (`./config.XXXX`) to configure cmake.
Then, type the command:
```
make
```
to create the binary file.
## Using Fedora/CentOS package
You have to have the administration rights (su).
you will need to get the following rpm packages:
```
wget ftp://ftp.pbone.net/mirror/ftp.pramberger.at/systems/linux/contrib/rhel5/i386/qt45-4.5.1-1.el5.pp.i386.rpm
wget ftp://ftp.pbone.net/mirror/ftp.pramberger.at/systems/linux/contrib/rhel5/i386/qt45-devel-4.5.1-1.el5.pp.i386.rpm
wget ftp://ftp.pbone.net/mirror/ftp.pramberger.at/systems/linux/contrib/rhel5/i386/qt45-sqlite-4.5.1-1.el5.pp.i386.rpm
```
Then, you will need to install the required packages used by the previous ones:
```
yum install dbus-devel fontconfig-devel freetype-devel glib2-devel libSM-devel libX11-devel libXcursor-devel libXext-devel libXfixes-devel libXi-devel libXinerama-devel libXrandr-devel libXrender-devel libpng-devel mesa-libGLU-devel glut glut-devel gcc-c++
```
After you can install the rpm packages you just download:
```
rpm -i qt45-4.5.1-1.el5.pp.i386.rpm
rpm -i qt45-sqlite-4.5.1-1.el5.pp.i386.rpm
rpm -i qt45-devel-4.5.1-1.el5.pp.i386.rpm
```
You have to export your `PATH` variable to the directory of qmake, which is by default:
```
export PATH=/usr/lib/qt45/qt/bin:/usr/lib/qt45/qt/include:$PATH
```
If it is not the case, try: `find / | grep qmake` and take the path given.
Go to the `vite/src/trunk` directory then:
```
./configure
make
```
# Documentation
For ViTE there is three documentations that can be found in the `docs` directory:
- `user_manual`: the user manual that explains ViTE and its features.
- `technical_manual`: the technical manual explains how ViTE is implemented
- `doxygen`: the Doxygen explains the classes and functions more in details.
For Doxygen, it is necessary to have `epstopdf` for the latex version. You can install it with the package `texlive-extra-utils`.
Also, install the `dot` program for graphics from the package `graphviz`.
The doxygen documentation can be compiled by the command: `make doc`.
# Supported Platforms
For this release, the following platforms have been tested on:
- Ubuntu 8.04 / 8.10 / 9.04 / 10.04.
- Windows Xp/Vista.
- Mandriva linux one 2009 kde (under virtualbox).
- MacOS X.
# Reporting bugs
To report a bug, if you have an Inria account, submit an issue on ViTE gitlab project:
https://gitlab.inria.fr/solverstack/vite/-/issues
Otherwise, please report the issue to vite-issues@inria.fr
|
