README 3.6 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

Arthur Redondy's avatar
Arthur Redondy committed
34
For Debian users, you may need to install also the qmake package.
35

Johnny Jazeix's avatar
Johnny Jazeix committed
36 37
Then, until Qt development files are installed, you can compile ViTE :

38
./configure (./configure -h will show you options for compilation).
39 40
or
cmake -D CMAKE_INSTALL_PREFIX:PATH=. .
41 42
or
ccmake (which allows you to choose the directories and library for otf)
43 44 45 46 47

will configure your Makefile depending on your OS.

make will create the binary file.

48 49

-----------------------
50
For Fedora/CentOS users:
51

52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
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
70

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

75 76 77


*************
Johnny Jazeix's avatar
Johnny Jazeix committed
78
DOCUMENTATION
79
*************
Johnny Jazeix's avatar
Johnny Jazeix committed
80 81 82

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

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

85
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.
86

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

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


93
*******************
Johnny Jazeix's avatar
Johnny Jazeix committed
94
SUPPORTED PLATFORMS
95
*******************
96

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

103 104

*******************
Johnny Jazeix's avatar
Johnny Jazeix committed
105
HOW TO REPORT A BUG
106
*******************
107

108
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