Wiki

Version 2 (Leonidas Poulopoulos, 02/18/2013 07:17 pm)

1 1 Leonidas Poulopoulos
h1. DjNRO: Django National Roaming Operator or how to manage your eduroam database
2 1 Leonidas Poulopoulos
3 1 Leonidas Poulopoulos
!https://code.grnet.gr/attachments/2224/logo.png!
4 1 Leonidas Poulopoulos
5 1 Leonidas Poulopoulos
DjNRO = Django + NRO
6 1 Leonidas Poulopoulos
7 1 Leonidas Poulopoulos
* [[Requirements]]
8 1 Leonidas Poulopoulos
* [[Installation]]
9 1 Leonidas Poulopoulos
10 1 Leonidas Poulopoulos
h2. About
11 1 Leonidas Poulopoulos
12 1 Leonidas Poulopoulos
In the "eduroam":http://www.eduroam.org world, NRO stands for National Roaming Operator. 
13 1 Leonidas Poulopoulos
Maintaining and managing a local eduroam database is quite an important responsibility of an eduroam NRO. 
14 1 Leonidas Poulopoulos
eduroam.org periodically polls and gathers information from all participating domains. 
15 1 Leonidas Poulopoulos
Information is provided upstream, in a structured way (XML format) and consists of participating institutions' data, location data along with monitoring data - though provisioning of monitoring data has been superseeded by the f-Ticks mechanism. 
16 1 Leonidas Poulopoulos
17 1 Leonidas Poulopoulos
The source of information should be the local eduroam database. So, changes to the database should be reflected to the XML files. 
18 1 Leonidas Poulopoulos
New eduroam locations, changes in contacts and information about each location should be up-to-date so as to ease the eduroam usage and assist eduroam users whenever they need support. 
19 1 Leonidas Poulopoulos
20 1 Leonidas Poulopoulos
DjNRO is a Django platform that eases the management process of a National Roaming Operator. DjNRO complies with the "eduroam database":http://monitor.eduroam.org/database.php and the eduroam XSDs.
21 1 Leonidas Poulopoulos
Thus, apart from domain management, it can generate the necessary xml files for eduroam.org monitoring.
22 1 Leonidas Poulopoulos
23 1 Leonidas Poulopoulos
DjNRO is more than keeping eduroam.org updated with data. 
24 1 Leonidas Poulopoulos
25 1 Leonidas Poulopoulos
In essence it is a distributed management application. It is distributed in the sense that information about each institution locations and services is kept up-to-date by each local eduroam administrator. Keeping in pace with eduroam's federated nature, our implementation uses federated authentication/authorisation mechanisms, namely Shibboleth. 
26 1 Leonidas Poulopoulos
In case Shibboleth is not an option for an institution, a social media auth mechanism comes in handy. The local institution eduroam administrators can become DjNRO admins. Local eduroam administrators register to the platform via Shibboleth or social media auth. The NRO's responsibility is to activate their accounts. 
27 1 Leonidas Poulopoulos
28 1 Leonidas Poulopoulos
From then on they can manage their eduroam locations, contact points and institution information. The administrative interface especially the locations management part, is heavily implemented with Google Maps. This makes editing easier, faster and accurate.
29 1 Leonidas Poulopoulos
30 1 Leonidas Poulopoulos
Installation and customization is fairly easy and is described in the following sections.
31 1 Leonidas Poulopoulos
32 1 Leonidas Poulopoulos
Currently the source code is availiable at code.grnet.gr and can be cloned via git:
33 1 Leonidas Poulopoulos
34 2 Leonidas Poulopoulos
	@git clone https://code.grnet.gr/git/djnro@
35 1 Leonidas Poulopoulos
36 1 Leonidas Poulopoulos
The Greek eduroam webpage is a living example of DjNRO: "eduroam|gr":http://www.eduroam.gr 
37 1 Leonidas Poulopoulos
38 1 Leonidas Poulopoulos
Features
39 1 Leonidas Poulopoulos
------------------
40 1 Leonidas Poulopoulos
41 1 Leonidas Poulopoulos
* Allow your local eduroam admins to edit their local eduroam data (AP locations, server params, etc)
42 1 Leonidas Poulopoulos
* Visualize the information via Google Maps
43 1 Leonidas Poulopoulos
* Eduroam world maps overview via daily update on eduroam.org KML file
44 1 Leonidas Poulopoulos
* *PLUS*: Find your closest eduroam in the world
45 1 Leonidas Poulopoulos
46 1 Leonidas Poulopoulos
Bootstrap CSS framework with responsive design makes it work on every device
47 1 Leonidas Poulopoulos
48 1 Leonidas Poulopoulos
49 1 Leonidas Poulopoulos
* [[Requirements]]
50 1 Leonidas Poulopoulos
* [[Installation]]