User Tools

Site Tools


wiki:wiki3:gateway_sw_3.2

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
wiki:wiki3:gateway_sw_3.2 [2020/01/31 11:30]
tda
wiki:wiki3:gateway_sw_3.2 [2020/09/22 17:35]
ghi old revision restored (2020/09/09 17:11)
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 is designed to **upgrade a system with a KerOS 4.x installed** (3.1 embedded software).
  
Line 7: Line 8:
  
 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]]. 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]].
- 
  
 This release version is designed for: This release version is designed for:
Line 16: Line 16:
  
 <note important>​**CAUTION with gateways that are statically IP assigned** \\ <note important>​**CAUTION with gateways that are statically IP assigned** \\
-You may loose the WMC connection! Follow the procedure described [[.faq_gw_upgrade_3.2#​how_to_upgrade_my_gateway_that_is_static-ip_assigned_with_32_embedded_software|here]]</​note>​+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>​
  
  
-The Wirnet Station ​is not supported for this software release.\\  +For the **Wirnet Station**, the 3.1 SW release ​must be used to connect a Wirnet Station to the WMC server v3.2. 
-Nevertheless, the 3.1 SW release ​can be used to connect a Wirnet Station to the WMC server v3.2. Follow the link [[http://​wikikerlink.fr/​wanesy-ran/​doku.php?​id=wiki:​wiki3:​gateway_sw_3.1|Resource page]] to install this software+
  
 For lucky owners of **Wirnet iFemtoCell-evolution**,​ please refer to [[wiki:​wiki3:​gateway_sw_3.3|this specific software]]. For lucky owners of **Wirnet iFemtoCell-evolution**,​ please refer to [[wiki:​wiki3:​gateway_sw_3.3|this specific software]].
Line 32: Line 31:
  
 ^ Product ​                ^ Megapackage ​       ^md5sum ​     ^                          ^ Product ​                ^ Megapackage ​       ^md5sum ​     ^                         
-| **Wirnet iBTS \\ Wirnet iFemtoCell \\ WIrnet ​iStation** | \\ {{ :​wiki3:​wmc_megapackage_for_keros_v3.2.5.tar.gz |}} | \\ 07344dade5adcf7dc6d2f36212b6425f | +| **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 | 
- +\\ 
-==== Megapackage Content ==== +\\ 
 +For **all products except the Wirnet Station**:
 ^Component ^Version ^  ^Component ^Version ^
 | **keros** | 4.1.6    |  | **keros** | 4.1.6    |
Line 44: Line 43:
 | **lorafwd** | 1.1.1-2 ​ |  | **lorafwd** | 1.1.1-2 ​ |
  
-==== Compatibility matrix ==== +For the **Wirnet Station**: 
- +^Component ​^Version ​^  
-Product ​                   ​FW ​   ​^    ​CPF      ^    BSCC     ​^ ​  ​SNMP ​    ​^ ​    ​VPN ​   ^ +| **keros** | 3.6    |  
-| **Wirnet iBTS \\ Wirnet iFemtoCell \\ WIrnet iStation**                 \\ 4.1     ​            \\ 1.1               ​   \\ 3.2.4    ​|  \\ 3.2.4     ​| ​  \\ 3.1      | +| **bscc** | 3.1.6    |  
 +| **lorasnmp**  3.1.4    |  
 +| **lorad** | 1.0.5-2  |  
 +| **lorafwd** | ​1.0.7-2  ​|  
 +\\ 
 +There are 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. \\
  
 +To update your gateway, apply the following procedure:
 +  - 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>​
  
-__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: =====+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.
  
 +\\
 +===== 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**. \\ 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.before upgrading your system. ​+If you want to install this sotfware from a KerOS 3.x, you need to install a KerOS 4.before upgrading your system. ​
  
  
Line 68: Line 92:
  
  
-^                   ​^ ​    FW 3.1        ^    FW 3.4     ​^ ​   FW 4.0  ^    FW 4.1   ​^ +^                   ​^ ​    FW 3.1        ^    FW 3.4     ​^ ​   FW 4.0  ^    
-| Nb of USB sticks ​   |     ​2 ​    ​| ​    ​2 ​       |    1        |    ​1    | +| Nb of USB sticks ​   |     ​2 ​    ​| ​    ​2 ​       |    1        |    ​
- +
  
 When using 2 USB sticks: \\ When using 2 USB sticks: \\
    
-  *  The first USB stick will upgrade the firmware to KerOS 4.0 after applying a **liveburner** (configuration files are preserved) and will install all others packages with the required release: BSCC, SNMP, Common Packet Forwarder (CPF) and OpenVPN packages. Please, refer to the following [[http://​wikikerlink.fr/​wanesy-ran/​doku.php?​id=wiki:​wiki3:​gateway_sw_3.1#​specific_procedure_to_follow_for_usb_usage|link]] to get the required software to install\\ +  * The **first USB stick** will upgrade the firmware to **KerOS 4.1**.  
-  * The second USB stick will upgrade the firmwares to KerOS 4.1 and will install all others packages with the required release ​as described in the compatibility matrix above: BSCC, SNMP, Common Packet Forwarder (CPF) \\+  * 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: \\ When using a single USB Stick: \\
 +
   * Put the file .tar.gz on your USB stick and decompress all the stuff in the root directory.   * 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: 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"​**. ​ **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. 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.
- 
  
 \\ \\
Line 99: Line 123:
 > 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)
-<note important**IT IS VERY IMPORTANT TO WAIT FOR THE LED FLASHING to not brick the gateway** </note>+
  
 Refer to the specific wiki to get more details about software update over USB: \\  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]] \\ **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 ====
  
 +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
 +
 +
 +
 +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]]
 +\\
 +\\
 +
 +==== USB stick content ====
  
-<​code>​ 
 The USB tree should contains the following files/​folders:​ The USB tree should contains the following files/​folders:​
  
 +<​code>​
 /                /               
 ├── COMMON ​                                               # KerOS products packages folder (iBTS, iFemtoCell, iStation) ├── COMMON ​                                               # KerOS products packages folder (iBTS, iFemtoCell, iStation)
Line 123: Line 173:
 ├── usbkey.txt ​                                           # USB key protection: must contain the device passwords (all of them) ├── usbkey.txt ​                                           # USB key protection: must contain the device passwords (all of them)
 └── vpn_packages ​                                         # WMC OpenVPN packages folder └── 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_secrets_***_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_secrets_***_wmcbeta.wanesy.com_***.ipk ​           # another package for one KerOS product to connect to a WMC platform (here wmcbeta) 
-    ├── ​openvpn_***_wmcbeta.wanesy.com_***.ipk ​           # ... +    ├── ​openvpn_secrets***_wmcbeta.wanesy.com_***.ipk ​            ​# ... 
-    ├── ​openvpn_***_wmcbeta.wanesy.com_***.ipk ​           # ... +    ├── ​openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk ​           # ... 
-    ├── ​openvpn_***_wmcbeta.wanesy.com_***.ipk ​           # ... +    ├── ​openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk ​           # ... 
-    ├── ​openvpn_***_wmcbeta.wanesy.com_***.ipk ​           # ... +    ├── ​openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk ​           # ... 
-    └── ​openvpn_***_wmcbeta.wanesy.com_***.ipk ​           # ...+    └── ​openvpn_secrets_***_wmcbeta.wanesy.com_***.ipk ​           # ...
  
 </​code>​ </​code>​
 \\ \\
 \\ \\
-\\ 
- 
 ===== Changelog ===== ===== Changelog =====
  
-Corrections ​are listed below:+Main changes regards to the 3.1 embedded software release ​are listed below:
  
 <​code>​ <​code>​
Line 145: Line 193:
 - Backhaul configuration improvement - Backhaul configuration improvement
 </​code>​ </​code>​
 +\\
 ===== Restrictions ===== ===== Restrictions =====
 <​code>​ <​code>​
wiki/wiki3/gateway_sw_3.2.txt · Last modified: 2021/02/16 15:12 by tda