Device Command and Control

Device Command and Control
Device Command and Control
• DCC Overview, page 1
• DCC UI Requirements, page 1
• Device Manager User Roles and Permissions, page 2
• Information About the DCC UI, page 3
• Logging In to the DCC-UI, page 4
• Configuring DCC Dialog Boxes, page 5
• Configuring the DCC Dashboard, page 10
DCC Overview
The Device Command and Control (DCC) application is the user interface within the Cisco Remote Management
System (RMS) that provides operation, administration and management of 3G access points. It is a collection
of tools and contains both a graphic user interface (GUI) and a command line interface (CLI). It enables the
following functions:
• Device data export
• Upgrade monitoring
• Device group management
• Single device management for troubleshooting
• Mass connection request and reboot
• SAI pool management
DCC UI Requirements
The DCC UI is supported on the following browser:
• Mozilla Firefox Version 16.0.1 and above.
Cisco RAN Management System Administration Guide, Release 4.x
OL-32398-01
1
Device Command and Control
Device Manager User Roles and Permissions
Device Manager User Roles and Permissions
To access the various device manager operations you must have the correct permission. Your permissions
determine which functionality you have within the system.
Table 1: Device Manager Functionality According to User Permissions
Functionality
Operation
User Permission Allows Functionality
Read-only
View
Provision
Perform
Register
Read-write Basic Read-write Advanced
Dashboard
Yes
Yes
Yes
Live Data
—
—
Yes
Update
—
Yes
Yes
Shutdown
—
Yes
Yes
Log Upload Triggers
—
—
Yes
Static Neighbors
—
Yes
Yes
Device Replacement
—
Yes
Yes
Connection Request
—
Yes
Yes
On-Demand Log Upload
—
Yes
Yes
Reboot
—
Yes
Yes
Factory Reset
—
Yes
Yes
Set Live Data
—
—
Yes
Set Modified Live Data
—
—
Yes
Register a Device
—
Yes
Yes
The three access levels restrict basic users to access advanced operations that require knowledge of device
parameters. The levels of access are:
• Read Only: Allows access to operations listed under ‘View’ button (currently only Dashboard) only.
This is meant for a user with very basic knowledge.
• Read Write Basic: Allows access to operations that require basic knowledge such as Registration,
Updation, Reboot, Shutdown, Reset, Static neighbours, CR, On demand log upload and so on in addition
to the Read Only operations.
• Read Write Advanced: Allows access to advanced operations such as View/Set Live Data, Modified
Live Data, Log upload triggers and so on in addition to the Read Write Basic operations. This is meant
for a user with advanced knowledge.
Cisco RAN Management System Administration Guide, Release 4.x
2
OL-32398-01
Device Command and Control
Information About the DCC UI
Information About the DCC UI
The DCC UI presentation framework has a generic design and layout. All the applications hosted on this
framework use this layer for display. The common elements like the header, application navigation, and
primary navigation are available to all the applications installed on this framework. The application navigation
is displayed below the header. All the installed and enabled applications that are approved are displayed in
this screen.
Figure 1: DCC UI Main Screen - Application Presentation Page
The DCC UI includes the following components:
Device Manager
The Device Manager consolidates the individual CPE management functions and provides the ability to
easily navigate through the device data model and view values.
Cisco RAN Management System Administration Guide, Release 4.x
OL-32398-01
3
Device Command and Control
Logging In to the DCC-UI
Some of the components of the device manager are located on the same machine, and the communication
with the CPE occurs through Provisioning Management Gateway (PMG), and Broadband Access Center
Regional Distribution Unit (BAC RDU).
Upgrade Monitor
The Upgrade Monitoring Tool (UMT) is a web based tool that supports multiple users concurrently viewing
a single monitoring job or executing multiple monitoring jobs. The tool is able to efficiently scale by receiving
real time events from BAC instead of polling the devices.
Groups and IDs
Groups and IDs allows you to manage the group types, groups, pool types and pools on the BAC.
Admin
Admin allows you to manage Users and Roles without having to access the DCC UI Admin User Interface
directly.
Configuration
Configuration allows you to manage global level configuration of devices in BAC RDU for properties such
as DN Prefix Format. This tab is disabled by default and can be enabled by updating 'superuser' role from
Admin tab->Roles.
Logging In to the DCC-UI
The DCC UI login and authentication system verifies the login credentials and authentication details.
DCC UI Password Policy:
As part of security measures, the password policy is implemented for DCC UI. Ensure that you adhere to the
password policy. The new password must be minimum 8-16 characters long and alphanumeric, should be
mixed case, should contain one of the special characters(*,@,#) and no spaces.
Procedure
Step 1
Step 2
Step 3
Navigate to the DCC-UI application URL. Below is a sample url:
https://central node eth1 IP address/dcc_ui/admin/Login.do
Enter a valid Username and Password in the appropriate text boxes and click Log In.
The credentials are verified by the Login and Authentication system. A new user is logged in with the default
password and is prompted to enter a new password.
Note
For the new user changing the password is a must to log in to the DCC UI application. With the
default password user cannot log in to the application.
Enter the existing and new password as requested and click Save. After entering the new password the
application redirects you to the log in page to log in to the DCC UI application with the new password.
Password changed successfully pop up box appears on Save if the new password provided adheres to the
password policy.
Cisco RAN Management System Administration Guide, Release 4.x
4
OL-32398-01
Device Command and Control
Configuring DCC Dialog Boxes
A popup is displayed that requests the user for which you are changing the password. This is a browser feature
and not triggered through the DCC UI.
Figure 2: Confirm Password Change Dialog
In order to disable this popup, the password history needs to be disabled for the browser through the browser
options.
Note
If you are an application administrator for a specific application, the specific application page displays
on successful login.
If the login credentials fail to authenticate, you are returned to the login page with a failure message.
DCC UI Session expiry: The session times out if the period of inactivity exceeds the time limit set for the
DCC UI. If you try to access the page after the session has expired, then you are navigated back to the login
page. The session timeout period is 45 minutes.
DCC UI Input Validation: As part of security feature XSS implementation, invalid data such as script tags
or html tags are not allowed.
Step 4
When you are finished, click Log Out at the top right corner to exit from the current session.
Configuring DCC Dialog Boxes
The dialog boxes of the Device Command and Control user interface can be customized according to your
needs. Each of the dialog boxes is controlled via an xml file contained in the /rms/app/rms/conf directory.
For example, the xml file for the dialog box for registering a device in Residential mode is named as
sdm-register-residential-screen-setup.xml and for Enterprise mode is named as
sdm-register-enterprise-screen-setup.xml. You can open this file in an xml or text editor and change
it as necessary to customize the dialog box for your needs. The xml file for the update screen for registering
a device in Residential mode is named as sdm-update-residential-screen-setup.xml, and for Enterprise
mode is named assdm-update-enterprise-screen-setup.xml.
This is an example of the sdm-register-residential-screen-setup.xml file:
<?xml version="1.0" encoding="UTF-8"?>
<!-This file is the confidential information and proprietary trade secret
of Cisco Systems, Inc. Possessions and use of this program must conform
strictly to the license agreement between the user and Cisco Systems,
Inc., and receipt or possession does not convey any rights to divulge,
Cisco RAN Management System Administration Guide, Release 4.x
OL-32398-01
5
Device Command and Control
Configuring DCC Dialog Boxes
reproduce, or allow others to use this program without specific written
authorization of Cisco Systems, Inc.
Copyright 2012 Cisco Systems, Inc. All rights reserved.
-->
<ScreenElements xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://www.cisco.com/rms/screen-setup.xsd"
xsi:schemaLocation="http://www.cisco.com/rms/screen-setup.xsd">
<ScreenElement>
<Id>area</Id>
<Required>true</Required>
<Label>Area</Label>
<LabelWidth>99px</LabelWidth>
<FilteringSelect>
<FieldWidth>198px</FieldWidth>
<ValueUrl>/sdm/handleService.do?action=Get
Groups&amp;additionalInfo=Area</ValueUrl>
</FilteringSelect>
<ToolTip>Select the area of the device.</ToolTip>
<StoredKey>Area</StoredKey>
<StoredSection>groups</StoredSection>
<StoredType>string</StoredType>
</ScreenElement>
<ScreenElement>
<Id>rfProfile</Id>
<Required>false</Required>
<Label>RF Profile</Label>
<LabelWidth>99px</LabelWidth>
<FilteringSelect>
<FieldWidth>198px</FieldWidth>
<ValueUrl>/sdm/handleService.do?action=Get
Groups&amp;additionalInfo=RFProfile</ValueUrl>
</FilteringSelect>
<ToolTip>Select an optional RF Profile to be used.</ToolTip>
<StoredKey>RFProfile</StoredKey>
<StoredSection>groups</StoredSection>
<StoredType>string</StoredType>
</ScreenElement>
<!-<ScreenElement>
<Id>activated</Id>
<Required>false</Required>
<Label>Activated</Label>
<LabelWidth>100px</LabelWidth>
<CheckBox>
<DisableOnChecked>
<Id>ID2</Id>
<Id>ID3</Id>
</DisableOnChecked>
</CheckBox>
<ToolTip>Controls if the device is allowed to activate its radio or not.</ToolTip>
<StoredKey>Activated</StoredKey>
<StoredSection>element</StoredSection>
<StoredType>boolean</StoredType>
</ScreenElement>
<ScreenElement>
<Id>dnmStatus</Id>
<Required>true</Required>
<Label>DNM Status</Label>
<LabelWidth>100px</LabelWidth>
<TextBox>
<FieldWidth>200px</FieldWidth>
<ValidationRegex>.+</ValidationRegex>
</TextBox>
<ToolTip>Updates the DNM status.</ToolTip>
<StoredKey>FC-DNM-STATUS</StoredKey>
<StoredSection>parameters</StoredSection>
<StoredType>string</StoredType>
</ScreenElement>
Cisco RAN Management System Administration Guide, Release 4.x
6
OL-32398-01
Device Command and Control
Configuring DCC Dialog Boxes
<ScreenElement>
<Id>dnmList</Id>
<Required>false</Required>
<Label>DNM List</Label>
<LabelWidth>95px</LabelWidth>
<TransferEntryBox>
<InputFieldType>mcc_or_mccmnc</InputFieldType>
<InputLabel>Add MCC or MCC/MNC</InputLabel>
<InputFieldWidth>200px</InputFieldWidth>
<TransferLabel>DNM List</TransferLabel>
<TransferFieldHeight>50px</TransferFieldHeight>
<AcceptDuplicates>false</AcceptDuplicates>
</TransferEntryBox>
<ToolTip>Updates the DNM list. MCC may be 3 digits long, MCC/MNC must be 5 to 6
digits long.</ToolTip>
<StoredKey>DNMIDList</StoredKey>
<StoredSection>expected_location</StoredSection>
<StoredType>mcc_or_mccmnc_list</StoredType>
</ScreenElement>
<ScreenElement>
<Id>ednList</Id>
<Required>false</Required>
<Label>EDN List</Label>
<LabelWidth>95px</LabelWidth>
<TransferEntryBox>
<InputFieldType>radio_neighbor_id</InputFieldType>
<InputLabel>Add MCC or MCC/MNC</InputLabel>
<InputFieldWidth>200px</InputFieldWidth>
<TransferLabel>EDN List</TransferLabel>
<TransferFieldHeight>50px</TransferFieldHeight>
<AcceptDuplicates>false</AcceptDuplicates>
</TransferEntryBox>
<ToolTip>Updates the EDN list.</ToolTip>
<StoredKey>EDNIDList</StoredKey>
<StoredSection>expected_location</StoredSection>
<StoredType>radio_neighbor_id_list</StoredType>
</ScreenElement>
<ScreenElement>
<Id>sai</Id>
<Required>true</Required>
<Label>SAI</Label>
<LabelWidth>100px</LabelWidth>
<SaiBox>
<FieldWidth>200px</FieldWidth>
</SaiBox>
<ToolTip>Sets the SAI.</ToolTip>
<StoredKey>SAI</StoredKey>
<StoredSection>element</StoredSection>
<StoredType>sai</StoredType>
</ScreenElement>
<ScreenElement>
<Id>accessMode</Id>
<Required>false</Required>
<Label>Closed Mode</Label>
<LabelWidth>100px</LabelWidth>
<CheckBox>
<CheckedValue>closed</CheckedValue>
<UncheckedValue>open</UncheckedValue>
<EnableOnChecked>
<Id>acl</Id>
</EnableOnChecked>
</CheckBox>
<ToolTip>Controls the access mode is closed (checked) or open (unchecked).</ToolTip>
<StoredKey>AccessMode</StoredKey>
<StoredSection>access_control</StoredSection>
<StoredType>access_mode</StoredType>
</ScreenElement>
Cisco RAN Management System Administration Guide, Release 4.x
OL-32398-01
7
Device Command and Control
Dynamic Screen Configuration Files
<ScreenElement>
<Id>acl</Id>
<Required>false</Required>
<Label>White List</Label>
<LabelWidth>95px</LabelWidth>
<TransferEntryBox>
<InputFieldType>text</InputFieldType>
<InputLabel>Add IMSI</InputLabel>
<InputFieldWidth>150px</InputFieldWidth>
<InputValidationRegex>\d{14}$|\d{15}$</InputValidationRegex>
<TransferLabel>ACL</TransferLabel>
<TransferFieldHeight>50px</TransferFieldHeight>
<AcceptDuplicates>false</AcceptDuplicates>
</TransferEntryBox>
<ToolTip>Updates the ACL list.</ToolTip>
<StoredKey>AccessControlList</StoredKey>
<StoredSection>access_control</StoredSection>
<StoredType>string_list</StoredType>
</ScreenElement>
-->
</ScreenElements>
Note
The DCC UI exposes xml files which the customer can modify to build their user interface.
Dynamic Screen Configuration Files
This table lists the xml files that are used to customize the associated DCC UI screens with additional
parameters. The complete list of configurable parameters that can be used is provided in the RMS Configurable
Parameters for Release 4.0 document.
DCC UI Dialog Box
DCC UI Area
XML Filename
Folder Path
Device
Device Manager sdm-register-enterprise-screen-setup.xml rms/app/rms/conf
Registration—Enterprise
Device
Device Manager sdm-register-residential-screen-setup.xml rms/app/rms/conf
Registration—Residential
Update Device
Device Manager sdm-update-enterprise-screen-setup.xml rms/app/rms/conf
Registration—Enterprise
Update Device
Device Manager sdm-update-residential-screen-setup.xml rms/app/rms/conf
Registration—Residential
Inter-Frequency
Neighbors
Device Manager sdm-inter-freq-static-neighbors.xml
rms/app/rms/conf
Inter-RAT Neighbors
Device Manager sdm-inter-rat-static-neighbors.xml
rms/app/rms/conf
Update Static Neighbors Device Manager sdm-static-neighbors-filter-screen-setup.xml rms/app/rms/conf
Filter
Add Firmware Type
Upgrade
Monitor
umt-setup.xml
rms/app/rms/conf
Add Firmware Version
Upgrade
Monitor
umt-config.xml
rms/app/rms/conf
Cisco RAN Management System Administration Guide, Release 4.x
8
OL-32398-01
Device Command and Control
Adding or Updating Fields in the Group Dialog Box
DCC UI Dialog Box
DCC UI Area
XML Filename
Folder Path
Log Uploads and
Triggers
Device Manager uploadServers.xml
rms/app/rms/conf
Dashboard Display
Device Manager deviceParamsDisplayConfig.xml
Copy the xml file to
/rms/app/rms/conf
directory from
/rms/app/rms/doc/config/sample
directory and make
appropriate
changes.
Add Area Instance
Groups and IDs bgmt-add-group-screen-setup-Area.xml
rms/app/rms/conf
Add Enterprise Instance Groups and IDs bgmt-add-group-screen-setup-Enterprise.xml rms/app/rms/conf
Add FemtoGateway
Instance
Groups and IDs bgmt-add-group-screen-setup-FemtoGateway.xml rms/app/rms/conf
Add RF Profile Instance Groups and IDs bgmt-add-group-screen-setup-RFProfile.xml rms/app/rms/conf
Add Site Instance
Groups and IDs bgmt-add-group-screen-setup-Site.xml
rms/app/rms/conf
Add SAI-POOL Instance Groups and IDs bgmt-add-group-screen-setup-SAI-POOL.xml rms/app/rms/conf
Add CELL-POOL
Instance
Groups and IDs bgmt-add-group-screen-setup-CELL-POOL.xml rms/app/rms/conf
Adding or Updating Fields in the Group Dialog Box
Use this task to make fields available in the Add/Update group dialog box.
Procedure
Step 1
Step 2
Step 3
Step 4
Step 5
Step 6
Create a file named 'bgmt-add-group-screen-setup-<groupTypeName>.xml' in the /rms/app/rms/conf directory.
Enter an appropriate screen element configuration for each BAC property that is applicable to groups of this
group type, in the xml. This xml should validate against screen-setup.xsd, which is available in
/rms/app/rms/doc/config/xsd for reference.
Sample files should be referred to while preparing the configuration file. The
bgmt-add-group-screen-setup-Area.xml and bgmt-add-group-screen-setup-FemtoGateway.xml are available
in /rms/app/rms/doc/config/sample for reference.
Use appropriate screen elements for each of the properties and save the file. Make screen elements 'Required'
as needed. Follow the convention used in sample xml files. Set readable label names and appropriate tooltip
messages. Values for each field can be validated by setting a regular expression on textbox value.
Restart the DCC UI application, so that it can pick up the new configuration file. Further changes made to
this file will be automatically reloaded by DCC UI after one minute.
Open the add/update group screen. The screen should contain dynamically added input elements for all the
configured properties as per the xml. If it does not, check for file loading/validation errors in DCC UI debug
Cisco RAN Management System Administration Guide, Release 4.x
OL-32398-01
9
Device Command and Control
Configuring the DCC Dashboard
Step 7
log. Also the headers in the grid inside Groups main page should show labels configured inside XML instead
of property names.
If you get an 'Unknown Parameter' error while adding/updating group with property values, make sure it is
configured in pmg-profile.xml so that PMG can recognize them. The sample PMG files (configs, xmls, and
xsds) are available in /rms/app/rms/doc/pmg for reference.
Usually all the properties needed to be set on a group should be configured in XML file, otherwise the PMG
maintains only properties submitted in the add or update group request in FRM.
Group dialog boxes can be configured with Reserved mode or LAC ID.
Configuring the DCC Dashboard
The Dashboard (combined view) can be configured dynamically with the help of a sample XML file present
in RMS. The sample file deviceParamsDisplayConfig.xml contains the default contents of the Dashboard
screen and is located at
/rms/app/rms/doc/config/sample/deviceParamsDisplayConfig.xml.
Dashboard can be customized by copying this sample file to /rms/app/rms/conf directory of central
node and adding/removing <parameter> tags to any of its sections, for example,<AssignedList> or
<LiveParameterList>, in accordance with xsd located at
/rms/app/rms/doc/config/xsd/deviceParamsDisplayConfig.xsd.
You can open the xml file using VI editor and change it as necessary to customize the dashboard for your
needs.
This is an example of the deviceParamsDisplayConfig.xml file:
<?xml version="1.0" encoding="UTF-8"?>
<!-$Id$
***************************************************************************
* CISCO CONFIDENTIAL
* Copyright (c) 2012, Cisco Systems, Inc.
***************************************************************************
-->
<ParameterConfiguration xmlns="deviceParametersConfig"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="deviceParametersConfig deviceParamsDisplayConfig.xsd">
<AssignedList>
<parameter>
<source>groups</source>
<key>FemtoGateway</key>
<displayName>HNB-GW</displayName>
</parameter>
<parameter>
<source>group_parameter</source>
<key>FemtoGateway:FC-MCC</key>
<displayName>MCC</displayName>
</parameter>
<parameter>
<source>group_parameter</source>
<key>FemtoGateway:FC-MNC</key>
<displayName>MNC</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-LAC-ID</key>
<displayName>LAC ID</displayName>
</parameter>
<parameter>
Cisco RAN Management System Administration Guide, Release 4.x
10
OL-32398-01
Device Command and Control
Configuring the DCC Dashboard
<source>group_parameter</source>
<key>FemtoGateway:FC-RNC-ID</key>
<displayName>RNC ID</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-SAC-ID</key>
<displayName>SAC ID</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>CELL-CONFIG-RAN-CELL-ID</key>
<displayName>Cell ID</displayName>
</parameter>
<parameter>
<source>access_control</source>
<key>AccessMode</key>
<displayName>AccessMode</displayName>
</parameter>
<!-- <parameter>
<source>access_control</source>
<key>AccessControlList</key>
<displayName>AccessControlList</displayName>
<format>commaseparated_to_linebreak</format>
</parameter> -->
<!-- <parameter>
<source>parameters</source>
<key>/provisioning/provGroup</key>
<displayName>Provisioning Group</displayName>
</parameter> -->
<parameter>
<source>group_parameter</source>
<key>FemtoGateway:FC-PROV-GRP-NAME</key>
<displayName>Provisioning Group</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>/provisioning/classOfService/selected</key>
<displayName>Class of Service</displayName>
</parameter>
</AssignedList>
<ActivatedList>
<parameter>
<source>element</source>
<key>ServiceStatus</key>
<displayName>Service Provisioning Status</displayName>
<defaultValue>Pre-requisites not met: AP not yet
bootstrapped</defaultValue>
</parameter>
<parameter>
<source>element</source>
<key>ServiceStatusTS</key>
<displayName>Service Provisioning Status Timestamp</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-FIRST-RADIO-ON</key>
<displayName>First Radio On</displayName>
</parameter>
<parameter>
<source>element</source>
<key>LocationValid</key>
<displayName>Location Valid</displayName>
<defaultValue>false</defaultValue>
</parameter>
<parameter>
<source>element</source>
<key>LocationValidTS</key>
<displayName>Location Valid Timestamp</displayName>
</parameter>
<parameter>
<source>location_status</source>
Cisco RAN Management System Administration Guide, Release 4.x
OL-32398-01
11
Device Command and Control
Configuring the DCC Dashboard
<key>DNMStatus</key>
<displayName>DNM Location Status</displayName>
</parameter>
<parameter>
<source>location_status</source>
<key>DNMStatusTS</key>
<displayName>DNM Location Status Timestamp</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-EDN-STATUS</key>
<displayName>Detected Neighbors Status</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>REPORTED-BANDS-SUPPORTED</key>
<displayName>Bands Supported</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>REPORTED-MAX-TX-POWER</key>
<displayName>Max Transmission Power</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>REPORTED-GPS-CAPABILITY</key>
<displayName>GPS Capability</displayName>
<format>int_to_boolean</format>
</parameter>
<parameter>
<source>element</source>
<key>BLOCKED</key>
<displayName>Blocked</displayName>
<!-- <format>int_to_boolean</format> -->
</parameter>
<parameter>
<source>parameters</source>
<key>FC-CSON-STATUS-HANR</key>
<displayName>QSS optimization status for HANR</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-CSON-STATUS-HSCO-M2F</key>
<displayName>QSS optimization status for HSCO M2F</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-CSON-STATUS-HSCO-INNER</key>
<displayName>QSS optimization status for HSCO Inner</displayName>
</parameter>
</ActivatedList>
<DiscoveredList>
<parameter>
<source>parameters</source>
<key>/cwmp/discovered/Inform.DeviceId.Manufacturer</key>
<displayName>Manufacturer</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>/cwmp/discovered/Inform.DeviceId.ManufacturerOUI</key>
<displayName>Manufacturer OUI</displayName>
</parameter>
<!-- UMTS params -->
<parameter>
<source>parameters</source>
<key>/cwmp/discovered/InternetGatewayDevice.DeviceInfo.ModelName</key>
<displayName>Model Name</displayName>
</parameter>
<parameter>
<source>parameters</source>
Cisco RAN Management System Administration Guide, Release 4.x
12
OL-32398-01
Device Command and Control
Configuring the DCC Dashboard
<key>/cwmp/discovered/InternetGatewayDevice.DeviceInfo.HardwareVersion</key>
<displayName>Hardware Version</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>/cwmp/discovered/InternetGatewayDevice.DeviceInfo.SoftwareVersion</key>
<displayName>Software Version</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>/cwmp/discovered/InternetGatewayDevice.DeviceInfo.X_00000C_3GModuleVersion</key>
<displayName>3G Module Version</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>/cwmp/discovered/InternetGatewayDevice.DeviceInfo.X_00000C_RouterModuleVersion</key>
<displayName>Router Module Version</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>/cwmp/discovered/InternetGatewayDevice.WANDevice.{i}.WANConnectionDevice.{i}.WANIPConnection.{i}.MACAddress</key>
<displayName>MAC Address</displayName>
</parameter>
</DiscoveredList>
<RegisteredList>
<parameter>
<source>groups</source>
<key>Enterprise</key>
<displayName>Enterprise</displayName>
</parameter>
<parameter>
<source>groups</source>
<key>Site</key>
<displayName>Site</displayName>
</parameter>
<parameter>
<source>groups</source>
<key>Area</key>
<displayName>Area</displayName>
</parameter>
<parameter>
<source>groups</source>
<key>RFProfile</key>
<displayName>RF Profile</displayName>
</parameter>
<parameter>
<source>element</source>
<key>Activated</key>
<displayName>Activated</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-LOG-PERIODIC-UPLOAD-ENABLE</key>
<displayName>Periodic Log Upload Enabled</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-LOG-PERIODIC-UPLOAD-INTERVAL</key>
<displayName>Periodic Log Upload Interval</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-AP-ROLE</key>
<displayName>Role</displayName>
</parameter>
<parameter>
Cisco RAN Management System Administration Guide, Release 4.x
OL-32398-01
13
Device Command and Control
Configuring the DCC Dashboard
<source>parameters</source>
<key>FC-AP-PURPOSE</key>
<displayName>Purpose</displayName>
</parameter>
<parameter>
<source>parameters</source>
<key>FC-RESERVED-MODE</key>
<displayName>Reserved Mode</displayName>
</parameter>
<parameter>
<source>element</source>
<key>REGISTEREDON</key>
<displayName>Registered On</displayName>
</parameter>
</RegisteredList>
<LiveParameterList>
<parameter>
<key>Alias.FAPService.FAPControl.AdminState</key>
<format>int_to_boolean</format>
</parameter>
<parameter>
<key>Alias.FAPService.FAPControl.OpState</key>
<format>int_to_boolean</format>
</parameter>
<parameter>
<key>Alias.FAPService.FAPControl.RFTxStatus</key>
<format>int_to_boolean</format>
</parameter>
<parameter>
<key>Alias.DeviceInfo.HardwareVersion</key>
</parameter>
<parameter>
<key>Alias.DeviceInfo.SoftwareVersion</key>
</parameter>
<!-- <parameter>
<key>Alias.DeviceInfo.X_00000C_3GModuleVersion</key>
</parameter>
<parameter>
<key>Alias.DeviceInfo.X_00000C_RouterModuleVersion</key>
</parameter>
<parameter>
<key>Alias.FAPService.FAPControl.EnclosureTamperingDetected</key>
<format>int_to_boolean</format>
</parameter> -->
</LiveParameterList>
Following is an example explaining how to add a new parameter, "JOB ID" to the "Assigned Data" section
in the Dashboard:
1 Log in to central node as a root user.
2 Copy the deviceParamsDisplayConfig.xml file to /rms/app/rms/conf folder.
3 Open the file using VI editor and edit the parameters as shown in the example below:
<parameter>
<source>parameters</source>
<key>FC-JOB-ID</key>
<displayName>JOB ID</displayName>
</parameter>
4 Save the changes using the command: :wq!
5 Log in to DCC UI, and verify whether the newly added parameter JOB ID has been updated in the Assigned
Data section of the device dashboard.
Note
If a configured parameter is not set for a particular device, it will not be visible in the Dashboard.
Cisco RAN Management System Administration Guide, Release 4.x
14
OL-32398-01
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising