Home

EdgeOS User Guide

1. The Trace tool traces the hops from the EdgeRouter to a specified outgoing IP address Use this tool to find the route taken by ICMP packets across the network to the destination host Destination Host Resolve IP Address Run Test Destination Host Enter the IP address of the destination host Resolve IP Address Select this option to resolve the IP addresses symbolically as names instead of numerically Run Test Click this button to start the test Responses are displayed after the test is completed Discover The Discover tool searches for all Ubiquiti devices on your network The Search field automatically filters devices containing specified names or numbers as you enter them d 7 devices Displayed 7 devices Interface Hardware Address AirCam AirCam AirCamMini 00 27 22 76 F7 55 TSW PoE PRO DC 9F DB 12 91 DC UBNT M2M DC 9F DB 17 0D 67 ERLite 3 All eth Select which interface to search or select All The tool reports the number of Discovered and Displayed Ubiquiti devices A table displays the following information about each Ubiquiti device Click a column heading to sort by that heading Interface The EdgeRouter interface used by the device is displayed Hardware Address The MAC address of the device is displayed Device Name The name assigned to the device is displayed Product Name The Ubiquiti name of the device is displayed IP Address The IP address of the device is displaye
2. Address _ No address settings e Use DHCP Renew _ Use DHCP for IPv6 _ Manually define IP address es Speed Duplex Auto negotiation Proxy ARP LJ Make changes as needed Description Enter keywords to describe this interface e Enable Check the box to enable the interface All of the interfaces are saved in the system configuration file however only the enabled interfaces are active on the device Note If you disable a port its PoE functionality remains This applies only to the EdgeRouter PoE e Address Select one of the following No address settings The interface uses no address settings In most cases an address is needed Use DHCP The interface acquires network settings from a DHCPV4 server Click the Renew button to acquire fresh network settings Use DHCP Use DHCP for IPv6 The interface acquires network settings from a DHCPV6 server Manually define IP address es Enter the Static IP address example 792 0 2 1 24 for IPv4 or 2001 db8 1 32 for IPv6 Click Add IP to enter additional IP addresses Manually define IP address es Add IP e MTU Enter the MTU Maximum Transmission Unit value which is the maximum packet size in bytes that a network interface can transmit The default is 7500 EdgeOS User Guide Speed Duplex The default is Auto negotiation The EdgeRouter automatically negotiates transmission parameters such as speed and du
3. Save Complete the following e Name Enter a name for this group e Description Enter keywords to describe this group e Group Type Select the appropriate option Address Group Define a group by IP address Network Group Define a group by network address Port Group Define a group by port numbers Click Save to apply your changes Search Allows you to search for specific text Begin typing there is no need to press enter The results are filtered in real time as soon as you type two or more characters All Address Network Port Click the appropriate tab to filter the groups as needed All All groups are displayed by default Address All of the address groups are displayed e Network All of the network groups are displayed Port All of the port groups are displayed 24 EdgeOS User Guide A table displays the following information about each group Click a column heading to sort by that heading Name The name of the group is displayed Description The keywords you entered to describe the group are displayed Type The type of group is displayed Number of group members The number of members is displayed Actions Click the Actions button to access the following options e Config To configure the group click Config Go to the Configure the Firewall Group section below e Delete Remove the group Configure the Firewall Group After you click Config the Edit Firewall Group screen appears
4. ras UBIQUITI NETWORKS Fdge MAX Release Version 1 2 USER GUIDE Operating System for Ubiquiti EdgeRouters EdgeOS User Guide Table of Contents Table of Contents Chapter 1 Overview 0 cc ccc ccc cece cece eeeeeeeeeeeees 1 NATE OCUAC TOM anna d eata ew arigiest aan en anterentacee aa ererrariewantatadewnuseeiaes 1 Configuration Interface System Requirements cc cece cece eect ee eeeeeees 1 Hardware Overview and Installation 0 cc cece eee eee eee eee eeeeeeeees 1 Typical Deployment SCON ANOS gs ast areceun see cacuceseaaoanwree ten eeeeeeaedasaaees 1 Chapter 2 Using EdgeOS 0 ccc ccc cece ccc e eect eeeeees 3 Ports and Status Information cncceudcenecae deve mange neesaneeshenecedeyawanace 3 NAVIG GUO ccr25 eu eenet meee eeecdicat eee ceestaeeebetteeoasr age aseaesereesdeees 3 Common Interface Options ccc ccc cece cece eee eee eee e eee eeeeeeeeeeenes 4 Chapter 3 Dashboard Tab ccc cc cece cece eee e tence eeees 8 DOI VICES sco ccca ers ee beepers ne hi es aba eed eee nee erecta A eens E 8 WIRSLT ACES EEEE E EEN ETETE O EE EEE EE OET 3 9 Chapter 4 Routing Tab ccc ccc ccc cece een e ete eeees 14 IPVO ROUNO sucescccesctecdescasccuesncecucesuseescasaeecnasueesatecssueacacerses 14 POU aea a E E T E ceacaeeenanes 15 Oe ed Er EE A E E ee ee A EE er ere 17 Chapter 5 Security Tab ccc cece eee een e nee eeneees 20 Firewall POUCICS 4 casacpeacye eran
5. Note To enhance security we recommend that you change the default login using at least one of the following options e Set up a new user account preferred option For details go to Remove the Default User Account on page 43 e Change the default password of the ubnt login Use the set command as detailed in Remove the Default User Account on page 43 AN Ubiquiti Networks Inc Appendix A Command Line Interface CLI Modes Operational Mode When you first log in the CLI is in operational mode Press the key to view the available commands ubnt ubnt Note The question mark does not display onscreen add delete ping6 reset terminal clear disconnect reboot restart traceroute configure generate release set traceroute6 connect initial setup remove show undebug copy no rename shutdown debug ping renew telnet Enter show and press the key to view the settings that you have configured ubnt ubnt S show arp flow accounting nat tech support bridge hardware ntp ubnt configuration history openvpn users date host pppoe server version debugging incoming queueing vpn dhcp interfaces reboot vrrp dhepv6 ip route map webproxy disk ipv6 shutdown zebra dns lldp snmp file log system firewall login table For example type show interfaces to display the interfaces and their status information ubnt ubnt S show interfaces Codes S State L Link u Up D Down A Admin Dow
6. Remove the Default User Account on page 43 40 EdgeOS User Guide Access Using the EdgeOS Configuration Interface Each tab of the EdgeOS interface contains CLI access 1 At the top right of the screen click the CLI button 2 The CLI window appears At the login prompt enter the username the default is ubnt Welcome to EdgeOS By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms UBNT OC login ubnt 3 At the Password prompt enter the password the default is ubnt Welcome to EdgeOS By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms UBNT OC login ubnt Password 4 For help with commands you can either press the key or enter show and press the key Welcome to EdgeOS By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms UBNT OC login ubnt Password Linux ubnt 2 6 32 13 UBNT 1 SMP Wed Oct 24 01 08 06 PDT 2012 mips64 Welcome to EdgeOS ubnt UBNT OC
7. and the default route The EdgeRouter uses the route with the lowest administrative distance All Static Connected RIP OSPF Add Static Route To create a new Static route click Add Static Route The Create Static Route screen appears Create Pv4 Static Route Select Route Type Gateway p Destination network Next hop address Distance 1 255 Enable Complete the following e Select Route Type You have three options Gateway Interface or Black Hole Gateway Define a route using the IP address and subnet mask of the next hop gateway Create IPv4 Static Route Select Route Type Gateway Destination network Next hop address Distance 1 255 Enable e Destination network Enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 The first default route is configured on the System tab see System gateway address on page 5 for more information To create multiple default routes set up static routes and enter 0 0 0 0 0 e Next hop address Enter the IP address e Distance 1 255 Enter the administrative distance If there are identical routes from different sources such as static RIP or OSPF the EdgeRouter compares the routes and uses the route with the lowest distance e Enable Check the box to enable the route Click Save to apply your changes AN Ubiquiti Networks Inc Chapter 4 Routi
8. ubnt ubnt set protocol icmp edit firewall name TEST rule 10 To show changes within the edit level use the compare command ubnt ubnt compare edit firewall name TEST rule 10 taction accept description allow icmp protocol icmp edit firewall name TEST rule 10 To move up an edit level use the up command ubnt ubnt up edit firewall name TEST ubnt ubnt compare edit firewall name TEST default action drop enable default log rule 10 action accept description allow icmp protocol icmp edit firewall name TEST ubnt ubnt up edit firewall ubnt ubnt compare edit firewall name TEST default action drop enable default log rule 10 action accept description allow icmp protocol icmp ji TJ edit firewall AN Ubiquiti Networks Inc Appendix A Command Line Interface To return to the top edit level use the top command ubnt ubnt top edit ubnt ubnt compare edit firewall name TEST edit default action drop enable default log rule 10 i action accept description allow icmp protocol icmp To display the existing firewall rule use the show firewall command ubnt ubnt show firewall name WAN1 LOCAL default action drop edit rule 10 rule 20 rule 30 action accept state established enable related enable I action drop state invalid
9. AND NOT I agree to the terms of this License Agreement Login The EdgeOS Configuration Interface will appear allowing you to customize your settings as needed A Ubiquiti Networks Inc Chapter 2 Using EdgeOS Note To enhance security we recommend that you change the default login using one of the following e Set up anew user account on the Users gt Local tab preferred option For details go to Add User on page 34 e Change the default password of the ubnt login on the Users gt Local tab For details go to Configure the User on page 35 Ports and Status Information The Ports image displays the active connections An amber port indicates 10 100 Mbps and a green port indicates 1000 Mbps The Status bar graphs display the following CPU The percentage of processing power that the EdgeRouter is using is displayed RAM The percentage of RAM that the EdgeRouter is using is displayed Uptime The duration of the EdgeRouter s activity is displayed 1 month 1 week 3 hours Place your mouse over a port to view the following Enabled Disabled The administrative status is displayed Link The connection status is displayed Speed The speed in Mbps and duplex mode are displayed Port eth1 Enabled Link up Speed 1000 full Navigation The EdgeOS software consists of five primary tabs and some of these tabs have sub tabs This User Guide covers each tab with a chapter For details o
10. Dest Addr The destination IP address is displayed Dest Port The destination port number is displayed Translation A description of the translation such as masquerade to eth_ is displayed Count The number of translations is displayed Actions Click the Actions button to access the following options e Config To configure the rule click Config Go to the Add or Configure a Source NAT Rule section below e Copy To create a duplicate click Copy The duplicate rule appears at the bottom of the list e Delete Remove the rule Add or Configure a Source NAT Rule After you click Config the Source NAT Rule Configuration screen appears Source NAT Rule Configuration Description Enable A Outbound Interface Translation _ Use Masquerade _ Specify address and or port Exclude from NAT _ Enable Logging a Protocol _ All protocols Both TCP and UDP _ Choose a protocol by name Enter a protocol number Src Address Src Port Dest Address Dest Port A Ubiquiti Networks Inc Chapter 5 Security Tab e Description Enter keywords to describe this rule e Enable Check the box to enable this rule e Outbound Interface Select the interface through which the outgoing packets exit the EdgeRouter This is required only for Source NAT Rules that use Masquerade e Translation Select one of the following Use Masquerade Masquerade is a type of Source NAT If enabled the so
11. Ethernet server so a remote PPPoE client can establish a tunnel to the EdgeRouter for network access PPPoE Server Fide MAX Welcome ubnt v to ubnt DHCP Server DNS PPPoE Server Client IP pool range start 172 16 100 100 Client IP pool range stop 172 16 100 200 RADIUS server IP address 1 4 44 RADIUS server key secret radius MTU 1492 DNS 1 10 1 0 1 DNS 2 10 1 0 2 Interface etho Add Listen Interface Client IP pool range start The client IP pool is the pool of IP addresses that remote PPPoE clients will use Enter the starting IP address of the range this address must in a 24 subnet Client IP pool range stop Enter the last IP address of the range RADIUS server IP address The RADIUS Remote Access Dial In User Service server provides authentication to help secure PPPoE connections Enter the IP address of the RADIUS server RADIUS server key Enter the key shared with the RADIUS server MTU Enter the MTU for the PPPoE connection DNS 1 Enter the IP address of the primary remote access DNS server that your PPPoE client will use DNS 2 Enter the IP address of the secondary remote access DNS server Interface Select the appropriate interface that the EdgeRouter will listen to so it can forward PPPoE requests Add Listen Interface You can select multiple interfaces To add another interface for PPPoE connections click Add Listen Interface From the new Interface drop down menu select the ap
12. Parent The interface belonging to this VLAN is displayed e Description Enter keywords to describe this interface e Enable Check the box to enable the VLAN All of the VLANs are saved in the system configuration file however only the enabled VLANs are active on the device AN Ubiquiti Networks Inc Chapter 3 Dashboard Tab Address Select one of the following No address settings The interface uses no address settings In most cases an address is needed Use DHCP The interface acquires network settings from a DHCPV4 server Click the Renew button to acquire fresh network settings Use DHCP Use DHCP for IPv6 The interface acquires network settings from a DHCPV6 server Manually define IP address es Enter the Static IP address example 792 0 2 1 24 for IPv4 or 2001 db8 1 32 for IPv6 Click Add IP to enter additional IP addresses Manually define IP address es Add IP MTU Enter the MTU Maximum Transmission Unit value which is the maximum packet size in bytes that a network interface can transmit The default is 7500 Proxy ARP Enable the EdgeRouter to answer a source host s ARP Address Resolution Protocol requests for the IP address of a destination host that is not located on the source host s network ARP allows hosts on the same network to discover each other s IP address via a layer 2 broadcast to all MAC addresses If they are not on the same network the layer 2 broadcas
13. RTR edit ubnt RTR commit Archiving config tftp 10 1 0 15 RTR OK edit On the remote tftp server a copy with the hostname and date is saved for each commit admin2 server tftpboot RTRS 1s 1 total 8 rw 1 nobody nogroup 908 Aug 17 17 19 config boot RTR 20120817 171932 rw 1 nobody nogroup 874 Aug 17 17 20 config boot RTR 20120818 002046 You can also keep a specified number of revisions of the configuration file on the local disk Use the commit revisions configuration option ubnt RTR set system config management commit revisions 50 edit ubnt RTR commit edit Here is an example that uses the commit revisions command ubnt RTR set system login user joe authentication plaintext password secret edit ubnt RTR commit edit ubnt RTR save exit Saving configuration to config config boot Done exit ubnt RTR S show system commit 2012 08 17 18 32 13 by ubnt via cli commit 2012 08 17 18 31 52 by ubnt via cli commit 2012 08 17 18 31 51 by root via init commit 46 EdgeOS User Guide Note The following commands require that the configuration option commit revisions be set first show system commit diff commit confirm show system commit file confirm show system commit rollback commit comment For details on the commit revisions option go to 4 Manage the Configuration File on page 46 To display the changes in revision 0 use the
14. Tab Actions Click the Actions button to access the following options e Config To configure the OSPF Interface click Config Go to the Configure the OSPF Interface section e Delete Delete the OSPF Interface Configure the OSPF Interface After you click Config the OSPF Interface Configuration screen appears OSPF Interface Configuration Interface vtunt Auth Type Off Auth Key Cost Make changes as needed e Interface The name of the interface is displayed e Auth Type Authentication helps secure communication between routers Select the appropriate option Off No authentication is used MD5 sec Each router uses a key password and key ID This is the most secure option because the key is never transmitted Plain text Each router uses a key This provides minimal security because the key is transmitted in plain text format e Auth Key Enter the key used for authentication e Cost By default the cost of an interface is based on its bandwidth however you can manually assign a cost to the interface Click Save to apply your changes EdgeOS User Guide FogeMAX Welcomeubnt v Firewall Policies Add Ruleset Name a Interfaces LAN_LOCAL eth1 local LOCAL WAN_IN WAN_OUT Showing 1 to 4 of 4 entries Chapter 5 Security Tab The Security tab displays status information about firewall policies firewall groups Network Address Translation rules and PPTP VPN options You can a
15. VLAN acquires network settings from a DHCPV4 server Use DHCP for IPv6 The VLAN acquires network settings from a DHCPV6 server Manually define IP address es Enter the static IP address example 792 0 2 1 24 for IPv4 or 2001 db8 1 32 for IPv6 Click Add IP to enter additional IP addresses Manually define IP address es Add IP Click Save to apply your changes or click Cancel Search Allows you to search for specific text Begin typing there is no need to press enter The results are filtered in real time as soon as you type two or more characters All Ethernet VLAN Click the appropriate tab to filter the interfaces as needed All All interfaces are displayed by default Ethernet All of the Ethernet interfaces are displayed e VLAN All VLANs are displayed EdgeOS User Guide A table displays the following information about each interface Click a column heading to sort by that heading Description The keywords you entered to describe the interface are displayed Interface The name of the interface is displayed Note A switch interface is created by default EdgeRouter PoE only however there are no switched ports by default To configure ports for the switch interface click Actions gt Config and go to Configure the Switch on page 12 Type The type of interface is displayed PoE Available for the EdgeRouter PoE only The status off or voltage 24v 48v of the PoE feat
16. address of the destination e Port Enter the port number of the destination AN Ubiquiti Networks Inc Chapter 5 Security Tab Address Group Network Group Port Group Firewall groups are created on the Firewall Groups tab see Firewall Groups on page 24 for more information Select the appropriate group s you can specify up to two groups maximum in these combinations e An address group and port group e A network group and port group The packets must match both groups to apply the rule Click Save to apply your changes or click Cancel Time Add New Rule Basic Advanced Month Days Match all month days except for these Week Days _ Match all week days except for these Start Date Start Time Stop Date Stop Time _ Interpret dates and times as UTC Month Days Enter the days of the month when the rule should be applied Enter numbers in the range 1 to 31 If you enter more than one day use commas to separate the numbers example 3 4 5 Match all month days except for these Match all days of the month except for the selected days Week Days Enter the days of the week when the rule should be applied Enter Sun Mon Tue Wed Thu Fri or Sat If you enter more than one day use commas to separate the days example Mon Tue Wed Match all week days except for these Match all days of the week except for the selected days Start Date Enter the date the rule should start bein
17. apply your changes Interfaces You can configure interfaces with specific OSPF options Interfaces Add OSPF Interface Interface a s Actions vtun1 Actions v vtun2 Actions v vtun3 Actions v Add OSPF Interface To create a new interface click Add OSPF Interface The OSPF Interface Configuration screen appears OSPF Interface Configuration Interface select Auth Type Off gt Auth Key Complete the following Interface Select the appropriate interface from the drop down list Auth Type OSPF authentication helps secure communication between routers Select the appropriate option Off No authentication is used MD5 sec Each router uses a key password and key ID This is the most secure option because the key is never transmitted Plain text Each router uses a key This provides minimal security because the key is transmitted in plain text format e Auth Key Enter the key used for authentication e Cost By default the cost of an interface is based on its bandwidth however you can manually assign a cost to the interface Click Save to apply your changes A table displays the following information about each OSPF Interface Click a column heading to sort by that heading Interface The name of the interface is displayed Cost The cost of the interface is displayed OSPF uses cost as a metric to determine the best route AN Ubiquiti Networks Inc Chapter 4 Routing
18. heading is a EBGP ences Border Gateway Protocol convenient link to the appropriate tab IBGP Interior Border Gateway Protocol The number of each route type and the total number of routes are displayed Click Routes to display the Routing gt Routes tab Go to Routes on page 15 for more information OSPF The OSPF status settings and number of areas are displayed Click OSPF to display the Routing gt OSPF tab Go to OSPF on page 17 for more information NAT The NAT Network Address Translation status and number of NAT rules are displayed Click NAT to display the Security gt NAT tab Go to NAT on page 25 for more information vooe9oe7ow ww Firewall The firewall status and numbers of sets and rules are displayed Click Firewall to display the Security gt Firewall Policies tab Go to Firewall Policies on page 20 for more information AN Ubiquiti Networks Inc 8 EdgeOS User Guide DHCP The DHCP server status and numbers of active and inactive servers are displayed Click DHCP to display the Services tab Go to DHCP Server on page 29 for more information Interfaces Distribution Click Hide Distribution to hide the nterfaces gt Distribution section Click the remaining open close tab to display the Interfaces gt Distribution section again Open Close Tab The RX Rate and TX Rate graph displays the current data traffic in both graphical and numerical
19. is displayed TX bytes The number of bytes transmitted is displayed RX packets The number of packets received is displayed RX bytes The number of bytes received is displayed 35 EdgeOS User Guide FogeMAX Welcomeubnt v to ubnt S Gc O Bi g ke Ey ix E tw admin Showing 1 to 7 of 7 entries Chapter 8 Toolbox Each tab of the EdgeOS interface contains network administration and monitoring tools At the top right of the screen click the Toolbox button The Toolbox drop down menu appears v Ping Trace P Discover Packet Capture B Log Monitor The following tools are available e Ping e Trace e Discover e Packet Capture e Log Monitor AN Ubiquiti Networks Inc Chapter 8 Toolbox P CLI Toolbox v lt Date Connected November 8 2012 November 12 2012 00h 24m 19s Ping You can ping other devices on the network directly from the EdgeRouter The Ping tool uses ICMP packets to check the preliminary link quality and packet latency estimation between two network devices Destination Hostv IP Packet Count Packet Size Destination Host IP Enter the IP address Packet Count Enter the number of packets to send for the ping test Packet Size Specify the size of the packet Run Test Click this button to start the test Packet loss statistics and latency time evaluation are displayed after the test is completed 36 EdgeOS User Guide Trace
20. mapping End 10 1 1 252 Status Enabled 488 345 143 id MAC Address Enter the MAC address of the DHCP client Create New Mapping a ae nT IP Address Enter the IP address that should be 00 1b 21 be 59 92 10 1 1 148 a ssig n ed 00 26 2d d1 31 29 10 1 0 250 cluster dToughSwitch device_primary device_staging P gateway printer Showing 1 to 37 of 37 entries 00 13 04 10 B1 51 00 27 22 76 C8 4F 00 26 9e 2b ba bb 00 26 9e 2b bb f9 00 26 9e 2b ba bd 1a 20 30 40 50 f0 00 1b 21 79 6f dO 00 30 18 a5 a2 9b 30 46 9a f9 77 2e 00 08 9b c8 50 5b 08 00 27 7a 55 3e 00 1D 73 19 2E 3F 00 24 A5 25 A1 7E 84 2b 2b 96 91 bd 00 26 9e 7f 6e 8a 00 90 8f 33 bb 02 00 C0 02 0D 75 0C 10 1 1 244 10 1 1 251 10 1 0 101 10 1 0 102 10 1 0 111 10 1 1 31 10 1 1 165 10 1 0 18 10 1 0 37 10 1 1 217 10 1 0 106 10 1 0 253 10 1 1 253 10 1 0 245 10 1 0 241 10 1 0 11 10 1 1 110 The top section displays the following status information e Pool Size The total number of IP addresses is displayed e Leased The number of used IP addresses is displayed e Available The number of available IP addresses is displayed e Subnet The IP address and subnet mask of the DHCP server are displayed in slash notation AN Ubiquiti Networks Inc Click Save to apply your changes Search Allows you to search for specific text Begin typing there is no need to press enter The resul
21. section displays the following status information e Pool Size The total number of IP addresses is displayed e Leased The number of used IP addresses is displayed e Available The number of available IP addresses is displayed e Subnet The IP address and subnet mask of the DHCP server are displayed in slash notation e Range Start The starting IP address of the range is displayed e Range End The last IP address of the range is displayed e Router The default route of the DHCP clients is displayed The DHCP clients route all packets to this IP address which is the EdgeRouter s own IP address in most cases e DNS The IP address of the DNS server is displayed e Status The Enabled Disabled status of the DHCP server is displayed The rest of the Details tab displays the following DHCP Name The name of the DHCP server is displayed e Subnet The IP address and subnet mask of the DHCP server are displayed in slash notation A Ubiquiti Networks Inc Chapter 6 Services Tab Make changes as needed to the following options e Range Start Enter the starting IP address of the range e Range Stop Enter the last IP address of the range e Router Enter the default route of the DHCP clients The DHCP clients route all packets to this IP address which is the EdgeRouter s own IP address in most cases e DNS 1 Enter the IP address of the primary DNS server Your ISP may provide this information or you can use Google
22. that facilitates the exchange of management information between network devices Network administrators use SNMP to monitor network attached devices for issues that warrant attention The EdgeRouter contains an SNMP agent which does the following e Provides an interface for device monitoring using SNMP e Communicates with SNMP management applications for network provisioning e Allows network administrators to monitor network performance and troubleshoot network problems AN Ubiquiti Networks Inc Chapter 2 Using EdgeOS For the purpose of equipment identification configure the SNMP agent with contact and location information SNMP Agent Enable SNMP community Contact Location Enable Disabled by default This option activates the SNMP agent SNMP community Specify the SNMP community string It is required to authenticate access to MIB Management Information Base objects and functions as an embedded password The device supports a read only community string authorized management stations have read access to all the objects in the MIB except the community strings but do not have write access The device supports SNMP v1 The default is public Contact Specify the contact who should be notified in case of emergency Location Specify the physical location of the EdgeRouter Click Save to apply your changes Configuration Management amp Device Maintenance The controls in this section mana
23. 0 1 0 30 10 1 0 31 10 1 0 32 10 1 0 33 10 1 0 34 10 1 0 35 10 1 0 38 10 1 0 39 10 1 0 41 10 1 0 42 10 1 0 43 10 1 0 44 10 1 0 45 10 1 0 46 10 1 0 47 10 1 0 49 Hardware Address 00 26 f2 ee 9f 28 fO cb a1 2c be 29 00 27 22 60 06 e9 88 53 2e 78 e4 0c 00 27 22 ca e1 e9 88 9f fa 2d b8 ec de 9f db 2a 01 52 8c 70 5a 36 0b cO 00 0c 29 32 91 86 60 c5 47 69 03 9d b8 17 2 04 53 b7 e0 b9 ba 3d be 95 8 2a 14 3e 40 db 00 27 22 61 e0 d7 fO de f1 ba 52 e7 d0 23 db 9e fd 27 00 27 22 60 0a 8b 90 27 4 f6 4d c1 fO bf 97 e0 96 5b Lease Expiration gt 2012 08 28 21 22 34 2012 08 28 21 08 19 2012 08 28 21 05 56 2012 08 28 21 19 09 2012 08 28 21 23 14 2012 08 28 21 23 55 2012 08 28 21 04 58 2012 08 28 21 15 21 2012 08 28 21 29 06 2012 08 28 21 29 52 2012 08 28 21 06 12 2012 08 28 20 59 44 2012 08 28 21 33 06 2012 08 28 21 30 57 2012 08 28 21 12 56 2012 08 28 19 52 42 2012 08 28 21 24 17 2012 08 28 21 16 52 2012 08 28 20 47 50 Pool Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal Internal G SPhone AV J M Support ubnt mFi UniFi ubuntu bPhone m JPhone e View Details To configure the DHCP server click View Details Go to Details on page 32 Showing 1 to 34
24. 24 by ubnt via cli add dmz interface to eth2 7 2012 08 21 14 19 53 by ubnt via cli add ipsec tunnel to office exchange 8 2012 08 21 14 07 18 by ubnt via cli add firewall for WAN_IN 9 2012 08 21 14 06 37 by ubnt via cli add user first last 10 2012 08 21 14 04 47 by ubnt via cli commit 11 2012 08 21 14 04 46 by root via init commit After viewing the history of system commits you decide to discard the last four commits by admin_5 Roll back the system configuration file to commit 4 ubnt RTR rollback 4 Proceed with reboot confirm y Broadcast message from root RTR ttyS0O Mon Aug 21 15 09 12 2012 The system is going down for reboot NOW 47 EdgeOS User Guide Appendix B Contact Information Ubiquiti Networks Support Ubiquiti Support Engineers are located around the world and are dedicated to helping customers resolve software hardware compatibility or field issues as quickly as possible We strive to respond to support inquiries within a 24 hour period Online Resources Support support ubnt com Community community ubnt com Downloads downloads ubnt com UBIQUITI NETWORKS 2580 Orchard Parkway San Jose CA 95131 www ubnt com 2012 2013 Ubiquiti Networks Inc All rights reserved EdgeMAX EdgeOS EdgeRouter and Ubiquiti Networks are trademarks of Ubiquiti Networks Inc AN Ubiquiti Networks Inc Appendix B Contact Information JLO70813 48
25. 5 of 345 entries e Delete Delete the DHCP server its configuration will be removed The top section displays the following status information e Disable Disable the DHCP server while keeping its e Pool Size The total number of IP addresses is displayed configuration The DHCP server assigns IP address from the pool or group of IP addresses e Leased The number of used IP addresses is displayed Available The number of available IP addresses is displayed e Subnet The IP address and subnet mask of the DHCP server are displayed in slash notation e Range Start The starting IP address of the range is displayed e Range End The last IP address of the range is displayed e Router The default route of the DHCP clients is displayed The DHCP clients route all packets to this IP address which is the EdgeRouter s own IP address in most cases e DNS The IP address of the DNS server is displayed e Status The Enabled Disabled status of the DHCP server is displayed e Search Allows you to search for specific text Begin typing there is no need to press enter The results are filtered in real time as soon as you type two or more characters AN Ubiquiti Networks Inc 30 EdgeOS User Guide A table displays the following information about each DHCP client Click a column heading to sort by that heading Chapter 6 Services Tab Range Start The starting IP address of the range is displayed Range End The last IP a
26. AATTEENA meena ees EAA anya 20 Firewall GrOUpS niu wasae aed is wwttaocenideaduendaeaeutunaiWwecmetubiausentad eeetued 24 PPI oe cae pacer ccavdvgr dee wav ore are Grae Sara mater ow a ey ae aerk ae ace E E E ha gacae ciate E 25 WPM ica ou suea et wi cals Sacer E E EEEE EAEE was oe eee tartan e a Gn ea AE E 28 Chapter 6 Services Tab cc ccc ccc ccc cece eee eee e tee eeees 29 Ba Ee oa aes ce a ee ee ee ee wee eee sees 29 ING rep oe bee ea pain o phe eas Fay ae ee ERES EREA 32 PPPOE ee ee ee ee ee 33 Chapter 7 Users Tab ccc ccc ccc ccc cece eee e nee eeeees 34 LQG alis as cng E E ava ecee deans poder ences swueesws ceees wees den edmanes 34 ROMTE eee eee ee ree ee eee Te ee re errr TT rere eer eT 35 Chapter 8 Toolbox aan ee ee ee re 36 PP UUM agp ewan 2 ere arene re ae arare eve re ascent eee Gone poe near Re ees cole Gureie eee aes ware eure es 36 PiE a EEE E be eae ne eee EE A lawless vee se oe eeeweneet ae A 37 DISCOV T T E E E TE E T E E E E T 37 Packet Cap tle anne ne caee steed ae conden deena sedeeeedcntes ent aneneess cenenaees 37 LOG MONTO ee ea E E E E E E E E 38 A Ubiquiti Networks Inc i EdgeOS User Guide Table of Contents Appendix A Command Line Interface 0 ccc cece eee eee 39 OVOCIVIOW TE E EE T E E EE E Shee wee E E E T 39 Access the CLl usnunnnnsnnnnenesenrsenrsserseorseersorresereosreseeseseseee gt 39 IER Siac noon E A E EEEE EEE E E E EEE O ET 41 Appendix B Contact Inf
27. Count Specify the number of ICMP echo response replies If the specified number of ICMP echo response packets is not received continuously Ping Watchdog will reboot the device The default value is 3 Cut power for Specify the number of seconds this port should pause PoE if applicable A WARNING Cutting power during a firmware upgrade can damage your device Ensure that you specify a safe Ping Interval Click Save to apply your changes or click Cancel AN Ubiquiti Networks Inc 13 EdgeOS User Guide FdgeMAX Welomeubnt v to ubnt S OSPF Destination a Next Hop 0 0 0 0 0 2030 113 177 1 1 1 0 24 10 1 0 38 10 0 1 0 24 10 1 200 6 10 1 0 0 23 10 1 0 0 23 10 1 2 0 24 10 1 254 2 10 1 3 0 24 10 1 254 3 10 1 5 0 24 10 1 5 0 24 10 1 6 0 24 10 1 6 0 24 10 1 200 2 32 10 1 200 2 32 10 1 200 4 32 10 1 200 4 32 10 1 200 5 32 10 1 200 6 32 10 1 200 6 32 10 1 200 7 32 10 1 200 8 32 10 1 200 8 32 10 1 254 0 24 10 1 254 0 24 10 2 0 0 24 Chapter 4 Routing Tab The Routing tab displays status information about a variety of connected static RIP and OSPF routes You can also configure static routes and OSPF options Any setting marked with a blue asterisk is required You have two sub tabs Routes View route information and create static routes OSPF Configure OSPF options IPv6 Routing IPv6 Internet Protocol version 6 is gaining popularity and is bound to grow as IP addressing demands in
28. Direction Select the direction of the traffic flow in Match inbound packets out Match outbound packets local Match local packets e Add Interface Click Add Interface to enter more interfaces Click Save Ruleset to apply your changes Stats Ruleset Configuration for LAN_IN Interfaces Stats Packets Action Description gt 0 0 DROP Drop rogue 174470481994 ACCEPT DEFAULT ACTION A table displays the following statistics about each rule Click a column heading to sort by that heading Rule The rules are applied in the order specified The number of the rule in this order is displayed Packets The number of packets that triggered this rule is displayed AN Ubiquiti Networks Inc Chapter 5 Security Tab Bytes The number of bytes that triggered this rule is displayed Action The action specified by this rule is displayed Description The keywords you entered to describe this rule are displayed Firewall Groups Create groups organized by IP address network address or port number FdgeMAX mers mes Miers nasers v Mees v moes v Msos Mosoes moes moses Masses mees mees v Masos Msas moes moses Moes Moes v All Address Network Port Add Group To create a new group click Add Group The Create New Group screen appears Create New Group Name Description Group Type _ Address Group C Network Group _ Port Group
29. Follow the instructions for your group type e Address Group Make changes as needed Edit Firewall Group Name Description Address 10 1 1 244 Add New Name The name of this group is displayed Description Enter keywords to describe this group Address Enter the IP address or range of addresses examples 192 0 2 1 or 192 0 2 1 15 Click Add New to enter more IP addresses Click Save to apply your changes e Network Group Make changes as needed Edit Firewall Group Name UBNT LAN Description Ubiquiti LAN Network 10 0 1 0 24 Add New Name The name of this group is displayed Description Enter keywords to describe this group AN Ubiquiti Networks Inc Chapter 5 Security Tab Network Enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 Click Add New to enter more network addresses Click Save to apply your changes e Port Group Make changes as needed Edit Firewall Group Name Web Server 1 Description website mirror Asia Port 22 23 Name The name of this group is displayed Description Enter keywords to describe this group Port Enter the port name number or range Click Add New to enter more ports Click Save to apply your changes NAT NAT changes the addressing of packets A NAT rule tells the EdgeRouter what action to take with a specific packet Define the followi
30. Name Server System name server System name server Enter the IP address of your DNS server example 192 0 2 1 for IPv4 or 2001 db8 1 for IPv6 Click Add New to add additional servers AN Ubiquiti Networks Inc Chapter 2 Using EdgeOS Domain Name Domain Name System domain name System domain name Enter the domain name of your EdgeRouter The domain name identifies the EdgeRouter s network on the Internet For example a com URL typically uses this format host_name lt domain_name gt com NTP NTP is a protocol for synchronizing the clocks of computer systems over packet switched variable latency data networks You can use it to set the system time on the EdgeRouter If the System Log option is enabled then the system time is reported next to every log entry that registers a system event NTP Automatically update system E time using NTP Automatically update system time using NTP By default the EdgeRouter obtains the system time from a time server on the Internet Click Save to apply your changes Management Settings SSH Server Management Settings SSH Server Enable v Port 22 Enable Enabled by default This option allows SSH Secure Shell access to the EdgeRouter for remote configuration by command line SSH uses encryption and authentication so it is a secure form of communication See Command Line Interface on page 39 for more information Port Specify the TCP I
31. P port of the SSH server The default is 22 EdgeOS User Guide Telnet Server Telnet Server Enable Port Enable Disabled by default This option allows Telnet access to the EdgeRouter for remote configuration by command line Telnet is not a secure form of communication so we recommend SSH See Command Line Interface on page 39 for more information Port Specify the TCP IP port of the Telnet server The default is 23 System Log Every logged message contains at least a system time and host name Usually a specific service name that generates the system event is also specified within the message Messages from different services have different contexts and different levels of detail Usually error warning or informational system service messages are reported however more detailed debug level messages can also be reported The more detailed the system messages reported the greater the volume of log messages generated System Log Log to remote server Log to remote server This option allows the EdgeRouter to send system log messages to a remote server Enter the remote host IP address and TCP IP port that should receive the system log syslog messages 574 is the default port for the commonly used system message logging utilities Note Properly configure the remote host to receive syslog protocol messages SNMP Agent Simple Network Monitor Protocol SNMP is an application layer protocol
32. Router connects an OSPF area to a network using a different routing protocol and redistributes the other protocol s static routes into the OSPF area These routes become external OSPF routes Metric If there are multiple routes to the same destination OSPF uses the metric to select a route for the routing table Assign a cost value to the redistributed static routes The EdgeRouter can then use this metric to compare these routes to other OSPF routes Announce default route If enabled the EdgeRouter communicates the default route to the other routers of the OSPF network eliminating the need to configure the default route on the other routers The default route connects the OSPF network to an outside network 17 EdgeOS User Guide Areas To enhance scalability an OSPF network is comprised of smaller sections called areas At the minimum there is the backbone area called Area 0 Add Area To create a new area click Add Area The Create OSPF Area screen appears Create OSPF Area Area ID Area Type Normal sec Auth Type Off Network Complete the following e Area ID This is the number that identifies an area It can be an integer or use a format similar to an IPv4 address e Area Type This defines the routes that are acceptable inside the area Select the appropriate option Normal sec The default type accepts all routes NSSA ANSSA Not So Stubby Area network is a variation
33. WAN_IN rule 50 destination address 172 16 0 0 16 edit ubnt RTR commit confirm commit confirm will be automatically reboot in 10 minutes unless confirmed Proceed confirm y edit AN Ubiquiti Networks Inc Appendix A Command Line Interface After you verify that the changes should be saved use the confirm command ubnt RTR confirm edit You can also specify the number of minutes to wait but you must remember to also use the confirm command Otherwise if you forget then you can be surprised by the EdgeRouter s reboot to its previous configuration ubnt RTR commit confirm 1 commit confirm will be automatically reboot in 1 minutes unless confirmed Proceed confirm y edit ubnt RTR Broadcast message from root RTR Mon Aug 20 14 00 06 2012 The system is going down for reboot NOW INIT Switching to runlevel 6 INIT Stopping routing services zebra done Removing all Quagga Routes SNIP To roll back to an earlier commit use the show system commit and rollback commands ubnt RTR show system commit 0 2012 08 21 14 46 41 by admin 5 via cli fix bgp policy maps 7 1 2012 08 21 14 45 59 by admin 5 via cli commit 7 2 2012 08 21 14 45 33 by admin_5 via cli fix port forwarding 3 2012 08 21 14 45 15 by admin_5 via cli fix firewall 4 2012 08 21 14 44 29 by ubnt via cli commit 5 2012 08 21 14 21 15 by ubnt via cli add port forward for port 2222 to build server 6 2012 08 21 14 20
34. a working IPsec tunnel configuration ubnt RTR save config boot ipsec Saving configuration to config config boot ipsec Done edit Note This is a backup if the EdgeRouter were rebooted it would still boot from the default file contig contig boot 2 After the administrator deleted the IPsec configuration and was configuring of the OpenVPN tunnel circumstances changed so that the IPsec tunnel was required again Consequently the administrator reverted the EdgeRouter to its previous configuration with the IPsec tunnel ubnt RTR load config boot ipsec Loading configuration from config config boot ipsec Load complete Use commit to make changes active edit ubnt RTR commit edit ubnt RTR save exit Saving configuration to config config boot Done exit ubnt RTR AN Ubiquiti Networks Inc Appendix A Command Line Interface To automatically make a remote backup after every commit use the commit archive configuration option enter location and press the key ubnt RTR set system config management commit archive location Possible completions lt url gt Uniform Resource Identifier Detailed information scp lt user gt lt passwd gt lt host gt lt dir gt ftp lt user gt lt passwd gt lt host gt lt dir gt tftp lt host gt lt dir gt ubnt RTR set system config management commit archive location tftp 10 1 0 15
35. able default log edit ubnt ubnt set firewall name TEST rule 10 description allow icmp edit ubnt ubnt set firewall name TEST rule 10 action accept edit ubnt ubnt set firewall name TEST rule 10 protocol icmp edit To display uncommitted changes use the compare command ubnt ubnt compare edit firewall name TEST default action drop enable default log rule 10 action accept description allow icmp protocol icmp T EJ edit To undo uncommitted changes use the discard command ubnt ubnt discard Changes have been discarded edit ubnt ubnt compare No changes between working and active configurations edit To create the same firewall rule while reducing the amount of repetition in the full syntax use the edit command ubnt ubnt edit firewall name TEST edit firewall name TEST ubnt ubnt set default action drop edit firewall name TEST ubnt ubnt set enable default log edit firewall name TEST ubnt ubnt edit rule 10 edit firewall name TEST rule 10 43 EdgeOS User Guide Press the or tab key to display options for the specified edit level ubnt ubnt set action disable ipsec p2p source time description fragment limit protocol state destination icmp log recent tcp edit firewall name TEST rule 10 ubnt ubnt set description allow icmp edit firewall name TEST rule 10 ubnt ubnt set action accept edit firewall name TEST rule 10
36. ault is ubnt Last login Wed Oct 3 11 28 35 on ttys000 MacBook Pro ee telnet 192 168 1 1 Trying 192 168 1 1 Connected to 192 168 1 1 Escape character is Welcome to Edge0S By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms UBNT OC login ubnt Password For help with commands you can either press the key or enter show and press the key Last login Wed Oct 3 11 28 35 on ttys000 MacBook Pro ee telnet 192 168 1 1 Escape character is Welcome to Edge0S By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms UBNT OC login ubnt Password Last login Wed Oct 3 18 26 59 UTC 2012 from 192 168 25 110 on pts 0 Linux ubnt 2 6 32 13 UBNT 1 SMP Thu Sep 13 13 26 16 PDT 2012 mips64 Welcome to Edge0S ubnt UBNT 0C I Note To enhance security we recommend that you change the default login using at least one of the following options e Set up a new user account preferred option For details go to Remove the Default User Account on page 43 e Change the default password of the ubnt login Use the set command as detailed in
37. ble rule 30 action accept destination port 22 protocol tcp name WAN2 IN default action drop rule 10 action accept state established enable related enable rule 20 action drop state invalid enable l rule 30 action accept destination port 22 protocol tcp edit ubnt ubnt 45 EdgeOS User Guide Manage the Configuration File Typically you use the save command to save the active configuration to disk config config boot however you can also save the active configuration to a different file or remote server Enter save and press the key ubnt RTR save Possible completions lt Enter gt Save to system config file lt file gt Save to file on local machine scp lt user gt lt passwd gt lt host gt lt file gt Save to file on remote machine ftp lt user gt lt passwd gt lt host gt lt file gt Save to file on remote machine Save to file on remote machine tfitp lt host gt lt file gt edit ubnt RTR save tftp 10 1 0 15 rtr config boot Saving configuration to tftp 10 1 0 15rtr config boot AAAA E AT T E A AAAA 100 08 Done edit Scenario In the midst of the administrator changing an IPsec tunnel into an OpenVPN tunnel the administrator had to revert the EdgeRouter to its previous configuration with the IPsec tunnel 1 Before making changes the administrator saved a backup configuration file with
38. c text Begin typing there is no need to press enter The results are filtered in real time as soon as you type two or more characters A table displays the following information about each user Click a column heading to sort by that heading Username The account name of the user is displayed Name The actual name of the user is displayed Level The permission level of the user is displayed Active Sessions The number of times the user has accessed the EdgeRouter is displayed Date Connected The date of the user s most recent access is displayed Uptime The duration of the user s access is displayed Status The status of the user is displayed 34 EdgeOS User Guide Actions Click the Actions button to access the following options e Config To configure the user click Config Go to the Configure the User section below e Delete Delete the user account its configuration will be removed Configure the User After you click Config the Username screen appears Make changes as needed Username admin Full Name Role Admin Password weREEKEK Change Password e Username The unique account name is displayed Full Name Enter the actual name of the user e Role Select the appropriate permission level Admin The user can make changes to the EdgeRouter configuration Operator The user can view the EdgeRouter configuration but cannot make changes e Password Click Change Password to make a chang
39. ccompanied your EdgeRouter includes a hardware description and instructions for hardware installation Typical Deployment Scenarios While there are numerous scenarios that are possible this section highlights a couple of typical deployments e Service Provider Deployment e Corporate Deployment Service Provider Deployment This scenario uses six EdgeRouter devices OSPF Area 0 to OSPF Area 1 OSPF Area 0 to OSPF Area 2 OSPF Area 1 OSPF Area 1 to Internet OSPF Area 2 OSPF Area 2 to Internet A a A Ubiquiti Networks Inc Chapter 1 Overview Site A Internet Site to Site Link OSPF Area 0 Site B Internet Here are the typical steps to follow 1 Configure the appropriate settings on the System tab see System on page 4 for more information e Host Name e Time Zone e Gateway e Name Server e Domain Name e NTP 2 Configure the interfaces on the Dashboard tab see Ml Interfaces on page 9 for more information 3 Configure OSPF settings on the Routing gt OSPF tab see Mf OSPF on page 17 for more information 4 Configure DHCP server s on the Services tab see DHCP Server on page 29 for more information 5 Configure NAT rules on the Security gt NAT tab see NAT on page 25 for more information 6 Configure firewall rules on the Security gt Firewall Policies tab see Firewall Policies on page 20 for more information 7 Configure additio
40. changes to the active configuration they are applied however the changes do not become part of the boot configuration until you save the changes to the boot configuration e Boot When the EdgeRouter reboots it loads the boot configuration for use The following scenarios cover some of the most commonly used commands e Configure an Interface see below 4 e Remove the Default User Account on page 43 4 e Create a Firewall Rule on page 43 Manage the Configuration File on page 46 Configure an Interface To configure an interface do the following e Assign an IP address and subnet mask e Enter a description Use the set compare commit and save commands AN Ubiquiti Networks Inc Appendix A Command Line Interface To configure an interface use the set command ubnt ubnt configure edit To view the possible completions for the ethO address enter set interfaces ethernet ethO address and press the key ubnt ubnt set interfaces ethernet eth0O address Possible completions lt X X X X X gt IP address and prefix length lt h h h h h h h h x gt IPv6 address and prefix length dhcp Dynamic Host Configuration Protocol dhcpv6 Dynamic Host Configuration Protocol for IPv6 edit ubnt ubnt set interfaces ethernet eth0 address 10 1 1 80 23 edit ubnt ubnt set interfaces ethernet eth0 description production LAN These changes affect the working configuration not th
41. configure and monitor advanced features on the EdgeRouter or prefer configuration by command line The CLI provides direct access to standard Linux tools and shell commands This chapter explains how to access the CLI and describes a basic set of frequently used commands Additional information is available on our website at http wiki ubnt com EdgeMAX_Wiki Access the CLI There are four methods you can use to access the CLI e terminal emulator Go to the following section Connect to the Console Port SSH If you are using the console port go to the following section Connect to the Console Port otherwise go to Access Using SSH on page 40 e Telnet If you are using the console port go to the following section Connect to the Console Port otherwise go to Access Using Telnet on page 40 e EdgeOS Configuration Interface Go to Access Using the EdgeOS Configuration Interface on page 41 Connect to the Console Port Instructions may vary slightly depending on your specific terminal emulator 1 Use a RJ45 to DB9 serial console cable also known as a rollover cable to connect the Console port of the EdgeRouter to your computer If your computer does not have a DB9 port then you will also need a DB9 adapter Console CONSOLE gt Computer AN Ubiquiti Networks Inc Appendix A Command Line Interface 2 Follow the appropriate set of instructions terminal emulat
42. crease The EdgeOS Configuration Interface supports IPv6 for the following options e System gt Name Server configuration Refer to Name Server on page 5 Dashboard gt VLAN configuration Refer to Add VLAN on page 9 Dashboard gt Interface configuration Refer to Configure the Interface on page 10 AN Ubiquiti Networks Inc Chapter 4 Routing Tab EJ Cul Toolbox v For IPv6 addresses the EdgeOS Configuration Interface supports double colon notation which substitutes x for a contiguous sequence of 16 bit blocks set to zero Here is an example 2001 db8 1 If written out the IPv6 address becomes 2001 db8 0000 0000 0000 0000 0000 0001 The EdgeOS Configuration Interface displays IPv6 addresses only in two locations e System gt Name Server section e Dashboard tab The EdgeOS Configuration Interface will increase its support of IPv6 in future releases For other options you can use the CLI which has comprehensive IPv6 support Note Use the CLI to view IPv6 options configured in the CLI but not supported by the EdgeOS Configuration Interface 14 EdgeOS User Guide Routes A route determines how traffic travels to its destination network If more than one route is suitable the EdgeRouter uses administrative distance as a metric to compare all available routes including directly connected routes Manually configured static routes dynamic routes
43. ction to take with a specific packet Define the following e Criteria for matching packets e Action to take with matching packets Rules are organized into a set and applied in the specified Rule Order If the packets match a rule s criteria then its action is triggered If not then the next rule is applied A table displays the following information about each rule Click a column heading to sort by that heading Order The rules are applied in the order specified The number of the rule in this order is displayed Description The keywords you entered to describe this rule are displayed Source The source specified by this rule is displayed Destination The destination specified by this rule is displayed Protocol The protocol that matches the rule is displayed Action The action specified by this rule is displayed Actions Click the Actions button to access the following options e Basic To configure the basic options of a rule click Basic Go to Basic on page 22 e Advanced To configure the advanced options of a rule click Advanced Go to Advanced on page 22 e Source To configure the source options of a rule click Source Go to Source on page 23 e Destination To configure the destination options of a rule click Destination Go to Destination on page 23 e Time To configure the time options of a rule click Time Go to Time on page 23 21 EdgeOS User Guide e Copy Rul
44. d You can click it to access the device s configuration through its web management interface AN Ubiquiti Networks Inc Chapter 8 Toolbox For more information click the arrow to view the following Firmware Version The version number of the device s firmware is displayed e Uptime The duration of the device s activity is displayed e Addresses The addresses of the device s interface are displayed If the device has more than one interface addresses for each interface are displayed hwaddr The MAC address of the device s interface is displayed ipv4 The IP address of the device s interface is displayed d 7 devices Displayed 7 devices Interface Hardware Address lt eth2 00 27 22 60 00 02 Firmware Version AirCam GM8126 v1 1 5 14312 120905 154 Uptime 2w3d17h8m19s Addresses hwaddr 00 27 22 60 00 02 ipv4 192 168 25 103 2 hwaddr 00 27 22 60 00 02 ipv4 169 254 0 2 amp Packet Capture Capture packets traveling through the specified interface for analysis You can set up filters to capture the specific types of packets you are seeking Packet Capture Interface Enter the name of the interface Packet Limit Enter the number of packets to capture The maximum number is 300 Resolve addresses Select this option to resolve the IP addresses symbolically as names instead of numerically Filter e Protocol Enter the protocol to filter e Address Enter the address to fi
45. ddress of the range is displayed e Router The default route of the DHCP clients is displayed The DHCP clients route all packets to this IP address which is the EdgeRouter s own IP address in most cases IP Address a Hardware Address gt Lease Expiration gt Pool 10 1 0 22 00 26 f2 ce 9f 28 2012 08 28 21 22 34 Internal G 10 1 0 28 f0 cb a1 2c be 29 2012 08 28 21 08 19 Internal SPhone 10 1 0 29 00 27 22 60 06 e9 2012 08 28 21 05 56 Internal AV 10 1 0 30 88 53 2e 78 e4 0c 2012 08 28 21 19 09 Internal J IP Address The IP address assigned to the DHCP client is displayed Hardware Address The MAC address of the DHCP client is displayed Lease Expiration The date and time when the DHCP DNS The IP address of the DNS server is displayed Status The Enabled Disabled status of the DHCP server is displayed Create New Mapping To map a static IP address toa specific MAC address click Create New Mapping The Create Static MAC IP Mapping appears lease will expire is displayed Create Static MAC IP Mapping e Pool The name of the DHCP server is displayed e Hostname The name used to identify the DHCP client is ID displayed MAC Address At the bottom of the screen you can click Delete to IP Address delete the DHCP server and its configuration Static MAC IP Mapping DHCP Server Internal Complete the following Static Map IP Mapping EO once Stat 10 10 21 cently ID Enter a name for this
46. e Password Enter the new password Confirm Enter the new password again Cancel Change Password Click this option to cancel Username admin Full Name Role Admin Password Confirm Cancel Change Password Click Save to apply your changes or click Cancel AN Ubiquiti Networks Inc Chapter 7 Users Tab Remote Remote access of the EdgeRouter is logged on this tab FdgeMAX Search Allows you to search for specific text Begin typing there is no need to press enter The results are filtered in real time as soon as you type two or more characters PPTP L2TP PPPOE AI Click the appropriate tab to filter the remote users as needed e PPTP All users who use PPTP Point to Point Tunneling Protocol connections are displayed e L2TP All users who use L2TP Layer 2 Tunneling Protocol connections are displayed e PPPOE All users who use PPPOE Point to Point over Ethernet connections are displayed All All remote users are displayed by default A table displays the following information about each remote user Click a column heading to sort by that heading Name The actual name of the user is displayed Type The type of connection used by the user is displayed Time The duration of the user s access is displayed Interface The specific interface used by the user is displayed Remote IP The remote IP address of the user is displayed TX packets The number of packets transmitted
47. e Delete OSPF Router ID Enter the IP address that identifies a specific router in an OSPF network In OSPF the highest Router ID determines which router is the Designated Router DR which distributes updates to the other OSPF routers Click Save to apply your changes or click Delete OSPF to remove the Router Redistribution and Area settings Interfaces settings are retained A Ubiquiti Networks Inc Chapter 4 Routing Tab Redistribution A single router can use multiple routing protocols such as OSPF and RIP which use incompatible metrics It must reconcile information from multiple protocols to determine which route to use for a specific destination network You can change the metrics of the distributed protocol to create protocol compatibility Redistribution Redistribute connected cA Redistribute static Announce default route _ Metric Metric Redistribute connected If enabled the EdgeRouter connects an OSPF area to a network using a different routing protocol and redistributes the other protocol s directly connected routes into the OSPF area These routes become external OSPF routes Metric If there are multiple routes to the same destination OSPF uses the metric to select a route for the routing table Assign a cost value to the redistributed connected routes The EdgeRouter can then use this metric to compare these routes to other OSPF routes Redistribute static If enabled the Edge
48. e To enhance security we recommend that you change the default login using at least one of the following options e Set up a new user account preferred option For details go to Remove the Default User Account on page 43 e Change the default password of the ubnt login Use the set command as detailed in Remove the Default User Account on page 43 AN Ubiquiti Networks Inc Appendix A Command Line Interface Access Using Telnet Telnet is disabled by default To use Telnet enable it on the System tab see Telnet Server on page 6 1 2 r Open the telnet client on your computer At the prompt enter telnet lt hostname gt The default is 192 168 1 1 for the hostname You can also enter a domain name instead of an IP address for the hostname Last login Wed Oct 3 11 26 03 on ttys000 MacBook Pro ee telnet 192 168 1 1 At the login prompt enter the username the default is ubnt Last login Wed Oct 3 11 27 26 on ttys000 MacBook Pro ee telnet 192 168 1 1 Trying 192 168 1 1 Connected to 192 168 1 1 Escape character is Welcome to Edge0S By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms UBNT OC login ubntff At the Password prompt enter the password the def
49. e active configuration To see what changes have been made to the working configuration use the compare command ubnt ubnt compare edit interfaces ethernet eth0 taddress 10 1 1 2 24 description production LAN edit To make the changes active use the commit command ubnt ubnt commit edit If you reboot the EdgeRouter the changes will be lost To save these changes use the save command to save the active configuration to the boot configuration ubnt ubnt save Saving configuration to config config boot Done edit ubnt ubnt exit exit ubnt ubnt S ubnt ubnt S show interfaces Codes S State L Link u Up D Down A Admin Down Interface IP Address S L Description etho 10 1 1 80 23 u u production LAN ethl u D eth2 u D lo 127 0 0 1 8 u u 1 128 ubnt ubnt 5 ping 10 1 0 1 PING 10 1 0 1 10 1 0 1 56 84 bytes of data 64 bytes from 10 1 0 1 icmp_req 1 ttl 64 time 0 460 ms 64 bytes from 10 1 0 1 icmp_req 2 ttl 64 time 0 407 ms C 10 1 0 1 ping statistics 2 packets transmitted 2 received 0 packet loss time 999 ms rtt min avg max mdev 0 407 0 433 0 460 0 033 ms 42 EdgeOS User Guide Remove the Default User Account To remove the default user account do the following e Create a new user Log out of the default user account e Log in with the new user account e Delete the default user account Use the set commit save exit and delete c
50. e To create a duplicate click Copy Rule The duplicate rule appears at the bottom of the list e Delete Rule Remove the rule Add or Configure a Rule The Rule Configuration for _ screen appears You have five tabs available e Basic see below e Advanced see the next column e Source on page 23 Destination on page 23 Time on page 23 Basic Add New Rule Advanced Destination Description Enable vw Action C Drop Reject Accept Protocol All protocols Both TCP and UDP Choose a protocol by name Enter a protocol number Logging O e Description Enter keywords to describe this rule e Enable Check the box to enable this rule e Action Select the action for packets that match this rule s criteria Drop Packets are blocked with no message Reject Packets are blocked and an ICMP Internet Control Message Protocol message is sent saying the destination is unreachable Accept Packets are allowed e Protocol All protocols Match packets of all protocols Both TCP and UDP Match TCP and UDP packets Choose a protocol by name Select the protocol from the drop down list Match packets of this protocol e Match all protocols except for this Match packets of all protocols except for the selected protocol Choose a protocol by name ah s _ Match all protocols except for this AN Ubiquiti Networks Inc Chapter 5 Security Tab Enter a
51. e version However we recommend that you back up your current system configuration before updating the firmware Upgrade System Image Upload system image To check for updates go to www ubnt com download Upload system image To update the EdgeRouter with new firmware click Upload a file and locate the new firmware file Then click Choose Please be patient as the firmware update routine can take three to seven minutes You cannot access the EdgeRouter until the firmware update routine is completed A WARNING Do not power off do not reboot and do not disconnect the EdgeRouter from the power supply during the firmware update process as these actions will damage the EdgeRouter Restart amp Shut Down Router Restart Router Restart amp Shut Down Router Restart Router Restart Restart To turn the EdgeRouter off and back on again click this option AN Ubiquiti Networks Inc Chapter 2 Using EdgeOS Shut Down Router Shut Down Router Shut Down Shut Down To turn off the EdgeRouter click this option A WARNING Click Shut Down to properly shut down the EdgeRouter An improper shutdown such as disconnecting the EdgeRouter from its power supply runs the risk of data corruption Click the top right corner of the System tab to close it EdgeOS User Guide Chapter 3 Dashboard Tab FdgeMAX l z R 1 week 2 days 21 hours Welcomeubnt v to ubnt SJ Users Interfaces Hide Distribution Rou
52. enable action accept destination port 22 protocol tcp AA EdgeOS User Guide To create a new firewall rule from an existing firewall rule use the copy command ubnt ubnt edit firewall edit firewall ubnt ubnt copy name WAN1 LOCAL to name WAN2_ LOCAL edit firewall ubnt ubnt commit edit firewall ubnt ubnt top edit ubnt ubnt show firewall name WAN1 LOCAL default action drop rule 10 action accept state established enable related enable i rule 20 action drop state invalid enable T rule 30 action accept destination port 22 protocol tep name WAN2_LOCAL default action drop rule 10 action accept state established enable related enable i rule 20 action drop state invalid enable rule 30 action accept destination port 22 protocol tcp edit AN Ubiquiti Networks Inc Appendix A Command Line Interface To change the name of the new firewall rule use the rename command ubnt ubnt edit firewall edit firewall ubnt ubnt rename name W TAB WAN1 LOCAL WAN2_ LOCAL edit firewall ubnt ubnt rename name WAN2 LOCAL to name WAN2_IN edit firewall ubnt ubnt commit edit firewall ubnt ubnt top edit ubnt ubnt show firewall name name WAN1 LOCAL default action drop rule 10 action accept state established enable related enable rule 20 action drop state invalid ena
53. er Match inbound non IPsec packets Match non Psec packets that are entering the EdgeRouter 22 EdgeOS User Guide P2P Match P2P Peer to Peer applications None Donot match P2P connections All Match all P2P connections Choose P2P app s by name Match packets of the selected P2P application s Check the box of any P2P application on this list to select it Choose P2P app s by name _ AppleJuice _ eDonkey BitTorrent Gnutella Direct Connect _ KaZaA Click Save to apply your changes or click Cancel Source Add New Rule Basic Advanced Destination Time Address Port MAC Address Address Group Network Group Port Group Address Enter the IP address of the source Port Enter the port number or range of the source MAC Address Enter the MAC address of the source Address Group Network Group Port Group Firewall groups are created on the Firewall Groups tab see Firewall Groups on page 24 for more information Select the appropriate group s you can specify up to two groups maximum in these combinations e An address group and port group e A network group and port group The packets must match both groups to apply the rule Click Save to apply your changes or click Cancel Destination Add New Rule Basic Advanced Address Port Address Group Network Group Port Group Address Enter the IP
54. f the EdgeRouter Configuration Interface click this option CLI Advanced users can make configuration changes using Linux commands At the top right of the screen click the CLI button See Command Line Interface on page 39 for more information Toolbox At the top right of the screen click the Toolbox button The following network administration and monitoring tools are available Mt Ping on page 36 Mf Trace on page 37 4 Discover on page 37 4 e Packet Capture on page 37 4 Log Monitor on page 38 AN Ubiquiti Networks Inc Chapter 2 Using EdgeOS Alerts The number of new alerts is displayed in a red popup p ll Alerts At the bottom of the screen click the Alerts tab poe 1 A table displays the following information about each important event Message A description of the event is displayed Field The settings that are affected by the event are displayed Actions The following options are available e Remove Click this button to clear an alert e Clear All Click this button to clear all alerts Click the top right corner of the Alerts tab to close it System At the bottom of the screen click the System tab to access the device settings Alerts System The device settings are organized into these sections 4M Basic Settings on page 5 4M Management Settings on page 5 4M e Configurati
55. form The graph scale and throughput dimension Mbps for example change dynamically depending on the mean throughput value The statistics are updated automatically The RX and TX pie charts display the data traffic allocated among the interfaces of the EdgeRouter The pie charts are updated automatically Place your mouse over an interface s portion of the pie chart to view its percentage of data traffic allocation TX amount of transmitted data and RX amount of received data 65 1 41 GB 3 35 GB AN Ubiquiti Networks Inc Chapter 3 Dashboard Tab All Ethernet VLAN Add VLAN To create a new VLAN click Add VLAN The Create a New VLAN screen appears Create New VLAN VLAN ID Interface select Description MTU 1500 Address No address settings C Use DHCP Use DHCP for IPv6 C Manually define IP address es CES Er e VLAN ID The VLAN ID is a unique value assigned to each VLAN at a single device every VLAN ID represents a different VLAN The VLAN ID range is 2 to 4094 e Interface Select the appropriate interface e Description Enter keywords to describe this VLAN e MTU Enter the MTU Maximum Transmission Unit value which is the maximum packet size in bytes that a network interface can transmit The default is 7500 e Address Select one of the following No address settings The VLAN uses no address settings In most cases an address is needed Use DHCP The
56. g applied Use the YYYY MM DD year month day format Start Time Enter the time the rule should start being applied Use the 24 hour format HH MM SS hours minutes seconds Stop Date Enter the date the rule should stop being applied Use the YYYY MM DD year month day format Stop Time Enter the time the rule should stop being applied Use the 24 hour format HH MM SS hours minutes seconds Interpret dates and times as UTC Check the box if your network uses UTC Click Save to apply your changes or click Cancel 23 EdgeOS User Guide Configuration Ruleset Configuration for LAN_IN Configuration Name LAN_IN Description LAN Inbound Default Action Drop Reject Accept Default Log J Name The name of this policy is displayed Description Enter keywords to describe this policy Default action All policies have a default action if the packets do not match any rule Select the appropriate default action e Drop Packets are blocked with no message e Reject Packets are blocked and an ICMP Internet Control Message Protocol message is sent saying the destination is unreachable e Accept Packets are allowed Default Log Check this box to log packets that trigger the default action Click Save Ruleset to apply your changes Interfaces Ruleset Configuration for LAN_IN Interface ethl Add Interface e Interface Select the appropriate interface from the drop down list e
57. ge the device configuration routines and firmware maintenance Back Up Config We recommend that you back up your current system configuration before updating the firmware or uploading a new configuration Configuration Management amp Device Maintenance Back Up Config Download backup config file Download Download backup config file Click Download to download the current system configuration file Note We strongly recommend that you save the configuration file in a secure location because it includes confidential information The user login passwords are encrypted however other passwords and keys such as those used for VPN BGP authentication and RADIUS are stored in plain text EdgeOS User Guide Restore Config Restore Config Upload config file Upload a tile Upload config file Click Upload a file to locate the configuration file previously created by the Back Up Config option Select the file and click Choose We recommend that you back up your current system configuration before uploading the new configuration Note for advanced users You can also upload a raw configuration file config config boot using this option Upgrade System Image Download the firmware file from downloads ubnt com and save it on your computer The firmware update is compatible with all configuration settings The system configuration is preserved while the EdgeRouter is updated with a new firmwar
58. he Ethernet port of your computer to the port labeled 0 on the EdgeRouter 2 Configure the Ethernet adapter on your computer with a static IP address on the 192 168 1 x subnet e g 192 168 1 100 Note As an alternative you can connect a serial cable to the Console port of the EdgeRouter See Command Line Interface on page 39 for more information 3 Launch your web browser Type https 192 168 1 1 in the address field Press enter PC or return Mac hitps 192 168 1 1 4 The login screen will appear Enter ubnt in the Username and Password fields Read the Ubiquiti License Agreement and check the box next to I agree to the terms of this License Agreement to accept it Click Login FogeMAX Please Login UBIQUITI LICENSE AGREEMENT This License Agreement strictly prohibits You from using the Ubiquiti Software on any device other than a Ubiquiti Device You are also prohibited from removing any Ubiquiti copyright notice or brand or modifying any user interface of the Ubiquiti Software or any Ubiquiti Device This is a legal agreement between You and Ubiquiti Networks Inc Ubiquiti YOU MUST READ AND AGREE TO THE TERMS OF THIS LICENSE AGREEME AGREEMENT BEFORE ANY UBIQUITI SOFTWARE CAN BE ICKING ON THE ACCEPT BUTTON OF THIS AGREEMENT OR ING UBIQUIT SOFTWARE OR USING UBIQUIT SOFTWARE MS AND CONDITIONS OF THIS AGREEMENT IF YOU DO NOT s CEMENT TUON VOL CUOL O WT TIC DACE
59. iguration screen appears Destination NAT Rule Configuration Description Enable Inbound Interface Translations Exclude from NAT Enable Logging Protocol All protocols QO Both TCP and UDP _ Choose a protocol by name _ Enter a protocol number Src Address Src Port Dest Address Dest Port e Description Enter keywords to describe this rule e Enable Check the box to enable this rule Inbound Interface Select the interface through which the incoming packets enter the EdgeRouter 27 EdgeOS User Guide Translations Complete the following Address Enter the IP address that will replace the destination IP address of the incoming packet Port Enter the port number that will replace the destination port number of the incoming packet e Exclude from NAT Check the box to exclude packets that match this rule from NAT Enable Logging Check this box to log instances when the rule is matched e Protocol All protocols Match packets of all protocols Both TCP and UDP Match TCP and UDP packets Choose a protocol by name Select the protocol from the drop down list Match packets of this protocol e Match all protocols except for this Match packets of all protocols except for the selected protocol Choose a protocol by name ah a _ Match all protocols except for this Enter a protocol number Enter the port number of the protocol Match packets of this protoco
60. ion NAT Rule section Save Rule Order To change the rule order click and drag a rule up or down the sequence and then release the rule When you are finished click Save Rule Order Search Allows you to search for specific text Begin typing there is no need to press enter The results are filtered in real time as soon as you type two or more characters AN Ubiquiti Networks Inc Chapter 5 Security Tab A table displays the following information about each rule Click a column heading to sort by that heading Order The rules are applied in the order specified The number of the rule in this order is displayed Description The keywords you entered to describe this rule are displayed Source Addr The source IP address is displayed Source Port The source port number is displayed Dest Addr The destination IP address is displayed Dest Port The destination port number is displayed Translation A description of the translation such as to lt IP_address gt is displayed Count The number of translations is displayed Actions Click the Actions button to access the following options e Config To configure the rule click Config Go to the Add or Configure a Destination NAT Rule section below e Copy To create a duplicate click Copy The duplicate rule appears at the bottom of the list e Delete Remove the rule Add or Configure a Destination NAT Rule After you click Config the Destination NAT Rule Conf
61. l e Match all protocols except for this Match packets of all protocols except for the selected protocol Enter a protocol number _ Match all protocols except for this e Src Address Enter the IP address or network address of the source You can also enter a range of IP addresses one of them will be used Note If you enter a network address enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 e Src Port Enter the port name or number of the source You can also enter a range of port numbers one of them will be used e Dest Address Enter the IP address or network address of the destination You can also enter a range of IP addresses one of them will be used Note If you enter a network address enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 e Dest Port Enter the port name or number of the destination You can also enter a range of port numbers one of them will be used Click Save to apply your changes or click Cancel AN Ubiquiti Networks Inc Chapter 5 Security Tab VPN A common type of VPN uses PPTP Point to Point Tunneling Protocol The EdgeRouter can function as a PPTP VPN server so a remote VPN client can access the LAN using a PPTP VPN tunnel over the Internet PPTP Server FdgeMAX Welcome ub
62. le Check the box to enable this DHCP server Click Save to apply your changes or click Cancel 29 EdgeOS User Guide Chapter 6 Services Tab Search Allows you to search for specific text Begin typing there is no need to press enter The results are filtered in real time as soon as you type two or more characters Configure the DHCP Server The DHCP Server screen appears You have three tabs available A table displays the following information about each Leases DHCP server Click a column heading to sort by that heading DHCP Server Internal Static Map IP Mapping Details Subnet 10 1 0 0 23 Range Start 10 1 0 21 Range End 10 1 1 252 Router 10 1 0 1 DNS 10 1 0 1 Status Enabled Pool Size Leased Available 488 345 143 Name The name of the DHCP server is displayed Subnet The IP address and subnet mask of the DHCP server are displayed Pool size The total number of IP addresses is displayed Leased The number of leased IP addresses is displayed Available The number of available IP addresses is displayed Actions Click the Actions button to access the following options e View Leases To view the current DHCP leases click View Leases Go to the Configure the DHCP Server gt Leases section e Configure Static Map To map static IP addresses to MAC addresses click Configure Static Map Go to Ml Static MAC IP Mapping on page 31 IP Address a 10 1 0 22 10 1 0 28 10 1 0 29 1
63. lows hosts on the same network to discover each other s IP address via a layer 2 broadcast to all MAC addresses If they are not on the same network the layer 2 broadcast will not reach its destination however the EdgeRouter can serve as the go between if Proxy ARP is enabled Click Save to apply your changes or click Cancel AN Ubiquiti Networks Inc Chapter 3 Dashboard Tab Configure the PoE Settings Note Before enabling PoE check the specifications of your airMAX airVision mFi UniFi legacy or third party devices to ensure they support passive PoE and require the available amount of voltage Available for the EdgeRouter PoE only After you click PoE the PoE tab of the Interface Configuration screen appears Interface Configuration for eth1 24V PoE Watchdog Enable A Cutting power during FW upgrade will damage your device Make sure you Watchdog specify safe Ping Interval IP Address Ping Interval Q Startup Delay Failure Count Cut power for PoE is disabled by default on all ports Make changes as needed e PoE Select one of the following Off To disable PoE select Off Note To disable PoE you must use this setting If you disable a port its PoE functionality remains 24V To output 24V PoE to the connected device select 24V 48V To output 48V PoE to the connected device select 48V Note You must have a 48V power adapter not included powering the EdgeRou
64. lso configure these policies groups rules and options Any setting marked with a blue asterisk is required You have four sub tabs Firewall Policies Each firewall policy is a set of rules applied in the order you specify Firewall Groups Create groups defined by IP address network address or port number NAT View and create NAT rules VPN Configure the EdgeRouter as a PPTP VPN server Firewall Policies A firewall policy is a set of rules with a default action Firewall policies are applied before SNAT Source Network Address Translation and after DNAT Destination Network Address Translation To create a firewall policy 1 Click the Firewall Groups tab and create the applicable firewall groups See Firewall Groups on page 24 for more information 2 Click the Firewall Policies tab and then click Add Policy Configure the basic parameters See the Add Policy description in the next column for more information A Ubiquiti Networks Inc Chapter 5 Security Tab E cul Toolbox v 3 Configure the details of the firewall policy See Configure the Firewall Policy on page 21 for more information All Drop Reject Accept Add Policy To create a new policy click Add Policy The Create New Ruleset screen appears Create New Ruleset Name Description Default action C Drop Reject Accept Default Log gogo Complete the following e Name Enter a name for this policy e De
65. lter e Port Enter the port number to filter e Negate filter Check this box to capture all packets except for the ones matching the selected filter s 37 EdgeOS User Guide Start Click this button to start the capture If a Packet Limit is not specified then this button becomes a Stop button during the capture Capture results are displayed with Time and Packet descriptions Log Monitor The Log Monitor is a log displaying live updates System Log Monitor System log messages Time v Message Oct 1 21 32 06 UBNT OC zebra 384 warning interface eth1 broadcast addr 255 255 255 255 26 calculated 24 43 103 255 routing protocols may malfunction Jun 1 10 00 35 UBNT OC dhcpd WARNING Host declarations are global They are not limited to the scope you declared them in UBNT OC dhcpd UBNT OC dhcpd No subnet declaration for eth 24 43 103 194 Click the pause button to stop the live updates Click the play button to resume the live updates The System log messages table displays the following information about each log Click a column heading to sort by that heading Time The system time is displayed next to every log entry that registers a system event Message A description of the system event is displayed AN Ubiquiti Networks Inc Chapter 8 Toolbox 38 EdgeOS User Guide Appendix A Command Line Interface Overview The Command Line Interface CLI is available if you need to
66. n Interface IP Address S L Description etho u u eth1 u D eth2 u D lo 127 0 0 1 8 u u To properly shut down the EdgeRouter use the shutdown command ubnt ubnt S shutdown A WARNING Use the shutdown command to properly shut down the EdgeRouter An improper shutdown such as disconnecting the EdgeRouter from its power supply runs the risk of data corruption 41 EdgeOS User Guide Configuration Mode To switch to configuration mode use the configure command ubnt ubnt S configure edit ubnt ubnt For the show set and delete commands you can press the key for help e set View the available commands e show View the settings that you have configured Because configurations vary the list you see will differ from the sample list displayed below e delete View the settings that you can delete Enter show and press the key ubnt ubnt show firewall interfaces protocol service system edit To display the available command completions press the tab key Note The tab does not display onscreen ubnt ubnt show Possible completions firewall Firewall interfaces Network interfaces protocols Routing protocol parameters service Services system System parameters The EdgeRouter uses three configurations e Working When you make changes to the working configuration they are not applied until you commit the changes to the active configuration e Active When you commit
67. n a specific tab refer to the appropriate chapter Dashboard The Dashboard Tab on page 8 displays status information about services and interfaces You can also configure interfaces and Virtual Local Area Networks VLANs e Routing The Routing Tab on page 14 configures Static routes and Open Shortest Path First OSPF settings including metrics areas and interfaces Security The Security Tab on page 20 configures firewall policies firewall groups Network Address Translation NAT rules and PPTP VPN options Services The Services Tab on page 29 configures DHCP servers DNS forwarding and the PPPoE server e Users The Users Tab on page 34 configures user accounts with administrator or operator access EdgeOS User Guide Depending on the tab you click some of the screens display information and options in multiple sections You can click the open close tab to hide or display a section Open Close Tab Open Close Tab Common Interface Options The common interface options are accessible from all tabs on the EdgeOS interface e Welcome e CLI e Toolbox e Alerts e System Required fields are marked by a blue asterisk When the information icon is displayed you can click the icon for more information about an option Welcome At the top left of the screen click Welcome to view the Logout option Welcome ubnt v Logout Logout To manually log out o
68. nal settings as needed for your network EdgeOS User Guide Corporate Deployment This scenario uses a single EdgeRouter device The three independent interfaces connect to the following e Internet DMZ e LAN Cons Firewall Policies Internet Lela is LAN Here are the typical steps to follow I Configure the appropriate settings on the System tab see System on page 4 for more information e Host Name e Time Zone e Gateway e Name Server e Domain Name e NTP Configure the interfaces on the Dashboard tab see Interfaces on page 9 for more information Configure DHCP server s on the Services tab see DHCP Server on page 29 for more information Configure NAT rules on the Security gt NAT tab see NAT on page 25 for more information AN Ubiquiti Networks Inc Chapter 1 Overview Configure firewall rules on the Security gt Firewall Policies tab see Firewall Policies on page 20 for more information Configure additional settings as needed for your network EdgeOS User Guide Chapter 2 Using EdgeOS EdgeOS is a powerful sophisticated operating system that manages your EdgeRouter It offers both a browser based interface EdgeOS Configuration Interface for easy configuration and a Command Line Interface CLI for advanced configuration To access the EdgeOS Configuration Interface 1 Connect an Ethernet cable from t
69. ng e Criteria for matching packets e Action to take with matching packets Rules are organized into a set and applied in the specified Rule Order If the packets match a rule s criteria then its action is performed If not then the next rule is applied FdgeMAX HUUHAA Source NAT Rules Source NAT changes the source address of packets a typical scenario is that a private source needs to communicate with a public destination A Source NAT Rule goes from the private network to the public network and is applied after routing Add Source NAT Rule To create a new rule click Add Source NAT Rule Go to Add or Configure a Source NAT Rule on page 26 25 EdgeOS User Guide Save Rule Order To change the rule order click and drag a rule up or down the sequence and then release the rule When you are finished click Save Rule Order Search Allows you to search for specific text Begin typing there is no need to press enter The results are filtered in real time as soon as you type two or more characters A table displays the following information about each rule Click a column heading to sort by that heading EIE E E E E E E E E Order The rules are applied in the order specified The number of the rule in this order is displayed Description The keywords you entered to describe this rule are displayed Source Addr The source IP address is displayed Source Port The source port number is displayed
70. ng Tab Interface Define a route using a next hop interface Create Pv4 Static Route Select Route Type Interface Destination network Next hop interface select Distance 1 255 Enable Destination network Enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 Next hop interface Select the appropriate interface from the drop down list Distance 1 255 Enter the administrative distance If there are identical routes from different sources such as static RIP and OSPF the EdgeRouter compares the routes and uses the route with the lowest distance e Enable Check the box to enable the route Click Save to apply your changes Black Hole Define a route that drops unwanted traffic Create Pv4 Static Route Select Route Type Black Hole Destination network Distance 1 255 Enable Destination network Enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 Distance 1 255 Enter the administrative distance If there are identical routes from different sources such as static RIP and OSPF the EdgeRouter compares the routes and uses the route with the lowest distance e Enable Check the box to enable the route Click Save to apply your changes Search Allows you to search for specific text Begin typing there i
71. nowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms UBNT OC login ubnt Password Linux ubnt 2 6 32 13 UBNT 1 SMP Wed Oct 24 01 08 06 PDT 2012 mips64 Welcome to EdgeOS ubnt UBNT OC Note To enhance security we recommend that you change the default login using one of the following e Set up a new user account preferred option For details go to Remove the Default User Account on page 43 e Change the default password of the ubnt login Use the set command as detailed in Remove the Default User Account on page 43 39 EdgeOS User Guide Access Using SSH SSH is enabled by default 1 Open the SSH client on your computer 2 At the login prompt enter ssh lt username gt lt hostname gt The defaults are ubnt for the username and 192 168 1 1 for the hostname You can also enter a domain name instead of an IP address for the hostname Last login Wed Oct 3 09 26 30 on console MacBook Pro ee ssh ubnt 192 168 1 1 Note Upon initial login a host key will be displayed You will be asked to confirm that you want to save the host key to the local database Click Yes to bypass this message in the future 3 At the Password prompt enter the password the default is ubnt Last login Wed Oct 3 11 21 11 on ttys000 MacBook Pro ee ssh ubnt 192 168 1 1 The authe
72. nt v to ubnt Firewall Policies Firewall Groups PPTP Server Client IP pool range start 100 0 0 1 Client IP pool range stop 100 0 0 100 Server outside address 10 1 0 248 RADIUS server IP address 1 1 1 1 RADIUS server key abckeyx 1492 Client IP pool range start The client IP pool is the pool of IP addresses that remote VPN clients will use Enter the starting IP address of the range this address must in a 24 subnet Client IP pool range stop Enter the last IP address of the range Server outside address Enter the IP address that VPN clients will connect to this is the outside or external address of the PPTP server RADIUS server IP address The RADIUS Remote Access Dial In User Service server provides authentication to help secure VPN tunnels Enter the IP address of the RADIUS server RADIUS server key Enter the key shared with the RADIUS server MTU Enter the MTU for the PPTP VPN connection DNS 1 Enter the IP address of the primary remote access DNS server that your VPN client will use DNS 2 Enter the IP address of the secondary remote access DNS server Click Save to apply your changes or click Cancel 28 EdgeOS User Guide FdgeMAX Welomeubnt v a Subnet 10 1 0 0 23 10 1 6 0 24 10 1 5 0 24 Chapter 6 Services Tab The Services tab displays status information about DHCP servers DNS forwarding and the PPPoE server Any setting marked with a blue asterisk is required You ha
73. nticity of host 192 168 1 1 192 168 1 1 can t be established RSA key fingerprint is 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Are you sure you want to continue connecting yes no yes Warning Permanently added 192 168 1 1 RSA to the list of known hosts Welcome to Edge0S By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms ubnt 192 168 1 1 s password I 4 For help with commands you can either press the key or enter show and press the key Last login Wed Oct 3 11 21 11 on ttys000 MacBook Pro ee ssh ubnt 192 168 1 1 The authenticity of host 192 168 1 1 192 168 1 1 can t be established RSA key fingerprint is 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 Are you sure you want to continue connecting yes no yes Warning Permanently added 192 168 1 1 RSA to the list of known hosts Welcome to Edge0S By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms ubnt 192 168 1 1 s password Linux ubnt 2 6 32 13 UBNT 1 SMP Thu Sep 13 13 26 16 PDT 2012 mips64 Welcome to Edge0S Last login Wed Oct 3 18 19 05 2012 ubnt UBNT 0C ff Not
74. of a stub network It can import external routes from type 7 Link State Advertisements which are NSSA specific Stub The network has no external routes Typically it has a default route for outbound traffic e Auth Type Authentication helps secure communication between routers Select the appropriate option Off No authentication is used MD5 sec Each router uses a key password and key ID This is the most secure option because the key is never transmitted Plain text Each router uses a key This provides minimal security because the key is transmitted in plain text format e Network Enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 Click Add New to enter more network addresses Click Save to apply your changes A table displays the following information about each OSPF Area Click a column heading to sort by that heading A Ubiquiti Networks Inc Chapter 4 Routing Tab Area ID The identification number of the area is displayed Area Type The type of area is displayed Auth Type The authentication type of the area is displayed Network The network address of the area is displayed Actions Click the Actions button to access the following options e Config To configure the OSPF Area click Config Go to the Configure the OSPF Area section e Delete Delete the OSPF Area Configure the OSPF Area After yo
75. ommands ubnt ubnt S configure edit ubnt ubnt set system login user adminl authentication plaintext password adminlpass edit ubnt ubnt commit edit ubnt ubnt save Saving configuration to config config boot Done edit ubnt ubnt exit exit ubnt ubnt exit logout Welcome to Edge OS ubnt ttyS0 ubnt login adminl Password Linux ubnt 2 6 32 13 UBNT 1 SMP Fri Jun 8 09 48 31 PDT 2012 mips64 Welcome to EdgeOS adminl ubnt configure edit adminl ubnt delete system login user ubnt edit adminl ubnt commit edit adminl ubnt save Saving configuration to config config boot Done edit admin ubnt exit exit adminl ubnt The plaintext password that you entered is converted to an encrypted password adminl ubnt configure edit adminl ubnt show system login user adminl authentication encrypted password 1Smv8ERQ1TS7xq eUDwy 5And7nV 9r6 plaintext password aa i edit adminl ubnt exit exit adminl ubnt S AN Ubiquiti Networks Inc Appendix A Command Line Interface Create a Firewall Rule To create a firewall rule use the set or edit commands both methods are described below In addition use the compare discard up top copy and rename commands Create a firewall rule using the full syntax ubnt ubnt S configure edit ubnt ubnt set firewall name TEST default action drop edit ubnt ubnt set firewall name TEST en
76. on Management amp Device Maintenance on page 6 4 e Restart amp Shut Down Router on page 7 EdgeOS User Guide Basic Settings Host Name Basic Settings Host Name System host name ubnt demo System host name Enter a name for the EdgeRouter The host name identifies the EdgeRouter as a specific device For example a com URL typically uses this format lt host_name gt domain_name com Time Zone Time Zone _ Use Coordinated Universal Time UTC Time zone Select continent ocean Use Coordinated Universal Time UTC UTC is the international time standard used by Network Time Protocol NTP servers If your routers are located in multiple time zones then you may want to use UTC Time zone To set your network to a specific time zone select Time zone and configure the following Select continent ocean Select your location Select country region Select your location Select time zone Select your time zone Gateway Gateway System gateway address System gateway address Enter the IP address of your gateway This will set up your default route If you want to set up additional default routes configure them as static routes on the Routing tab See Routing Tab on page 14 for more information Name Server Domain Name System DNS translates domain names to IP addresses each DNS server on the Internet holds these mappings in its respective DNS database
77. or Go to the following section Access Using a Terminal Emulator e SSH Go to Access Using SSH on page 40 e Telnet Go to Access Using Telnet on page 40 Access Using a Terminal Emulator Instructions may vary slightly depending on your specific terminal emulator 1 Open the terminal emulator on your computer and configure it with the following serial port settings e Baud rate 115200 Data bits 8 Parity NONE Stop bits 1 Flow control NONE 2 Select Serial as the connection type 3 Click Open to connect to the EdgeRouter 4 At the ubnt login prompt enter the username the default is ubnt Welcome to EdgeOS By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms UBNT OC login ubnt 5 At the Password prompt enter the password the default is ubnt Welcome to EdgeOS By logging in accessing or using the Ubiquiti product you acknowledge that you have read and understood the Ubiquiti License Agreement available in the Web UI at by default http 192 168 1 1 and agree to be bound by its terms UBNT OC login ubnt Password 6 For help with commands you can either press the key or enter show and press the key Welcome to EdgeOS By logging in accessing or using the Ubiquiti product you ack
78. or this 26 EdgeOS User Guide e Src Address Enter the IP address or network address of the source You can also enter a range of IP addresses one of them will be used Note If you enter a network address enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 e Src Port Enter the port name or number of the source You can also enter a range of port numbers one of them will be used e Dest Address Enter the IP address or network address of the destination You can also enter a range of IP addresses one of them will be used Note If you enter a network address enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 e Dest Port Enter the port name or number of the destination You can also enter a range of port numbers one of them will be used Click Save to apply your changes or click Cancel Destination NAT Rules Destination NAT changes the destination address of packets a typical scenario is that a public source needs to communicate with a private destination A Destination NAT Rule goes from the public network to the private network and is applied before routing FdgeMAX TRS ERS Ba EGO E Pee eee EES Add Destination NAT Rule To create a new rule click Add Destination NAT Rule Go to the Add or Configure a Destinat
79. ormation 0 cece ccc eee eee ees 48 Ubiquiti Networks Support 6 cswxx ad de scinawe vse deen thu sud acdoowaenet eens ctowses 48 AN Ubiquiti Networks Inc EdgeOS User Guide Chapter 1 Overview Introduction EdgeOS is a powerful sophisticated operating system from Ubiquiti Networks It allows you to manage your EdgeRouter and networks This User Guide is designed for use with version 1 2 or above of the EdgeOS Configuration Interface and all of the EdgeRouter models which this User Guide will collectively refer to as EdgeRouter Additional information is available on our website at http community ubnt com edgemax http wiki ubnt com EdgeMAX_Wiki http documentation ubnt com edgemax Product Name Model Number of Ports PoE Configuration The intuitive EdgeOS Configuration Interface allows you to conveniently manage your EdgeRouter using your web browser See Using EdgeOS on page 3 for more information If you need to configure advanced features or prefer configuration by command line you can use the Command Line Interface CLI See Command Line Interface on page 39 for more information Configuration Interface System Requirements e Microsoft Windows XP Windows Vista Windows 7 Windows 8 Linux or Mac OS X e Web Browser Google Chrome Mozilla Firefox or Microsoft Internet Explorer 8 or above Hardware Overview and Installation The Quick Start Guide that a
80. plex with its counterpart In this process the networked devices first share their capabilities and then choose the fastest transmission mode they both support To manually specify the transmission link speed and duplex mode select one of the following options 100 full 100 half 10 full or 10 half Full duplex mode allows communication in both directions simultaneously Half duplex mode allows communication in both directions but not simultaneously and only in one direction at a time e Proxy ARP Enable the EdgeRouter to answer a source host s ARP Address Resolution Protocol requests for the IP address of a destination host that is not located on the source host s network ARP allows hosts on the same network to discover each other s IP address via a layer 2 broadcast to all MAC addresses If they are not on the same network the layer 2 broadcast will not reach its destination however the EdgeRouter can serve as the go between if Proxy ARP is enabled Click Save to apply your changes or click Cancel Configure the VLAN After you click Config the Interface Configuration screen appears Interface Configuration for eth1 10 VLAN ID 10 Parent eth Description UniFi guest network Enable T Address No address settings _ Use DHCP _ Use DHCP for IPv6 C Manually define IP address es 10 1 5 1 24 Add IP MTU 1500 Proxy ARP B Make changes as needed e VLAN ID The VLAN ID is displayed e
81. propriate interface Click Save to apply your changes or click Cancel AN Ubiquiti Networks Inc Chapter 6 Services Tab 33 EdgeOS User Guide FdgeMA Welkomeubnt v to ubnt SjJ Or O Bw g ke Ey ix E tw admin Showing 1 to 7 of 7 entries Chapter 7 Users Tab The Users tab displays account information about users You can also configure these user accounts Any setting marked with a blue asterisk is required You have two sub tabs Local Displays configurable user accounts Remote Displays statistics about the users who remotely access the EdgeRouter Local Configure user accounts with unique logins Add User To create a new user click Add User The Create New Local User screen appears Create New Local User Username Full Name Password Confirm Role AN Ubiquiti Networks Inc Chapter 7 Users Tab P CLI Toolbox v lt Date Connected November 8 2012 November 12 2012 00h 24m 19s Complete the following e Username Enter a unique account name for the user Full Name Enter the actual name of the user e Password Enter the password e Confirm Enter the password again e Role Select the appropriate permission level Admin The user can make changes to the EdgeRouter configuration Operator The user can view the EdgeRouter configuration but cannot make changes Click Save to apply your changes Search Allows you to search for specifi
82. protocol number Enter the port number of the protocol Match packets of this protocol e Match all protocols except for this Match packets of all protocols except for the selected protocol Enter a protocol number _ Match all protocols except for this e Logging Check this box to log instances when the rule is matched Click Save to apply your changes or click Cancel Advanced Add New Rule Recent Time Recent Count IPsec Destination Established Invalid J New Related _ Don t match on IPsec patckets _ Match inbound IPsec packets _ Match inbound non IPsec packets J None All _ Choose P2P app s by name e State This describes the connection state of a packet Established Match packets that are part of a two way connection Invalid Match packets that cannot be identified New Match packets creating a new connection Related Match packets related to established connections e Recent Time Enter the number of seconds to monitor for attempts to connect from the same source e Recent Count Enter the number of times the same source is detected within the Recent Time duration This helps thwart attacks using continual attempts to connect e IPsec IPsec Internet Protocol security helps secure packet routing Don t match on IPsec packets Do not match any IPsec packets Match inbound IPsec packets Match IPsec packets that are entering the EdgeRout
83. s DNS server at 8 8 8 8 e DNS 2 Enter the IP address of the secondary DNS server e Domain Enter the domain name for DHCP clients e Lease Time Enter the period of time in seconds that a DHCP lease should last e Enable Check the box to enable this DHCP server Click Save to apply your changes At the bottom of the screen you can click Delete to delete the DHCP server and its configuration DNS The EdgeRouter receives all LAN DNS requests and forwards them to the service provider s DNS server The EdgeRouter receives responses from the DNS server and forwards them to the LAN clients DNS Forwarding FdgeMA X Welkome ubnt v to ubnt DHCP Server DNS Forwarding Cache Size 200 Interface eth2 ethl Add Listen Interface Cancel Save Cache Size Completed DNS requests are cached so response time is faster for cached entries and there is less traffic traveling to the DNS server Enter the maximum number of DNS queries to cache Interface Select the appropriate interface that the EdgeRouter will listen to so it can forward DNS requests Add Listen Interface You can select multiple interfaces To add another interface for DNS forwarding click Add Listen Interface From the new Interface drop down menu select the appropriate interface Click Save to apply your changes or click Cancel 32 EdgeOS User Guide PPPoE The EdgeRouter can function as a PPPoE Point to Point Protocol over
84. s no need to press enter The results are filtered in real time as soon as you type two or more characters 15 EdgeOS User Guide All Static Connected RIP OSPF Click the appropriate tab to filter the routes as needed All All routes are displayed by default e Static All static routes that you have configured are displayed e Connected All routes that are directly connected to the EdgeRouter are displayed RIP All RIP Routing Information Protocol routes are displayed RIP is an interior distance vector routing protocol that uses hop count as a metric to determine the best route e OSPF All OSPF Open Shortest Path First routes are displayed OSPF is an interior link state routing protocol that uses cost as a metric to determine the best route The bandwidth of an interface determines the cost the higher the bandwidth the lower the cost A table displays the following information about each route Click a column heading to sort by that heading Selected The status of the route whether it has been selected for the routing table is displayed Destination The destination IP address is displayed Next Hop The IP address of the next hop interface is displayed Interface The name of the interface is displayed Route Type The type of route is displayed In FIB The forwarding status of the route whether it is in the FIB Forwarding Information Base is displayed Actions Click the Actions button to acces
85. s the following options e Config To configure the route click Config Go to the Configure the Static Route section below e Delete Delete the route its configuration will be removed e Disable Disable the route while keeping its configuration This option is not available for black hole routes AN Ubiquiti Networks Inc Chapter 4 Routing Tab Configure the Static Route After you click Config the Static Route Configuration screen appears Static Route Configuration Route type gateway Destination network 10 100 10 0 24 Next hop address 10 1 200 2 Distance 1 255 Enable M Save Follow the instructions for your route type Gateway e Route type The gateway route uses the IP address and subnet mask of the next hop gateway e Destination network The IP address and subnet mask are displayed in slash notation e Next hop address The IP address of the next hop gateway is displayed Distance 1 255 Enter the administrative distance If there are identical routes from different sources such as Static RIP and OSPF the EdgeRouter compares the routes and uses the route with the lowest distance e Enable Check the box to enable the route Click Save to apply your changes Interface Static Route Configuration Route type interface Destination network 203 0 113 170 32 Next hop interface 203 0 113 177 Distance 1 255 e Route type The interface route uses the next hop interface e Destina
86. scription Enter keywords to describe this policy e Default action All policies have a default action if the packets do not match any rule Select the appropriate default action Drop Packets are blocked with no message Reject Packets are blocked and an ICMP Internet Control Message Protocol message is sent saying the destination is unreachable Accept Packets are allowed through the firewall 20 EdgeOS User Guide e Default Log Check this box to log packets that trigger the default action Click Save to apply your changes Search Allows you to search for specific text Begin typing there is no need to press enter The results are filtered in real time as soon as you type two or more characters All Drop Reject Accept Click the appropriate tab to filter the policies by default action All All policies are displayed by default Drop All of the drop policies are displayed e Reject All of the reject policies are displayed e Accept All of the accept policies are displayed A table displays the following information about each policy Click a column heading to sort by that heading Name The name of the policy is displayed Interfaces The specified interface and direction of traffic flow are displayed Number of Rules The number of rules in the policy is displayed Default Action The action that the policy will execute if the packets do not match any rule is displayed Actions Click the Ac
87. show system commit diff command ubnt RTR show system commit diff 0 edit system login user joe authentication encrypted password 1 CWVzYggs NyJXxC3S572rfm6pY8ZMO plaintext password level admin To display the entire configuration file for revision 0 use the show system commit file command ubnt RTR S show system commit file 0 To add a comment to the commit use the comment command ubnt RTR set system login user joe level operator edit ubnt RTR commit comment change joe from admin to op edit ubnt RTR save exit Saving configuration to config config boot Done exit Now you will see the comment when you use the show system commit command ubnt RTR S show system commit 0 2012 08 17 18 44 41 by ubnt via cli change joe from admin to op 2012 08 17 18 34 01 by ubnt via cli commit 2012 08 17 18 32 13 by ubnt via cli commit 2012 08 17 18 31 52 by ubnt via cli commit 2012 08 17 18 31 51 by root via init commit e WUN When you work on a remote router certain changes such as a firewall or NAT rule can cut off access to the remote router so you then have to visit the remote router and reboot it To avoid such issues when you make risky changes use the commit confirm command first Then use the confirm command to save your changes ubnt RTR configure edit ubnt RTR set firewall name WAN_IN rule 50 action drop edit ubnt RTR set firewall name
88. t will not reach its destination however the EdgeRouter can serve as the go between if Proxy ARP is enabled Click Save to apply your changes or click Cancel EdgeOS User Guide Configure the Switch Available for the EdgeRouter PoE only After you click Config the Interface Configuration screen appears Interface Configuration for switchO Description Address No address settings Use DHCP _ Use DHCP for IPv6 Manually define IP address es Switch Ports O eth2 eth3 SF eth4 Proxy ARP e Make changes as needed e Description Enter keywords to describe this switch e Address Select one of the following No address settings The switch uses no address settings In most cases an address is needed Use DHCP The switch acquires network settings from a DHCPV4 server Click the Renew button to acquire fresh network settings Use DHCP Use DHCP for IPv6 The switch acquires network settings from a DHCPV6 server Manually define IP address es Enter the Static IP address example 792 0 2 1 24 for IPv4 or 2001 db8 1 32 for IPv6 Click Add IP to enter additional IP addresses Manually define IP address es Add IP e Switch Ports Select the ports for the switch interface e Proxy ARP Enable the EdgeRouter to answer a source host s ARP Address Resolution Protocol requests for the IP address of a destination host that is not located on the source host s network ARP al
89. ter PoE otherwise 48V PoE is not allowed PoE Watchdog Ping Watchdog is only for PoE enabled ports It configures the device to continuously ping a user defined IP address it can be the Internet gateway for example If it is unable to ping under the user defined constraints then the device will automatically turn off PoE on the port and then turn it back on This option creates a kind of fail proof mechanism Ping Watchdog is dedicated to continuous monitoring of the specific connection to the remote host using the Ping tool The Ping tool works by sending ICMP echo request packets to the target host and listening for ICMP echo response replies If the specified number of replies is not received the tool reboots the device EdgeOS User Guide Chapter 3 Dashboard Tab Enable Watchdog Enable the use of Ping Watchdog IP Address To Ping Specify the IP address of the target host to be monitored by Ping Watchdog Ping Interval Specify the time interval in seconds between the ICMP echo requests that are sent by Ping Watchdog The default value is 300 seconds Startup Delay Specify the initial time delay in seconds until the first ICMP echo requests are sent by Ping Watchdog The default value is 300 seconds The Startup Delay value should be at least 60 seconds as the network interface and wireless connection initialization takes a considerable amount of time if the device is rebooted Failure
90. tes connected ai I cethi BB eth2 7 OSPF is enabled 10 1 254 1 areas 1 NAT is enabled Add VLAN La Ethernet VLAN Search active rules Description c Interface a Type IP Addr Status a Actions Firewall is enabled rulesets Internet eth0 ethernet 203 0 113 178 29 500 1 56 Mbps Connected Actions v rules 203 0 113 179 29 203 0 113 180 29 DHCP is enabled active servers inactive servers UniFi guest eth1 10 vlan 10 1 5 1 24 500 0 bps 0 bps Connected Actions v network production LAN eth1 ethernet 10 1 0 1 23 0 20 83 Mbps 13 04 Mbps Connected Actions v UniFi corporate eth1 20 vian 10 1 6 1 24 0 3 14 Mbps 8 31 Mbps Connected Actions v Routers network eth2 ethernet 10 1 254 1 24 00 9 80 Kbps 16 26 Kbps Connected Actions v UBNT Atlanta openvpn 0 Obps Obps Connected Actions v office UBNT LT office vtun1 openvpn 00 0 bps Obps Connected Actions UBNT LA office vtun2 openvpn 272 bps Obps Connected Actions v UBNT TW office vtun3 openvpn 00 303 30 Kbps 37 87 Kbps Connected Actions v Showing 1 to 9 of 9 entries Lnapter S Dasnnoerd Tap The following route types are listed The Dashboard tab displays status information about e Connected services and interfaces You can also configure interfaces and Virtual Local Area Networks VLANs Any setting Static marked with a blue asterisk is required RIP Routing Information Protocol Services e OSPF Open Shortest Path First Status information is displayed Each
91. tion network The IP address and subnet mask are displayed in slash notation e Next hop interface The name of the next hop interface is displayed Distance 1 255 Enter the administrative distance If there are identical routes from different sources such as static RIP and OSPF the EdgeRouter compares the routes and uses the route with the lowest distance e Enable Check the box to enable the route Click Save to apply your changes EdgeOS User Guide Black Hole Static Route Configuration Route type blackhole Destination network 192 168 0 0 23 Distance 1 255 e Route type The black hole route drops unwanted traffic Destination network The IP address and subnet mask are displayed in slash notation e Distance 1 255 Enter the administrative distance If there are identical routes from different sources such as static RIP and OSPF the EdgeRouter compares the routes and uses the route with the lowest distance e Enable Check the box to enable the route Click Save to apply your changes OSPF Using Link State Advertisements routers communicate with each other when there is a router or link status change Each router maintains the information in a database which is used to create and update a network map from the router s point of view Each router then uses the map to build and update a routing table FdgeMAX Wekomeubet to viat Router Router Router ID 10 1 254 1 Sav
92. tions button to access the following options e Edit Rules To configure the rules click Edit Rules Go to the Rules section in the next column e Configuration To configure the policy click Configuration Go to Configuration on page 24 e Interfaces To select interfaces and direction of traffic flow for your policy click Interfaces Go to Interfaces on page 24 e Stats To view statistics on firewall usage click Stats Go to Stats on page 24 e Copy Policy To create a duplicate click Copy Policy The Copy Firewall Ruleset screen appears Copy Firewall Ruleset Name Enter anew name for this policy Click Copy to confirm or click Cancel Delete Policy Remove the policy AN Ubiquiti Networks Inc Chapter 5 Security Tab Configure the Firewall Policy The Ruleset Configuration for _ screen appears Ruleset Configuration for LAN_IN Order Description Source Destination Protocol Action 1 Drop rogue mac address 00 16 b a3 ba 77 You have four tabs available e Rules see below mu e Configuration on page 24 Interfaces on page 24 Stats on page 24 Add New Rule To create a new rule click Add New Rule Go to Add or Configure a Rule on page 22 Save Rule Order To change the rule order click and drag a rule up or down the sequence and then release the rule When you are finished click Save Rule Order Rules A rule tells the EdgeRouter what a
93. ts are filtered in real time as soon as you type two or more characters A table displays the following information about each static MAC IP mapping Click a column heading to sort by that heading Name The name of the mapping is displayed MAC Address The MAC address of the DHCP client is displayed IP Address The IP address assigned to the corresponding MAC address is displayed Actions Click the Actions button to access the following options Config To configure the mapping click Config Go to Configure Static MAC IP Mapping on page 32 Delete Remove the selected mapping At the bottom of the screen you can click Delete to delete the DHCP server and its configuration 31 EdgeOS User Guide Configure Static MAC IP Mapping The Static MAC IP Mapping screen appears Static MAC IP Mapping ID a MAC Address 00 1b 21 bc 59 92 IP Address 10 1 1 148 Make changes as needed ID The name of this mapping is displayed MAC Address Enter the MAC address of the DHCP client IP Address Enter the IP address that should be assigned Click Save to apply your changes Details DHCP Server Internal Leases Static Map IP Mapping Subnet 10 1 0 0 23 Router 10 1 0 1 Poo Stasi seinen Range Start 10 1 0 21 DNS 10 1 0 1 488 358 1 3 0 Range End 10 1 1 252 Status Enabled DHCP Name Internal Subnet 10 1 0 0 23 Range Start 10 1 0 21 Range Stop 10 1 1 252 Router 10 1 0 1 The top
94. u click Config the OSPF Area Configuration screen appears OSPF Area Configuration Area ID 0 0 0 0 Area Type Normal sec Auth Type Off Network 10 1 254 0 24 10 1 0 0 23 10 1 200 0 24 10 242 1 0 24 10 1 5 0 24 10 1 6 0 24 Add New Make changes as needed e Area ID This is the number that identifies an area It can be an integer or use a format similar to an IPv4 address e Area Type This defines the routes that are acceptable inside the area Select the appropriate option Normal sec The default type accepts all routes NSSA ANSSA Not So Stubby Area network is a variation of a stub network It can import external routes from type 7 Link State Advertisements which are NSSA specific Stub The network has no external routes Typically it has a default route for outbound traffic e Auth Type Authentication helps secure communication between routers Select the appropriate option Off No authentication is used MD5 sec Each router uses a key password and key ID This is the most secure option because the key is never transmitted Plain text Each router uses a key This provides minimal security because the key is transmitted in plain text format EdgeOS User Guide e Network Enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 Click Add New to enter more network addresses Click Save to
95. urce IP address of the packets becomes the public IP address of the outbound interface Specify address and or port If enabled the source IP address of the packets becomes the specified IP address and port e Address Enter the IP address that will replace the source IP address of the outgoing packet You can also enter a range of IP addresses one of them will be used e Port Enter the port number that will replace the source port number of the outgoing packet You can also enter a range of port numbers one of them will be used Specify address and or port Address Port e Exclude from NAT Check the box to exclude packets that match this rule from NAT e Enable Logging Check this box to log instances when the rule is matched e Protocol Select one of the following All protocols Match packets of all protocols Both TCP and UDP Match TCP and UDP packets Choose a protocol by name Select the protocol from the drop down list Match packets of this protocol e Match all protocols except for this Match packets of all protocols except for the selected protocol Choose a protocol by name ah 3 _ Match all protocols except for this Enter a protocol number Enter the port number of the protocol Match packets of this protocol e Match all protocols except for this Match packets of all protocols except for the selected protocol Enter a protocol number _ Match all protocols except f
96. ure is displayed IP Addr The IP address of the interface is displayed MTU The MTU Maximum Transmission Unit value of the interface is displayed This is the maximum packet size in bytes that the interface can transmit TX The transmit speed of the interface is displayed RX The receive speed of the interface is displayed Status The connection status of the interface is displayed Actions Click the Actions button to access the following options e Config To configure the interface click Config If the interface is a physical port go to the Configure the Interface section If the interface is a VLAN go to Configure the VLAN on page 11 If the interface is a switch available for the EdgeRouter PoE only go to Configure the Switch on page 12 e PoE Available for the EdgeRouter PoE only To configure the PoE settings click PoE Go to Configure the PoE Settings on page 12 e Disable Disable the interface while keeping its configuration The switch interface cannot be disabled Note If you disable a port its PoE functionality remains This applies only to the EdgeRouter PoE e Delete Available for VLANs only Delete the VLAN from the EdgeRouter configuration AN Ubiquiti Networks Inc Chapter 3 Dashboard Tab Configure the Interface After you click Config the Interface Configuration screen appears Interface Configuration for eth1 Description Internet Enable TA
97. ve three sub tabs DHCP Server Configure DHCP servers to implement different subnets on the independent interfaces DNS Configure DNS forwarding so the EdgeRouter receives all LAN DNS requests and forwards them to the service provider s DNS server PPPoE Server Configure the PPPoE server so a remote PPPoE client can establish a tunnel to the EdgeRouter for network access DHCP Server A DHCP server assigns IP addresses to DHCP clients You can configure multiple DHCP servers to assign IP ranges in different subnets on the different interfaces Add DHCP Server To create a new DHCP server click Add DHCP Server AN Ubiquiti Networks Inc Chapter 6 Services Tab The Create DHCP Server screen appears Create DHCP Server Complete the following e DHCP Name Enter a name for this DHCP server e Subnet Enter the IP address and subnet mask using slash notation lt network_IP_address gt lt subnet_mask_number gt example 192 0 2 0 24 e Range Start Enter the starting IP address of the range e Range Stop Enter the last IP address of the range e Router Enter the default route of the DHCP clients The DHCP clients route all packets to this IP address which is the EdgeRouter s own IP address in most cases e DNS 1 Enter the IP address of the primary DNS server Your ISP may provide this information or you can use Google s DNS server at 8 8 8 8 e DNS 2 Enter the IP address of the secondary DNS server e Enab

EdgeOS User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents