====== Base Station Controller ======

The goal of the BSC is to manage the gateways, supervise their status and collect statistics about them.

{{:wiki:bsc_overview.png|}}

===== Fleet management =====

A fleet is a collection of gateways.

Through the Dashboard interface, a fleet can be selected via the filtering option //Select your fleet//:


{{:images:fleet_filtering.png|}}

Once a fleet is selected, the following views are prompted to the interface: 

{{:wiki:fleet_dsc_synthesis.png|}}
{{:wiki:fleet_dsc_last_operations.png|}}
{{:wiki:fleet_dsc_overview.png|}}

===== Stations management =====
==== Dashboard ====
Gives a status summary of each gateway of your fleet 

{{:wiki:stations_management_list_3.png|}}

==== Station Status ====
By clicking a particular gateway EUI, you can obtain a high level view of the gateway and its status summary:

{{:wiki:station_status_2.1.png|}}


==== Station Statistics ====

By selecting the //Statictics// menu option, you can get a detailled and historical view of your gateway: 

  * Link Status
  * RAM
  * CPU
  * Disk (System & User)
  * RSSI
  * Temperature
  * Power supply
  * Uplink (from 2.1 release version)
  * Downlink (from 2.1 release version)

{{:wiki:stats_link_status_2.1_2.png|}}

{{:wiki:stats_ram_2.1_2.png|}}

{{:wiki:stats_cpu2.1.png|}}

{{:wiki:stats_system_disk_2.1.png|}}

{{:wiki:stats_user_disk_2.1.png|}}

{{:wiki:stats_rssi_2.1.png|}}

{{:wiki:stats_temperature_2.1.png|}}

{{:wiki:stats_power_supply_2.1.png|}}

{{:wiki:stats_uplink_messages_2.1.png|}}

{{:wiki:stats_uplink_bytes_2.1.png|}}

{{:wiki:stats_downlink_messages_2.1.png|}}

{{:wiki:stats_downlink_bytes_2.1.png|}}


===== Stations configuration =====
==== Remote connection ====
  * File System explorer
  * Shell
  * Command

The difference between shell and command is that the former is a full interactive shell, while the latter is just a non-interactive command launch.

The interactive shell may have been disabled by your network or security configuration.

==== Configuration ====
Control panel enables to configure
  * CPU
  * System disk
  * Door

\\
==== Sofware update ====

==== Versions information ====

By selecting the "Versions" item of the menu options, you can obtain following information:

  * information about the current version of the gateway,
  * information about older versions of the gateway,
  * information about the last software update, 


{{:wiki:versions_2.png|}}

\\
==== Execute a software update ====

There are 2 ways to perform a Software Update through the Dashboard interface:

   - Software Update by using Drag&Drop feature
   - Software Update by using the Workflow feature
\\
 

=== Software Update by using Drag&Drop feature ===

By selecting the "Software update" option, you can execute an update of your gateway:

   - Drag and drop your .tar.gz file to the "File" area
   - Select the date of the update (now or planned for a specific date) 
   - Click the "send" button to proceed to the update.

{{:wiki:software_update_2.1_1.png|}}

{{:wiki:software_update_2.1_2.png|}}

Then confirm the update :

{{:wiki:confirm.png?|}}

Once the package has been received by the gateway, the following message is prompted to the user:

{{:wiki:successful_update.png?|}}

Then the system reboots to install the new package in the system.

<note important>
In the case of several package updates to perform in sequence, you should wait that the system is ready to accept a new update. In fact, you must wait the "connected" status before dropping the new package in the Drag&Drop area 
</note>


{{:wiki:connected2.png|}}

If you don't wait sufficient time before proceeding to the new package update, the following message may be prompted to you:

{{:wiki:error_during_loading.png|}}

\\
=== Software Update by using the Workflow feature ===

<note important>
Feature is only available from RAN 2.1 release version
</note>

From RAN 2.1 release version, it is possible to update a group of gateways by using the Workflow feature.

To achieve this function, you should :

  - Create and save your list of stations or load your Cart 
  - Execute an updateFirmware workflow

== Create your Cart == 

<note important>
It is recommended to group a same type of products in your cart before applying a worflow.
</note>

In BSCC menu, click on "Stations" and select the stations you want to add in your cart by clicking on the "Cart button" at the left side of the station's EUI:

{{:wiki:add_station_to_cart4.png|}}

== Save your Cart == 

Click on the Cart icon located in the upper right side of your web page:

{{:wiki:save_cart2_1.png|}}

Then, select the "Save cart" icon at the bottom left of your page:

{{:wiki:save_cart2_2.png|}}

Enter the name of your Cart (mandatory) and a description (facultative):

{{:wiki:save_cart2_3.png|}}

<note important>
It is recommended to put the name of your product in the name of the Cart: ex "DSC_Wirnet_Stations"
</note>

To ckeck the save operation has been correctly done, select the manage icon in the bottom right of your page:

{{:wiki:save_cart2_4.png|}}

and check that your Cart has been successfully created:

{{:wiki:save_cart2_5.png|}}

== Load your Cart == 

If your list of stations has been already saved, you can load it to your Cart by 2 manners:

   - from the manage function
   - from the add saved cart function

== Load your Cart from the manage function == 

Select the manage function:
  
{{:wiki:load_an_empty_cart_from_manage_option_1.png|}}

Add the list to your Cart:
  
{{:wiki:load_an_empty_cart_from_manage_option_2.png|}}

View your Cart's content:

{{:wiki:load_an_empty_cart_from_manage_option_3.png|}}

{{:wiki:load_an_empty_cart_from_manage_option_4.png|}}


== Load your Cart from the "Add saved cart" function == 

Select the "Add saved cart" function:
  
{{:wiki:load_an_empty_cart_from_add_option_1.png|}}

Select the list to load your Cart:
  
{{:wiki:load_an_empty_cart_from_add_option_2.png|}}

View your Cart's content:

{{:wiki:load_an_empty_cart_from_add_option_3.png|}}


== Execute an updateFirmware Workflow == 

   - Select the Cart icon
   - Select the Workflow function
   - select the updateFirmware option in the ListItems menu

{{:wiki:select_worflow_updatefirmware_4_zoomed.png?800|}}

then select the file used to upgrade the gateway:

{{:wiki:workflow_select_file2.png|}}

then select the execute date:

{{:wiki:select_workflow_execute_date_2_zoomed.png?800|}}

and select the START button. A message indicates that the workflow has started :

{{:wiki:started_workflow_updatefirmware_3.png?300|}}

You can see your work in progress by selecting the Worflow feature in the main vertical menu in the left side of your page:

{{:wiki:workflow_in_progress_3_zoomed.png|}}

When the process completes, it disappears from the "Workflow processes in-progress" list and is added to the "Workflow processes Ended" list:

{{:wiki:workflow_ended_2.png|}}

The operation result can be viewed by selecting the EUI of your station in the list:

{{:wiki:workflow_result_updatefirmware_4.png|}}

{{:wiki:workflow_result2_updatefirmware_3.png|}}


==== Task, SNMP, Events ====
=== Tasks ===
This section lists all the tasks that were run on the station. When clicking on a task, you can see all its messages and SNMP logs.

=== SNMP ===
This section lists all the SNMP requests that were made on the gateway.

=== Events ===
It lists all events that were triggered on the gateway.


== Alarms ==

Events can be alarms (high CPU value for instance) or simple events (station start, door open/closed, etc.).

This section presents the alarms of the selected fleet:

{{:wiki:bsc_alarms.png|}}