/
README
129 lines (77 loc) · 4.03 KB
/
README
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
-=================-
RdvZ version 2.0.3 2010/05/25
-=================-
Bug tracker : https://sourcesup.cru.fr/tracker/?atid=2113&group_id=586&func=browse
Developper contact : - https://listes.univ-avignon.fr/wws/info/gpl
- romain.deveaud@univ-avignon.fr
1. Introduction
RdvZ is a web application developed by the Université d’Avignon et des Pays
de Vaucluse which allows to create and manage meetings and to poll potential
attendee avalibility. The application allows both anonymous and authenticated
access (it can be either with Database or with a CAS server + LDAP or with a
LDAP server alone), but whatever the access mode, everybody is able to vote
without being authenticated.
2. Licence
See the LICENSE file.
3. Requirements
3.1. Web Server requirements
RdvZ is developped with the web framework symfony and is based on a LAMP
architecture (Linux, Apache, MySQL, PHP), so you need to setup a web server
in order to run RdvZ.
Websites to check :
- https://help.ubuntu.com/community/ApacheMySQLPHP if you are running Ubuntu,
- http://wiki.debian.org/LaMp if you are running Debian,
- http://www.lamphowto.com/ if you need further help.
Of course MySQL is not required, you can use for example PostgreSQL, Oracle...
In addition, the install bash script requires php-cli to run (PHP Command Line),
if you are running a Debian based distribution, just do :
$ apt-get install php5-cli
3.2. Symfony requirements
The symfony version used for RdvZ is symfony1.3. It requires :
- PHP >= 5.2.4, and ideally not 5.2.9
It also requires some optional things, if you want to perform a clean install
you may want to check it, do :
$ wget http://sf-to.org/1.4/check.php
$ php check_configuration.php
You should also execute the checker from a browser and fix the issues it might
discover. That's because PHP can have a distinct php.ini configuration file for
these two environments, with different settings.
Don't forget to remove the index.html file in your root web browser directory.
3.3 CAS requirements
If you plan to run RdvZ with a CAS authentication, note that the php-cas library
is already include in the RdvZ sources, but it requires the curl library :
$ apt-get install php5-curl
3.4 LDAP requirements
If you plan to run RdvZ with a LDAP (with or without CAS), note that the php-ldap
library is required :
$ apt-get install php5-ldap
4. Install
See the INSTALL file.
5. I was using RdvZ 1.x and I want my datas in RdvZ 2.0 !
You just have to run a command :
$ php symfony rdvz:retrieve-old-datas "<rdvz1_database_dsn>" <db_user> <db_password>
The DSN has the following syntax : [pdo]:host=[host_serv];dbname=[db_name]
Where - pdo : mysql, pgsql...
(values accepted by PHP PDO : http://www.php.net/manual/en/pdo.drivers.php)
- host_serv : the server where the database is hosted
- db_name : the name of the database
- db_user : the user that has rights on the database (usually root)
- db_password : the db password of the user
6. RdvZ 2.0.x was already running on my web server, but I want to install
the latest version
Just run the install script as you did the first time, the database structure
will be automatically updated.
7. I want LDAP autocompletion on mail adresses
See the README of `plugins/uapvFormExtraPlugin`. Currently a very experimental feature,
feel free to contribute !
8. Did you find a bug?
Or maybe you think the application or the installer can be improved? Visit our
bugtracker at https://sourcesup.cru.fr/tracker/?atid=2113&group_id=586&func=browse
and create a ticket to describe your problem (you can leave your messages in
french if you are comfortable with it) ; we will answer as soon as possible.
9. For a better RdvZ experience...
RdvZ works on Firefox, Google Chrome, Opera and Safari browsers, but its design
is optimized for the following versions :
- Firefox >= 3.6 (which is a major update, if you are not currently using you
should seriously consider upgrading your version),
- All Google Chrome versions