A network-wide view of devices is available by clicking Devices in the navigation pane. Two sub-menus are available: List and Operations.
Click Devices → List to display device information in a tabular format by device type. Use the toggle in the upper left-hand corner to show either RNs or BNs. Remember to use the filters in the top middle portion of the screen to select a specific network. The Device List view is a convenient way to examine many different details about a particular device.
Figure 49: Devices List View
Devices that are up and connected will have their serial number listed in green. Disconnected devices are shown in red. An orange lightning bolt icon indicates that a device is currently unreachable. A device that is shown to be connected but unreachable (RN 2N-094 in the example below) indicates that the device is able to talk to TCS but that TCS is unable to talk to the device.
Click on the Device Status dropdown box to show All, Connected, or Disconnected devices. Clicking the serial number of a device will open the device dashboard.
Figure 50: Devices List (Connected Status)
Select an individual device to issue an operational command against it. Choose from Upgrade, Snapshot, or Reboot. Each of these will be discussed further in the Device Operations section. For RNs, a fourth operation, Remove from TCS, is available.
Figure 51: Devices List (Device Operations)
A warning/confirmation message will appear before the device is removed from the TCS.
Figure 52: Remove from TCS (RN only)
Use the search box to dynamically filter against values in most of the columns.
Figure 53: Devices List Searches
Most columns are sortable. Click the column title (e.g., Serial Number, Hostname, etc.) to sort in ascending or descending order. Note: The column categories available are dependent on the device type and categories shown in the table can be customized.
Figure 54: Devices List Columns
To resize columns (here or other tables such as Alarms or Events), mouse to between column headings to get the resize tool. Click and drag to the right or left to widen or narrow the column width.
Note
This is not a persistent change.
Figure 55: Resize Columns
The data displayed for each column is not automatically refreshed. To do so, click the refresh icon in the bottom right corner to refresh data. Note: This will persist for the user account even after logging out. To download the data displayed in CSV format, select the checkbox next to the devices and click Download in the bottom left corner. The file will be saved to the local device.
Figure 56: Refresh and Download Device List Data
To customize what is shown, click the Customize icon in the bottom right corner and select the appropriate information. Click Done to update the display.
Note
These changes persist for the user even after logging out.
Figure 57: Customize Device List View
Link metrics provide measured operational information about the device link between the BN and RN.
RN Link Metrics:
-
Availability (month): The time that the link was up regardless of which BN the RN is connected to. Included time in the down-time calculation are unintentional reboots (watchdog timeout or crash) and the amount of time required to connect to an alternate BN. Excluded from the down-time calculations are cold boots (powered off or a power outage), intentional reboots (such as user initiated or software upgrades), associated BN is powered off and no other BN is available, or the BN’s data interface is down. This value is calculated as a percent out to two decimal places. Parameter resets at the first of every month.
-
LoS Distance: Indicates the calculated distance between the BN and RN. This is only available if the RN has been configured with latitude and longitude information.
-
RF Range: Indicates estimated distance traveled by the RF signal taking into consideration signal reflection and refraction (in meters).
-
Path Loss: Measured attenuation of the signal by air and obstructions of the link (in dB).
-
Link Uptime: Length of time the link has been established
-
DL SINR: Downlink signal-to-interference-noise ratio (in dB).
-
UL SINR: Uplink signal-to-interference-noise ratio (in dB).
-
DL PER: Downlink packet error rate.
-
UL PER: Uplink packet error rate.
-
DL Tonnage (24 hrs): Total amount of data sent from BN to RN in the past 24 hours (in gigabytes).
-
UL Tonnage (24 hours): Amount of data transferred from the RN to the BN in the last 24 hours (in gigabytes).
-
DL Tonnage (month): Total amount of data sent from BN to RN in the past calendar month (in gigabytes).
-
UL Tonnage (month): Amount of data transferred from the RN to the BN in the past calendar month (in gigabytes).
-
DL Peak: Peak downlink speed (in Mbps) since the link was brought up (resets at device reboot).
-
DL Peak (24 hrs): Peak downlink speed over the last 24 hours (in Mbps).
-
UL Peak: Peak uplink speed (in Mbps) since the link was brought up (resets at device reboot).
-
UL Peak (24 hrs): Peak uplink speed over the last 24 hours (in Mbps).
-
DL Rate: Downlink layer 2 rate of data transfer (in Mbps) as assigned by the scheduler.
-
UL Rate: Uplink layer 2 rate of data transfer (in Mbps) as assigned by the scheduler.
-
Life Time DL Peak: Peak downlink speed (in Mbps) since the RN associated with a BN (survives device reboot).
-
Life Time UL Peak: Peak uplink speed (in Mbps) since the RN associated with a BN (survives device reboot).
-
DL Transport Block Error Rate: Rate at which downlink transmit blocks errors occur. A transmit block is defined as data sent within a dedicated portion (width) of the utilized channel for a period of time.
-
UL Transport Block Error Rate: Rate at which uplink transmit blocks errors occur. A transmit block is defined as data sent within a dedicated portion (width) of the utilized channel for a specified duration of time.
-
Intf. Noise Ratio Max Carrier 0: The strength of the interfering signal over the noise floor at the signal’s maximum point on Carrier 0.
-
Intf. Noise Ratio Max Carrier 1: The strength of the interfering signal over the noise floor at the signal’s maximum point on Carrier 1.
-
Sensitivity Loss Max Carrier 0: Carrier 0 sensitivity loss (in dB) due to operating at lower than max received gain.
-
Sensitivity Loss Max Carrier 1: Carrier 1 sensitivity loss (in dB) due to operating at lower than max received gain.
-
Rx Signal Carrier 0: The received signal power on Carrier 0 in dBm
-
Rx Signal Carrier 1: The received signal power on Carrier 1 in dBm
Figure 58: Link Metrics Customization (RN)
BN Link Metrics:
Note
The UL / DL capacity is the amount of traffic a link could theoretically pass in the uplink or downlink direction with the existing allotment by the scheduler. This is a calculation based on Path Loss, TBER, etc. Should a link become active, the allotment would increase to meet the demand of the traffic. This would, in turn, increase the link's capacity.
Figure 59: Link Metrics Customization (BN)
-
Active Connections: Number of RNs connected to a BN.
-
Availability (month): The time the BN is up and providing service. Included time in the down-time calculation are unintentional reboots (watchdog timeout or crash) and when GPS lock is lost. Excluded from the down-time calculations are cold boots (powered off or a power outage), intentional reboots (such as user initiated or software upgrades), data interface down, radio muted, waiting for SAS spectrum allocation, or a radio reset due to a configuration change. This value is calculated as a percent out to two decimal places. Parameter resets at the first of every month.
-
Intf. Noise Ratio Max Carrier 0: Interference-to-noise ratio for carrier 0.
-
Intf. Noise Ratio Max Carrier 1: Interference-to-noise ratio for carrier 1.
-
Sensitivity Loss Max Carrier 0: Carrier 0 sensitivity loss (in dB) due to operating at lower than max received gain.
-
Sensitivity Loss Max Carrier 1: Carrier 1 sensitivity loss (in dB) due to operating at lower than max received gain.
-
Rx Signal Carrier 0: Received signal strength (including interference) on carrier 0 radio.
-
Rx Signal Carrier 1: Received signal strength (including interference) on carrier 1 radio.
-
DL Peak Rate: The highest DL rate detected in the last 150 seconds.
-
UL Peak Capacity*: The maximum UL capacity value in the last 150 seconds.
-
DL Peak Capacity*: The maximum DL capacity value in the last 150 seconds.
Device Management Information
System metrics provide non-hardware-specific information about the device.
-
Hostname: Hostname, if set, otherwise the system serial number.
-
Software Version: Software version currently installed and in use on the device.
-
First Seen: Timestamp for when this device was first seen by TCS.
-
Notes: (RN only)
-
Active Bank: The internal bank in which the active software resides.
-
Alarms Count: Number of currently raised alarms on the device.
-
Boot Reason: Reason for the last reboot.
-
System Uptime: Duration since the device was last rebooted.
-
CPU: CPU utilization.
-
Memory: Memory utilization.
-
Sector: Administratively-assigned sector name. (BN only)
-
Site: Administratively-assigned site name. (BN only)
-
Subscriber ID: This is an example custom parameter defined through the API.
Figure 60: System Metrics Customization (RN & BN)
Device Identification Information
Hardware metrics include information relevant to device identification or environment.
-
Serial Number: Unique system identifier. (Note: This parameter cannot be deselected.)
-
Part No.: System part number based on the hardware SKU.
-
MAC Address: MAC (hardware) address of this device.
-
Temperature: Internal board temperature of the device.
BN Only:
-
Digi Part No.: Digital board part number.
-
RF Serial: Unique sub-serial number.
-
RF Part No.: Unique sub-part number
-
Voltage: Input DC voltage to the BN.
Note
If the input voltage to the BN falls below -40 V it may power down.
Figure 61: Hardware Metrics Customization (RN & BN)
Location Metrics includes device installation information.
-
Sector BN (RN only): Hostname of the BN to which the RN has associated and maintains a link.
-
Location: Comma delimited, latitude and longitude of the device in decimal notation.
-
Height: Installed height above mean ground level (AGL).
-
Azimuth: Horizontal angle of device installation as measured clockwise from north.
-
Tilt: Vertical (elevation) angle of device installation as measured from the horizon (0 degrees).
Note
On the BN the latitude, longitude, height, and tilt are provided automatically via a GPS module. The azimuth can be set through the BN’s device page in TCS. For RNs, tilt and height can only be set using the RN’s web UI (this should be done at set up). Latitude, longitude, and azimuth can also be set through the device page in TCS.
The latitude, longitude, and azimuth can manually be entered here or from the RN’s Device page in TCS, but the Tilt, and Height, can only be configured from the RN’s Web UI.
For 5 GHz RNs, the latitude and longitude are only necessary for an accurate Map View in TCS and the Height, Tilt, and Azimuth are optional. However, for CBRS RNs, all five of these parameters are required
Figure 62: Location Metrics Customization (RN & BN)
Planning metrics describe device radio configuration information.
-
Frequency Carrier 0: Center frequency of 1st Carrier band
-
Frequency Carrier 1: Center frequency of 2nd Carrier band
-
Operational Bandwidth: Channel width (in MHz)
RN Only Parameter:
-
Data VLAN: An optional VLAN setting on the RN that overrides the VLAN setting on the BN (the RN does not tag or untag frames). For more information, see VLANs and Quality of Service.
-
SLA Profile: The service level agreement (SLA) on each RN is applied to downlink traffic only.
BN Only Parameters:
-
Planning ID: An identifier for the BN based on <Cell ID>.<Sector>. The Cell ID [BN] is an identifier for the cell (A group of 4 co-channel sectors form a cell).
-
Network Profile: DL/UL ratio of the TDD frame and max distance between a BN and RN.
-
Mgmt VLAN: An optional parameter that, if used, tags all traffic on the in-band management port with the specified VLAN. This is set in the BN’s web UI.
Figure 63: Planning Metrics Customization (RN & BN)
|
Network Profile |
Max Cell Range |
DL Symbols |
UL Symbols |
DL:UL Ratio |
|---|---|---|---|---|
|
1 |
15 km |
36 |
8 |
4.5:1 |
|
5 |
15 km |
32 |
12 |
2.67:1 |
|
6 |
15 km |
28 |
16 |
1.75:1 |
Navigate to a device’s individual dashboard by clicking Devices in the Navigation pane on the left and then clicking on the desired device’s serial number.
Note
Ensure that the correct network entity is selected for the device desired. Also check that the correct device type is selected (RN or BN).
Figure 64: Device List
With appropriate TCS user permissions, device management functionality is also available.
Figure 65: Device List Dashboard
The individual device page for both RNs and BNs is divided into several sections. Link performance is in the upper left quadrant. For the RN, the graphs shown are the DL and UL peak throughput over the past 24 hours.
Figure 66: RN Device Dashboard (Link Performance)
For the BN, the graphs shown are the DL and UL throughput over the past 24 hours. For either device type, mouse over any part of the chart to see the throughput and timestamp or click the mini menu for any of the link performance parameters to view the chart in full screen, print, or to download the chart as an image (PNG, JPEG, or SVG), PDF, or CSV file.
Figure 67: BN Device Dashboard (Link Performance)
The summary box displays the same information as the map view pop-out box. A connected device is shown as green. Disconnected devices are shown as gray. The Sector, Cell, Site, Market, and Region parameter values are hyperlinks (shown in yellow) that link to the Performance page for that network entity. The BN device summary includes the management and data VLAN IDs.
Note
The default management VLAN is 2000. The management VLAN is optional, but the data VLAN is required. If a management VLAN is used, it must be on separate VLAN from the data VLAN. VLANs 4092, 4093, and 4094 are reserved.
The RN device summary includes the SLA profile and data VLAN. Both can be edited from this window by clicking the pencil icon next to the parameter.
Note
The RN data VLAN is between the individual RN and the BNG.
Figure 68: Device Summary (RN and BN)
The service level agreement (SLA) is set on a per-RN basis
Note
The SLA is applied to downlink traffic only. The supported SLA profiles are shown below.
|
Min SLA – 1 Mbps |
SLA 200 – 200 Mbps |
|
SLA 5 – 5 Mbps |
SLA 250 – 250 Mbps |
|
SLA 10 – 10 Mbps |
SLA 300 – 300 Mbps |
|
SLA 15 – 15 Mbps |
SLA 400 – 400 Mbps |
|
SLA 20 – 20 Mbps |
SLA 500 – 500 Mbps |
|
SLA 25 – 25 Mbps |
SLA 600 – 600 Mbps |
|
SLA 50 – 50 Mbps |
SLA 1000 – 1,000 Mbps |
|
SLA 100 – 100 Mbps |
Max SLA – unlimited (no restrictions) |
|
SLA 150 – 150 Mbps |
A zoomed-in view of the device plotted on a map is displayed. The zoom level can be adjusted as needed or the map can be shown in full screen.
Figure 69: Device Location Map
Device installation parameters may also be viewed.
For users with appropriate TCS permissions, some device installation parameters can be edited here.
Note
The latitude and longitude of a BN is derived from the GPS unit on the BN and cannot be modified but azimuth can be set here. Latitude, longitude, and azimuth is optional for 5GHz RNs, but can manually be entered here. For CBRS RNs, these parameters are required along with height and tilt. Height and tilt can only be set from the RN’s web UI.
Click the Update button to save editable parameters.
Figure 70: Device Installation Parameters (BN and RN)
The operating information box displays information such as system uptime, configured radio frequency and bandwidth, as well as utilization, and active connections. Parameters vary between BN and RN.
Figure 71: Operating Information (BN and RN)
The Alarms and Events Feed window shows an Alarms display with a high-level summary of critical, major, and minor alarms. Below that is a real-time feed of events for this device.
The hyperlink icon in the upper right of each display links to the Alarms and the Events navigation panel windows for this device.
Figure 72: Device Dashboard: Alarms and Events Feed (BN and RN)
The interface summary displays important information about the various network interfaces on the device in a tabular format. This list will vary depending on the device type. In the example below, the top graphic is from a BN and the bottom is from an RN.
Note
Cloud Internal indicates the device connection to TCS.
Figure 73: Interface Summary (BN and RN)
Network packet statistics are available here and are listed by packet type as well as ingress or egress. Use the drop-down menu to switch between different network interfaces. In the example below, the top graphic is from a BN and the bottom is from an RN.
Figure 74: Network Interface Statistics (BN and RN)
BNs have a device configuration window in the device page dashboard. This displays a summary of configuration attributes, their current value, and the saved value.
Users with OP Admin rights can click Set Config to change an attribute value and Push Config to modify the attribute on the device. Configuration changes pushed to a device take immediate effect. To make a change permanent (applied even after a reboot) click Save to Disk.
Note
Only the Hostname parameter is configurable.
Figure 75: Device Configuration (BN only)
In the upper right corner of the individual device pages are a set of icons that hyperlink to a navigation pane or to an action that can be taken with this device. In the graphic below, the top device is an RN. The BN below it has one extra icon.
Figure 76: RN and BN Action Icons
The first icon will navigate to the Performance page for this device. Performance and KPIs were discussed in an earlier section of this guide.
Figure 77: Performance Page
User with OP Admin rights can use Notes to add additional information to a device such as comments or descriptions. NOC-level users have read-only access to Notes.
To add or view a note, click the note icon on the top right of the Device Dashboard screen. Enter the information and click Update.
Figure 78: Device Notes
If the device is a BN and the user has sufficient rights, the mute/unmute icon is available on the top right. Clicking this will toggle between muting and unmuting the device. This option is not available for RNs.
Note
Muting a BN turns off the radios. The BN will stop transmitting/receiving and all connected RNs will immediately be disconnected.
Figure 79: Mute/Unmute (BN only)
A Snapshot collects a set of logs and is intended for troubleshooting purposes when working with Tarana Technical Support. A snapshot may be saved by clicking the Snapshot icon on the top right of the screen. The text under the icon will change from Generating to Successful upon completion of the snapshot.
Note
Snapshots are retrievable from TCS by Tarana Support and engineers.
Figure 80: Taking a Snapshot
Clicking the Upgrade icon on the top right of the screen opens the upgrade dialogue box. This may be used to upgrade an individual device. Select the correct software from the drop-down box as well as whether to activate the software after upgrade. Click Proceed to continue with the software upgrade.
Note
Selecting Activate software after upgrade will cause the device to immediately reboot after installation.
Figure 81: Upgrade Device Software
An admin can log directly into the device via the Web UI icon. Clicking this open will open a new browser window to the login page for the device’s Web UI. This allows an admin to proxy into the Web UI on the BN or RN from TCS. This UI is the same interface seen if directly connected through the management port on the device. OP Admin rights in TCS and login/password information for this device are required to access the web UI from TCS. Using the device Web UI is covered in later sections of this guide.
Note
In general, the web UI should only be used for initial configuration and setup. TCS settings will overwrite web UI settings. To avoid confusion and misconfiguration, always use TCS once the device is registered and reachable.
Figure 82: Log into Web UI
Click Devices >Operations to display operational information about BNs and RNs.
Figure 84: Device Operations View
To view operations by type, choose the drop-down menu on the top left to select the operation type: Upgrade, Snapshot, or Reboot.
Figure 85: Operations Types
The Customize icon in the bottom right may be used to further customize the columns and information displayed.
Figure 86: Customize Operations View
To re-run a failed operation (e.g., a software upgrade), click the three-dot icon in the Manage column for the operation and click Retry.
Figure 87: Manage Operations
The search field is used to look up operations manually. Click the Advanced drop-down menu next to the search bar to further filter the results:
-
Operation Status - select from All, Queued, Running, Aborted, Success, and Failed.
-
Period - select from All, 24 hours, 1 week, 2 weeks, or 1 month.
Figure 88: Advanced Lookup Options
Comments
Article is closed for comments.