User Tools

Site Tools


Sidebar

WMC v3.x wiki


Introduction


Quick Start


System Management


Network Management


SNMP


Push


LoRa features


GMS API


Troubleshooting


Gateway software resources

WMC 3.2:

Previous version

Server software resources

WMC 3.2:

Previous version


FAQ

WMC 3.x:

WMC 3.0:

WMC 3.1:

>= WMC 3.2:

>= WMC 3.1:

wiki:wiki3:gateway_sw_3.3

This is an old revision of the document!


v3.3 Gateway Software Release

This version is designed to connect Kerlink products except the Wirnet Station to WMC server 3.2 or greater
They are not intended to be used with WMC servers 2.3, 3.0 or 3.1.

There are 3 ways to do that:

Download

Product Package md5sum
All products except Wirnet Station wmc_embedded_keros_v3.3.5.tar.gz 0696a403d25d2a1739c263cea0ecc875

The content of this package is listed below:

Component Version
keros 4.2.2
bscc 3.3.3
lorasnmp 3.3.2
lorad 1.2.2-2
lorafwd 1.1.2-1
kerlink-openvpn-wmc-config 4.3


USB usage

This procedure used for automatic deployment can be used to UPGRADE from a KerOS 4.x system on a single or a group of gateways.

To update/connect your system from a KerOS 4.x system, use the following software:

description file md5sum
USB stick AUTO_DEPLOY_3.3.5_KEROS_USB_STICK.tar.gz b1a144d2cf9ec866b4c6fd97f44a2c7c

The .tar.gz file provided above is “ready-to-use”. You only need to copy your OpenVPN packages on the USB stick: your OpenVPN secrets files in vpn_packages directory and your OpenVPN config file in the COMMON directory to be able to connect properly to your WMC server.


To update your gateway, apply the following procedure:

  1. Unpack the tarball file ('.tar.gz') to get files (README.txt, usb.autorun, …) and put all files on your USB stick in the root directory
  2. Request your VPN package(s) to the Kerlink Support team: support@kerlink.fr (optional: in case of a First Install or Migration)
  3. Put your VPN config package in the COMMON directory to connect to YOUR WMC server (optional: in case of a First Install or Migration)
  4. Put your VPN secrets packages of your KerOS products in the vpn_packages directory (optional: in case of a First Install)
  5. Plug the USB stick in the gateway USB slot (device must be powered on)
  6. Wait the end of the update (Status led flashes quickly)
IT IS VERY IMPORTANT TO WAIT FOR THE LED FLASHING TO NOT BRICK THE GATEWAY

Refer to the specific wiki to get more details about software update over USB:
Wirnet Product Line (iBTS, iFemtocell, iStation)

The USB tree should contains the following files/folders:

/
├── COMMON                                                                # Common packages folder (all products)
│   ├── keros_***_klkgw.ipk                                               # Keros firmware package 
│   ├── bscc_***_klkgw.ipk                                                # WMC BSCC package 
│   ├── lorasnmp_***_klkgw.ipk                                            # WMC SNMP package 
│   ├── lorad_***_klkgw.ipk                                               # HAL daemon package
│   ├── lorafwd_***_klkgw.ipk                                             # Packet Forwarder package
│   └── kerlink-openvpn-wmc-config_***.ipk                                # Defaut OpenVPN configuration (to be replaced by provided packages in case of First install or migration)
├── README.txt                                                            # This file
├── usb.autorun                                                           # executed by KerOs products when plugging the USB stick
├── usbkey.txt                                                            # USB key protection: must contain the device passwords (all of them)
└── vpn_packages                                                          # WMC OpenVPN packages folder
    ├── kerlink-openvpn-secrets-***_wmcbeta.wanesy.com_***.ipk            # OpenVPN package for one KerOS product to connect to a WMC platform (here wmcbeta)
    ├── kerlink-openvpn-secrets-***_wmcbeta.wanesy.com_***.ipk            # another package for one KerOS product to connect to a WMC platform (here wmcbeta)
    ├── kerlink-openvpn-secrets-***_wmcbeta.wanesy.com_***.ipk            # ...
    ├── kerlink-openvpn-secrets-***_wmcbeta.wanesy.com_***.ipk            # ...
    ├── kerlink-openvpn-secrets-***_wmcbeta.wanesy.com_***.ipk            # ...
    ├── kerlink-openvpn-secrets-***_wmcbeta.wanesy.com_***.ipk            # ...
    └── kerlink-openvpn-secrets-***_wmcbeta.wanesy.com_***.ipk            # ...



Ethernet usage

This procedure can be used to UPGRADE from a KerOS 4.x system on a single gateway.

To update your gateway, apply the following procedure:

  1. Request your VPN package(s) to the Kerlink Support team: support@kerlink.fr (optional: in case of a First Install or Migration)
  2. Transfer package(s) in this directory:
    # From a computer:
    scp WMC_embedded_keros_v3.3.5.tar.gz openvpn-*.ipk root@<ip_address>:/user/.updates/
  3. Deflate archive and ensure file is correctly written:
    # On the gateway:
    cd /user/.updates
    tar -xzf *.tar.gz
    rm -f WMC*.tar.gz
    sync 
  4. Trigger Update for next reboot:
    kerosd -u 
  5. Restart:
    reboot

Refer to software update procedure for further details.

Changelog

Here is listed main changelog from v3.2 software release:

  • iFemtocell-Evolution gateway support
  • Backhaul configuration improvement
  • Spectral scan improvement on iStation and iFemtocell-Evolution
  • Power management improvement
  • Allow Internet access while connected to WMC

Please note that, if gateways use public IP, it also makes your gateway accessible from Internet on open SSH or HTTP ports (protected by passwords). Kerlink so recommends to change passwords as described in Connection, login and credentials

Warranty

CAUTION ABOUT WARRANTY:
Kerlink is not responsible for damages resulting from failure to follow these instructions relating to the Kerlink Product’s use.
wiki/wiki3/gateway_sw_3.3.1586272566.txt.gz · Last modified: 2020/04/07 17:16 by tda