====== Update a group of gateways on Wanesy Management Cockpit ======
===== Documentation =====

[[https://wmc.wanesy.com|Wanesy Management Cockpit]]  (online)
[[https://wmc.wanesy.com/docs/index.html|API Web services documentation]]  (online)

===== Update a group of gateways =====
<note>
The constraints associated to the group update command are as follows:
  * The udpate command is only accessible to users with **SERVICE_ADMINISTRATOR** and **CHANNEL_ ADMINISTRATOR** roles
  * It is not possible to send a new udpate command (whatever its type) if the same one is already in progress for the group or one gateway of the group
</note>

To update a group of gateways, you need to go to the ''Group overview'' page and select ''Software update'' from the ''CONFIGURATION'' menu.

{{:images:group_update_menu.jpg?800|}}

You are then redirected to the "Group software update" page.

{{:images:group_update_page.jpg?800|}}

You have the option to select:
  * A pre-defined software update (previously declared by Kerlink) to apply a public software or configuration
  * A Custom Magic Link to apply a specific software or configuration

{{:images:group_update_list.jpg?400|}}

<note>For a Custom Magic Link, you will be asked to enter the ''Magic Link value'' (i.e. the hash) provided by Kerlink support team. \\
This option will work only for gateways declared in the Magic Link.</note>

After clicking on ''SEND'' button, you will be asked to confirm in a popup.

Once triggered, the udpate command will be sent to each gateway of the group when the next telemetry message is received (message expected every hour).

When an update command is in progress (waiting to be sent to all the gateways), an orange dot is displayed in the ''CONFIGURATION'' menu.

{{:images:group_update_pending.jpg?200|}}

You can consult the software update history of your group in the ''Last updates'' table.

{{:images:group_update_history.jpg?800|}}

Depending on its progress, the update command goes through different possible statuses:
  * **Created**: the update command has been created
  * **In progress**: the update command is ready to be sent to the gateways
  * **Sent**: the update command has been sent to all the gateways
  * **Partially sent**: the update command has been sent to some of the gateways
  * **Cancel request**: the cancellation of the update command has been requested
  * **Cancelled**: the update command has been cancelled

To cancel the update command, you need to click on the ''CANCEL UPDATE'' button present in the table.

Clicking on the eye link in the ''Last updates'' table opens a dashboard allowing you to follow the progress of the group update.

{{:images:group_update_dashboard.jpg?800|}}

Clicking on a status in the progress bar allows to only list the gateways with update specifically in this status.

You have the option to cancel the update individually at each gateway (by clicking on the ''CANCEL UPDATE'' button at the end of each line).

The dashboard is automatically refreshed and goes through the different statuses, until it is **Sent**, **Partially sent** or **Cancelled**.

{{:images:group_update_dashboard_sent.jpg?800|}}