Projecte

General

Perfil

Start » Historial » Versió 75

Jorge L. Florit, 15-10-2013 14:33

1 70 Pau Escrich
!http://qmp.cat/images/qmp_small.png!
2 64 Pau Escrich
3 64 Pau Escrich
4 47 Jorge L. Florit
[[Inici|Catalan Version]] | [[Inicio|Spanish Version]]
5 13 Pau Escrich
6 46 Pau Escrich
{{toc}}
7 45 Pau Escrich
8 1 Pau Escrich
h2. What is qMp?
9 1 Pau Escrich
10 38 Pau Escrich
* It is firmware for embedded network devices based on "OpenWRT":http://www.openwrt.org Linux operating system
11 44 Pau Escrich
* It provides an easy way to set up networks using MESH it doesn't matter your they are either wired or WiFi or a mix of both
12 44 Pau Escrich
* It is a fast and reliable way to extend an Internet uplink to end-users
13 44 Pau Escrich
14 1 Pau Escrich
h2. Why?
15 1 Pau Escrich
16 1 Pau Escrich
Two main purposes:
17 1 Pau Escrich
18 6 Pau Escrich
* *For quick deployments*
19 6 Pau Escrich
There's no need to think about network topology, all you need to do is to spread the nodes and connect one to internet.
20 6 Pau Escrich
Use it in any kind of environments like concerts, meetings, demonstrations or in case of a natural disaster.
21 1 Pau Escrich
22 6 Pau Escrich
* *For the wireless communities*
23 6 Pau Escrich
If you are new into this all you need to become part of the existing community or to start building one is to download and install the firmware. It won't take you more than the time you need to take a coffee to have your node ready to be put in place.
24 6 Pau Escrich
But if you are already an old hands at wireless communities here is qMp to let you forget about all those weird network administration tricks that don't last more than a day in your mind and focus on what makes your community grow, that is, the nodes deployment.
25 1 Pau Escrich
26 1 Pau Escrich
h2. How?
27 1 Pau Escrich
28 1 Pau Escrich
* Providing a complete autoconfiguration system from the first boot
29 67 Pau Escrich
* Using a set of Layer 3 MESH protocols: BMX6 (main), OLSR6 as backup (depending on the node size)
30 67 Pau Escrich
* Using IPv6 as the main IP protocol with autoconfigured ULA addresses (global is also possible) 
31 1 Pau Escrich
* Using IPv4 only for end-user connection (tunneling)
32 1 Pau Escrich
* Providing an easy and intuitive administration web interface (LuCI based)
33 1 Pau Escrich
34 56 Pau Escrich
35 1 Pau Escrich
* Two main modes
36 56 Pau Escrich
** See this basic example to understand how qMp works in the [[Starting|community mode]].
37 57 Pau Escrich
** And read this short article to understand the differences between [[Roaming-Collaborative|roaming and community modes]].
38 52 Pau Escrich
39 12 Pau Escrich
h2. Devices
40 1 Pau Escrich
41 66 Roger Baig Viñas
Currently the fully supported devices are: Alix, Routerstation, RouterstationPro, Ubiquiti M5 products and several TP-Links.
42 66 Roger Baig Viñas
Some of the devices known to be fully supported by qMp are:
43 66 Roger Baig Viñas
* PCEngines
44 66 Roger Baig Viñas
** Alix: all models
45 66 Roger Baig Viñas
* Ubiquiti:
46 66 Roger Baig Viñas
** RouterstationPro (discontinued, unfortunately)
47 66 Roger Baig Viñas
** M2 and M5: all models
48 66 Roger Baig Viñas
* TP-Links
49 66 Roger Baig Viñas
** ar7xxx/ar9xxx OpenWRT target (all models should work): TL-WD2543ND, WDR{3500,3600,4300}
50 66 Roger Baig Viñas
51 66 Roger Baig Viñas
qMp is OpenWRT based, so most of the devices supported by OpenWRT are also very likely to be supported by qMp (at least to some extend).
52 66 Roger Baig Viñas
qMp is Free software, so if it doesn't perfectly suits for you all you need to do is to modify it and send us your patches to let us apply them.
53 31 Pau Escrich
Read the next article to see how to add a new device [[New_device]]
54 1 Pau Escrich
55 1 Pau Escrich
h2. Features
56 6 Pau Escrich
57 23 Pau Escrich
# *mesh:* Using a set of mesh protocols to provide automatic networking participation
58 6 Pau Escrich
# *autoconf:* A system to auto-configure all settings. So the user does not need to configure anything.
59 67 Pau Escrich
# *qmpinfo:* It is a tool written in Lua to get some information about the qMp system.
60 67 Pau Escrich
# *qmpcontrol:* It is a tool written as a shell script to manage the qMp system.
61 67 Pau Escrich
# *qMp web:* A LUCI (web interface) module to manage and monitor qMp.
62 68 Simó Albert i Beltran
# *map:* A map tool (named "b6m":http://qmp.cat/projects/b6m and written in JavaScript and Shell Script) to see the position of all network nodes and how are they connected.
63 68 Simó Albert i Beltran
# *internet detect:* A tool (named "gwck":http://qmp.cat/projects/gwck) written in Shell Script which is monitoring if the node is connected to internet, in this case it modifies all needed things to share it with the whole network.
64 1 Pau Escrich
65 40 Pau Escrich
Take a look to the screenshots section: [[Screenshots|Screenshots]]
66 39 Pau Escrich
67 7 Pau Escrich
h2. Get the firmware
68 7 Pau Escrich
69 65 Simó Albert i Beltran
See options on page [[Get_qMp]].
70 7 Pau Escrich
71 21 Pau Escrich
h2. Use the firmware
72 21 Pau Escrich
73 21 Pau Escrich
By default the network interfaces from your device are used for the next purposes (if some of them missing, it is just ignored):
74 21 Pau Escrich
75 21 Pau Escrich
* eth0 LAN with DHCP server and IP 172.30.22.1
76 21 Pau Escrich
* eth1 WAN with DHCP client running (you can connect it to internet)
77 21 Pau Escrich
* wlan0 MESH & ADHOC Routing daemons running using IPv6
78 67 Pau Escrich
* wlan1 LAN & AP with DHCP server and IP 172.30.22.1
79 21 Pau Escrich
80 51 Pau Escrich
So you can access it connecting your computer to eth0 or wlan1 and going via web browser to http://172.30.22.1 or http://admin.qmp using default login:
81 21 Pau Escrich
82 21 Pau Escrich
* user: root
83 21 Pau Escrich
* password: 13f
84 21 Pau Escrich
85 75 Jorge L. Florit
Check the article [[Starting|How to start a community network]], and many others in the [[/|WiKi]].
86 48 Pau Escrich
87 1 Pau Escrich
h2. Contributions
88 1 Pau Escrich
89 75 Jorge L. Florit
In the year 2011 the qMp project was partially funded by the PuntCat Foundation (.cat TLD registrar). 
90 1 Pau Escrich
91 71 Pau Escrich
The company routek.net is helping the project by hiring people for developing new features (for their customers) and write bugfixes.
92 71 Pau Escrich
93 71 Pau Escrich
*The main part of this project has been freely contributed by a bunch of networking enthusiast volunteers.*
94 71 Pau Escrich
95 71 Pau Escrich
You can also help us by crowdfunding our project, we accept BitCoins:
96 71 Pau Escrich
97 73 Pau Escrich
@1qMp9BWTM1Soth2NGgxsTBqvXX5mpPiPy@
98 71 Pau Escrich
99 74 Agustí Moll Garcia
!http://qmp.cat/attachments/download/138/btc-wallet.png!
100 71 Pau Escrich
101 71 Pau Escrich
Thank you!
102 71 Pau Escrich
103 10 Pau Escrich
h2. Contact
104 10 Pau Escrich
105 10 Pau Escrich
* e-mail: info_at_qmp.cat
106 1 Pau Escrich
* Users mailing list: https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-users
107 10 Pau Escrich
* Developers mailing list: https://mail.qmp.cat/cgi-bin/mailman/listinfo/qmp-dev
108 71 Pau Escrich
* Enterprise: http://routek.net
109 10 Pau Escrich
110 10 Pau Escrich
<pre>             
111 10 Pau Escrich
                 __ _  /\/\  _ __  
112 10 Pau Escrich
                / _` |/    \| '_ \ 
113 10 Pau Escrich
               | (_| / /\/\ \ |_) |
114 10 Pau Escrich
                \__, \/    \/ .__/ 
115 10 Pau Escrich
                   |_|      |_|    
116 1 Pau Escrich
                                   
117 1 Pau Escrich
                 quick MESH project
118 61 Pau Escrich
</pre>