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:automatic_deployment

Automatic Deployment

When provisioning a large number of gateways, it can be tedious to upload one dedicated VPN package for each device.

To automate the process, the use of a generic USB stick containing all the software packages can be used.

Download the USB package

Instructions

  1. Request VPN packages.
  2. Place VPN packages in vpn_packages.
  3. Place Wirnet Station packages at the root (if applicable).
  4. Place Wirnet iBTS packages in IBTS (if applicable).
  5. Place Wirnet iFemtoCell packages in IFEMTO (if applicable).
  6. Plug USB stick on the target device (which must be powered on).
  7. Wait for the device to be ready:
    • for Wirnet iBTS and Wirnet iFemtoCell: wait for the LED to flash, then unplug.
    • for Wirnet Station: wait for the reboot, press the “TEST” button and wait until “MOD1” and “MOD2” are OFF.
For 3.1 embedded software, the procedure has been simplified. You will find “ready-to-use” packages with software embedded in the Resources page. You have just to put your OpenVPN packages on the USB stick.

Request VPN packages

Request VPN packages through support@kerlink.com: please mention the device serial numbers when requesting the VPN packages.

Place VPN packages

Place all VPN packages in the vpn_packages folder. These packages are provided by the Kerlink support team.

Place Wirnet XXX packages at YYY

Download all application packages (firmware, HAL, Packet Forwarder, BSCC and SNMP) for your hardware architecture (e.g. Wirnet Station and Wirnet iFemtoCell) from the Software Releases page.

Place the packages:

  • for Wirnet Station: at the root of the USB stick
  • for Wirnet iBTS: place in the IBTS subfolder
  • for Wirnet iFemtoCell: place in the IFEMTO subfolder
Wirnet iBTS and Wirnet iFemtoCell share the same software architecture (ipk packages) but they should not be mixed.

Hence, they are placed in subfolders and the usb.autorun script will copy the suitable packages at the root of the USB stick before triggering the update.

Resulting USB stick

The USB stick should then have a similar structure:

.
├── autorun_klk.sh                           # executed by Wirnet Stations when plugging the USB stick
├── custo_libloragw_***_wirnet.tar.gz        # HAL package for Wirnet Stations
├── dota_spf_***_wirnet.tar.gz               # Packet Forwarder package for Wirnet Stations
├── dota_***_bscc.tar.gz                     # WMC BSCC package for Wirnet Stations
├── dota_***_snmp.tar.gz                     # WMC SNMP package for Wirnet Stations
├── IBTS                                     # iBTS-only packages folder
│   ├── bscc_***_klk_lpbs.ipk                # WMC BSCC package for Wirnet iBTS
│   ├── keros_***_klk-lpbs.ipk               # KerOS firmware package for Wirnet iBTS
│   ├── libloragw2_***_klk_lpbs.ipk          # HAL package for Wirnet iBTS
│   ├── lorasnmp_***_klk_lpbs.ipk            # WMC SNMP package for Wirnet iBTS
│   └── spf2_***_klk_lpbs.ipk                # Packet Forwarder package for Wirnet iBTS
├── IFEMTO                                   # iFemtoCell-only packages folder
│   ├── bscc_***_klk_wifc.ipk                # WMC BSCC package for Wirnet iFemtoCell
│   ├── keros_***_klk-wifc.ipk               # KerOS firmware package for Wirnet iFemtoCell
│   ├── libloragw-fpga_***_klk_wifc.ipk      # HAL package for Wirnet iFemtoCell
│   ├── lorasnmp_***_klk_wifc.ipk            # WMC SNMP package for Wirnet iFemtoCell
│   └── spf_***_klk_wifc.ipk                 # Packet Forwarder package for Wirnet iFemtoCell
├── _produsb.sh                              # executed by Wirnet Stations after rebooting (will flash the software)
├── README                                   # This file
├── usb.autorun                              # executed by Wirnet iFemtoCell and Wirnet iBTS when plugging the USB stick
├── usbkey.txt                               # USB key protection: must contain the device passwords (all of them)
└── vpn_packages                                         # WMC OpenVPN packages folder
    ├── custo_openvpn_***_demoran.wanesy.fr_***.tar.gz   # OpenVPN package for one Wirnet Station
    ├── custo_openvpn_***_demoran.wanesy.fr_***.tar.gz   # another Wirnet Station
    ├── custo_openvpn_***_demoran.wanesy.fr_***.tar.gz   # ...
    ├── custo_openvpn_***_demoran.wanesy.fr_***.tar.gz   # ...
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # OpenVPN package for one Wirnet iBTS
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # another Wirnet iBTS
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # ...
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # ...
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # ...
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # OpenVPN package for one Wirnet iFemtoCell
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # another Wirnet iFemtoCell
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # ...
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # ...
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # ...
    ├── openvpn_***_demoran.wanesy.fr_***.ipk            # ...
    └── openvpn_***_demoran.wanesy.fr_***.ipk            # ...

USB key password file

The usbkey.txt file contains the password for the usbuser Linux user. This can be used to protect the gateways from malicious firmware upgrades over USB. The default password for Wirnet iBTS and Wirnet iFemtoCell is USBklkPassword but it can be changed. There is no password by default for Wirnet Station, so the file would be ignored.

USBklkPassword

It is strongly recommended to change default usbuser password. To do so, use the following command:

klk_set_passwd -u usbuser -p <new_password>

wiki/wiki3/automatic_deployment.txt · Last modified: 2021/09/01 16:18 by tda