User Tools

Site Tools


wiki:wiki3:magic_link

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
wiki:wiki3:magic_link [2020/05/18 14:54]
tda
wiki:wiki3:magic_link [2020/12/14 14:44] (current)
tda
Line 29: Line 29:
  
 <note important>​ <note important>​
-This feature //​requires//​ an Internet connection throughout all the procedure.+**This feature //​requires//​ an Internet connection ​(ethernet, cellular or wifi) throughout all the procedure.**
  
 The used connection is HTTPS to ''​upgrade.wanesy.com''​ (TCP port 443). The used connection is HTTPS to ''​upgrade.wanesy.com''​ (TCP port 443).
Line 46: Line 46:
 For Wirnet iBTS and Wirnet iFemtoCell, please remove the USB stick after 15 seconds (as soon as the LED blinks). For Wirnet Station, please leave the USB stick plugged in for 20 minutes, or until the gateway is shown as connected on the WMC instance. For Wirnet iBTS and Wirnet iFemtoCell, please remove the USB stick after 15 seconds (as soon as the LED blinks). For Wirnet Station, please leave the USB stick plugged in for 20 minutes, or until the gateway is shown as connected on the WMC instance.
  
 +\\
 ==== Over WMC dashboard ==== ==== Over WMC dashboard ====
  
 Over WMC dashboard, you can use the Magic Link to update a single gateway or a group of gateways. Over WMC dashboard, you can use the Magic Link to update a single gateway or a group of gateways.
  
 +\\
 === Updating a single gateway with the Magic Link == === Updating a single gateway with the Magic Link ==
 +\\
 For WMC, it is less useful to use the Magic Link as the Software Upgrade feature can be used to send any package: new VPN package (migration),​ megapackage (upgrade), etc. For WMC, it is less useful to use the Magic Link as the Software Upgrade feature can be used to send any package: new VPN package (migration),​ megapackage (upgrade), etc.
  
-The advantage though, is that it's no longer required to download the megapackage from this wiki and upload it in the //Software update// section of the WMC. The gateway will directly download the megapackage and VPN package ​through the use of the Magic Link.+The advantage though, is that it'​s ​**no longer required to download the megapackage from the Wiki in one hand and the OpenVPN packages on the other hand.** \\ 
 +The gateway will directly download the required ​megapackage and VPN packages according to the software version of your WMC through the use of the Magic Link.
  
 +**The other advantage is that you can update a remote gateway by using the magic link script.**
  
-Use the File Explorer feature of the WMC to upload the Magic Link script to ''/​tmp''​ or ''/​user''​. Then use the Remote Shell feature and type: ''​sh /​tmp/​magic_link.sh''​+<note important>​**Do not use the magic link command directly in the Remote Shell session. That does not work. Use instead the Magic Link script to update remote gateways.**</​note>​ 
 + 
 +Do achieve this, \\ 
 +  - Use the File Explorer feature of the WMC to upload the Magic Link script to ''/​tmp'' ​(for Wirnet Stations) ​or ''/​user'' ​(for i-Series Stations) 
 +  - Then use the Remote Shell feature and type: ''​sh /​tmp/​magic_link.sh'' ​for Wirnet Stations or ''​sh /​user/​magic_link.sh''​ for i-Series Stations.
  
 {{:​wiki3:​upload_magic_link_script.png|}} ​ {{:​wiki3:​upload_magic_link_script.png|}} ​
  
 Then execute the Magic Link script using the remote shell feature: ​ Then execute the Magic Link script using the remote shell feature: ​
 +{{:​wiki3:​executing_magic_link_script_here.png|}}
  
-{{:​wiki3:​executing_magic_link_script.png|}}+\\ 
 +=== Updating a whole set of gateways with the Magic Link == 
 +\\ 
 +Updating a single gateway is easyUpdating one hundred gateways is a boring task !
  
 +The Workflow feature will deliver you from this hard task !
  
-=== Updating ​a whole set of gateways ​with the Magic Link ==+In the same order, the Magic Link feature can be used to **update different types of gateways**, the Workflow feature can be used to update ​**whole set of gateways**. \\ 
 +Combining both, that will allow us to update **a whole set of different types of gateways.** \\ 
 +That'​s ​the magic of these features !
  
-Since the same script can be used to update ​gateway, the Magic Link can be used to update ​whole set of gatewaysThat's the magic of this feature !+<note important>​ 
 +**Care: This feature is only available for WMC with software release >= 3.2. and a Gateway FW >= 4.0 (>= embedded SW 3.1) ** 
 +</​note>​
  
-Create ​template using the 2 following web services:+The first thing to do is to **ask the Kerlink Support to deliver you magic link** to update your gateways. You need to give them the serial numbers of all your gateways you want to update.
  
-- CreateGatewayPutFileCommand\\ +Thenyou have to select all your gateways by clicking the cart icon in front of each gateway or selecting the cart icon located at the upper level (near EUI item) if you want to select all the gateways of the current page (you can also change the number of items per page: /10 /50 /100).
-- CreateGatewayCommand.+
  
-{{:wiki3:create_template3.png|}}+{{:wiki3:add_gateway_to_cart.png?|}}
  
-Take care to put CreateGatewayPutFileCommand as Task #1 and CreateGatewayCommand as Task #2.+{{:​wiki3:​add_gateway_to_cart2.png|}} 
 + 
 +<note important>​**Care to not mix i-Series Gateways (Wirnet iStation, Wirnet iBTS, Wirnet iFemtoCell) with Wirnet Stations when you create your list of stations \\ 
 +since the parameters will differ when creating the workflow. \\ \\ 
 +Create a workflow for Wirnet Stations only and another one for i-Series Stations.**</​note>​ 
 + 
 +<note important>​**We recommend to put a maximum of 100 gateways in the workflow to be sure that all the tasks will be correctly performed.**</​note>​ 
 + 
 +Then, create a template using the 2 following web services: 
 + 
 +- **createGatewayPutFileCommand**,​ \\ 
 +- **createGatewayCommand**. 
 + 
 +{{:​wiki3:​create_template3_new.png|}} 
 + 
 +Take care to put ''​CreateGatewayPutFileCommand'' ​as Task #1 and ''​CreateGatewayCommand'' ​as Task #2.
 Give a name to your template and select the button ''​VALIDATE''​. Give a name to your template and select the button ''​VALIDATE''​.
  
-Go to your Cart and select your new template:+Go to your Cartselect ​''​Execute Workflow''​ and choose ​your new template:
  
-{{:wiki3:execute_magic_link_template.png|}}+{{:wiki3:execute_magic_link_template_new.png|}} 
 +{{:​wiki3:​execute_magic_link_template2_new.png|}}
  
-{{:wiki3:​execute_magic_link_template2.png|}}+Click on the ''​CHOOSE A FILE''​ button and select the Magic Link script delivered by your favorite Kerlink Support team:
  
-Click on the ''​CHOOSE A FILE''​ button and select your Magic Link script delivered by the Kerlink Support team:+{{:wiki3:​execute_magic_link_template3_new.png|}}
  
-{{:​wiki3:​execute_magic_link_template3.png|}}+Set the destination path to ''​**/​tmp**''​ if you are using a **Wirnet Station** else set the value of ''​**/​user**''​ for **i-Series products**,
  
-Set the destination path to ''/​tmp''​ if you are using a WIrnet Station else set the value of ''​/user''​ for KerOS product,+<note important>​**Care to specify ​the correct ​destination path to avoid the workflow task failing.**<​/note>
  
-Copy/Paste the Magic Link script filename to the command area and prefixe it with the ''​sh ​/user/''​ command:+Copy/Paste the Magic Link script filename to the command area and prefixe it with the ''​sh''​ command ​and destinationPath value:
  
-{{:wiki3:execute_magic_link_template4.png|}}+{{:wiki3:execute_magic_link_template4_new.png|}}
  
 Select the START button. Select the START button.
Line 104: Line 136:
 {{:​wiki3:​execute_magic_link_template5.png|}} {{:​wiki3:​execute_magic_link_template5.png|}}
  
-Wait for the workflow execution to complete:+Wait a few minutes (around 5'​) ​for the workflow execution to complete.
  
 {{:​wiki3:​execute_magic_link_template6.png|}} {{:​wiki3:​execute_magic_link_template6.png|}}
  
 +All your gateways have been updated.
 +
 +<note important>​**Due to a bug, the workflow task may stay in pending state for a long time. Check gateway side if the update has been correctly done for each gateway in the list. This bug will be fixed in a future WMC software release.**</​note>​
 +
 +So, the page about completed workflows will show information about the completed status of your task once the time out has been reatched (2 hours).  ​
 +\\
 +\\
  
 ===== Use cases ===== ===== Use cases =====
  
-==== First installation ====+==== First installation ​/ Prestaging ​====
  
    * over SSH: not applicable for cellular backhaul unless the gateway has a known public IP address. A DHCP server would be necessary on the LAN if Ethernet/​WiFi,​ though static IP should work if directly connected to a computer (static IP and RJ45 cable or WiFi access from the computer to the gateway).    * over SSH: not applicable for cellular backhaul unless the gateway has a known public IP address. A DHCP server would be necessary on the LAN if Ethernet/​WiFi,​ though static IP should work if directly connected to a computer (static IP and RJ45 cable or WiFi access from the computer to the gateway).
    * over USB: works all the time, but requires physical access.    * over USB: works all the time, but requires physical access.
  
-==== Migration (e.g. from instance A to instance B) ====+==== Migration (e.g. moving gateways ​from instance A to instance B) ====
  
    * over SSH: only applicable for on-premises instances (where SSH is available through the VPN tunnel from the WMC server itself).    * over SSH: only applicable for on-premises instances (where SSH is available through the VPN tunnel from the WMC server itself).
-   * using WMC: upload ​script and execute it.+   * using WMC: upload ​the Magic Link script and execute it.
    * over USB: works all the time, but requires physical access.    * over USB: works all the time, but requires physical access.
  
-==== Upgrade (e.g. same instance, ​but different embedded software version) ====+==== Upgrade (e.g. same instance, ​updating gateways) ====
  
    * over SSH: only applicable for on-premises instances.    * over SSH: only applicable for on-premises instances.
-   * using WMC: upload ​script and execute it.+   * using WMC: upload ​the Magic Link script and execute it.
    * over USB: works all the time, but requires physical access.    * over USB: works all the time, but requires physical access.
  
 ===== Specific Use cases ===== ===== Specific Use cases =====
  
-When may want to upgrade several gateways ​using the Magic Link. +Combine Magic Link and Workflow features ​to upgrade several gateways ​in one shoot.
-In this case, you can use the workflow feature to achieve this.+
  
  
wiki/wiki3/magic_link.1589806458.txt.gz · Last modified: 2020/05/18 14:54 by tda