Merge branch 'master' of github.com:aus/pfatt

This commit is contained in:
aus 2018-09-23 22:54:08 -05:00
commit 23a6db21a2
2 changed files with 15 additions and 12 deletions

View file

@ -19,8 +19,7 @@ If you don't have three NICs, you can buy this cheap USB NIC one [from Amazon](T
## Install ## Install
1. Logon to your pfSense box via SSH. 1. Copy the `bin/ng_etf.ko` kernel module to `/boot/kernel` on your pfSense box (because it isn't included):
1. Copy the `bin/ng_etf.ko` kernel module to `/boot/kernel` (because it isn't included with pfSense):
a) Use the pre-compiled kernel module from me, a random internet stranger: a) Use the pre-compiled kernel module from me, a random internet stranger:
``` ```
@ -39,10 +38,10 @@ If you don't have three NICs, you can buy this cheap USB NIC one [from Amazon](T
``` ```
1. Edit the following configuration variables in `bin/pfatt.sh` as noted below. `$RG_ETHER_ADDR` should match the MAC address of your Residential Gateway. AT&T will only grant a DHCP lease to the MAC they assigned your device. 1. Edit the following configuration variables in `bin/pfatt.sh` as noted below. `$RG_ETHER_ADDR` should match the MAC address of your Residential Gateway. AT&T will only grant a DHCP lease to the MAC they assigned your device.
``` ```shell
ONT_IF='em0' ONT_IF='em0' # NIC -> ONT
RG_IF='em1' RG_IF='em1' # NIC -> RG
RG_ETHER_ADDR='xx:xx:xx:xx:xx:xx' RG_ETHER_ADDR='xx:xx:xx:xx:xx:xx' # MAC address of Residential Gateway
``` ```
1. Copy `bin/pfatt.sh` to `/usr/local/etc/rc.d` to enable it to run at boot: 1. Copy `bin/pfatt.sh` to `/usr/local/etc/rc.d` to enable it to run at boot:
@ -96,13 +95,13 @@ If you don't see traffic being bridged between `ngeth0` and `$ONT_IF`, then netg
If the VLAN0 traffic is being properly handled, next pfSense will need to request an IP. `ngeth0` needs to DHCP using the authorized MAC address. You should see an untagged DCHP request on `ngeth0` carry over to the `$ONT_IF` interface gged as VLAN0. Then you If the VLAN0 traffic is being properly handled, next pfSense will need to request an IP. `ngeth0` needs to DHCP using the authorized MAC address. You should see an untagged DCHP request on `ngeth0` carry over to the `$ONT_IF` interface gged as VLAN0. Then you
should get a DHCP response and you're in business. should get a DHCP response and you're in business.
### netgraph ## netgraph
The netgraph system provides a uniform and modular system for the implementation of kernel objects which perform various networking functions. The netgraph system provides a uniform and modular system for the implementation of kernel objects which perform various networking functions.
Your netgraph should look something like this: Your netgraph should look something like this:
![netgraph](https://github.com/aus/pfatt/master/img/ngctl.png) ![netgraph](img/ngctl.png)
Try these commands to inspect whether netgraph is configured properly. Try these commands to inspect whether netgraph is configured properly.
@ -132,10 +131,6 @@ Alternatively, you can also do the EAP / VLAN0 magic at the Linux hypervisor lay
I haven't tried to do this with ESXi. Feel free to submit a PR with notes on your experience. I haven't tried to do this with ESXi. Feel free to submit a PR with notes on your experience.
# OPNSense / FreeBSD
I haven't tried this with OPNSense or native FreeBSD, but I imagine the process is the same with netgraph. Feel free to submit a PR with notes on your experience.
# Other Methods # Other Methods
## Linux ## Linux
@ -148,6 +143,10 @@ There is a whole thread on this at [DSLreports](http://www.dslreports.com/forum/
However, I don't think this works for everyone. I had to explicity tag my WAN traffic to VLAN0 which wasn't supported on my switch. However, I don't think this works for everyone. I had to explicity tag my WAN traffic to VLAN0 which wasn't supported on my switch.
## OPNSense / FreeBSD
I haven't tried this with OPNSense or native FreeBSD, but I imagine the process is the same with netgraph. Feel free to submit a PR with notes on your experience.
# U-verse TV # U-verse TV
TODO TODO

View file

@ -61,5 +61,9 @@ echo -n " enabling one2many links... "
/usr/sbin/ngctl msg o2m: setconfig "{ xmitAlg=2 failAlg=1 enabledLinks=[ 1 1 ] }" /usr/sbin/ngctl msg o2m: setconfig "{ xmitAlg=2 failAlg=1 enabledLinks=[ 1 1 ] }"
echo "OK!" echo "OK!"
echo -n " removing waneapfilter:nomatch hook... "
/usr/sbin/ngctl rmhook waneapfilter: nomatch
echo "OK!"
echo "ngeth0 should now be available to configure as your pfSense WAN" echo "ngeth0 should now be available to configure as your pfSense WAN"
echo "done!" echo "done!"