Wanesy™ Management Center (End Of Life)

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.

====== 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** \\
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>

\\
===== Download =====

^  Package                                                 ^   md5sum      ^                         
| {{ :wiki3:keros_4.3.3_klkgw-signed.ipk |}} | 5b74d037fdd8c237655fa4cf199a7903 |

The content of this package is listed below:

^Component ^Version ^	
| **keros**	| 4.3.3    |
| **bscc**	| included in KerOS 4.3.3 firmware |	
| **lorasnmp**  | included in KerOS 4.3.3 firmware |	
| **lorad**	| included in KerOS 4.3.3 firmware |	
| **lorafwd**	| included in KerOS 4.3.3 firmware |	

Starting from version 4.3, KerOS firmware is delivered with Kerlink Common Packet Forwarder and WMC Embedded applications. These applications are disabled by default and need to be enabled to use the gateways on WMC. \\
\\
There are 3 ways to update your gateway's software:
  * by using the [[.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)]]
  * 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 keros_4.3.3_klkgw-signed.ipk  root@<ip_address>:/user/.updates/
scp openvpn-*.ipk root@<ip_address>:/user/.updates/
</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.
  - 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 ===== 

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**. \\
If you want to install this software from a KerOS 3.x, you need to install a KerOS 4.0 before upgrading your system:
[[https://wikikerlink.fr/wanesy-ran/doku.php?id=wiki:wiki3:gateway_sw_3.1|SW_3.1]]

To update your system from a KerOS 4.x system, you will need to create 2 USB sticks:

The first USB stick will install the firmware 4.3.3 with embedded BSCC, SNMP and CPF. \\
The second USB stick will configure the VPN to connect to your WMC server (klk_apps_config).

^description                 ^file        ^md5sum      ^
|**USB stick ** | {{ :wiki3:auto_deploy_keros_4.3.3_usb_stick_1.tar.gz | AUTO_DEPLOY_KEROS_4.3.3_USB_STICK_1.tar.gz }} |  c8eee539e87b9623c36884e69fd4a6cd  |
|**USB stick ** | {{ :wiki3:auto_deploy_keros_4.3.3_usb_stick_2.tar.gz | AUTO_DEPLOY_KEROS_4.3.3_USB_STICK_2.tar.gz }} |  0f3ad94ba33b77e44f7275b3c8c802b4  |


**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.

\\
To update your gateway, apply the following procedure :

> 1. Deflate twice the AUTO_DEPLOY_KEROS_4.3.3_USB_STICK_1.tar.gz file to get .ipk files and put them on your USB stick in the root directory
> 2. Copy all files located in the folder AUTO_DEPLOY_KEROS_4.3.3_USB_STICK_X in the root directory
> 3. Request your VPN secret package(s) v4.3 to the Kerlink Support team: [[support@kerlink.fr]] (optional: in case of a First Install or Migration or Upgrade from FW < 4.2.2)
> 4. Put your VPN secrets packages of your KerOS products in the //vpn_packages// directory (optional: in case of a First Install or Migration or Upgrade from FW < 4.2.2))
> 5. Plug the first USB stick in the gateway USB slot (device must be powered on)
> 6. Wait for the leds blinking and unplug the USB stick from the slot
> 7. The system reboots
> 8. Wait for the end of the update

> 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''.
> 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
> 14. The system reboots
> 15. Wait for the end of the reboot 

Refer to the specific wiki to get more details about software update over USB: \\ 
**Wirnet i-series (iBTS, iFemtocell, iStation, iFemtoCell-evolution)**: [[http://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:keros_custo:sw_updates#software_update_over_usb]] \\
\\
\\
==== USB stick 1 content ====

The USB tree should contains the following files/folders:

<code>
/               
└── COMMON                                                    # Common packages folder
|    └── keros_4.3.3_klkgw-signed.ipk                         # Keros v4.3.3 firmware package
|
├── 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_***_4.3.ipk            # OpenVPN package for one KerOS product to connect to a WMC platform (here wmcbeta)
    ├── openvpn_***_wmcbeta.wanesy.com_***_4.3.ipk            # another package for one KerOS product to connect to a WMC platform (here wmcbeta)
    ├── openvpn_***_wmcbeta.wanesy.com_***_4.3.ipk            # ...
    ├── openvpn_***_wmcbeta.wanesy.com_***_4.3.ipk            # ...
    ├── openvpn_***_wmcbeta.wanesy.com_***_4.3.ipk            # ...
    ├── openvpn_***_wmcbeta.wanesy.com_***_4.3.ipk            # ...
    └── openvpn_***_wmcbeta.wanesy.com_***_4.3.ipk            # ...

</code>
\\

==== USB stick 2 content ====

The USB tree should contains the following files/folders:

<code>
/               
├── 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)
└── wmc-server-name.txt                      # WMC server name (ex: wmc-poc.wanesy.com)
</code>

\\
===== Changelog =====

Main changes regards to the 3.2 embedded software release are listed below:

  * Integration of CPF in KerOS 4.3.3 firmware
  * Integration of WMC Embedded applications 4.3.3 firmware
  * Add NetID Filtering in CPF
  * Increase CPF log size
  * Uplink: fix fallback from Ethernet to GSM if no DNS server
  * CPF: fix reconnection to LNS server after an uplink reconnection
 
Please note that, if gateways use public IP, it also makes your gateway accessible from Internet on open SSH or HTTP ports (protected by passwords). Kerlink so recommends to change passwords as described in [[https://wikikerlink.fr/wirnet-productline/doku.php?id=wiki:systeme_mana:connection_credentials|Connection, login and credentials]]
\\
\\
===== Warranty =====

<note important>
**CAUTION ABOUT WARRANTY:** \\
**Kerlink is not responsible for damages resulting from failure to follow these instructions relating to the Kerlink Product’s use.**
</note>
Wanesy™ Management Center (End Of Life)

User Tools

Site Tools

Page Tools
