Home

1. Development Environment
2. Downloading

Development Environment

Use this section to setup a development environment that is identical to those used internally at Range Networks. We are working to support other development environments setups in the future but this one is guaranteed to work.

Install Base Operating System

If you're already running Ubuntu Desktop or Server 32-bit 12.04, you can skip this section.

1. download Ubuntu Server 32-bit 12.04.4 LTS from here
2. boot the .iso on a fresh machine (VMWare virtual machines are also often used)
3. select "English" for language
4. press F4
5. select "Install a minimal system" from install type
6. select "Install Ubuntu Server" from main menu
7. select your language
8. select your country
9. use keyboard layout auto-detection or select the country and layout
10. enter a hostname
11. enter "openbts" for "full name for the new user"
12. enter "openbts" for "username for your account"
13. enter and confirm a password for the openbts account
14. select "no" to "Encrypt your home directory?"
15. select "Guided - Use Entire Disk" for "Partitioning method"
16. select/confirm the disk you'd like to use
17. select "yes" to "Write the changes to disks?"
18. enter nothing for "HTTP Proxy" and select continue
19. select "No automatic updates"
20. toggle OpenSSH on in "Software selection"
21. select "continue"
22. select "yes" to "Install the GRUB boot loader on a hard disk"
23. select "continue" to "Finish the installation"

Installing a Modern Git

The OpenBTS project utilizes several new features in Git. To make sure your client is compatible (e.g. newer than 1.8.2), perform the following.

$ sudo add-apt-repository ppa:git-core/ppa
(press enter to continue)
$ sudo apt-get update
$ sudo apt-get install git

Once you have git installed, most of the remaining installation process is automated via scripts.

Downloading

Several software components are needed to actually create a usable mobile network. To efficiently manage them, we've prepared some scripts to automate the clone, pull, branch and build operations.

Tools

From the command line in your fresh development environment, execute the following to download the most recent set of tools:

$ git clone https://github.com/RangeNetworks/dev.git

Before proceeding, these tools require that you are using a modern version of Git (>1.8.2). Check now if you are:

$ git --version
git version 1.9.1

Components

This development scripts assume that you have SSH keys set up for GitHub. If you do not, please follow these instructions to set them up before proceeding.

Now, to download all of the components simply run the clone script.

$ cd dev
$ ./clone.sh

Building

asdf