EMS User Manual-v2.0.0 Revision Date Author Comments 1.0 07/18/19 MK Final Draft to DISH networks 1.1 07/29/2019 AS (Demo Fdbk) permission to create delete and update alarm for different users. 1.2 09/18/2019 AS Updated configuration, alarm tables. Added Reboot, Show notifications and Audit logs procedures. Updated Saankhya logo and requirements for ems (Browser versions). 1.3 10/07/2019 AG Alarms Documentation and other configuration related fixes 1.
EMS User Manual-v2.0.
EMS User Manual-v2.0.0 Introduction Kailash EMS is used to manage a network of Broadcast Radio Heads (hereafter referred to as BRH). The management comprises of following: - Fault Monitoring Configuration Accounting Provisioning Security This confirms with the traditional FCAPS model for management of telecom networks. Details of workflow and how the above model is available to the user is described in the following sections.
EMS User Manual-v2.0.0 Figure - 1 : EMS Roles and Users Configuration Configurations are of 2 types: 1) Device Configuration - This configuration determines both the boot time and run-time behavior of the device. This configuration can be applied per device or for a set of devices. These include parameters for all the different submodules which can be changed etc. (eg. STLIP IP Address/Port, MPE PID etc.
EMS User Manual-v2.0.0 Accounting This being a broadcast solution, there is no per user accounting that is applicable in the case of EMS. Fault Monitoring Faults originated at the device are available as Alarm Notifications on EMS. Based on the Alarms Configuration for a given type of Alarm, an alarm can be acknowledged automatically. Details of the alarms supported by the system are mentioned in the table below.
EMS User Manual-v2.0.0 EMS workflows EMS Workflows define user interaction with the EMS UI. This workflow typically consists of following three stages 1. Initial Setup - This involves actions required to bootstrap EMS system and setting up initial user for the EMS. This action is not exposed through EMS UI. 2. Provisioning - This includes adding users to system, defining device configurations adding new devices to the system etc. 3.
EMS User Manual-v2.0.
EMS User Manual-v2.0.0 Logout as ‘Owner’ Role and Login as ‘Administrator’ Role (optional) All the subsequent steps are performed with the user logged in at the end of step 3 above.
EMS User Manual-v2.0.0 2) Fill in the required form (All fields are Required) 3) Operator if Added is shown successfully.
EMS User Manual-v2.0.
EMS User Manual-v2.0.0 Note: FCC Configuration is available only in devices with latest firmware and for the user with Owner privilege. Warning : CW mode is strictly to be used in a controlled environment, And is intended to be used for FCC testing purposes only. Device Configuration, if added, is shown successfully.
EMS User Manual-v2.0.0 2) Fill in the appropriate values of the configuration as indicated in the table below Supported Values are as below Component Parameter Value type Value range Comments DVBS2 Center Frequency (MHz) Float 950-2150Mhz In 100 KHz step Symbol rate (MSPS) uint32 1000000-40000000 Samples/sec PID uint16 0 - 8191 Multicast IP uint32 239.127.1.
EMS User Manual-v2.0.0 FCC Configuration CW mode "off" "on" When CW mode is "off" the BRH unit will transmit an ATSC3.0 signal. When CW mode is "on" the BRH unit will transmit a continuous waveform signal with center frequency 725Mhz; With transmission power fixed at 37dbm/5Watt.
EMS User Manual-v2.0.0 The parameters are as discussed below Parameter Type Valid range Serial Number ASCII string Model No Drop down MAC ID ASCII String Operator Drop down list of Operators. Operators configured for this owner Configuration Drop Down list of Config Names Configuration s created for the devices.
EMS User Manual-v2.0.0 Boot-up the Device Once the device is provisioned, it is ready to be connected to the network. Power on the device and ensure that the device has network connectivity. The device should initiate contact with the EMS server. The change in the states of the device is observed on the status icon as shown in Figure above. Wait for the icon to turn green indicating device is now functional When the device is operational, Device Status, Serial No.
EMS User Manual-v2.0.0 Monitoring Device Statistics Once the device is operational, device statistics can be monitored from the EMS UI.
EMS User Manual-v2.0.
EMS User Manual-v2.0.
EMS User Manual-v2.0.0 3) It is possible to monitor real time values for different statistics graphically. Please select the value(s) to be plotted and then the values appear along with their plot in the area for the plot. 4) It is possible to plot historical data by clicking “Plot Historical Chart” button. A historical chart window pops up. It is possible to plot using user selected time intervals. Also, pre-configured buttons for 1day, 7day and 15day historical data is available.
EMS User Manual-v2.0.0 b Historical Char Dialog as below pops up c It is possible to download historical data as a CSV.
EMS User Manual-v2.0.0 Configuration of Device Alarms (Notifications) Notifications are triggered from the BRH Device under deviation from expected behaviors. These notifications are displayed in the EMS as Alarms. Alarms provide a window into the health of a given BRH Device as well as across several BRH devices across the network. Alarms that will be generated are system defined and are captured in the table below.
EMS User Manual-v2.0.0 2) Details of a given System Supported alarm are as shown below. Once changes are performed to Configuration, the changes can be saved by clicking the “Edit Alarm” button.
EMS User Manual-v2.0.0 Alarms - Monitoring and Acknowledging Generated Alarms that are not automatically acknowledged are visible on Both Dashboard and Top Level Alarms page. Dashboard being the landing page of the application, user actionable things are available on the dashboard. Also an alarm “clear” functionality is implemented in the EMS.
EMS User Manual-v2.0.0 6) Alarms can be filtered using different filtering criteria ○ Alarm source ○ MAC ID of the device ○ Severity (See values in the Table 5 above.) ○ Time based filtering (last n days/ n hours) Alarms - Downloading Historical Data It is possible to download historical data for the alarms up to 30 days prior at-least. Note: in some cases additional data may also be available. This data can be downloaded by clicking on the “CSV” button on the alarms page.
EMS User Manual-v2.0.0 1) Navigate to BRH Firmwares and Click “+” to add a new Firmware. This will open a dialog to upload firmware to EMS. 2) Click on choose file to select firmware, and add version.
EMS User Manual-v2.0.0 3) On successful addition, the firmware should be visible in the list of BRH Firmwares.
EMS User Manual-v2.0.0 4) Navigate to BRH Device and click on more, and select software upgrade from the drop down menu. Note: Some Options may be available only on devices with latest firmware and they are also available only to a user belonging to a certain role. (eg. Snapshot Related options are available only on device with latest firmware only for the users belonging to Owner Class.) 5) In the dialog that is shown, Choose the firmware that is to be uploaded.
EMS User Manual-v2.0.0 Rebooting Device 1) Navigate to BRH Device and click on more, and select Reboot from the drop down menu and Confirm. Viewing Device Notifications (Alarms) 1) Navigate to BRH Device and click on more, and select Show Notifications from the drop down menu.
EMS User Manual-v2.0.
EMS User Manual-v2.0.0 Updating Runtime Configs Runtime configuration of a BRH device can be upgraded through an action provided on “BRH Devices” Page. The following RF Transmission parameters can be updated during runtime once the device has connected to EMS: ● Transmission Power can be configured between 37dbm/5Watt and 30dbm/1Watt. ● Transmission Frequency(Mhz) can be configured to 725.0 Mhz. ● RF Transmission can be configured to "on" to enable RF transmissions or "off" to mute RF transmissions.
EMS User Manual-v2.0.0 Note: Ability to control RF Transmission will be available for only devices with latest firmware versions. For devices with older firmware versions, the default choice is On. 3) The updated configuration will be applied to the device and a result of success or failure will be logged in the audit logs.
EMS User Manual-v2.0.0 2) Audit logs can be viewed in pages. All the historical audit logs generated can be downloaded as a CSV File by the user by clicking the “CSV” button.
EMS User Manual-v2.0.0 a b c username (User that triggered the option) deviceid (Devices for which action was triggered) facility (Security - login etc. or device_tasks - Reboot/Upgrade etc.) Device Snapshots This feature is available for users with “owner” privileges. Using this feature it is possible to collect logs at a device from the EMS. Note: This feature consumes a lot of upstream bandwidth at the device end and should only be used sparingly only for debugging purposes.
EMS User Manual-v2.0.
EMS User Manual-v2.0.0 Operation Owner Admin Operator View Device Statistics Yes Yes Yes View Running Devices List Yes Yes Yes View Audit Logs Yes No No Add New Firmware Yes Yes No View List of Firmwares Yes Yes Yes Delete Firmware Yes Yes No Upgrade device with new Firmware (already added) Yes Yes Yes Reboot Device Yes Yes Yes Update Runtime Configuration Yes Yes Yes Table 6: Role Actions Note :- “*” means A user can view / update his/her own data.
EMS User Manual-v2.0.0 Browser Requirements Browser versions which support EMS Google Chrome Version 75.0.3770.142(Official Build) (64 bit) or above. Firefox Quantum Version 60.8.0esr(64bit) or above.
