PFSenseDevWiki: RouterStationPRO Setup Instructions

RouterStationPRO Setup Instructions

This document (as is the rspro image) is a work in progress (ALPHA ALPHA ALPHA ALPHA).

Acknowledgments

Thanks to Oleksandr Tymoshenko, Andrew Thompson and Ubiquiti Networks, Inc for helping make this possible!

RSPro Images/Firmware

http://cvs.pfsense.org/~sullrich/rspro (1 Gigabyte image + kernel)
http://cvs.pfsense.org/~sullrich/rspro/old (older images, some report the above does not work)

Warnings / Things not completed yet

- This image may eat your cable modem and swallow your internets. You are warned.
- Packages need to be recompiled and platform type added (packages do not work)
- Upgrade code needs fconfig support and glabel support (cannot be upgraded atm)
- Only 2 interfaces will work at a time currently
- Diagnostics -> NanoBSD link is currently broken in menu

Prerequisites

- Bootstrapping the RouterStationPRO requires a working TFTP server. You can setup a TFTP server using the pfSense package under 2.0 or see the FreeBSD MIPS wiki page for NetBOOT hints http://wiki.freebsd.org/FreeBSD/mips
- Download kernel.gz and nanobsd.full.img.gz
- Launch gzip -d kernel.gz (extract file)
- Place extracted kernel in your /tftpboot directory (or wherever the root of your TFTP server is located)

Bootstrapping

- Next, write out the pfSense MIPS image (nanobsd.full.img.gz) to a SD flash card (minimum 1 GB) using physdiskwrite or dd using bs=16k (32k did not work on OSX?)
- Boot the RSPRO (115200, 8N1) + null modem adapter cable and press CTRL-C a few times to break out into Redboot>
- Reset the flash to accommodate new configuration + kernels

fis init -f

- Set the IP address of TFTP server.

-h is the TFTP Server IP Address

-l is the IP Address that will be assigned to RouterStationPRO

RedBoot> ip -h 10.10.250.243 -l 10.10.250.123

- Load and store the first and second kernel in flash:

load kernel
fis create pfsense0
fis create pfsense1

- Setup the rootfs information:

fconfig
press enter
press enter
fis load pfsense0
# Note the following line will be ufs:/dev/dev/label/pfsense0
# once a nanobsd bug is fixed.
exec -c "vfs.root.mountfrom=ufs:/dev/da0s1"
press enter
type 1 enter for boot script timeout
keep pressing enter for defaults
Y to save

Here is a sample fconfig session:

RedBoot> fconfig
Network hardware address [MAC]: 0x00:0x01:0x02:0x03:0x04:0x05
Run script at boot: true
Boot script: 
.. ip -h 10.10.250.243 -l 10.0.250.123
.. load kernel
.. exec
Enter script, terminate with empty line
>> fis load pfsense0
>> exec -c "vfs.root.mountfrom=ufs:/dev/da0s1a"
>> 
Boot script timeout (1000ms resolution): 1
Use BOOTP for network configuration: false
Gateway IP address: 10.10.250.1
Local IP address: 10.10.250.236
Local IP address mask: 255.255.255.0
Default server IP address: 10.10.250.243
Console baud rate: 115200
GDB connection port: 9000
Force console for special debug messages: false
Network debug at boot time: false
Update RedBoot non-volatile configuration - continue (y/n)? y
... Erase from 0xbfff0000-0xc0000000: .
... Program from 0x87ff0000-0x88000000 at 0xbfff0000: .

Continue loading of pfSense

reset

Upgrading

- XXX Finish me. Write Code. Be happy. Enjoy RSPro + pfSense

Todo

- Implement RSPro specific code that allows for NanoBSD upgrade
- Ensure 3rd NIC is working (FreeBSD kernel code)
- Implement fconfig that thompsa ported
- Misc loose ends in the PHP code
- Extensive Testing

PFSenseDevWiki : RouterStationPRO