User Tools
wiki:wiki3:gateway_sw_3.2
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
wiki:wiki3:gateway_sw_3.2 [2020/01/07 10:10] tda |
wiki:wiki3:gateway_sw_3.2 [2021/02/16 15:12] (current) tda |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== v3.2 Gateway Software Releases ====== | ====== v3.2 Gateway Software Releases ====== | ||
| + | \\ | ||
| + | \\ | ||
| + | This version is designed to **upgrade a system with a KerOS 4.x installed** (3.1 embedded software). | ||
| - | This version can upgrade a previous WMC embedded 3.1 (except for iStation) or be installed "from scratch". | + | To update a system which KerOS version is lower than 4.x, the **liveburner 4.0** available [[http://wikikerlink.fr/wanesy-ran/doku.php?id=wiki:wiki3:gateway_sw_3.1#download|here]] need to be applied first before applying the current update. |
| - | Either install packages from USB stick or copy the megapackage in the folder ///user/.updates// on the gateway and deflate it or use the [[.magic_link|magic link]]. | + | To update a system from KerOS 4.x, either install packages from USB stick or copy the megapackage in the folder ///user/.updates// on the gateway and deflate it or use the [[.magic_link|magic link]]. |
| - | <note important>**CAUTION: \\ \\ | + | This release version is designed for: |
| - | Theses packages are only dedicated to connect gateways to WMC v3.2. \\ They are not intended to be used with WMC v2.3, 3.0 or 3.1.** | + | |
| - | **The Wirnet Station is not supported for this software release. ** \\ | + | * **Wirnet iBTS**, |
| - | **The SW release 3.1 can be used to connect your Wirnet Station to the WMC server v3.2: \\ | + | * **Wirnet iFemtoCell**, |
| - | See the [[wiki:wiki3:gateway_sw_3.1|Resource page]] **</note> | + | * **Wirnet iStation**. |
| + | <note important>**CAUTION with gateways that are statically IP assigned** \\ | ||
| + | You may lose the WMC connection! Follow the procedure described [[wiki:wiki3:faq_gw_upgrade_3.2#how_to_upgrade_my_gateway_that_is_static-ip_assigned_with_32_embedded_software|here]]</note> | ||
| - | ===== Download ===== | ||
| - | ^ Product ^ Megapackage ^md5sum ^ | + | For the **Wirnet Station**, the 3.1 SW release must be used to connect a Wirnet Station to the WMC server v3.2. |
| - | | **Wirnet iBTS \\ Wirnet iFemtoCell \\ WIrnet iStation** | \\ {{ :wiki3:wmc_megapackage_for_keros_v3.2.5.tar.gz |}} | \\ 07344dade5adcf7dc6d2f36212b6425f | | + | |
| + | For lucky owners of **Wirnet iFemtoCell-evolution**, please refer to [[wiki:wiki3:gateway_sw_3.3|this specific software]]. | ||
| - | ==== Megapackage Content ==== | ||
| + | <note important>**CAUTION: \\ \\ | ||
| + | Theses packages are only dedicated to connect gateways to WMC v3.2. \\ They are not intended to be used with WMC 2.3, 3.0 or 3.1.** | ||
| + | </note> | ||
| + | |||
| + | ===== Download ===== | ||
| + | |||
| + | ^ Product ^ Megapackage ^md5sum ^ | ||
| + | | **Wirnet iBTS \\ Wirnet iFemtoCell \\ Wirnet iStation** | \\ {{ :wiki3:wmc_megapackage_for_keros_v3.2.5.tar.gz |}} | \\ 07344dade5adcf7dc6d2f36212b6425f | | ||
| + | | **Wirnet Station** | {{ :wiki3:fwupgrade_wirmav2_wirnet_v3.6_wmc_v3.1.6.tar.gz | fwupgrade_wirmav2_wirnet_v3.6_wmc_v3.1.6.tar.gz}} | b74737609413bb65b5f68716568da150 | | ||
| + | \\ | ||
| + | \\ | ||
| + | For **all products except the Wirnet Station**: | ||
| ^Component ^Version ^ | ^Component ^Version ^ | ||
| | **keros** | 4.1.6 | | | **keros** | 4.1.6 | | ||
| Line 28: | Line 42: | ||
| | **lorad** | 1.1.5-2 | | | **lorad** | 1.1.5-2 | | ||
| | **lorafwd** | 1.1.1-2 | | | **lorafwd** | 1.1.1-2 | | ||
| + | | **OpenVPN** | 3.1 | | ||
| - | ==== Compatibility matrix ==== | + | For the **Wirnet Station**: |
| + | ^Component ^Version ^ | ||
| + | | **keros** | 3.6 | | ||
| + | | **bscc** | 3.1.6 | | ||
| + | | **lorasnmp** | 3.1.4 | | ||
| + | | **lorad** | 1.0.5-2 | | ||
| + | | **lorafwd** | 1.0.7-2 | | ||
| + | | **OpenVPN** | 3.1 | | ||
| + | \\ | ||
| + | There are 3 ways to update your gateway's software: | ||
| + | * by using [[.magic_link|Magic link]] | ||
| + | * by using an [[.gateway_sw_3.2#software_update_over_usb|USB stick]] | ||
| + | * by using [[.gateway_sw_3.2#software_update_over_ethernet|Ethernet connection (SSH)]] | ||
| + | * over WMC dashboard, by using the [[wiki:wiki3:install_upgrade#wmc_drag_n_drop_feature|Drag and drop feature]] | ||
| + | \\ | ||
| + | \\ | ||
| + | ===== Software update over ethernet ===== | ||
| + | \\ | ||
| + | This procedure can be used to **UPGRADE from a KerOS 4.x system** on a **single** gateway. \\ | ||
| - | ^ Product ^ FW ^ CPF ^ BSCC ^ SNMP ^ VPN ^ | + | To update your gateway, apply the following procedure: |
| - | | **Wirnet iBTS \\ Wirnet iFemtoCell \\ WIrnet iStation** | \\ 4.1 | \\ 1.1 | \\ 3.2.4 | \\ 3.2.4 | \\ 3.1 | | + | - Request your VPN package(s) to the Kerlink Support team: [[support@kerlink.fr]] (optional: in case of a First Install or Migration) |
| + | - Transfer package(s) in this directory: <code bash> | ||
| + | # From a computer: | ||
| + | scp WMC_embedded_keros_v3.3.5.tar.gz openvpn-*.ipk root@<ip_address>:/user/.updates/ | ||
| + | </code> | ||
| + | - Deflate archive and ensure file is correctly written: <code bash># On the gateway: | ||
| + | cd /user/.updates | ||
| + | tar -xzf *.tar.gz | ||
| + | rm -f WMC*.tar.gz | ||
| + | sync </code> | ||
| + | - Trigger Update for next reboot: <code bash>kerosd -u </code> | ||
| + | - Restart: <code bash>reboot</code> | ||
| + | \\ | ||
| + | Refer to [[http://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:sw_updates#software_update_over_network|software update procedure]] for further details. | ||
| - | |||
| - | __Legend:__ \\ | ||
| - | **FW**: Firmware \\ | ||
| - | **CPF**: Kerlink Common Packet Forwarder \\ | ||
| - | **BSCC**: Base Station Component Client \\ | ||
| - | **SNMP**: Simple Network Management Protocol \\ | ||
| - | **VPN**: OpenVPN packages \\ | ||
| \\ | \\ | ||
| - | ===== Specific procedure to follow for USB usage: ===== | + | ===== Software update over USB ===== |
| + | \\ | ||
| + | ==== For all products except the Wirnet Station ==== | ||
| + | \\ | ||
| + | This procedure used for automatic deployment can be used to **UPGRADE from a KerOS 4.x system** (embedded software 3.1.x) on a **single** or a **group of gateways**. \\ | ||
| + | If you want to install this sotfware from a KerOS 3.x, you need to install a KerOS 4.x before upgrading your system. | ||
| - | This procedure used for automatic deployment can be used to upgrade or install software on a SINGLE or a GROUP of gateways. | ||
| - | **You need to use 1 USB stick **. \\ \\ | + | **You need to use 1 or 2 USB sticks depending on your FW version **. \\ \\ |
| - | **If your KerOS version is lower than 4.0 then you need to plug the USB stick TWICE.** \\ | + | **If your KerOS version is lower than 4.0 then you will need to create 2 USB sticks.** \\ |
| - | The first USB plug will upgrade the firmware to 4.1 and install/update OpenVPN packages. \\ | + | |
| - | The second USB plug will install all others packages: BSCC, SNMP, and Common Packet Forwarder (CPF) packages. | + | |
| - | **The .tar.gz file provided below 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. | ||
| - | <note important>From v3.1 release, The OpenVPN package is splitted to a secret file (installed once) and a config file (can be installed several times)</note> | + | ^ ^ FW 3.1 ^ FW 3.4 ^ FW 4.0 ^ |
| + | | Nb of USB sticks | 2 | 2 | 1 | | ||
| - | <code> | + | When using 2 USB sticks: \\ |
| - | The USB tree should contains the following files/folders: | + | |
| + | * The **first USB stick** will upgrade the firmware to **KerOS 4.1**. | ||
| + | * The **second USB stick** will **install all others packages** with the required software release: BSCC, SNMP, Common Packet Forwarder (CPF) and OpenVPN packages. | ||
| - | / | + | When using a single USB Stick: \\ |
| - | ├── COMMON # KerOS products packages folder (iBTS, iFemtoCell, iStation) | + | |
| - | │ ├── keros_***_klkgw.ipk # Keros firmware package for Wirnet iBTS | + | |
| - | │ ├── bscc_***_klkgw.ipk # WMC BSCC package for Wirnet iBTS | + | |
| - | │ ├── lorasnmp_***_klkgw.ipk # WMC SNMP package for Wirnet iBTS | + | |
| - | │ ├── lorad_***_klkgw.ipk # HAL package for Wirnet iBTSpk | + | |
| - | │ ├── lorafwd_***_klkgw.ipk # Packet Forwarder package for Wirnet iBTS | + | |
| - | │ └── openvpn_config_wmcbeta.wanesy.com_3.1.ipk # sample file: the WMC server to connect to | + | |
| - | ├── 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 | + | |
| - | ├── openvpn_***_wmcbeta.wanesy.com_***.ipk # OpenVPN package for one KerOS product to connect to a WMC platform (here wmcbeta) | + | |
| - | ├── openvpn_***_wmcbeta.wanesy.com_***.ipk # another package for one KerOS product to connect to a WMC platform (here wmcbeta) | + | |
| - | ├── openvpn_***_wmcbeta.wanesy.com_***.ipk # ... | + | |
| - | ├── openvpn_***_wmcbeta.wanesy.com_***.ipk # ... | + | |
| - | ├── openvpn_***_wmcbeta.wanesy.com_***.ipk # ... | + | |
| - | ├── openvpn_***_wmcbeta.wanesy.com_***.ipk # ... | + | |
| - | └── openvpn_***_wmcbeta.wanesy.com_***.ipk # ... | + | |
| - | </code> | + | * Put the file .tar.gz on your USB stick and decompress all the stuff in the root directory. |
| - | \\ | + | |
| - | \\ | + | To update your system from a KerOS 4.x system, use the following software: |
| ^description ^file ^md5sum ^ | ^description ^file ^md5sum ^ | ||
| - | |**USB stick ** | {{ wiki3:auto_deploy_3.2.5_keros_usb_stick.tar.gz | AUTO_DEPLOY_3.2.5_KEROS_USB_STICK.tar.gz }} | b1590a10cd75f0abf61af10d72b167c8 | | + | |**USB stick ** | {{ wiki3:auto_deploy_3.2.5_keros_usb_stick.tar.gz | AUTO_DEPLOY_3.2.5_KEROS_USB_STICK.tar.gz }} | b1590a10cd75f0abf61af10d72b167c8 | |
| + | The same USB stick can be used twice. | ||
| + | **The .tar.gz file provided below 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. | ||
| - | ^ ^ FW 3.1 ^ FW 3.4 ^ FW 4.0 ^ FW 4.1 ^ | ||
| - | | Nb of USB stick plugs | 2 | 2 | 1 | 1 | | ||
| - | |||
| - | \\ | ||
| \\ | \\ | ||
| To update your gateway, apply the following procedure : | To update your gateway, apply the following procedure : | ||
| Line 100: | Line 123: | ||
| > 4. Put your VPN config packages in the //COMMON// directory to connect to YOUR WMC server (optional: in case of a First Install or Migration) | > 4. Put your VPN config packages in the //COMMON// directory to connect to YOUR WMC server (optional: in case of a First Install or Migration) | ||
| > 5. Put your VPN secrets packages of your KerOS products in the //vpn_packages// directory (optional: in case of a First Install) | > 5. Put your VPN secrets packages of your KerOS products in the //vpn_packages// directory (optional: in case of a First Install) | ||
| - | |||
| - | Then apply this TWICE if your KerOS version < FW 4.0, otherwise apply this ONCE (FW = 4.x): | ||
| > 6. Plug the USB stick in the gateway USB slot (device must be powered on) | > 6. Plug the USB stick in the gateway USB slot (device must be powered on) | ||
| > 7. Wait the end of the update | > 7. Wait the end of the update | ||
| + | > 8. Plug the second USB stick in the gateway USB slot (if needed) | ||
| + | > 9. Wait the end of the update (if needed) | ||
| + | Refer to the specific wiki to get more details about software update over USB: \\ | ||
| + | **Wirnet Product Line (iBTS, iFemtocell, iStation)**: [[http://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:sw_updates#software_update_over_usb]] \\ | ||
| + | \\ | ||
| + | \\ | ||
| + | ==== For the Wirnet Station ==== | ||
| - | <note important> **IT IS VERY IMPORTANT TO WAIT FOR THE LED FLASHING to not brick the gateway** </note> | + | The update procedure uses 2 USB sticks: \\ |
| + | |||
| + | * The **first USB stick** will upgrade the firmware to **KerOS 3.6.** | ||
| + | * The **second USB stick** will install **all others packages** with the required software release: BSCC, SNMP, Common Packet Forwarder (CPF) and OpenVPN packages. | ||
| + | ^description ^file ^md5sum ^ | ||
| + | |**USB stick number 1** | {{:wiki3:auto_deploy_3.1.6_usb_stick_1.tar.gz | AUTO_DEPLOY_3.1.6_USB_STICK_1.tar.gz}} | 6c31bebc9f2942bb852adecd74a57284 | | ||
| + | |**USB stick number 2** | {{:wiki3:auto_deploy_3.1.6_usb_stick_2_bis.tar.gz | AUTO_DEPLOY_3.1.6_USB_STICK_2.tar.gz}} | 458c2c2c8684e732e3fb9023d3e4fa43 | | ||
| + | > 1. Deflate twice the tar.gz file on each USB stick in the root directory | ||
| + | > 2. Copy files located in the folder AUTO_DEPLOY_3.1.6_USB_STICK_x in the root directory | ||
| + | > 3. Add your OpenVPN packages in AUTO_DEPLOY_3.1.6_USB_STICK_2 before plugging the stick into the system. | ||
| + | > 4. Plug the first USB stick in the gateway USB slot | ||
| + | > 5. Wait the end of the update | ||
| + | > 6. Plug the second USB stick in the gateway USB slot | ||
| + | > 7. Wait the end of the update | ||
| - | <note important> | ||
| - | **CAUTION ABOUT WARRANTY:** \\ | ||
| - | **Kerlink is not responsible for damage arising from failure to follow these instructions relating to the Kerlink Product’s use.** | ||
| - | </note> | ||
| - | Refer to the specific wiki to get more details about software update over USB: \\ | ||
| - | **Wirnet Product Line (iBTS, iFemtocell, iStation)**: [[http://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:sw_updates#software_update_over_usb]] \\ | ||
| + | Refer to the specific wikis to get more details (ex led management) about software update via USB sticks: \\ \\ | ||
| + | Wirnet Station: [[http://wikikerlink.fr/lora-station/doku.php?id=wiki:updates#usb_update_recommended]] | ||
| + | \\ | ||
| \\ | \\ | ||
| - | ===== Changelog ===== | + | ==== USB stick content ==== |
| - | Corrections are listed below: | + | The USB tree should contains the following files/folders: |
| <code> | <code> | ||
| - | -[ifemtoCell] WiFi settings are not properly set | + | / |
| - | -Changing ntp configuration disconnects gateway | + | ├── COMMON # KerOS products packages folder (iBTS, iFemtoCell, iStation) |
| - | -Ethernet config is taken from kconf and not from bscc | + | │ ├── keros_***_klkgw.ipk # Keros firmware package for Wirnet iBTS |
| - | -[snmp] Logs are not written in /user/snmp/traces | + | │ ├── bscc_***_klkgw.ipk # WMC BSCC package for Wirnet iBTS |
| - | -Version of modem software should be available | + | │ ├── lorasnmp_***_klkgw.ipk # WMC SNMP package for Wirnet iBTS |
| - | -No Logrotate on snmp and bscc | + | │ ├── lorad_***_klkgw.ipk # HAL package for Wirnet iBTSpk |
| - | -MIB specification is not up-to-date | + | │ ├── lorafwd_***_klkgw.ipk # Packet Forwarder package for Wirnet iBTS |
| - | -BSCC rewrite provisioning for sim without taking into account the MNC | + | │ └── openvpn_config_wmcbeta.wanesy.com_3.1.ipk # sample file: the WMC server to connect to |
| - | -List of ConfigurationDto is empty at first install | + | ├── README.txt # This file |
| - | -VPN connection lost on iFemto with GSM | + | ├── usb.autorun # executed by KerOs products when plugging the USB stick |
| - | -Gateway connects and disconnect every 40s | + | ├── usbkey.txt # USB key protection: must contain the device passwords (all of them) |
| - | -Change toolchain path for keros platforms | + | └── vpn_packages # WMC OpenVPN packages folder |
| - | -Interface version of MIB is described nowhere | + | ├── openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk # OpenVPN package for one KerOS product to connect to a WMC platform (here wmcbeta) |
| - | -BSCC reboots gateways every hour even if it is connected | + | ├── openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk # another package for one KerOS product to connect to a WMC platform (here wmcbeta) |
| - | -BSCC and lora_snmp constantly reboots on Ibts | + | ├── openvpn_secrets***_wmcbeta.wanesy.com_***.ipk # ... |
| - | -BSCC log history too small | + | ├── openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk # ... |
| - | -Log configuration of bscc/snmp is not kept after an upgrade | + | ├── openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk # ... |
| - | -Improve backhaul configuration | + | ├── openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk # ... |
| + | └── openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk # ... | ||
| </code> | </code> | ||
| + | \\ | ||
| + | \\ | ||
| + | ===== Changelog ===== | ||
| + | Main changes regards to the 3.1 embedded software release are listed below: | ||
| + | |||
| + | <code> | ||
| + | - iStation gateway support | ||
| + | - New power management for iStation | ||
| + | - Backhaul configuration improvement | ||
| + | </code> | ||
| + | \\ | ||
| ===== Restrictions ===== | ===== Restrictions ===== | ||
| <code> | <code> | ||
| - | Spectral scan with LBT mode enabled does not work properly | + | - Spectral scan with LBT mode enabled does not work properly |
| </code> | </code> | ||
| + | |||
| + | \\ | ||
| + | \\ | ||
| + | |||
| + | ===== Warranty ===== | ||
| + | |||
| + | <note important> | ||
| + | **CAUTION ABOUT WARRANTY:** \\ | ||
| + | **Kerlink is not responsible for damage arising from failure to follow these instructions relating to the Kerlink Product’s use.** | ||
| + | </note> | ||
| + | |||
| + | |||
| + | |||
wiki/wiki3/gateway_sw_3.2.1578388258.txt.gz · Last modified: 2020/01/07 10:10 by tda
Page Tools
