User Tools

Site Tools


wiki:quick_startup_guide

Quick startup guide

How to install packages for the RAN ?

For Wanesy RAN connectivity, we recommend to install the latest version of the packages specified in the compatibility matrix (depending of the RAN release version) that you can find here: Software Releases:

  • Firmware package
  • BSCC package
  • SNMP package
  • HAL package
  • Packet Forwarder package
  • OpenVPN package

To obtain the specific OpenVPN package for your gateway, please contact support@kerlink.fr

Install can be performed either over the network, either by USB.
You need also a local debug link or open a SSH session in order to send commands to the gateway and get the feedback.

Package installation procedure is described on the product dedicated wiki page :

We recommend to follow the procedure below :

  1. Install the firmware package
  2. Install RAN packages : BSCC / SNMP / OpenVPN
  3. Check the VPN connection to the RAN
  4. Install HAL & Packet Forwarder packages : LORA HAL / SPF
  5. Check Packet Forwarding
Note that for Step 4, you can install packages from the RAN Dashboard interface using the the Drag&Drop feature.
Refer to the section Software update to know how to proceed.


How to update packages for the RAN ?

Preconditions: Before proceeding to the update, check that all your software packages are at the software level (version number) indicated in the compatibility matrix: Software Releases

There are 3 ways to update your gateway:

  • via the RAN Dashboard interface (recommended)
  • over the network
  • via an USB key

Update via the Dashboard interface

Since you are already connected to the RAN, you can update your packages through the Dashboard interface via the Drag&Drop area: refer to the Software update page to know how to proceed.

Update over the network or via USB

Install the new version by following the procedure described above for packages installation. OpenVPN package does not need to be re-installed in the system. Refer to the specific Wiki to get details about the procedure to remove a package from the system.

Upgrading the packet Forwarder will remove all your Packet Forwarder's configuration data (config.json)
Please save it or copy files to a well-known location (ex /user/my_backup) before proceeding to the update
Take care if your Wirnet Station's firmware is 2.x and if you choose to upgrate your gateway via a remote manner, you must install a specific dota to upgrade your firmware. Refer to the Wirnet Station section to get some details about the procedure to follow.


Checking configuration

You can either check all points in the checklist either check the 2 following points to go faster.


Checking VPN connection to the RAN


Type an ifconfig command and check that the vpn0 interface has been created. On failure, refer to the troubleshooting section.

Via the Dashboard interface

Your gateway must be declared in an existing fleet (create it first if necessary) using its EUI in the administration menu.

This EUI can be found in the field gateway_ID of the generated JSON file (you need obviously a local or remote access to the gateway):

  • For Wirnet station : grep gateway_ID /mnt/fsuser-1/spf/etc/local_conf.json
  • For Wirnet iBTS : grep gateway_ID /user/spf2/etc/config.json
  • For Wirnet iFemtoCell : grep gateway_ID /user/spf/etc/local_conf.json

Once the station has been added to an existing fleet, select the BSC menu and select your fleet. http://wikikerlink.fr/wanesy-ran/doku.php?id=wiki:bsc

The Gateway should appear in the list of stations and its status should be “Connected”. Wait few minutes and force F5 page refresh if not the case. In case of persistent issue, refer to the troubleshooting section.


Checking Packet Forwarding


Connect to the gateway via SSH command.

Then, check LoRa packet-forwarder configuration file :

  • For Wirnet station : /mnt/fsuser-1/spf/etc/global_conf.json
  • For Wirnet iBTS : /user/spf2/etc/config.json
  • For Wirnet iFemtoCell : /user/spf/etc/global_conf.json

Parameters to check are :

  • server_address: lns (or “172.18.0.1” if you experience issues or if the support team asked you to do so)
  • serv_port_up: 1700
  • serv_port_down: 1700

Check packet forwarder logs:

  • For Wirnet station : /mnt/fsuser-1/spf/var/log
  • For Wirnet iBTS : /user/spf2/var/log/
  • For Wirnet iFemtoCell : /user/spf/var/log

Via the dashboard interface

In the administration menu :

  • Declare a new cluster if the test cluster does not exist
  • Declare a test endpoint in this cluster
  • Select your gateway EUI in the BSC/Stations menu and copy it to the clipboard
  • Select your gateway in the LNS/Stations menu using filtering function and paste EUI
  • check traffic messages (Last Rx messages)
wiki/quick_startup_guide.txt · Last modified: 2018/01/31 11:45 by tda