This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:spf [2018/05/04 16:35] bdu clearer documentation |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Packet forwarder ====== | ||
- | |||
- | ===== What is the packet forwarder ===== | ||
- | |||
- | The packet forwarder is a program running on the host of a Lora gateway. It forwards RF packets received by the gateway to a server through an UDP/IP link, and emits RF packets that are sent by the server. | ||
- | |||
- | Every X seconds the program displays statistics about the received and sent RF packets, and about the received and sent network datagrams. The program also sends a few statistics to the server in JSON format. | ||
- | |||
- | For a full packet forwarder description and the way it works, read the "Semtech readme file" available in each packet forwarder [[wiki:resources#semtech_packet_forwarder_v2|resource page]]. | ||
- | |||
- | ===== How to install the packet forwarder? ===== | ||
- | |||
- | - Choose the packet forwarder to install from the [[wiki:resources#semtech_packet_forwarder_v2|resource page]]. Choosing the latest version of the packet forwarder is recommended. | ||
- | - Retrieve the matching firmware and FPGA packages (check compatibility on the packet forwarder page). Update them if necessary (see [[wiki:sw_updates|software updates page]]). | ||
- | - Download the packet forwarder precompiled ''.ipk'' file. | ||
- | - Install the ''.ipk'' file using the instructions of the [[wiki:sw_updates|software updates page]]. | ||
- | - Edit the packet forwarder configuration. | ||
- | |||
- | |||
- | ===== How to configure and monitor the packet forwarder? ===== | ||
- | |||
- | * [[wiki:loraloc_spf-5.1.0| Wirnet™ iBTS Packet Forwarder v5.1.0 - instructions (February 2018)]] | ||
- | |||
- | * [[wiki:loraloc_spf-4.0.0| Wirnet™ iBTS Packet Forwarder v4.0.0 - instructions (June 2017)]] | ||
- | |||
- | * [[wiki:loraloc_spf-3.3.1| Wirnet™ iBTS Packet Forwarder v3.3.1 and lower - instructions (January 2017)]] | ||
- | |||
- | The associated Semtech HAL is indicated in the name of IPK: | ||
- | |||
- | * ''packet-forwarder-v2_<version>-**<HAL>**_klk_lpbs.ipk'' | ||
- | |||
- | ===== Firewall configuration ===== | ||
- | |||
- | <note warning> | ||
- | Due to firewall modifications in firmware v3.3.3, the packet forwarders, version 5.1.0 and lower, need to be specially configured for this firmware version. | ||
- | |||
- | Indeed, rules are loaded at boot time and the last rule instruction is to reject all traffic. The packet forwarder configuration used to //append// rules to the tables, meaning that they are ignored. | ||
- | </note> | ||
- | |||
- | |||
- | Modify the firewall rules in the file ''/user/spf2/bin/execute_spf2.sh''. | ||
- | |||
- | In this file, the rules must be set with ''iptables -I'' (//insert//) instead of ''iptables -A'' (//append//). | ||
- | |||
- | The following commands will correctly adapt the script ''/user/spf2/bin/execute_spf2.sh'': | ||
- | |||
- | <code bash> | ||
- | sed -i "/null/ s/-A/-I/" /user/spf2/bin/execute_spf2.sh | ||
- | /etc/init.d/firewall restart | ||
- | monit restart spf2 | ||
- | </code> | ||