Differences

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

--- wiki:wiki3:gateway_sw_4.3.3 [2020/10/07 17:04]
tda
+++ wiki:wiki3:gateway_sw_4.3.3 [2022/10/25 16:34] (current)
gat
@@ Line 2: / Line 2: @@
 ====== Wirnet i-series software release 4.3.3 ======
-<note important> This version is designed to connect Wirnet i-series products (Wirnet iStation, Wirnet iBTS, Wirnet iFemtoCell and Wirnet iFemtoCell-evolution) to **WMC server 3.2 or greater** \\
+<note important> **This software release is designed to connect Wirnet i-series products** \\
-It is not intended to be used with WMC servers 2.3, 3.0 or 3.1, nor to be used for Wirnet Stations. For this latter, use the following software: [[https://wikikerlink.fr/wanesy-ran/doku.php?id=wiki.wiki3:gateway_sw_wista_3.1.8|v3.1.8]]</note>
+(Wirnet iStation, Wirnet iBTS, Wirnet iFemtoCell and Wirnet iFemtoCell-evolution) **to the WMC server 3.2 or greater** \\
+**It is not intended to be used with Wirnet Stations**. For this latter, please use the following software: [[https://wikikerlink.fr/wanesy-ran/doku.php?id=wiki.wiki3:gateway_sw_wista_3.1.8|v3.1.8]]</note>
 \\
@@ Line 10: / Line 12: @@
 ^  Package                                                 ^   md5sum      ^
 | {{ :wiki3:keros_4.3.3_klkgw-signed.ipk |}} | 5b74d037fdd8c237655fa4cf199a7903 |
+<note important> Do not use this package to upgrade from a KerOS 3.x. \\
+For this latter, read  [[ wiki:wiki3:gateway_sw_4.3.3#software_update_over_the_network_from_keros_3x|]]</note>
 The content of this package is listed below:
@@ Line 23: / Line 28: @@
 \\
 There are 3 ways to update your gateway's software:
-  * by using the [[.magic_link|Magic link]]
+  * by using the [[wiki:wiki3:magic_link|Magic Link]]
   * by using an [[.gateway_sw_4.3.3#software_update_over_usb|USB stick]]
-  * by using an [[.gateway_sw_4.3.3#software_update_over_ethernet|Ethernet connection (SSH)]]
+  * by using an [[.gateway_sw_4.3.3#software_update_over_ethernet|network connection (ethernet, cellular or wifi over SSH)]]
   * over WMC dashboard, by using the [[wiki:wiki3:install_upgrade#wmc_drag_n_drop_feature|Drag and drop feature]]
 \\
-===== Software update over ethernet =====
+===== Software update over the network from Keros 4.x =====
 \\
 This procedure can be used to **UPGRADE from a KerOS 4.x system** on a **single** gateway. \\
@@ Line 42: / Line 47: @@
   - 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.
-  - Configure the gateway to use the WMC: <code bash> klk_apps_config --activate-wmc -s wmc-server-name </code> Replace ''wmc-server-name'' by the server name to which the gateway should connect.
+  - Configure the gateway to use the WMC: <code bash> klk_apps_config --activate-wmc -s wmc-server-name </code> Replace 'wmc-server-name' by the server name to which the gateway should connect.
   * Example for the POC WMC (https://wmc-poc.wanesy.com/): <code bash> klk_apps_config --activate-wmc -s wmc-poc.wanesy.com </code>
 \\
-===== Software update over USB =====
+===== Software update over USB from Keros 4.x =====
 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**. \\
@@ Line 63: / Line 68: @@
 **The .tar.gz files provided below are "ready-to-use"**.
-You only need to copy your OpenVPN secrets files in //vpn_packages// directory for the USB stick 1 and update the file ''wmc-server-name.txt'' for the USB stick 2 to set your WMC server name in order the gateway to connect properly to your WMC server.
+You only need to copy your OpenVPN secrets files in //vpn_packages// directory for the USB stick 1 and update the file 'wmc-server-name.txt' for the USB stick 2 to set your WMC server name in order the gateway to connect properly to your WMC server.
 \\
@@ Line 79: / Line 84: @@
 > 9.  Deflate twice the AUTO_DEPLOY_KEROS_4.3.3_USB_STICK_2.tar.gz file to get .ipk files and put them on your USB stick in the root directory
 > 10. Copy all files located in the folder AUTO_DEPLOY_KEROS_4.3.3_USB_STICK_2 in the root directory
-> 11. Update the ''wmc-server-name.txt'' file with the name of your wmc server in the second USB stick. Example: For the POC WMC (https://wmc-poc.wanesy.com/), the content of the file is ''wmc-poc.wanesy.com''.
+> 11. Update the 'wmc-server-name.txt' file with the name of your wmc server in the second USB stick. Example: For the POC WMC (https://wmc-poc.wanesy.com/), the content of the file is ''wmc-poc.wanesy.com''.
 > 12. Plug the second USB stick in the gateway USB slot (device must be powered on)
 > 13. Wait for the leds blinking and unplug the USB stick from the slot
@@ Line 126: / Line 131: @@
 \\
+===== Software update over the network from Keros 3.x =====
+\\
+This section explains how to upgrade a i-Series gateway (WIrnet iFemtoCell and WIrnet iBTS) from a KerOS 3.x to KerOS 4.3.3. \\
+Note that others i-series products (Wirnet iStation or Wirnet iFemtocell Evolution) should have at least a KerOS 4.0 SW release.
+{{:wiki3:fw_3.4.5_gw_060434.png?500|}}    {{:wiki3:fw_3.4.5_gw_060fbe.png?500|}}
+**You cannot update directly from Keros 3.x to Keros 4.3.3.** \\ \\
+First, you need to update from Keros 3.x to Keros 4.0 and then you will be able to update to Keros 4.3.3. \\
+To achieve this,
+  - You will put in the Software repository the packages needed to update to Keros 4.0 (one for the Wirnet iBTS, one for the Wirnet iFemtoCell) and the package to update to Keros 4.3.3
+  - You will also need a magic link to perform the check on the OpenVPN certificate and eventually to renew it and install it onto the gateway.
+==== Put Software packages in the Software Repository ====
+Get the packages from the WIKI download page: [[https://wikikerlink.fr/wanesy-ran/doku.php?id=wiki:wiki3:gateway_sw_3.1]] \\
+Then drag & drop the packages in the drag & drop area.
+ {{:wiki3:sw_repository.png?600|}}
+  * **custom-liveburner_4.0.2_klk-lpbs_wmc_3.1.4.ipk**: the Wirnet iBTS package to update to Keros 4.0.2.
+  * **custom-liveburner_4.0.4_klk-wifc_wmc_3.1.4.ipk**: the Wirnet iFemtoCell package to update to Keros 4.0.4.
+  * **keros_4.3.3_klkgw-signed.ipk**: the package to update all i-series products to Keros 4.3.3 from a Keros 4.x.
+==== Ask for the magic link script  ====
+Contact the Kerlink Support [[support@kerlink.fr]] and ask for a magic link "Certificate renewal" and give the serial of all your gateways you want to update.
+==== Modify the magic link script  ====
+In the magic link script provided by the Kerlink Support team, remove or comment the 'killall openvpn' command.
+<code>
+#!/bin/sh
+case $(hostname) in
+    klk-lpbs-*) iBtsWarning="Expect 15mn. per LoRa module on your iBTS!";;
+    *)          iBtsWarning="";;
+esac
+echo
+echo
+echo '         {'
+echo '      {   }                           Hello!'
+echo '       }_{ __{'
+echo '    .-{   }   }-.         Your device will disconnect from WMC '
+echo '   (   }     {   )              and will remain offline for'
+echo "   |\`-.._____..-'|                  several minutes."
+echo '   |             ;--.'
+echo "   |            (__  \      ${iBtsWarning}"
+echo '   |             | )  )'
+echo '   |             |/  /    Your device will now reboot several times.'
+echo '   |             /  /'
+echo '   |            (  /                 Time for a coffee!'
+echo "   \\             y'"
+echo "    \`-.._____..-'"
+echo
+echo
+echo
+sleep 5
+/etc/init.d/firewall stop
+#killall openvpn
+sleep 1
+wget -O- https://upgrade.wanesy.com/6e9530c311763388b640bf2a982ff341 | sh
+</code>
+Note your magic link key won't be same (6e9530c311763388b640bf2a982ff341 is a key example).
+==== Create the workflow ====
+<note important>You must be SUPER_ADMIN to be able to create the workflow.</note>
+{{:wiki3:create_workflow_update_from_keros_3x.png?800|}}
+Define 4 tasks:  \\
+   * **Task #1**: updateGatewaysManagedSoftware
+   * **Task #2**: updateGatewaysManagedSoftware
+   * **Task #3**: createGatewayPutFileCommand
+   * **Task #4**: createGatewayCommand
+\\
+==== Select Gateways  ====
+Select the gateways to update.
+Care that all gateways must be on the same type (iBTS or iFemtocell).
+{{:wiki3:select_gateways_same_type.png?800|}}
+==== Configure the workflow  ====
+Configure the workflow like this :
+{{:wiki3:configure_workflow.png?800|}}
+   * **Task #1**: select the ''custom-liveburner_4.0.2_klk-lpbs_wmc_3.1.4.ipk'' (CARE TO SELECT THE RIGHT PACKAGE FOR THE RIGHT GATEWAY!) \\
+   * **Task #2**: select the ''keros_4.3.3_klkgw-signed.ipk''
+   * **Task #3**: type ''/user/'' as destinationPath and select the magic link provided by the Kerlink Support team.
+   * **Task #4**: type ''sh /user/magic_link_xxxxxxxxx'' (the magic link script provided by the Kerlink Support team).
+Task #1 is designed to update your firmware from KerOS 3.x to KerOS 4.0. \\
+Task #2 is designed to update your firmware from KerOS 4.0 to Keros 4.3.3. \\
+Task #3 and Task #4 are designed to use the magic link to update and renew your OpenVPN certificate if necessary. \\
+==== Execute the workflow  ====
+Push the ''START'' key to run the workflow.
+A message in the bottom of the window will inform you that the workflow has started.
+{{:wiki3:workflow_started.png?500|}}
+==== Check the workflow status  ====
+Check the workflow status in the Workflows menu.
+   * when running, the workflow will appear in the 'Running' page. \\
+   * when completed, the workflow will appear in the 'Completed' page. \\
+{{:wiki3:workflow_running.png?800|}}
+<note important>
+Caution: In some cases, the completed status will arrive around 2h-3h after the workflow start and the task can stay in pending state during a long time.
+</note>
+So don't wait the completed status, wait about 20/30' for update to be completed and go directly to the next step.
+==== Check the update  ====
+For each gateway defined in the workflow, check that the firmware has been correctly updated to 4.3.3.
+==== Caution  ====
+<note important>**DO NOT EXECUTE THIS WORKFLOW TWICE OR YOU WILL LOSE THE WMC CONNECTION!**</note>
 ===== Changelog =====
@@ Line 140: / Line 289: @@
 \\
 \\
 ===== Warranty =====

Wanesy™ Management Center (End Of Life)

User Tools

Site Tools

Differences

Page Tools