Differences

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

--- wiki:wiki3:gateway_sw_3.2 [2020/01/09 18:12]
tda
+++ wiki:wiki3:gateway_sw_3.2 [2021/02/16 15:12] (current)
tda
@@ Line 1: / Line 1: @@
 ====== v3.2 Gateway Software Releases ======
+\\
+\\
 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]].
 This release version is designed for:
@@ Line 15: / Line 15: @@
   * **Wirnet iStation**.
-The Wirnet Station is not supported for this software release.\\
+<note important>**CAUTION with gateways that are statically IP assigned** \\
-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.
+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>
+For the **Wirnet Station**, the 3.1 SW release must be used to connect a Wirnet Station to the WMC server v3.2.
+For lucky owners of **Wirnet iFemtoCell-evolution**, please refer to [[wiki:wiki3:gateway_sw_3.3|this specific software]].
@@ Line 26: / Line 31: @@
 ^ 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 ^
 | **keros**	| 4.1.6    |
@@ Line 37: / Line 42: @@
 | **lorad**	| 1.1.5-2  |
 | **lorafwd**	| 1.1.1-2  |
+| **OpenVPN**	| 3.1  |
-==== 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  |
+| **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. \\
+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**. \\
-If you want to install this sotfware from a KerOS 3.x, you need to install a KerOS 4.0 before upgrading your system.
+If you want to install this sotfware from a KerOS 3.x, you need to install a KerOS 4.x before upgrading your system.
@@ Line 62: / Line 94: @@
-^                   ^     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: \\
-  *  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: \\
   * 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      ^
-|**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.
 \\
@@ Line 93: / Line 125: @@
 > 6. Plug the USB stick in the gateway USB slot (device must be powered on)
 > 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: \\
 **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:
+<code>
 /
 ├── 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_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>
 \\
 \\
-\\
 ===== Changelog =====
-Corrections are listed below:
+Main changes regards to the 3.1 embedded software release are listed below:
 <code>
- iStation gateway support
+- iStation gateway support
 - New power management for iStation
 - Backhaul configuration improvement
 </code>
+\\
 ===== Restrictions =====
 <code>
-Spectral scan with LBT mode enabled does not work properly
+- Spectral scan with LBT mode enabled does not work properly
 </code>

Wanesy™ Management Center (End Of Life)

User Tools

Site Tools

Differences

Page Tools