Mpumulanga Mesh

From WirelessAfrica
Revision as of 16:33, 17 November 2005 by Kingdavid (talk | contribs)
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.


White River is a medium sized town about 20 minutes north of Nelspruit, the capital of Mpumalanga Province. Peables Valley and the Masoi Tribal land is located 20 minutes to the North East of White River along the road leading to the Kruger National Parks Numbi gate.

The area is hilly with some large granite outcrops. The Peables Valley stretches from the ACTS clinic and divides the commercial farms from the Masoi area. Commercial farming in the broader area is predominately timber but fortunately along the valley there is no timber farming (this would pose a connectivity problem and impact line of sight requirements). The farmers as a community are already well connected (organisationally not in terms of Internet connectivity) with commando like structures in place because of crime.

The ACTS clinic is located at the beginning of the Valley. ACTS stands for AIDS Care Training and Support Clinic. They provide medical services to AIDS patients, councilling, testing and Anti-retroviral (ARV) treatment. The clinic has gained a reputation within the community with many people coming from outside of the Masoyi area for treatment. They are have been selected for managing ARV roleout because of their well developed councilling, testing and support group networks. Currently they have about 200 people on ARVs with this figure likely to grow to over 600. These treatements are being monitored by researchers at WITS University.

The Masoyi area runs along the right hand side of the valley. We identified approximately 10 schools, with two identified as being high schools with computer facilities. The project team has good links to a teacher in one of these schools who is in charge of the computer lab. In the area there is also a teachers training centre, government hospital and various government clinics in the area. The ACTS clinic runs a hospice close to one of the Government clinics.

Situation in the Community

The community is underserviced. Most roads remain unpaved with the main road having been rebuilt after the floods of 2000. Electricity is available within the community. The community is poor and has been hugely impacted by AIDS. Losing salaried member of households through AIDS has a bi impact on extended families. There is also the associated superstition and secretiveness around AIDS which does not help improve the situation.

ACTS clinic

The clinic is a non-profit organisation established to provide AIDS care in the Masoyi area. It was initially sponsored by Glaxo Smithcline. The clinic has two doctors, an onsite hospice, training centre and accomodation for people on training courses.

A number of staff have been trained to provide pre-test and post-test councilling. This leaves the doctors free to focus on the medical aspects of treatment. The clinic operates in many ways like a private doctors practice. They charge consultation fees and patients on medical aid are charged accordingly. They however usually waive all fees as soon as it is established that a patient is suffering from AIDS. The clinic is relatively sopphisticated in their use of computers: they run practice management software, are connected to the Internet via Vsat for their research with WITS. They also have some custom MS Access based applications written internally to track patient statistics.

Proposed Solution

Deploy a mesh network within the Peables Valley, run training courses to transfer skills on mesh setup and installation, work together with the clinic staff using Free Attitude Interviews (FAI) to discover applications and uses that work for the staff.

What problem is being addressed

The main thrust is to connect the clinic to its community hospice and thus allow them to extend their computer facilities to the hospice (practise management software and statistics gathering). This is most easily achieved through a wireless network and more specifically a mesh because of the terrain.

A mesh network requires a number of nodes in areas not owned by the clinic but that are part of the commuity: schools and farmers. The main thrust of the research question is to implement the network in such a way that the firstly the clinic and secondly the community have taken ownership of the network. That they have created systems that ensure that the infrastructure is maintained and expanded by the users of the network.

Technology Explained

A wireless network involves radios and arials. The radios broadcast and receive signals which are boosted and directed by the arials. Anyone with a radio can access the network. The spectrum used for Wifi required line-of-sight for connectivity. The routes between sites are also hard coded or manually adjusted in each device. This makes it technically difficult on two levels. Firstly, you need a deaper understanding or the radio spectrum and the operation of radio wave and secondly, configuration of the equipment requires a higher level of skill.

A mesh network uses the same infrastructure: arials and radios. But at the network level it operated differently. The network simply requires that each node can see at least one other node (ie it can be part of the network) and that each node can send trafic to any node on the network (ie there are no islands which are not connected to the whole). In a mesh network this problem is solved at the software level. As long as your node can see another node it will be able to determine the routes to follow. The also allows for a level of self healing and thus less maintenance. If for example a truck parks in from of the node or a tree grows up over time and block the signal to another node then as long as the node can see an alternate node it can route traffic via this new path. On a conventional wireless network this would need to be manually configured.

The choice of mesh in the Peables Valley was made for these reasons: Hilly terrain that requires a number of hops to reach the destination Low skilled network operators Changing conditions in the environment. Nodes that disappear through neglect, theft, obstruction.

Social Challenges

There are a number of social challenges:

Firstly, for the the network to operate to serivice firstly the clinic and secondly the community it requires the cooperations of teachers in schools and of farmers. They all have there own agenda's there own perceptions of their expected level of involvment and their expectation of how aid is given to them.

In the school we are concerned about a hand-out mentality that will not see the school working hard to be involved in the extension of the mesh but simply being involved as long as it takes to link the school to the Internet. There is also the risk of our contact at the school wanting to be seen as being in charge and not wanting to work together with schools in the community.

To addess that we are looking at bringing the school pupils into the process from the beginning and teaching them how to install and configure equipment.

Secondly, with the farmers we are confident that it will be easy to sell them the concept of Internet connectivity. However, for the network to work for them will require that they connect to schools in the Masoyi area. We are not certain about the realtionship between these two groups. Considering the crime levels there is the risk that there is not a good level of trust.

Our strategy is to involve people from both groups during training workshops. Which at the very least would allow realtionships to be established.

Lastly, this is not the primary focus of the ACTS clinic so there will always be the risk that people are redeployed.

However, our main contact in the clinic is an electrical engineer by profession and the clinic itself has proved that they are a teaching organisation (their previous garder now runs the reception).

Technical Challenges

Mesh networks are a new phenomena with the software sometimes not yet at the level required for the mesh to operate well. There is the risk that in this project we will discover the limitations of the technology and have to spend time compensating for that.

Some of the endpoint nodes we have identified require many hops. This requires many nodes. This is both a social and technical challenge. Social in that the project needs to bring each of those players on board and technical in that each of those nodes needs to be built, deployed and maintained.

There is also the risk of theft. The node equipment has very little commercial resale value in the community, although there seems to be wifi operating in the Nelspruit, White River area. However, that never seems to be a consideration of petty thieves. Hopefully deploying the equipment in established locations: schools, shops, private homes and not simply in the open will help secure the equipment.

Equipment Ownership

As the objective is to create a community based network where the network is seen as a community asset so therefore some of the equipment at key nodes should belong to the community. Official ownership will be with the ACTS clinic until such time as a more formal structure for ownership of key mesh equipment can be established.

As the mesh grows individual node owners will own their own equipment. So a farmer or school will be the owner of that equipment and it will form part of the mesh. It is hoped that farmers will partner with institutions such as schools in which case the partners will define ownership relationships.

The project does not envision supplying any equipment to farmers unless they are located such that having equipment on their farm is critical to creating the mesh. In such as case we would look at funding that node if the project has to but the project will still attempt to have the farmer install his/her own equipment.

Intellectual Property

The project will release all work under a suitable Open Source license. This work includes documentation and results of the research.

The project will not be developing any independent software but will be using other freely available mesh software. In the case that software is improved or modified it will be released under the license of the original software project to ensure that it can be included in future releases of that software.


A key component to sustainability will be involvement of the farmers, Bible colleges, etc within the Peables Valley. The project will draw in the farmers for the following reasons: 1) they are a source of skills, 2) they have finances to pay for Internet connectivity and 3) that once they become users they are likely to become dependent on the mesh and thus ensure its ongoing success.

Part of the program will be to educate participants from the start so that they can extend the reach of the mesh. Included will be education of pupils from the partner schools. This education is designed to ensure that enough skills are available in the valley to repair nodes, setup new nodes, manage the mesh and train others.

A key component to the sustainability is that the project manager as the ACTS clinic is a qualified electrical engineer. We are therefore confident that it will not be difficult to educate him on the workings of the mesh network. He has already demonstrated his excitement and commitment to the project by spending a Saturday with the project leaders evaluating high sites. He is involved in training staff and is extremely practical so will be invaluable in erecting high sites.

Pros and Cons of the system

First considering some positive aspects of the mesh. Firstly the clinic is already using IT infrastructure in the following areas: ARV monitoring, clinic management and accounts. Farmer, bible colleges, etc in the community already use the Internet for email etc but usually at great cost because of the limited choice of commectivity options. The partner schools already has a lab that has in the past been connected to the Internet. So there is already a body of people who have demonstrated the willingness or need to use the Internet who we feel would be willing the use a mesh if it provide always on and lower Internet connectivity costs.

The potential problems we see are the following. There is the risk that the effort to manage or be part of the mesh may be more expensive then direct connection especially in the case of the lack of good neighbourliness from any mesh participant. The clinic, although they currently use IT extensively, may in fact not need to extend that usage beyond the main clinic. The risk with the schools we feel is that there is a general hand-out mentality and that there will not be the will to learn, extend the network or integrate this into the curriculum. Another large risk is the sustainability of the network not from the mesh side but from the side of financing the hop onto the Internet itself.

Backhaul Connectivity

The connectivity to ACTS is provided via Telkom VSAT. ACTS uses the connection as part of their involvement in ARV roleout for the Right To Care group. They have an Internet based application for capturing details of patients for monitoring and evaluating patients receiving ARVs

Network Topology

Acts meshnet.jpg

News Flashes

September 22, 2005, WiFi in the bush or the plot

Duane visited the IDRC funded workshop for WiFi in Africa. Sorry don't knwo what the real project name is. Sat in on the session on regulation, the Department of Communications delegates decided that this would be a good time to leave. Nice when you know you can't actually stand the heat.

Had a look at their cantenna based access-point liming over about 5km. With a Linksys strapped to a tree with... red tape... man we can't get away from red tape in this industry.

Most surprising was a local WISP that delivers Internet to about 100 customers and nobody new that they existed before booking the venue. They do long haul links to ADSL connections in Pretoria. Quite an innoative solution to high cost access. I want to explore that possibility in Peebles Valley.

July 06, 2005, Realisation of a mesh vision

Today we had a film crew filming the installation of a mesh node. It was great fun but they did waste our time a bit. Technically this is what we got done:

   * Installed the node on Agnus' house permanately. Lassy did all this work
   * Put a 3m pole at the Hospice to see if we can get over the ridge
   * Upgraded AGNUS, HOSPICE and SIKILE to OpenWrt
   * The clinic is cabling various buildings so we will be able to recover one node an just run a cable from the FLATS node to the VSAT.

We had a 7ms delay between AGNUS and ACTS_VSAT which is a route that passes through all present nodes. VoIP is now truely achievable. Wonderful performance compared to WDS mode. Throw out WDS wherever you see it its just not worth the effort. It is honestly more simple to setup OLSR. Glad we've learnt that and can move on.

We still ahve the following technical hurdles to overcome. The default route keeps disappearing. We need to install a proper firewall. Once that is done we can move onto the community adoption.

The day was full of some lovely experiences of the potential of what we are doing.

Once we had AGNUS up we setup Dave's laptop and had Agnus' daughter and a neighbour sit at the computer. Dave opened Google. They didn't know what to do. We asked them waht infomration they wanted to know. Stuck again. "Who is your favourite singer?" - Alicia Keys - "OK type that in the seach box, then click on search" - Shouts of glee as the search results return. "Now click here". Off they went to Alecia Keys home site and disappeared for about 10 minutes. Does that count as training? The two of them were sitting inside quite a dark house, they sat together on a sofa and the laptop screen glowed in the semi-dark with their face highlighted. This exact image was the vision I had for this project. So that made my day.

I did a quick training course in the dirt. Explaining what the differnt aerials did, how it all fitted together. And of course how to use a high-gain antenna as a fish braai. Lassy provided Swati translation as soon as there was any confusion.

Now off to the school to film students working on computers. They wanted to interview the teacher, who was a standin for Mr Sihlabela who we usualy work with. "What will you use the Internet for at your school", to which he replied, "I don't know". David did a quick exercise of taking the teacher, a history teacher, to Google. They Googled for "Shaka Zulu" and ended up at a very good site on the subject. "What will you use the Internet for at your school", and we got a 5 minute reply. Does that count as training?

What worked best about this trip was having a very focussed objective - get the mesh working. We didn't care about the firewall, the billing, shapping, etc. And we got it done. The next trips will be similarly techically focussed.

July 05,2005 Moving on to OLSR

I left Peebles Valley at the end of May and this is the first return since then. David and I are migrating all the Linksys boxes from Sveasfot to OpenWrt, specifically the builds produced by Freifunk which has a nice web interface. Lassy has joined us againt and is helping us move the equipment around.

The task involves loading the Freifunk firmware onto the box. This requires local connectivity. We still had connection problem until we discovered the ghosts of a WDS past. A ot of WDS settings were still on each of the boxes. We've now had to go and remove those especially the Lazy WDS mode settings which keep establishing bridges. OLSR looks like the right solution. Its the same amount of work as WDS setup but you get real routes, ones that you see and can traceroute through so you can actually see exactly how packets are being routed on the network. I'm much much happier. Yesterday we got USAID, ACTS_VSAT and ACTS_FLATS converted. Today we are in the field with a film crew and will migrate: AGNUS house, SIKILE_HIGH and FARM_COBUS. If we can get traffic from either Agnus' house or Cobus' farm then we know that the protocol is good, both these points would have to route through. SIKILE, USAID, ACTS_FLATS then ACTS_VSAT. WDS could never do that and if we can get this working then the mesh is good and we can move onto the next challenging problem.

At the last conservanc meeting at which ACTS slinic was present they mentioned the Mesh but all the famers were wondering when exactly anythin would happen. Hopefully we have a working system before we leave.

We also spoke to Frans Benz who's property is below USAID and he is still interested.

Of the nodes that we have observed all were powered up except ACTS_VSAT this was good as it means that people are leaving the equipment to do its job. THe VSAT was down because the plug is just too close to a usefull double adapter.

We have brought 300m of CAT5 cable which the clinic will use to run cable from the VSat to the Flat so we can eliminate one node and use it elsewhere. This clinic has arranged conduit and pulling of the cables.

February 11, 2005, Equipment got

We now have the equipment for the FMFI Wireless project in Mpumalanga. We have 10 Linksys wireless AP which we're firmware upgrading. The cards are in a nice heavy duty all weather box. A picture would be great :). All the boxes are being moded to do power over ethernet which makes hte whole installation clean and simple. Currently it looks like costs are around R2,000 a node.

I'm lugging the lot down to White River this weekend and will erect 3 of the nodes. Mainly to test equipment and get a working initial network. The other nodes will be setup by the community, following the Onno Purbo style of network deployment.