How to use Builder to create a Node

This page is intended to formalize how to use the current Builder scripts in the PTP subversion repository.

To build a Captive Portal Personal Telco Branded router on a computer with two ethernet cards and subversion installed on the computer used to run

The current state of builder is a working proof of concept. In the future all of the fuctionality of these process will be part of Adhocracy.

Step One (Prepare the Hardware)

For a matter of maintaining support and stability in a rational way we have choosen to use Debian Woody (Stable) as the Linux distribution to build upon. These scripts expect to find a computer that has a minimal debian install, two ethernet cards, and a connection to the Internet.

partition the hard disk

Currently the most common hard drive size that we have been using is a 2G drive. This is the chosen partition layout. You can make a custom partition layout but must reconfigure grub after builder finishes. For SCSI disks or custom / (root) or /boot partitions, please referance the grub install section of builder or for further information on grub see the grub manual. [] )

as these do not appear as selections when partitioning.

install Debian Woody

1. Perform a minimal stable install easily accomplished with a Debian Stable r3 or r2 netinst disk.

  1. Install with a 2.4 kernel
    • boot: bf24

Do not run tasksel

Do not run dselect

2. Installation will Reboot to finish installation

  1. Upon Reboot
    • only create the root user
    • tell the mail subsystem to do nothing
    • enable all choices for encrypting passwords (Shadow File and MD5 Encryption)
    • answer the default for most other questions (More detail later)

Do not run tasksel

Do not run dselect

Step Two (Create Nodedb Entry)

1. Go to

2. Create an entry in nodedb which contains the details of the node location.

  1. Please use the naming scheme
    • 'Personal Telco - Node Name'
      1. Could this be expanded to Personal Telco - Quadrant - Neighborhood - Node Name ?
        • e.g. Personal Telco - NE - Kerns - Urban Grind
        • Personal Telco - NW - Pearl - Urban Grind

3. Document the Node number which was assigned to the location.

Step Three (Create Configuration Files)

Define Network Address Allocation

1. Go to the wiki page NetworkAddressAllocations

Create files with

1. Create a working directory to run the builder script

2. Get the script from subversion that will do the configuration

3. Prepare the script for execution

4. Run with the -s option

5. Complete the following questions in a way that is applicable to your node location

NOTE: svn is required for this step.

Step Four (Make it all come together)

Obtain and Run builder script

From the command line on the machine that is going to be the captive portal router

1. Install wget

2. Use wget to retreive

3. Make the script executabe

4. Run the script

And now watch it go. When this finishes, reboot the machine. Now you should have a working Personal Telco Captive Portal Machine. This includes all services to provide the network infrastructure at the location. All configuration files are stored and managed in subversion.


[CategorySoftware] [CategoryNode] [CategoryNuCab] [CategoryDocumentation] [CategoryNetwork] [AaronBaer]