| search |
OSBManager User Manual
ver. 2.00b1
OSBManager is a Microsoft Windows GUI utility used to configure OSBRiDGE devices.
Currently supported (as of OSBMAnager v2.00b1) devices, min. firmware revisions:
OSBRiDGE 5XLi, 5GXi, 5XL - firmware ver. 4.00b9 or later
Initial Login Screen
After running the application the initial screen looks as follows:
Please enter username and password, then press submit to log to the device.
Alternatively you can double click on the device from the list on the left part of the page and IP Address, Login and Password will be automaticaly copied to the tab on the right.
Resetting device to default settings
This tab allows resetting of your OSBRiDGE device to factory default settings. After pressing the "Search Devices" button you will see all OSBRiDGE devices available in your local subnetwork. Select the one you want to reset to factory default settings, enter password and press "Reset to default" button.
Firmware Upgrade
The Upgrade Firmware tab allows upgrading firmware on your OSBRiDGE devices.
System Information
System Information tab shows information about system hardware and operational parameters:
Device Information:
Device Type – Device type you are logged into.
MAC Address – Device MAC address.
Firmware Version – Current firmware version.
Hardware Revision – Device Hardware revision.
Regulatory Domain – Currently configured regulatory domain.
Connection Information:
Status – Connected – device is currently connected to an Access Point or other device when operating in PtP Bridge mode.
Searching for Network – the connection has not yet been established.
BSSID – MAC address of the Access Point or network peer this device is currently connected to.
Signal Strength – Signal Strength as seen by the device.
Noise Level – Noise Level as seen by the device.
Operational Rate – Bit data rate at which device sends packets to the Access Point.
TX Packets – Number of data packets that have been sent to the Access Point.
RX Packets – Number of data packets that have been received from the Access Point.
TX Bytes – Number of bytes sent to the Access Point.
RX Bytes – Number of bytes received from the Access Point.
Ethernet Speed – Current Ethernet port connection speed (or No Connection if ethernet port is not connected).
Operational Settings:
Device Name - System Name for easy identification of the OSBRiDGE 5XLi/5GXi unit.
WLAN Operational Mode – Wireless LAN Operational mode the device has been configured to operate.
Available modes are:
Infrastructure Client - Client mode for 3rd party 802.11a compatible Access Points. To achieve compatibility with all 802.11a Access Points the so-called MAC address NAT is being performed for all traffic originating from this device and going out on the wireless interface.
Polling Client - Client for OSBRiDGE devices using OSBRiDGE proprietary polling TDMA protocol.
AP Client - Client for OSBRiDGE 5G and other 3rd party compatible devices operating in Access Point mode. In this mode full MAC address passthrough is achieved between bridged ethernet segments.
PtP Bridge Master - Master device when configured to operate as point to point wireless bridge.
PtP Bridge Slave - Client device when configured to operate as point to point wireless bridge.
WDS Client - Client mode for Mikrotik RouterOS based Access Points. In this mode full MAC address passthrough is achieved between bridged ethernet segments.
IP Operational Mode – Network mode the device has been configured to work with. Available modes are Bridge, Router and NAT Router.
Uptime – Time the device has been up and running since last reboot.
System Load – Average number of processes in the queue waiting for CPU time, over the last 1, 5, and 15 minutes.
ESSID - An ESSID is the name of a wireless network. All wireless devices on a common wireless network must employ the same ESSID in order to communicate with each other.
Frequency – The frequency the device is currenly operating on.
Channel Width – Channel width the device is configured to operate. Available values, depending on configured Regulatory Domain, are 20 MHz (standard width), 10 MHz (half width), 5 MHz (quarter width) and 40 MHz (802.11a Turbo mode).
Preferred BSSID – MAC Address of the Access Point or network Peer this device should connect to. If set to 00:00:00:00:00:00 then only ESSID is taken into account when connecting to the Access Point.
PPPoE Authorization – Disabled or Enabled.
PPPoE Link Status – If the OSBRiDGE device succesfuly established PPPoE connection to the PPPoE concentrator the status will show Connected. Otherwise it will show Not Connected.
Fragmentation Threshold - The size at which WLAN packets are fragmented.
RTS Threshold - Minimum packet size to require RTS (Request To Send) handshaking limiting on-the air collisions. For packets smaller than this threshold, RTS is not sent and the packet is transmitted directly to the WLAN. For packets larger than this threshold the RTS/CTS handshaking is established.
WLAN Speed – Configured fixed wireless interface Transmit Data Rate or Auto for automatic speed selection.
Supported Data Rates – Wireless Data rates the device supports.
Available Data Rates are:
6, 9, 12, 18, 24, 36, 48 and 54 Mbps for regular 802.11a mode (20 MHz channel width),
12, 18, 24, 36, 48, 72, 96 and 108 Mbps in 802.11a Turbo mode (40 MHz channel width),
3, 4.5, 6, 9, 12, 18, 24 and 27 Mbps for 802.11a mode with 10 MHz channel width,
1.5, 2.25, 3, 4.5, 6, 9, 12 and 13.5 Mbps for 802.11a mode with 5 MHz channel width.
Supported Frequencies – List of supported frequencies for currently configured Regulatory Domain.
Distance to the Access Point – Configured distance between OSBRiDGE device and the Access Point (or other Wireless Bridge) it is connecting to.
IP Address – Device IP address.
Subnet Mask – Currently defined subnet mask.
Default Gateway – Currently defined default gateway.
DHCP – Whether built in DHCP (Dynamic Host Configuration Protocol) server or client is disabled or enabled.
Traffic Shaping – If enabled then device will use traffic shaping to limit data according to defined rules. If disabled then there will be no data traffic limiting.
Firewall – If enabled then device will use build in firewall to pass/block traffic according to the defined rules. If disabled then there will be no packet filtering.
Web Server on Port - Port number the build-in web server currently runs on.
Watchdog – Disabled or Enabled, depending on current Watchdog configuration.
Web Login Timeout – Timeout after which web session times out and requires re-logging in order to manage or monitor the device.
General Settings
Regulatory Domain – Please select regulatory domain that is most appropriate to your location.
Supported Regulatory Domains and allowed frequency ranges are defined as follows:
Europe – 5500 – 5700 MHz with DFS, 20 MHz, 10 MHz and 5 MHz selectable channel widths
OFCOM UK – 5735 MHz, 5755 MHz, 5775 MHz, 5835 MHz with DFS, 20 MHz, 10 MHz and 5 MHz selectable channel widths
USA – 5745 - 5825MHz, 20 MHz, 10 MHz and 5 MHz selectable channel widths
Far East & Africa – 4920 – 6100 MHz (236 channels), 40 MHz, 20 MHz, 10 MHz and 5 MHz selectable channel widths.
Device Name - This is the system name for easy identification of the OSBRiDGE device.
ESSID - An ESSID is the unique name shared among all peers in your wireless network. The name must be identical for all devices and points attempting to connect to the same network. It shall be up to 32 characters length.
Preferred BSSID - BSSID corresponds to the MAC Address of the Access Point or Wireless Bridge you want to connect to. Using 00:00:00:00:00:00 as BSSID will make the device connect to any Access Point based on correct ESSID only.
WLAN Operational Mode - Wireless LAN Operational mode for the device. Available modes are:
Infrastructure Client - This mode allows connection to any 802.11a based Access Point.
Polling Client – This mode allows connection to OSBRiDGE device, utilizing proprietary OSBRiDGE Polling Wireless MAC Protocol, that has been specifically optimized for high performance outdoor networks.
AP Client – This mode allows connection to OSBRiDGE or any 3rd party compatible device operating as Access Point. Full Layer-2 MAC address passthrough is provided using this option in IP Bridge mode.
PtP Bridge Master – This mode allows creation of a point to point connection with another OSBRiDGE device operating in tP Bridge Slave (or Client) mode.
PtP Bridge Slave – This mode allows creation of a point to point connection with another OSBRiDGE device operating in PtP Bridge Master mode.
WDS Client – This mode allows connection to Mikrotik RouterOS based Access Points. In this mode full MAC address passthrough is achieved between bridged ethernet segments.
Channel Width – The channel width device uses - depending on configured Regulatory Domain available values are 20 MHz (default), 10 MHz and 5 MHz or 40 MHz (Atheros Turbo mode).
Carrier Sense - Default 802.11 carrier sense type or disabled.
IP Operational Mode
Bridge - Bridge works at OSI model Layer 2. This means it does not know anything about protocols, but just forwards data depending on the destination address in the data packet. This address is not the IP address, but the MAC (Media Access Control) address that is unique to each network adapter card. With a Bridge, all your computers are in the same network subnet, so you don't have to worry about not being able to communicate between computers or share an Internet connection. The only data that is allowed to cross the bridge is data that is being sent to a valid address on the other side of the bridge.
Router - Router is an OSI model Layer 3 device, and forwards data depending on the network address, not the hardware (MAC) address. For TCP/IP networks this means the IP address of the network interface. Routers isolate each LAN into a separate subnet. Routers provide bandwidth control by keeping data out of subnets where it doesn't belong, however routes need to be set up before they can get going.
NAT Router – This mode is similar to the Router mode only that all traffic coming on wired interface and going out on wireless interface is masqueraded. Masquerade allows a set of machines to invisibly access the Internet via the gateway (OSBRiDGE device in this case). To other machines on the Internet, all this outgoing traffic will appear to be from the OSBRiDGE device itself. In addition to the added functionality, IP Masquerade provides the foundation to create a fairly secure networking environment.
DHCP – Enable or disable built in DHCP client/server.
DHCP Relay – In IP Router/NAT Router mode enable DHCP Relay so DHCP requests coming from the LAN subnetwork will be relayed to the WLAN subnetwork and DHCP Server replies will be relayed back to the LAN interface. If no specific DHCP server IP address is configured (default value 0.0.0.0) then DHCP requests will be relayed to any DHCP server on the WLAN address. If the DHCP server IP address is configured then all DHCP requests will be relayed to that particular DHCP server.
Firewall – Enable or disable built in packet filtering firewall.
PPPoE Authorization – Enable or disable built in PPPoE client:
1. In IP Bridge mode, if PPPoE is enabled, the device will authorize itself to the PPPoE concentrator and establish a PPP link to it. Ethernet traffic will be bridged as usual.
2. In IP Router/NAT Router mode, if PPPoE is enabled, the OSBRiDGE device will authorize itself to the PPPoE concentrator and establish a PPP link to it – over the wireless interface in the Access Point Client mode or over the wired interface in the Access Point mode, PPPoE link will be then used as a default gateway by the device. While operating in Router/Access Point Client all traffic originating from the wired LAN subnetwork will be transported over PPPoE link to the PPPoE concentrator.
PPPoE Username/Password – A PPPoE Username and Password that are required to create PPP link to the PPPoE concentrator. Currently supported PPPoE authorization types are CHAP, PAP, MSCHAP and MPPE.
Watchdog – If enabled then OSBRiDGE device will send 3 ICMP Echo Requests to the configured IP address, each in 60 seconds interval. If there is no single ICMP Echo Reply to any of these requests, then the device will reboot itself.
The device also has independent hardware watchdog built in, that checks for critical operational parameters and reboots the device, should the system hang or become unstable. That watchdog works all the time, regardless of the ping watchdog configuration.
Run Web Server on Port – Enter the port the build-in Web server should be configured to run on.
Web Login Timeout – Enter the value the management Web session should be kept alive without any action from the user.
Reset to Default Password – Password that is used to reset device to factory default settings using OSReset software.
NTP Server – Configure IP address of the external NTP (Network Time Protocol) server OSBRiDGE device will obtain current time from at startup time.
ETH Speed – LAN Port connection speed - available values are Auto (Auto Negotiation), 100Mbps FDX, 100Mbps HDX, 10Mbps FDX, 10Mbps HDX.
Last Good Config - If Enabled then device will keep copy of previously used configuration and directly after reboot, if the built in watchdog triggers reset, will revert back to that configuration.
Packet Aggregation - Packet Aggregation feature is used to join a number of small packets into a big one. Normal Internet traffic usualy uses large number of small packets instead of big ones, therefore enabling this option greatly increases system performance and reliability. This option is available only when operating in Point to Point Bridge mode.
IP Settings
Wired Interface IP – Enter IP address of the wired interface here.
Wired Interface Mask – Enter wired network subnet mask here.
Wireless Interface IP – Enter IP address of the wireless interface here.
Wireless Interface Mask – Enter wireless network subnet mask here.
Default Gateway – IP address of a router where traffic not destined for defined routes / local routes will be forwarded.
Defined Routes – This table displays currently defined static routes. To delete a route select "Delete" checkbox and press Submit on the bottom of the page. Please note that it is not possible to delete first two entries – direct routes to local interfaces.
Add Route:
Direct – on wired or wireless interface - When router has two or more IP subnets directly attached to its different interfaces, it can route IP packets between those subnets using a direct route. A direct route consists of an IP Address which specifies the basic IP address to route, a Subnet Mask which defines the class of IP addresses that will be routed, and an interface which specifies where the IP subnet is attached. When an IP packet addressed to a system on the directly routed subnet arrives at the router, the router will send it directly to the target machine on the interface specified. When entering direct route use 0.0.0.0 as Gateway.
Indirect - When router needs to send IP packets between IP subnets which are not directly connected to one of its interfaces, it must have an indirect route for sending those packets. An indirect route consists of an IP Address which specifies the basic IP address to route, a Subnet Mask which defines the class of IP addresses that will be routed and a Gateway that will relay the IP packet. When an IP packet addressed to a system on the indirectly routed subnet arrives at the router, the router will route it over to the specified Gatway to be routed further.
When operating in Bridge mode the Wired Interface IP/Mask addresses are used to provide access to the device. Since all traffic passing through the device is bridged in the OSI Layer 2 the Wired Interface IP settings are not used.
Advanced Settings
Fragmentation Threshold – Enter the size at which the packets will be fragmented.
RTS/CTS Threshold – Enter the minimum packet size to require RTS (Request To Send) handshaking limiting on-the air collisions. For packets smaller than this threshold, a RTS is not sent and the packet is transmitted directly to the WLAN. For packets larger than this threshold the RTS/CTS handshaking is established. This value should only be changed when operating as an Access Point Client.
Distance to the Peer – Configure distance between this OSBRiDGE device and the Access Point (or other bridge when operating as PtP Bridge) it is connecting to. Please use integer value rounded up.
It is very important to enter proper distance value here. If this value is set too low then the link performance will be severely affected and not working properly. Entering too high value is safer, however if the value is much higher than the real distance then the link speed may be affected.
TX Power - By default, the OSBRiDGE 5XLi/5GXi transmits data at the maximum output power for the regulatory domain selected and frequency used. With Transmit Power Control (TPC), you can adjust the output power of the unit to a lower level in order to reduce interference from neighboring devices.
WLAN Speed – Choose Data Rate the device will support while connecting to the Access Point.
Available Data Rates are:
6, 9, 12, 18, 24, 36, 48 and 54 Mbps for regular 802.11a mode,
12, 18, 24, 36, 48, 72, 96 and 108 Mbps in 802.11a Turbo mode,
3, 4.5, 6, 9, 12, 18, 24 and 27 Mbps for 802.11a mode with 10 MHz channel width,
1.5, 2.25, 3, 4.5, 6, 9, 12 and 13.5 Mbps for 802.11a mode with 5 MHz channel width.
Data Encryption – Enable or Disable over the air OSBRiDGE proprietary data Encryption here. This encryption scheme works only between compatible OSBRiDGE devices.
Encryption – Please select generic WLAN encryption scheme: WEP, WPA-PSK TKIP or WPA-PSK CCMP (AES).
WEP Key – Enter WEP encryption key here. Keys are entered as hexadecimal numbers in following format:
64 bit WEP: xxxx-xxxx-xx
128 bit WEP: xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xx
156 bit WEP: xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx
Pre-shared WPA Key – the key is entered as 8-63 characters long string, ie. OSBRiDGE.
Supported Data Rates – Enable or Disable WLAN specific data rates the OSBRiDGE device should advertise as supported when establishing communication with other device.
VLAN Settings
Use Management VLAN – If this option is enabled then it will be possible to access this device for management (via HTTP, SNMP, etc.) only using configured VLAN ID. Please note that even if this option is enabled it will still be possible to reach this device on the ethernet side using OSReset (no IP address will be shown though).
Tagging all traffic - If enabled then all traffic traversing through the bridge and going out of the wireless interface will be tagged with specified VLAN ID. All traffic coming to the bridge on the wireless interface, that is tagged with this specified VLAN ID, will also be untagged by the bridge before forwarding it out on the ethernet interface.
VLAN Filtering - This option allows to choose which VLAN IDs can traverse through the wireless bridge and which ones should be dropped.
QOS Settings
When the device operates in Access Point Client, Infrastructure Client or Polling Client mode the built-in traffic shaper allows you to set up different data flow speeds for it’s clients –
In IP Bridge Mode - based on MAC Address,
In IP Router Mode - based on IP Address or IP Subnetwork.
Downlink – In Access Point mode this is speed of the data going out of the wireless interface. In Access Point Client mode this is speed of the data going out of the wired interface.
Uplink – In Access Point mode this is speed of the data going out of the wired interface. In Access Point Client mode this is speed of the data going out of the wireless interface.
Total Downlink Speed - Cumultative speed the data can flow through the device.
Total Uplink Speed - Cumultative speed the data can flow through the device.
High Priority Traffic - Size that will be reserved for high priority queue and sent before any other traffic. High Priority traffic is defined as traffic from VOIP applications and other types of applications requiring low latency for correct operation.
Default Priority Traffic - Size that will be reserved for default priority queue from which data is sent after the High Priority queue is empty. Default Priority traffic is defined as traffic originating from well known services (http, smp, pop3, ssh etc.) which should be prioritized but is not as latency dependent as high priority traffic.
Low Priority Traffic - Size that will be reserved for all traffic that does not fall into other queues.
Per User QOS - If enabled then individual entries from the table below will be used for further configuration of the traffic shapping.
Table QOS Entries
Enabled – If selected then this particular entry is enabled, in not selected then that entry is disabled.
Description - Entry description.
Type - MAC Address or IP Address.
Address – For MAC Address enter it as xx:yy:xx:yy:xx:yy. For single IP Address enter it as x.x.x.x/32, or if you want to limit speed for whole subnetwork enter it as x.x.x.x/y (ie. 192.168.0.0/24 if you want to limit all IP addresses within 192.168.0.0 - 192.168.0.255 range).
Downlink Speed – Queue size for all packets matching defined IP/MAC Address.
Uplink Speed - Queue size for all packets matching defined IP/MAC Address.
High Down/Up - Queue size for high priority traffic in format xx:yy, where xx is percentage of the queue size that will be guaranteed for high priority traffic and yy is percentage of queue size that can be used if queue is not used by other kind of traffic.
Default Down/Up - Queue size for default priority traffic in format xx:yy, where xx is percentage of the queue size that will be guaranteed for default priority traffic and yy is percentage of queue size that can be used if queue is not used by other kind of traffic.
Low Down/Up - Queue size for low priority traffic in format xx:yy, where xx is percentage of the queue size that will be guaranteed for low priority traffic and yy is percentage of queue size that can be used if queue is not used by other kind of traffic.
Firewall Settings
Built in Firewall allows you to pass or block traffic going through the device, based on selected criteria.
There are two tables shown on the configuration screen. "Ethernet" table shows currently defined firewall rules for the wired interface of the OSBRiDGE device. "Wireless" table shows currently defined rules for the wireless interface. You can delete existing firewall rule by selecting "Delete" checkbox on the right side of the rule and pressing Submit button.
Define New Rule (IP Bridge Mode):
Interface – Select the incoming interface the rule should apply to. Choose either Ethernet or Wireless interface.
Action – Select what to do with the packet matching the rule. You can either pass that packet through, or block it.
Protocol – Enter the number representing IP Protocol that should be matched. Use "*" to match all protocols. Most common numbers are:
"*" – All IP protocols
1 – ICMP protocol
6 – TCP protocol
17 – UDP protocol
For complete list of protocols please see Appendix 1 of this document, or go to: http://www.iana.org/assignments/protocol-numbers
Source – Source MAC address of the packet to be matched. Use "*" to match any MAC address.
Source Port – Source port of the packet to be matched. Use "*" to match any source port.
Destination – Destination MAC address of the packet to be matched. Use "*" to match any MAC address.
Destination Port - Destination port of the packet to be matched. Use "*" to match any destination port.
Define New Rule (IP Router Mode):
Interface – Select the incoming interface the rule should apply to. Choose either Ethernet or Wireless interface.
Action – Select what to do with the packet matching the rule. You can either pass that packet through, or block it.
Protocol – Enter the number representing protocol that should be matched. Use "*" to match all protocols. Most common numbers are:
"*" – All IP protocols
1 – ICMP protocol
6 – TCP protocol
17 – UDP protocol
For complete list of protocols please see Appendix 1 of this document, or go to: http://www.iana.org/assignments/protocol-numbers
Source – Source IP address or IP subnet (in x.x.x.x/y format) of the packet to be matched. Use "*" to match any IP address.
Source Port – Source port of the packet to be matched. Use "*" to match any source port.
Destination – Destination IP address or IP subnet (in x.x.x.x/y format) of the packet to be matched. Use "*" to match any IP address.
Destination Port - Destination port of the packet to be matched. Use "*" to match any destination port.
DHCP Settings
If DHCP server is enabled then you can configure it’s operational parameters on this tab.
Server Enabled on Interface – Choose the interface the DHCP server should listen for requests on. You can choose Wired or Wireless interface or both.
Offered IP Starting Address – First IP address from the range that will be provided to hosts requesting DHCP server to provide them an address.
Offered IP Ending Address – Last IP address from the range that will be provided to hosts requesting DHCP server to provide them an address.
Default Subnet Mask – Subnet Mask that will be provided to hosts requesting IP information.
Default Gateway IP – Gateway IP address that will be provided to hosts requesting IP information.
First DNS Server IP – First DNS IP address that will be provided to hosts requesting IP information.
Second DNS Server IP - Second DNS IP address that will be provided to hosts requesting IP information.
Lease Time in Minutes – Lease time the information received from DHCP service is valid. After that time computer that has requested the DHCP server to provide it IP addres information will automaticaly request that information again.
Static Mapping – This option allows static mapping of MAC addresses to specific IP addresses offered by DHCP server.
Port Forwarding
When the device is operating in Access Point Client and IP Router/NAT Router mode this tab will let you configure port forwarding from external (WLAN) interface to the host available on the internal (ethernet) interface.
Each forwarding rule consists of:
Application - Description of the application the rule applies to.
Port - Port on the external (WLAN) interface - when connection is made to that port it will be forwarded to defined IP address.
Protocol - protocol type this rule applies to - TCP, UDP or both TCP and UDP.
IP Address - IP address on the internal (ethernet) interface connection will be forwarded to.
Enabled - select che ckbox to enable the rule or leave it not selected to disable the rule.
Device Security
Use this tab to change password which is used to access and configure the device.
Syslog Settings
This tab allows device events logging to remote Syslog server.
Syslog Server IP - IP Address of the computer where Syslog server is running.
Syslog Server Port - Port the Syslog server is listening on.
Log Messages - Enable or disable logging for specific events:
Device Startup - save an event when the device has started.
Firmware Upgrade - save an event when firmware upgrade was performed on the device.
Device Reboot - save an event when device is rebooting.
Admin Log In - save an event when user admin logged to device via WWW.
DHCP Server Lease - save an event when the built in DHCP server leased an IP address to the client (event will contain MAC address of the network card build into computer that obtained the lease).
Realtime Signal Strength Reading
If you are logged to a device then this tab shows signal level graph in the realtime read from the device.