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
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<link rel="stylesheet" href="style.css">
<title>ControlAula - System administrator manual</title>
<meta content="Classroom control tool - Herramienta de control de aula" name="description">
</head>
<body>
<div style="text-align: center;"><img style="width: 762px; height: 110px;" alt="Education and gnuLinEx" src="imagenes/titulo.png"><br>
</div>
<h1 style="text-align: center;">School sysadmin manual</h1>
<br>
<div style="text-align: justify;"><br>
</div>
<h2>Introduction</h2>
<div style="text-align: justify;">ControlAula was
developed with Extremadura schools' network configuration in mind. That
means that the application will work out of the box in those
environments. To use it in other networks, some parameters will be
needed for the application to identify the computers that are part of a
classroom and the users who are real teachers.<br>
<br>
Extremadura schools will work without any previous setup because:<br>
<ul>
<li>Classroom names follow this format: classroom_name-o01,
classroom_name-o02, ... for the students PC, and classroom_name-pro for
the teacher computer. "Classroom_name" can be any combination of letters and
numbers (although it must begin with a letter). Valid examples are:
classroom1-o01, library-o03, lab1-014, etc.</li>
<li>Teacher users belong to a unix group called <span style="font-style: italic;">teacher</span>.</li>
</ul>
Any school following these criteria will be able to begin to use
ControlAula inmediatly without modifying anything. For those schools that do
not, a small setup procedure must be followed, as explained at the
<a href="install.html#Quick_general_use">Quick Start Guide</a>. <br>
<h2>ControlAula config files:</h2>
<h3>/etc/sirvecole</h3>
This file is used by the daemon <span style="font-style: italic;">sirvecole</span>
that must be run on every computer in the classroom. It's a normal plain
text file that can only be modified by the root user. <br>
<br>
This file can be generated by a graphical frontend using the "<span style="font-style: italic;">Setup</span>"
button when ControlAulas is run by a teacher at a teacher computer.
After doing this, it must be copied to every computer in the classroom.<br>
<br>
For those who wish to study it or modify it by hand, it contains the following
settings:<br>
<ul>
<li><span style="font-style: italic;">ipProfesor</span>is
the teacher
computer's IP. This must be set for all the computers in the network in
order for the application to work (unless the Extremadura network setup
is used).</li>
<li>ClassroomName is the classroom name for this PC. If the
computer is in
a network where the Extremadura configuration
is not followed, this parameter must be set to the same value on every
computer in the classroom.</li>
<li><span style="font-style: italic;">Puerta</span>is the IP
address of the gateway to be used by every computer on the network. If
not set, the application will use the result of running the unix
command <span style="font-style: italic;">route</span>.</li>
<li>ipAdmin is an IP address with the same privileges as the
teacher
computer. It is intended to facilitate remote access by sysadmins to all the
computers in a school.</li>
<li><span style="font-style: italic;">SeApaga</span> will, if set to
"1", shut down a student computer if it has not received a ping response from
the teacher computer within two minutes. In this case, keeping the
teacher computer turned off will prevent the students from turning on their
computers. It can also prevent students from using their computers if they
have unplugged the network cable. This parameter is not active after installing
the application, but after the teacher computer makes first contact with the
student computer, it will be set -- unless it has being previously set to
"0" in this config file. Obviously, this parameter is ignored when the
application is running on a teacher computer.</li>
<li><span style="font-style: italic;">MonitorNecesario</span> will,
if set to "1", switch off the student computer if it has not
received a response within two minutes from the ControlAulas application on
the teacher computer. In this case, even if the teacher computer is
on, the students cannot switch on their computers until the teacher
starts the application. The default value for this parameter
is "0". If this parameter is set to "1", the value of SeApaga is
ignored. When the application is running on the teacher computer,
this parameter is also ignored.</li>
<li><span style="font-style: italic;">adminGroup</span>
is the name of the system group to which the teachers belong. If none is
set, the application will use "<span style="font-style: italic;">teacher</span>"
(when using the application in English). If ControlAula is used in
another language, in translation, the default group name will change (for example, in Spanish it will use "<span style="font-style: italic;">profesor</span>").
To be assigned the priviliges of a teacher, a user must be a member of this group.</li>
<li><span style="font-style: italic;">InicioSinInet</span> will,
if set to "1", disable Internet access for the computer.
The default value is "0". If this parameter is set to "1", the computer won't
have an available gateway until the teacher enables Internet access.</li>
<li>InicioSinRaton will, if set to "1", disable the keyboard and
mouse for the user after login. The default value is "0". If set to "1", the
user won't be able to use the keyboard or mouse until the teacher enables
them.</li>
<li><span style="font-style: italic;">Debugging</span>
will, if set to "1", show debugging messages in the TTY in which the
application is started. Its only purpose is making debugging of the
application easier. Its default value is "0".</li>
<li><span style="font-style: italic;">SharedPrinter </span>is
used to inform the user whether the teacher has shared ("1") or not ("0") his
or her printer with this PC. This parameter is automatically modified by the
application while running and must not be changed by hand.</li>
<li><span style="font-style: italic;">InternetEnabled
</span>is used to inform the user whether the teacher has enabled ("1") or
disabled ("0") Internet access to this PC. This parameter is
automatically modified by the application while running and must not be
changed by hand.<br>
</li>
</ul>
<h3>/var/monitorprofe/monitorprofe.cfg</h3>
This file stores the classroom setup (desktop distribution, hostnames,
etc.). It's a regular plain text file that can be modified by the teacher
using the "Classroom setup" button in the Application. This file only
needs to be configured on the teacher computer.<br>
<br>
For those who wish to study it or modify it by hand, it contains the following
settings:<br>
<br>
<ul>
<li><span style="font-style: italic;">Columnas</span>
is the number of columns (from 1 to 4) that form the classroom desktop
distribution.</li>
<li><span style="font-style: italic;">Filas</span>
is the number of rows (from 1 to 10) that form the classroom
desktop distribution.</li>
<li><span style="font-style: italic;">Position</span>:
is the numerical
position of a desktop within the classroom grid. The
application uses a 40-cell grid beginning with the value 1 for row1,
column1, to the value 40 for row10, column4. This parameter is
repeated in the file with as many lines as there are desktops, using the
format Position/ClassroomName[Desktop No]="x", where x is the number of the
cell representing the desktop on the grid. For example:
Position/room1[01]="3". This parameter should not be modified by hand,
as it's very easy to configure the classroom using the application
frontend.</li>
<li>Ocul: flags the desktop as visible or not. This parameter
is
repeated in the file as many times as there are hidden desktops, and has
the same format as Position; setting this parameter to "1" hides the desktop.
(For example:
Ocul/room1[03]="1"). This parameter should not be modified by
hand, as it's very easy to configure the classroom using the
application frontend.</li>
<li>MAC: the MAC address of the computer network card. This
parameter is needed to be able to start the machines via the network
cable. It's automatically assigned the first time controlaula starts and
shouldn't be changed manually.</li>
<li>Name: the hosntame for every computer in the classroom.
This value will place every computer in the right place in the
classroom distribution. It's assigned using ControlAula as a teacher,
with the "Classroom setup" option: just double click on a desktop
button and rename it.</li>
</ul>
<h2>Several technical issues:</h2>
<ul>
<li>ControlAulas' source code and future updates are available
at the <a href="http://www.linex.org">gnuLinEx</a>
repositories. The development svn repository is available at
<a href="http://forja.linex.org/projects/controlaulas">http://forja.linex.org/projects/controlaulas</a>.</li>
<li>Video broadcasting through the network is done
using <a href="http://www.videolan.org/">videolan</a>.
Sometimes this feature is limited by the network switch configuration. In such
cases the multicast filtering igmp of the switch must be modified.</li>
<li>Since most of the commercial DVDs these days are encrypted, in order to
broadcast a DVD from the teacher computer, the libdvdcss2 package
must be installed. A Debian package for it can be downloaded from <a href="http://ftp.debian-unofficial.org/debian/pool/main/libd/libdvdcss/">http://ftp.debian-unofficial.org/debian/pool/main/libd/libdvdcss/</a> and installed using
"<span style="font-style: italic;">dpkg -i package.deb</span>"
(gnuLinEx users can do it automatically
via ControlPanel->Programs->Upgrade LinEx)</li>
<li>To enable all of the application's functionality, some TCP ports must be open on the computers: </li>
<ul>
<li>41000 is used to interchange information between users using http protocol. It's a must</li>
<li>6969 to share files using bittorrent.</li>
<li>487 (TCP & UDP) to send files. It uses saft protocol under
inetd, so if ports are closed at the /etc/hosts.deny file it should be
enabled adding" <span style="font-style: italic;">sendfiled:ALL</span>" to the /etc/hosts.allow file. </li>
<li>5900 for Big Brother and Projector features. It uses VNC protocol.</li>
<li>6522 for the workgroup feature. It uses obby protocol.</li>
</ul>
</ul>
</div>
<span style="font-style: italic;"></span><br>
<h2>Application manuals</h2>
<ul>
<li><a href="index.html">Index</a></li>
<li><a href="user.html">Users documentation</a></li>
<li><a href="teacher.html">Teachers documentation</a></li>
<li><a href="install.html">Installation and Quick
Start</a></li>
</ul>
<br clear="all">
<hr style="width: 100%; height: 2px;">
<div style="text-align: center;">Last modification on 18th
November, 2007 <a href="http://validator.w3.org/check?uri=referer"><img style="border: 0px solid ; width: 88px; height: 31px;" src="imagenes/valid-html401.png" alt="Valid HTML 4.01 Transitional"></a>
<a href="http://www.nvu.com/"><img style="border: 0px solid ; width: 80px; height: 15px;" alt="Document made with Nvu" src="imagenes/madewithNvu80x15clear.png"></a></div>
</body>
</html>
|
