Difference between revisions of "TrainingServer"
| (5 intermediate revisions by the same user not shown) | |||
| Line 22: | Line 22: | ||
|'''Type''' | |'''Type''' | ||
|- | |- | ||
| − | |rowspan=" | + | |rowspan="8"|Trainees |
|uid | |uid | ||
|randomly generated identifer | |randomly generated identifer | ||
| Line 45: | Line 45: | ||
|version | |version | ||
|user's activity version | |user's activity version | ||
| + | |String | ||
| + | |- | ||
| + | |role | ||
| + | |user's role in their institution | ||
|String | |String | ||
|- | |- | ||
| Line 73: | Line 77: | ||
|String | |String | ||
|- | |- | ||
| − | | | + | |requested |
|whether or not a confirmation email was sen | |whether or not a confirmation email was sen | ||
|Boolean | |Boolean | ||
| Line 91: | Line 95: | ||
The code is available under GPL at https://github.com/tchx84/training-server | The code is available under GPL at https://github.com/tchx84/training-server | ||
| − | == RPM | + | == RPM Installation == |
If you plan to run this Server on Fedora 18 or never installation, I would you strongly recommend you to install via our RPMS packages. | If you plan to run this Server on Fedora 18 or never installation, I would you strongly recommend you to install via our RPMS packages. | ||
| − | === Install tch's | + | === Install tch's Repository === |
$sudo vim /etc/yum.repos.d/tch.repo | $sudo vim /etc/yum.repos.d/tch.repo | ||
| Line 105: | Line 109: | ||
gpgcheck=0 | gpgcheck=0 | ||
| − | === Install | + | '''Warning:''' before moving on to the next step, make you have installed db-migrate tool via pip, pip install db-migrate (I will soon package this as an RPM). |
| + | |||
| + | === Install Training Server === | ||
$sudo yum install training-sever | $sudo yum install training-sever | ||
$sudo service training start | $sudo service training start | ||
$sudo systemctl enable training.service | $sudo systemctl enable training.service | ||
| + | |||
| + | === Training Activity Settings === | ||
| + | |||
| + | To send reports to your server some values must be changed in user's machines. | ||
| + | |||
| + | gconftool-2 --set /desktop/sugar/services/training/url "https://your.server.com:443/training/report" --type=string | ||
| + | gconftool-2 --set /desktop/sugar/services/training/api_key "your-servers-api-key" --type=string | ||
| + | |||
| + | == Development == | ||
| + | |||
| + | If you interested in contributing to this project please contact tch at sugarlabs dot org (Martin Abente Lahaye). | ||
Latest revision as of 08:34, 20 March 2014
Training Server Project
This project is a complementary project to One Laptop Per Child Australia and Sugar Labs Training Activity [1]. This projects aims to help us understand how users progress during their training, using the Training Activity.
How It Works
Each time a user finishes a new training section, a report is sent automatically, by the Training Activity to the Training Server. In this way we obtain valuable feedback on users progression and also tasks statistics. Once the server receives reports from a new user, it will send a welcome email with a confirmation link. This helps us to validate users authenticity.
Concepts
- Trainees refers to the users of the Training Activity.
- Tasks refers to each of the individual actions user must complete in each training section.
- Confirmations refers to the email confirmation data, that reflects the confirmation status.
Structure
| Report | ||||
|---|---|---|---|---|
| Concept | Attribute | Description | Type | |
| Trainees | uid | randomly generated identifer | String | |
| user's email address | String | |||
| name | user's full name | String | ||
| school | user's school name | String | ||
| percentage | user's training completion percentage | Integer | ||
| version | user's activity version | String | ||
| role | user's role in their institution | String | ||
| reported | timestamp for when the report was received | Unix time | ||
| Tasks | task | name of the task | String | |
| start | timestamp for when the user start the task | Unix time | ||
| end | timestamp for when the user finished the task | Unix time | ||
| accumulated | total time in seconds for completing the task | Integer | ||
| Confirmations | code | unique confirmation code | String | |
| requested | whether or not a confirmation email was sen | Boolean | ||
| confirmed | whether or not the user's email was confirmed | Boolean | ||
How It Is Useful
- Provides a automated feedback mechanism that allows us to see user's progress.
- Provides task related data that can allow us to do more insight in to training process and even Sugar usage.
Source Code
The code is available under GPL at https://github.com/tchx84/training-server
RPM Installation
If you plan to run this Server on Fedora 18 or never installation, I would you strongly recommend you to install via our RPMS packages.
Install tch's Repository
$sudo vim /etc/yum.repos.d/tch.repo
[tch] name=tch baseurl=http://www.sugarlabs.org/~tch/repos/f19/ enabled=1 metadata_expire=1d gpgcheck=0
Warning: before moving on to the next step, make you have installed db-migrate tool via pip, pip install db-migrate (I will soon package this as an RPM).
Install Training Server
$sudo yum install training-sever $sudo service training start $sudo systemctl enable training.service
Training Activity Settings
To send reports to your server some values must be changed in user's machines.
gconftool-2 --set /desktop/sugar/services/training/url "https://your.server.com:443/training/report" --type=string gconftool-2 --set /desktop/sugar/services/training/api_key "your-servers-api-key" --type=string
Development
If you interested in contributing to this project please contact tch at sugarlabs dot org (Martin Abente Lahaye).