-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
283 lines (204 loc) · 8.32 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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
README - Mezuro Plugin
======================
Mezuro is a source code tracking platform based on Noosfero social networking
platform with Mezuro Plugin actived to access Kalibro Web Service.
INSTALL
=======
Instalation and executing of Mezuro requires session to be initialized as login
shell mode.
Shortcut
-----------
If you want to use RVM (Ruby Version Manager) environment, just run:
$ plugins/mezuro/script/install/install-rvm.sh
Watch out for pre-existing gems which may be incompatible, and it may be
necessary to uninstall them prior to running the script.
Ubuntu Package Dependencies
---------------------------
$ sudo apt-get update
$ sudo apt-get install build-essential curl libxslt1-dev git git-core tango-icon-theme sqlite3 libsqlite3-dev patch bzip2 openssl libreadline6 libreadline6-dev zlib1g zlib1g-dev libssl-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt-dev autoconf libc6-dev libgdbm-dev ncurses-dev automake libtool bison subversion pkg-config libffi-dev openjdk-6-jre
Also, be sure to install RVM version 1.19.0. If you are lost use the following
commands:
$ curl -L https://get.rvm.io | bash -s stable --autolibs=enabled --version 1.19.0
Now you must load RVM into a shell session *as a function*. You may achieve it
by following the next script lines, as per the RVM standard reference:
if [[ -s "$HOME/.rvm/scripts/rvm" ]] ; then
# First try to load from a user install
source "$HOME/.rvm/scripts/rvm"
elif [[ -s "/usr/local/rvm/scripts/rvm" ]] ; then
# Then try to load from a root install
source "/usr/local/rvm/scripts/rvm"
else
printf "ERROR: An RVM installation was not found.\n"
fi
rvm reload
rvm requirements run
IMPORTANT: Since Mezuro uses a very specific version of Ruby, to prevent
incompatibilities you'll need to run this command every time you open a new
session to work with Mezuro:
$ rvm use ruby-1.8.7-p302@mezuro
Ruby Setup
----------
Use the following bash script lines to install and setup Ruby for running
Mezuro:
CFLAGS="-O2 -fno-tree-dce -fno-optimize-sibling-calls" rvm install 1.8.7-p302
rvm use ruby-1.8.7-p302@global
gem install rubygems-update -v 1.3.7
update_rubygems
gem install rake -v 0.8.7
yes | gem uninstall rake -v 10.0.4
rvm gemset create mezuro
rvm use ruby-1.8.7-p302@mezuro
Gem Dependencies
------------
See the Noosfero INSTALL (and HACKING) file. After install Noosfero, you must
install Mezuro dependences below. The order really matters here, so if you see
an output like "2 gems instaled" something should be wrong.
$gem install --no-ri --no-rdoc rack -v 1.0.1
$gem install --no-ri --no-rdoc rack-test -v 0.6.2
$gem install --no-ri --no-rdoc httpi -v 1.0
$gem install --no-ri --no-rdoc nokogiri -v 1.5.5
$gem install --no-ri --no-rdoc wasabi -v 2.0.0
$gem install --no-ri --no-rdoc json -v 1.7.5
$gem install --no-ri --no-rdoc gherkin -v 2.5.4
$gem install --no-ri --no-rdoc multi_json -v 1.3.7
$gem install --no-ri --no-rdoc rubyzip -v 0.9.9
$gem install --no-ri --no-rdoc ffi -v 1.2.0
$gem install --no-ri --no-rdoc childprocess -v 0.3.6
$gem install --no-ri --no-rdoc websocket -v 1.0.4
$gem install --no-ri --no-rdoc libwebsocket -v 0.1.6.1
$gem install --no-ri --no-rdoc selenium-webdriver -v 2.30.0
$gem install --no-ri --no-rdoc activesupport -v 2.3.5
$gem install --no-ri --no-rdoc actionpack -v 2.3.5
$gem install --no-ri --no-rdoc actionmailer -v 2.3.5
$gem install --no-ri --no-rdoc activerecord -v 2.3.5
$gem install --no-ri --no-rdoc activeresource -v 2.3.5
$gem install --no-ri --no-rdoc addressable -v 2.2.2
$gem install --no-ri --no-rdoc builder -v 3.1.4
$gem install --no-ri --no-rdoc gyoku -v 0.4.6
$gem install --no-ri --no-rdoc akami -v 1.2.0
$gem install --no-ri --no-rdoc xpath -v 0.1.4
$gem install --no-ri --no-rdoc mime-types -v 1.19
$gem install --no-ri --no-rdoc capybara -v 1.1.1
$gem install --no-ri --no-rdoc term-ansicolor -v 1.0.7
$gem install --no-ri --no-rdoc diff-lcs -v 1.1.3
$gem install --no-ri --no-rdoc cucumber -v 1.1.0
$gem install --no-ri --no-rdoc cucumber-rails -v 0.3.2
$gem install --no-ri --no-rdoc culerity -v 0.2.15
$gem install --no-ri --no-rdoc database_cleaner -v 0.9.1
$gem install --no-ri --no-rdoc exception_notification -v 1.0.20090728
$gem install --no-ri --no-rdoc googlecharts -v 1.6.8
$gem install --no-ri --no-rdoc hpricot -v 0.8.2
$gem install --no-ri --no-rdoc httpi -v 0.9.7
$gem install --no-ri --no-rdoc i18n -v 0.4.1
$gem install --no-ri --no-rdoc metaclass -v 0.0.1
$gem install --no-ri --no-rdoc mocha -v 0.9.8
$gem install --no-ri --no-rdoc nori -v 1.1.3
$gem install --no-ri --no-rdoc ntlm-http -v 0.1.1
$gem install --no-ri --no-rdoc polyglot -v 0.3.3
$gem install --no-ri --no-rdoc rails -v 2.3.5
$gem install --no-ri --no-rdoc rcov -v 0.9.7.1
$gem install --no-ri --no-rdoc RedCloth -v 4.2.2
$gem install --no-ri --no-rdoc rspec -v 1.2.9
$gem install --no-ri --no-rdoc rspec-rails -v 1.2.9
$gem install --no-ri --no-rdoc savon -v 0.9.7
$gem install --no-ri --no-rdoc Selenium -v 1.1.14
$gem install --no-ri --no-rdoc selenium-client -v 1.2.18
$gem install --no-ri --no-rdoc sqlite3 -v 1.3.6
$gem install --no-ri --no-rdoc system_timer -v 1.2.4
$gem install --no-ri --no-rdoc tango -v 0.1.15
$gem install --no-ri --no-rdoc tidy -v 1.1.2
$gem install --no-ri --no-rdoc treetop -v 1.4.10
$gem install --no-ri --no-rdoc webrat -v 0.5.1
$gem install --no-ri --no-rdoc will_paginate -v 2.3.12
$gem install --no-ri --no-rdoc gettext -v 1.8.0
Enable Mezuro Plugin
--------------------
Also, you need to enable Mezuro Plugin at your Noosfero installation:
$ cd <your_noosfero_dir>
$ ./script/noosfero-plugins enable mezuro
$ mkdir tmp
Install Service
---------------
To run Mezuro (Noosfero with Mezuro Plugin), you need to install the Kalibro
Service. For that, see:
https://gitorious.org/kalibro/kalibro/blobs/master/INSTALL
Configure Service Address
-------------------------
Addictionaly, copy service.yml.example to service.yml and define your Kalibro
Service address:
$ cp plugins/mezuro/service.yml.example plugins/mezuro/service.yml
If you install Kalibro Service at localhost, just keep the default
adress:
http://localhost:8080/KalibroService/
Configure, Create and Populate Database and Solr
---------------------------
$ cp config/database.yml.sqlite3 config/database.yml
$ cp config/solr.yml.dist config/solr.yml
$ rake db:schema:load
$ rake db:migrate
$ rake makemo
$ ./script/sample-data
Set Licences list
-----------------
$ cp plugins/mezuro/licenses.yml.example plugins/mezuro/licenses.yml
Apply Mezuro Theme
---------------------
(Our RVM install script already do that)
If you want, you can use the Mezuro default theme:
$ cd public/designs/themes
$ rm -f default
$ git clone git://gitorious.org/mezuro/mezuro-theme.git
$ ln -s mezuro-theme/ default
$ cd ../../../
Active Mezuro Plugin on Noosfero Environment
--------------------------------------------
As a Noosfero administrator user, go to administrator panel:
- Click on "Enable/disable plugins" option
- Click on "Mezuro Plugin" check-box
Test Environment
----------------
To prepare Mezuro for running functional and unit tests run the following
commands:
$ rake solr:download
$ rake db:test:prepare
DEVELOPMENT
===========
Get the Mezuro (Noosfero with Mezuro Plugin) development repository:
$ git clone https://gitorious.org/+mezuro/noosfero/mezuro
$ cd mezuro
$ git checkout mezuro
Running Mezuro tests
--------------------
$ rake test:noosfero_plugins:mezuro
or just:
$ rake test:noosfero_plugin_mezuro:units
$ rake test:noosfero_plugin:mezuro:functionals
Running Mezuro Acceptance tests
-------------------------------
Mezuro acceptance tests depend on Kalibro Service. You must to install Kalibro
Service to run them.
$ cd mezuro
$ ./plugins/mezuro/script/tests/run_acceptance_tests.sh plugins/mezuro/features/<feature_file>
or
$ ./plugins/mezuro/script/tests/run_acceptance_tests.sh plugins/mezuro/features/<feature_file> selenium
for running tests in browser.
* Make sure cucumber is set in environment variable PATH.
Get Involved
============
If you found any bug and/or want to collaborate, please send an e-mail to
LICENSE
=======
Copyright (c) The Author developers.
See Noosfero license.
AUTHORS
=======
Please, see the Mezuro AUTHORS file.
ACKNOWLEDGMENTS
===============
The authors have been supported by organizations:
University of São Paulo (USP)
FLOSS Competence Center
http://ccsl.ime.usp.br
Brazilian National Research Council (CNPQ)
http://www.cnpq.br/