README 3.68 KB
Newer Older
1

2
This is ViTE version 1.2.
3

4
ViTE is a C++ Visual Trace Explorer using Qt for viewing.
5

6 7

***************
Johnny Jazeix's avatar
Johnny Jazeix committed
8
INSTALLING ViTE
9
***************
Johnny Jazeix's avatar
Johnny Jazeix committed
10

11 12
-----------------
For Windows users:
Johnny Jazeix's avatar
Johnny Jazeix committed
13

14
Run the installer provided.
Johnny Jazeix's avatar
Johnny Jazeix committed
15

16
-----------------------
17 18
For Debian/Ubuntu users:

19 20 21 22 23 24 25 26 27 28
** 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


-------------------------------
Otherwise (Debian/Ubuntu users):

Johnny Jazeix's avatar
Johnny Jazeix committed
29
If you do not have Qt please visit : http://www.qtsoftware.com/downloads/opensource/appdev and download the development files for your operating system.
30

31
you can use apt-get :
32
sudo apt-get install vite
33

Mathieu Faverge's avatar
Mathieu Faverge committed
34 35
For Debian users, you may need to install several packages:
apt-get install qtbase5-dev qt5-qmake qttools5-dev
36

Mathieu Faverge's avatar
Mathieu Faverge committed
37
Then, after Qt development files have been installed, you can compile ViTE:
Johnny Jazeix's avatar
Johnny Jazeix committed
38

39
cmake -DCMAKE_INSTALL_PREFIX:PATH=. .
40 41
or
ccmake (which allows you to choose the directories and library for otf)
42 43

will configure your Makefile depending on your OS.
44
You can also use one of the config.XXXX scripts (./config.XXXX) to configure cmake.
45

46
Then, type the command:
Mathieu Faverge's avatar
Mathieu Faverge committed
47
make
48
to create the binary file.
49

50 51

-----------------------
52
For Fedora/CentOS users:
53

54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
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.
Johnny Jazeix's avatar
Johnny Jazeix committed
72

73 74 75
Go to the vite/src/trunk directory then :
./configure
make or gmake will create the binary file.
Johnny Jazeix's avatar
Johnny Jazeix committed
76

77 78 79


*************
Johnny Jazeix's avatar
Johnny Jazeix committed
80
DOCUMENTATION
81
*************
Johnny Jazeix's avatar
Johnny Jazeix committed
82 83 84

For ViTE there is three documentations that can be found in documentation folder.

85
The first one is the user manual which explain ViTE and its features.
Johnny Jazeix's avatar
Johnny Jazeix committed
86

87
The two other ones are for developers : this is the technical manual and the Doxygen generated doc. The technical manual explains how ViTE is coded and the Doxygen explains the classes and functions more in details.
88

89
For Doxygen, it is necessary to have epstopdf for the latex version. You can install it with the package texlive-extra-utils.
90
Also, install the dot program for graphics from the package graphviz.
91

Johnny Jazeix's avatar
Johnny Jazeix committed
92
The doxygen documentation can be compiled by the command : make doc.
93 94


95
*******************
Johnny Jazeix's avatar
Johnny Jazeix committed
96
SUPPORTED PLATFORMS
97
*******************
98

Johnny Jazeix's avatar
Johnny Jazeix committed
99
For this release, the following platforms have been tested on :
100
- Ubuntu 8.04 / 8.10 / 9.04 / 10.04.
Johnny Jazeix's avatar
Johnny Jazeix committed
101 102 103
- Windows Xp/Vista.
- Mandriva linux one 2009 kde (under virtualbox).
- MacOS X.
104

105 106

*******************
Johnny Jazeix's avatar
Johnny Jazeix committed
107
HOW TO REPORT A BUG
108
*******************
109

110
If you think you have found a bug in ViTE, you can report it by mail at vite-developpeurs@lists.gforge.inria.fr or in the forum at https://gforge.inria.fr/forum/?group_id=1596