[[File:deployed_tower_austin.jpg|thumb|x300px|alt=tower_in_austin|Tower deployed in Austin, 2011]]
So, I'll start putting this together for my own reference and someone with more direct knowledge can fill in/correct whatever I miss. I'll try to add links to items as I find them online. - --[[User:Sunflame|Sunflame]] 01:55, 6 November 2011 (CST)
FreedomTowers are owned and operated by those that benefit from them. They benefit entire neighborhoods – communities on the order of five to ten thousand individuals. FreedomTowers perform critical Layer 1 network operations, and help the neighborhood mesh run efficiently. In addition to improving the throughput of Layer 1 connectivity, FreedomTowers participate in the Layer 2 regional mesh. This means that neighborhoods can connect directly to one another, and that material peer-to-peer is not limited in scope to local communities.
== Meta bits ==
Like all components of the Free Network Stack, the exact implementation and role of the FreedomTower is flexible; the currently pursued architecture is to have some towers connect "upstream" via high-bandwidth FCC-licensed 3.6GHz radio links to FreedomLink nodes in existing industry fiber connectivity sites, to route tower-to-tower over either the same licensed links or directional 5GHz WiFi links, and to provide "downlink" connectivity to a WiFi mesh of [[FreedomNode|FreedomNodes]] and [[FreedomBox|FreedomBoxes]].
* [http://chili.freenetworkfoundation.org/projects/fnf-tower-power Chili project page]
FreedomTowers have so far been assembled and deployed for short periods independent of the rest of the stack by using retail "4G" wireless modem uplinks. See [[FreedomTower/ConstructionDocs|ConstructionDocs]] for a recommended bill of materials and assembly instructions.
#TODO: Merge with below bill of materials
*A UPS such as the APC BE750G ($100 )
*A nettop such as the Lenovo IdeaCentre ($300 )
**Google Shopping Search "[http://www.google.com/products/catalog?q=Lenovo+IdeaCentre&hl=en&safe=active&prmd=imvnsr&bav=on.2,or.r_gc.r_pw.r_cp.,cf.osb&biw=1504&bih=965&um=1&ie=UTF-8&tbm=shop&cid=5803394447437975775&sa=X&ei=3z-2TqCGGcXdtgfVqrXNAw&ved=0CKsBEIIIMAA#scoring=tp Lenovo IdeaCentre]", sorted by Total Price.
*Two 4G modems such as the Clear Series M ($100 x2 = $200)
**[http://www.clear.com/devices/details/id/80 Get it refurbished] for only $50 x2 = $100.
*Enclosure for UPS, computer, router, modems, and radio power injectors
*($100)
*Telescoping mast ($30)
*Brackets, velcro, whatnot ($20)
So, total bill of materials comes in at $1240
== Software ==
Was originally pulled from: [http://freenetworkfoundation.org/?p=400 http://freenetworkfoundation.org/?p=400]
The Ubiquity directional radio units run AirOs, but just act as "dumb" bridges; the router computer runs pfSense (based on BSD).
When acting as a component of the Free Network Stack, towers will fill the role of neighborhood wireless mesh "Super Nodes" (coordinating mesh routing) and additional software packages and daemons to manage upstream routing, neighborhood services (mailing lists, chat, wiki, etc), user device authentication, resource abuse and accounting, etc will be required.
'' See [[FreedomTower/ConstructionDocs|ConstructionDocs]] for details and a full bill of materials ''
* A quiet power generator such as the Honda EU1000i ($800 )
* A UPS such as the APC BE750G ($100 )
* A nettop such as the Lenovo IdeaCentre ($300 )
* An 8-port network switch ($15)
* Three USB->Ethernet adapters ($30 x3)
* Two 4G modems such as the Clear Series M ($85.00 for each modem, $45.00 for first month for each, $30.00 activation fee total ($320.00 total) [Procure from Clear store so no contract required]
* Three Ubiquiti NSM2′s ($80 x3 = $240)
* Three Ubiquiti NSM5 Locos ($50 x3 = $150)
* Enclosure for UPS, computer, router, modems, and radio power injectors ($115)
* EMT Conduit mast (9') $12.00
* Two ten-inch sections of 2x10" board $10
* Five power splitters
* 50' red CAT5
* 25' black CAT5
* Velcro, zipties ($20)
==Needed supplies==
The core components of a "permanent" FreedomTower are:
* Drill
* 1/2" bit
* RJ45 (ethernet) Crimper
* Label maker
* 1 Hour Epoxy
==Abstract==
* A relatively reliable source of electrical power...
There are two phases in the construction of a FreedomTower: configuration and assembly. Configuration has three stages: modems, router, and radios. Assembly has two: enclosure and mast. We will begin with configuration, and move into assembly.
** Could be a quiet fossil-fuel power generator such as the Honda EU1000i ('''$800''' plus fuel)
** Or a sustainable power solution like solar panels or a wind turbine
** Or simply a nearby AC power plug
** Combined with un-interuptable power supply such as the APC BE750G ('''$100''')
* A "upstream" radio/modem...
** Could be "legacy" a 4G modem such as the Clear Series M ('''$80''' plus monthy service around '''$40''')
** Or 3.6GHz Free Network backhaul equipment such as the [[AirFiber]] radios from Ubiquity ('''$1500''')
* A low-power "headless" computer to act as a router, and a cheap 8-port network switch
* Three 2.4GHz 802.11b/g WiFi radio units (Ubiquiti hardware '''$80''' each)
* Three 5GHz 802.11a/n WiFi radio units (Ubiquiti hardware '''$80''' each)
* A robust enclosure for electronics (crate for '''$115''')
* Radio mast/pole (3 meters)
==Phase one: Configuration==
== Status ==
===Stage one: Modems===
We recommend that you procure the wimax modems for your tower through a corporate account with Clear. There is no price difference, and it will give you access to second level support, should the need arise.
Once you have procured the modems (we suggest two, but you could use as few as one or as many as are needed), configure your machine to look for an address via DHCP on your wired interface. Plug directly into each modem in turn. You should be able to access the web administration interface of the modem by navigating to 192.168.15.1 - the password is set by default to CLEAR123, but maybe still be the OEM default of motorola.
Once you're in, you should change the password, and record the WAN IP address of the modem.
If you're only using one modems, that's it. For those using two or more modems, there is another step. Because all Clear modems are set to the same address by default, it will be necessary to change the DHCP settings so that each modem has a different address. Leave one modem as 192.168.15.1, and number additional modems by iterating the third octet: 192.168.16.1, 192.168.17.1, etc.
===Stage two: Router===
'''May 2012:''' [[MayFirst2012NYCCrateDeployment|NYC deployment]] of "mobile edition" tower ("internet in a suitcase")
The heart of the FreedomTower is a nettop computer running pfsense, a variant of openbsd, that makes it easy to do network administration. We used the Lenovo Q150 in our build, but ran into problems when we discovered that the south bridge of the Q150's chipset is not supported by openBSD. You may wish to proceed as we have, by working around the problem using USB to Ethernet adapters, or you may wish to explore alternative nettop hardware. If you do the latter, please let us know how it goes.
Hook up your nettop to a monitor and keyboard. You will need a live image of pfsense. You should use the stable release of version 2. Before you proceed, connect the box to at any WAN connections, and to the network switch. Install pfsense on the box, configuring it to accept an address via DHCP on all WAN connections, and to serve addresses via DHCP to the LAN.
Once this is done, you'll want to reconfigure the LAN settings to expand the subnet. We recommend using 192.168.10.0 through 192.168.254.254. Then configure DHCP to hand out that range of addresses. << Wouldn't this be the FNF coordinated subnet?
The next step is to set up load balancing against the WAN connections. This is done by creating a gateway group, and making a firewall rule to route all lan traffic to that gateway. << Let's add screenshots here
===Stage three: Radios===
'''October 2011:''' Two first-generation FreedomTowers were deployed at OWS sites in NYC and Austin, TX ([http://freenetworkfoundation.org/?p=475 blog post])
== More Resources ==
A) Label them with
* [[FreedomTower/ConstructionDocs]]
Role (mesh node 5/2.4ghz node (x), mesh node 5/2.4ghz gateway)
* [http://chili.freenetworkfoundation.org/projects/fnf-tower-power Chili project page]
* [[MayFirst2012NYCCrateDeployment|NYC deployment]] of "mobile edition" on 5/1/2012
* [http://photos.freenetworkfoundation.org/index.php?/category/2 Assembly and deployment photos] of towers (circa 2011)
(pic 1)
* [http://freenetworkfoundation.org/?p=422 More build photos] (from blog, October 2011)
* Mailing list threads: [http://freenetworkfoundation.org/pipermail/builders_freenetworkfoundation.org/2012-May/000573.html moving the FreedomTower and FreedomNode towards 1.0] (May 2012), [http://freenetworkfoundation.org/pipermail/builders_freenetworkfoundation.org/2012-February/000076.html FreedomTower] (February 2012), [http://freenetworkfoundation.org/pipermail/builders_freenetworkfoundation.org/2011-December/000053.html FreedomTower Mark II] (December 2011)
Configuring the radios has two steps.
====Step One: Flash OLSR capable firmware====
First, it's necessary to flash the devices with the proper firmware. We'll go over that procedure once, but you'll need to do it for all six radios. For the time being, we are using a version of Ubiquiti's AirOS that's been patched to support OLSR routing. You'll also need to have TFTP installed on your machine. It is widely available via your fravorite package manager. The firmware can be found here:
LocoM5: Using binary image from http://build.ffgraz.net/ubnt/AirOS%20v5.x/XM.v5.3.3.sdk.9634.with-olsr-0.6.1/
--[[User:Sunflame|Sunflame]] 07:58, 13 December 2011 (CST) I had an issue with the configuration resetting to default every power cycle. It was due to a bug discussed [http://www.ubnt.com/forum/showthread.php?t=16923 here]. The solution was to flash the latest official firmware via tftp and then the custom firmware via web interface. This resolved the problem.
====Step Two: Power them all up====
Once you've got the firmware on your machine, you'll need to put it on the radios. First, you'll configure your machine to have a static address is in the 192.168.1.x subnet. Any address besides 192.168.1.20 will work. Next, take an unpowered radio, and depress the reset button. Continue to hold the reset button, and plug the radio in. Continue holding the reset button until the lights on the radio flash 1-3, 2-4, 1-3, 2-4. Release the reset button.
The radio is now in TFTP flash mode. You'll want to ping 192.168.1.20 to make sure that you've got a connection to the radio. Navigate to the directory where you've stored the firmware binary, and flash it to the radio using the following commands, there is not tab-to-finish in TFTP, so you'll have to type everything out:
tftp 192.168.1.20
bin
trace
put firmware_binary
Did this via tftp ( http://www.ubnt.com/wiki/Firmware_Recovery#Linux_Users )
Wait until you see the lights stop cascadaing back and forth, and an ARP request like:
before you consider the firmware complete. Also be VERY gentle with the reset switch. Very light pressure required. Use
a paper clip. DO NOT USE A SCREWDRIVER. This will almost certainly break the reset switch.
Once the transfer has finished, you can quit TFTP. Wait several minutes for the radio to reboot. Once it comes back online, navigate to 192.168.1.20 in your browser. You should be presented with the ubiquiti web interface. The default username and password are ubnt:ubnt. We recommend changing the admin user name, and the hostname. Our radios are named FNF2-0, FNF2-1, FNF2-2, and FNF5-0, FNF5-1, and FNF5-2. Once you've changed these settings, you should also ssh into the machine in order to change the password, using the command passwd.
All radios should be set to bridge mode, and configured to obtain an address via DHCP. The 2-0 and 5-0 radios will be configured as access points, and the 2-1, 2-2, 5-1, and 5-2 radios will be configured as stations. You should also make sure that all radios are set to a 20MHz channell width, and have AirMax turned off.
On the 2-0 and 5-0 machines, you'll set SSIDs for the networks. Ours are called 'The Free Network' and 'The Free Network 5GHz'. Once you've set the SSIDs on the Access Points, you'll lock the station radios to the MAC address of their respective APs.<< I believe the lock step is only on the nsm hardware in the 5.2 airos
At this point, you'll probably want to configure the router to grant a static lease to the radios. Ours are numbered 192.168.2.0-2 and 192.168.5.0-2 << do we want to encourage a separate vlan for management?
As far as configuration goes, that's it! You're ready to put everything in the enclosure
==Phase Two: Assembly==
Keep in mind here that these instructions are based on the components listed in the Bill of Materials above. If you've chosen to use different hardware, your mileage may vary.
===Step One: Enclosure===
In order to keep the power supply stable, it will be necessary to fill the bottom gap (between the wheel wells of the case) with the boards. Epoxy the two boards together. Then expoxy the boards to the bottom of the case, in the center, being careful to keep the boards flush with the bottom. Once the boards have cured, attach the power supply on top of them using a couple strips of velcro. Carefuly not to affix the velcro such that it makes it impossible to open the battery compartment of the UPS. The power supply should be attached such that the cord exits at the bottom right corner of the case.
As you may notice, the case can't shut with a power cord inbetween the base and the lid. Use a knife to carve away the closure lip, without cutting through the weather seal. You should be able to close the case around the power cord, and maintain a water-tight closure.
Next, you'll mount the modems, one (or more) on either side of the case. Use velcro. Be generous.
Then mount the nettop. Same story. Use velcro. We mounted ours so that the fan vent is up, which puts the power button against the back wall of the case. This helps avoid accidental power cycles.
Again, same story with the switch, but this time, mount it to the top of the case. Depending on what model of switch you have, you may want to remove the rubber feet before applying the velcro, as the feet tend to slip out of their fittings.
Next task is to mount the power over ethernet injectors for the radios to the lid. The ports should face the top.
Now you're ready to plug the five power splitters into the five outlets labelled 'sure protections and battery backup'. This is so that the entire rig can run off of batteries. We use the three splitters on the left for the power injectors, and the two on the right for the modems, router, and switch.
Plug everything in. Tidy up with zipties where you can, and you're ready to move on to the mast.
===Step Two: Mast===
The mast consists of the six radios mounted atop a piece of conduit, with an ethernet run through the middle of the mast, and out the bottom. On one end, drill two 1/2" holes in a vline, one XX inches from the end, and another XX inches from the end. The top hole will be for the ethernet cables going to the NSM2s, and the bottom will be for the NSM5Ls. XX inches from the bottom, drill two 1/2" holes in a horoizonal line, with about 3/4" between the two. Now run 11' sections of uncrimped ethernet cable through the mast. Cables that enter through the same hole should exit through the same hole. Use two red cables and one black per hole. The black cable will carry power and data. The red cables will cary only power. You might use fish tape or string, and a bent wire hanger to make the process go quicker. Once the cables are through, crimp both ends.
Ziptie the radios to the mast, and plug in the cables. Mount the mast on the tripod, and run the cables down around the tripod. You'll need to do the same for the two ethernet bundles as you did for the power cord. Carve away the lip of the closure, but the leave the weather stripping. Plug everything in, and you've got yourself a FreedomTower!
[[Category:Projects]]
{{FNFProject}}
Latest revision as of 21:34, 15 June 2012
FreedomTowers are owned and operated by those that benefit from them. They benefit entire neighborhoods – communities on the order of five to ten thousand individuals. FreedomTowers perform critical Layer 1 network operations, and help the neighborhood mesh run efficiently. In addition to improving the throughput of Layer 1 connectivity, FreedomTowers participate in the Layer 2 regional mesh. This means that neighborhoods can connect directly to one another, and that material peer-to-peer is not limited in scope to local communities.
Like all components of the Free Network Stack, the exact implementation and role of the FreedomTower is flexible; the currently pursued architecture is to have some towers connect "upstream" via high-bandwidth FCC-licensed 3.6GHz radio links to FreedomLink nodes in existing industry fiber connectivity sites, to route tower-to-tower over either the same licensed links or directional 5GHz WiFi links, and to provide "downlink" connectivity to a WiFi mesh of FreedomNodes and FreedomBoxes.
FreedomTowers have so far been assembled and deployed for short periods independent of the rest of the stack by using retail "4G" wireless modem uplinks. See ConstructionDocs for a recommended bill of materials and assembly instructions.
The Ubiquity directional radio units run AirOs, but just act as "dumb" bridges; the router computer runs pfSense (based on BSD).
When acting as a component of the Free Network Stack, towers will fill the role of neighborhood wireless mesh "Super Nodes" (coordinating mesh routing) and additional software packages and daemons to manage upstream routing, neighborhood services (mailing lists, chat, wiki, etc), user device authentication, resource abuse and accounting, etc will be required.