Baseline Configuration The Small Cell RMS solution supports provisioning of devices by configuring RMS components based on the baseline configuration. The baseline configuration defines the BAC custom properties using a defined template, depending on the software version and the device model. The baseline configuration defines a number of scripts, templates, extensions, and images that are executed from the command line or using the UIs to configure various components. • Configuring BAC, page 1 Configuring BAC The devices in the Small Cell RMS solution are managed through a larger set of TR-196 extension parameters to provide additional enhanced functionalities. These standard TR-196 extension parameters are used for retrieving device status information and for managing configuration through XML profiles (BAC templates). The BAC configuration of the Small Cell RMS solution includes the following BAC custom properties that are defined in the configuration template: • Device Activation Custom Properties • Location Aware Custom Properties • RF Profiles Custom Properties • Firmware Upgrade Custom properties • ubi-config-vX.Y.Z Custom Properties Device Activation Custom Properties The below table lists the Device Activation Custom properties that are defined in the BAC configuration template. Cisco RAN Management System Administration Guide, Release 4.x OL-32398-01 1
Transcript
Baseline Configuration
The Small Cell RMS solution supports provisioning of devices by configuring RMS components based onthe baseline configuration. The baseline configuration defines the BAC custom properties using a definedtemplate, depending on the software version and the device model. The baseline configuration defines anumber of scripts, templates, extensions, and images that are executed from the command line or using theUIs to configure various components.
• Configuring BAC, page 1
Configuring BACThe devices in the Small Cell RMS solution are managed through a larger set of TR-196 extension parametersto provide additional enhanced functionalities. These standard TR-196 extension parameters are used forretrieving device status information and for managing configuration through XML profiles (BAC templates).
The BAC configuration of the Small Cell RMS solution includes the following BAC custom properties thatare defined in the configuration template:
• Device Activation Custom Properties
• Location Aware Custom Properties
• RF Profiles Custom Properties
• Firmware Upgrade Custom properties
• ubi-config-vX.Y.Z Custom Properties
Device Activation Custom PropertiesThe below table lists the Device Activation Custom properties that are defined in the BAC configurationtemplate.
Cisco RAN Management System Administration Guide, Release 4.x OL-32398-01 1
DescriptionAccess TypeProperty TypeProperty Name
This custom property is used to determine ifthe device is previously detected as tampered.The property is set to "true" if the device istampered. Else, the value of the property isset to "false" or is non-existent. This customproperty is set by the activation flow logicand is used to determine if the device ispreviously detected as tampered.
Read OnlyBooleanFC-TAMPERED
This custom property is used to determine ifthe service is to be disabled before endingthe TR-069 session. If the property is set to"true", the device is in the shutdown mode.Else, the value of the property is set to "false"or is non-existent. This custom property isset by the RMS as a result of the Shutdownmessage on the device record in the RDU.
Read WriteBooleanFC-SHUTDOWN
This custom property is set by the activationflow logic on the device record in the RDUand indicates the service activation status.This custom property is set automatically bythe activation flow logic on the device recordin the RDU. The valid values are:Pre-requisites not met: AP tamperedPre-requisites not met: AP blockedPre-requisites not met: AP location is invalidEnablement pending Enablement error:<cause> Enabled Operation error: <cause>Operational
Read WriteStringFC-SERVICE-STATUS
This custom property is automatically set onthe device record in the RDU and indicatesthe last time when theFC-SERVICE-STATUS property is set. Theformat is as per TR-069 protocol and mustbe in Co-ordinated Universal Time (UTC)standard with a trailing 'Z'. This customproperty is set by the activation flow logicon the device record in the RDU.
Read OnlyDateTimeFC-SERVICE-STATUS-TS
This custom property is automatically set onthe device record in the RDU and indicatesthe first time the service is reported as"Operational". The format is as per TR-069protocol and must be in Co-ordinatedUniversal Time (UTC) standard with atrailing 'Z'. This custom property is set by theactivation flow logic on the device record inthe RDU.
Read OnlyDateTimeFC-FIRST-RADIO-ON
Cisco RAN Management System Administration Guide, Release 4.x2 OL-32398-01
This custom property is used to determine ifthe service is to be activated, and indicatesif the device is allowed for service. If theproperty is set to "true", the service isactivated, else the property is set to "false".The custom property is set by the RMS orthroughAdmin using UI on the device recordin the RDU.
Read WriteBooleanFC-ACTIVATED
This custom property includes the followingaccess mode type definitions, where: 0x00defines the Closed Access. 0x01 defines theHybrid Access. 0x02 defines the OpenAccess.
Read WriteByteFC-ACL-ACCESS-MODE
This custom property indicates the RANService Area Code.
Read WriteIntegerFC-SAC-ID
This custom property indicates the "LocationArea Code Identifier".
Read WriteIntegerFC-LAC-ID
This custom property indicates the device RFcandidate list.
Read WriteStringFC-RF-CL
This custom property indicates the RNC ID.Read WriteIntegerFC-RNC-ID
This custom property indicates the TR-069Periodic Inform Interval and is set to '300'(five minutes).
Read WriteIntegerFC-PERIODIC-INFORM-INTERVAL
This custom property indicates the MobileCountry Code.
Read WriteIntegerFC-MCC
This custom property indicates the MobileNational Code.
Read WriteIntegerFC-MNC
This custom property indicates the AP IPsectraffic selector string.
Read WriteStringFC-IPSEC-TRAFFIC-SEL
This custom property indicates the FemtoHNBGateway FullyQualifiedDomainNameand is set to ASR5K HNB Gateway IPaddress.
Read WriteStringFC-FGW-FQDN
This custom property indicates the LAC/RACcandidate list.
Read WriteStringFC-LAC-RAC-CL
This custom property indicates the list ofUMTS RF frequencies for band-II andband-V for Network Listen scanning.
Read WriteStringFC-NWL-SCAN-RANGE
This custom property indicates the IPsecserver host IP address and is the OAMinterface of the Security Gateway (SeGW).
Read WriteStringFC-IPSEC-SERVER-HOST
Cisco RAN Management System Administration Guide, Release 4.x OL-32398-01 3
This custom property is used to reduce thenumber of UEs allowed in the CELL_DCHstate to fewer than the number the hardwareis capable of supporting. If the value of thisattribute is greater than or equal to the valueof the attribute maxNumCellDchUes, thereare no changes. The minimum value is set to"0", and the maximum value is "64". Thedefault value is "64".
Read WriteIntegerFC-MAX-NUM-CELL-OVERRIDE
Location Aware Custom PropertiesThe below table lists the Location Aware Custom properties that are defined in the BAC configuration template.
DescriptionProperty TypeProperty Name
This custom property is set by the activation flow logic on thedevice record in the RDU once the location verificationmethodis completed. If the property is set to "true", the location is valid.Else, if the property is set to "false" or is non-existent, thelocation is not valid.
BooleanFC-LOCATION-VALID
This custom property indicates the last time theFC-LOCATION-VALID property was set. The property isset by the activation flow logic on the device record in the RDUas per TR-069 protocol and must be in the Co-ordinatedUniversal Time (UTC) standard with a trailing 'Z'.
DateTimeFC-LOCATION-VALID-TS
This custom property is set by RMS as a result of "Register" or"Update" messages on the device record in the RDU. Theproperty is set by the activation flow logic to determine if thelocation verification methods must be executed. If the locationverification is set to "true", all location methods are skippedand the flow removes all location verification statuses and setsFC-LOCATION-VALID to "true".
BooleanFC-NO-LV
This custom property indicates the DNM location verificationmethod status and is set by the activation flow logic on thedevice record in the RDU. The valid values are: Missing validMCC/MNCs Error: <cause> Wrong location Valid location Ifthe property is not present, then DNM location verification hasnot yet occurred or is disabled.
StringFC-DNM-STATUS
This custom property is set by the activation flow logic on thedevice record in the RDU and indicates the last time theFC-DNM-STATUS property is set. The format is as per TR-069protocol andmust be in the Co-ordinated Universal Time (UTC)standard with a trailing 'Z'.
DateTimeFC-DNM-STATUS-TS
Cisco RAN Management System Administration Guide, Release 4.x4 OL-32398-01
This custom property is a comma separated list of valid MCCor MCC/MNCs and is configured upon initial setup of BAC.The property is set by the RMS as a result of the "Register" or"Update" messages on the device record in the RDU. Theproperty is used by the activation flow logic and comparesagainst the detected neighbors (from NWL) to determine if thedevice location is valid or not.
StringFC-DNM-LIST
This custom property value indicates the minimum number ofexpected neighbors that must be matched against the detectedneighbors (from REM). If the value is not present, the BACactivation flow logic uses a default value of "1" (indicating asingle neighbor must be matched).
IntegerFC-EDN-TOLERANCE
Firmware Upgrade Custom PropertiesThe below table lists the Firmware Upgrade Custom properties that are defined in the BAC configurationtemplate.
DescriptionProperty TypeProperty Name
Conditional that defines if Router chipsetfirmware upgrades or downgrades are enabledor disabled for the UBI Access Points.
BOOLEANFIRMWARE-DPH-SO16-ENABLE
ASCII textual string to define the explicit Routerfirmware and software version for the UBIAccess Points.
STRINGFIRMWARE-DPH-SO16-VERSION
ASCII textual string to define the explicit nameof the Router firmware/software image for theUBI Access Points.
STRINGFIRMWARE-DPH-SO16-IMAGE
RF Profiles Custom PropertiesThe below table lists the RF Profiles Custom properties that are defined in the BAC configuration template.
DescriptionProperty ValueProperty Name
This custom property contains the percentage of theMaximum Total Wideband Transmit Power that isallocated to the primary CPICH. The Primary CPICHPower is calculated from the Primary CPICH PowerPercent in dBm and the Maximum Total WidebandTransmit Power in dBm. The minimum value of theproperty is 1 and the maximum value is 250.
200FC-POWER-PERCENT
Cisco RAN Management System Administration Guide, Release 4.x OL-32398-01 5
This custom property defines the transmission poweroffset measured in {{units}} of the PCH relative tothe Primary CPICH power. The minimum value ofthe property is -350 and the maximum value is 150.
-80FC-PCH-POWER
This custom property defines per downlink RABtype configuration used in downlink power control.Each entry in the list consists of Downlink RABType, Maximum Downlink Transmitter Power, andDownlink BLER Target. The property can includea maximum of eight entries. The allowed value forMaximumDownlink Transmitter Power is an integerin the range of -350 to 150 and the allowed valuefor Downlink BLER Target is an integer in the rangeof -63 to 0 with a scale factor of 10. The maximumvalue is 512.
-70, -60, -30,-27, -20, 0, 10,20
FC-DLINK-POWER-CTRL-PER-RAB
This custom property defines the transmission poweroffset measured in {{units}} of the FACH relativeto the Primary CPICH power. The minimum valueof the property is -350 and the maximum value is150.
-10FC-FACH-POWER
This custom property indicates the level of HighSpeed Downlink Shared Channel (HS-DSCH)measurement power offset. The minimum value ofthe property is -12 and the maximum value is 26.
13FC-HSDSCH-POWER
This property indicates the power level of the HighSpeed Shared Control Channel (HS-SCCH) relativeto CPICH. The minimum value of the property is-28 and the maximum value is 0.
-16C-HSSCCH-POWER
This custom property defines the transmission poweroffset measured in {{units}} of one AICH relativeto the Primary CPICH power. The minimum valueof the property is -22 and the maximum value is 5.
-8FC-AICH-POWER
This custom property defines the transmission poweroffset measured in {{units}} of the Secondary SCHrelative to the Primary CPICH power. Theminimumvalue of the property is -350 and the maximum valueof the property is 150.
-80FC-SSCH-POWER
This custom property indicates the value of thetransmission power of the Primary Common PilotChannel (P-CPICH). The P-CPICH physical channelcarries the common pilots of the cell. The maximumvalue of the property is 64.
1FC-PCPICH-POWER
Cisco RAN Management System Administration Guide, Release 4.x6 OL-32398-01
This custom property defines the transmission poweroffset measured in {{units}} of the BCH relative tothe Primary CPICH power. The minimum value ofthe property is -350 and the maximum value is 150.
-50FC-BCH-POWER
This custom property defines the transmission poweroffset measured in {{units}} of the Primary SCHrelative to the Primary CPICH power. Theminimumvalue of the property is -350 and the maximum valueis 150.
-10FC-PSCH-POWER
This custom property defines the headroom used bythe dynamic HSDPA power allocation algorithm atthe Baseband Processor in terms of the percentageof the maximum available 3GAP power. Theminimum value of the property is 0 and themaximum value of the property is 100.
8FC-POWER-HEADROOM
This custom property defines the maximumtransmission power offset measured in {{units}} ofthe PICH channel relative to the Primary CPICHtransmission power. The minimum value of theproperty is -10 and the maximum value is 5.
-8FC-PICHPOWER
This custom property defines the power used totransmit the E-DCH HARQ AcknowledgementIndicator Channel or E-DCHRelativeGrant Channeland is relative to the CPICHTransmitter Power. Theminimum value of the property is -127 and themaximum value is 127.
-64FC-EHICH-POWER
This custom property defines the power used totransmit the E-DCH Absolute Grant Channel and isrelative to the CPICH TX Power. The minimumvalue of the property is -128 and the maximum valueis 127.
-20FC-EAGCH-POWER
The custom property has a maximum value 8 and aminimum value 0.
4FC-EDPCCH-POWER
ubi-config-X.Y.Z Custom PropertiesThe below table lists an example of the ubi-config-v3.4.2 Custom properties that are defined in the BACconfiguration template.
DescriptionPropertyType
Property Name
Enables or disables the ability to send FAPinformation periodically to a designated File Server.
BooleanFC-LOG-PERIODIC-UPLOAD-ENABLE
Cisco RAN Management System Administration Guide, Release 4.x OL-32398-01 7
URL specifies the destination file location. HTTPand HTTPS transports MUST be supported.
StringFC-LOG-PERIODIC-UPLOAD-URL
Absolute time references in UTC to determinewhenthe FAP will initiate the periodic file upload.
DateTimeLOG-UPLOAD-PERIODIC-TIME
Username to be used by the FAP to authenticatewith the file server.
StringLOG-PERIODIC-UPLOAD-USERNAME
Password to be used by the FAP to authenticatewith the file server.
StringLOG-PERIODIC-UPLOAD-PASSWORD
The duration in seconds of the interval for whichthe FAP MUST create an Performance File andattempt to upload the file to URL ifPeriodicUploadEnable is true.
IntegerFC-LOG-PERIODIC-UPLOAD-INTERVAL
The duration in seconds of the interval for whichthe CPE MUST attempt to connect with the ACSand call the Informmethod if PeriodicInformEnableis true.
IntegerFC-PERIODIC-INFORM-INTERVAL
Name of the local time zone (human readablestring).
StringLOCAL-TIME-ZONE-NAME
First public NTP timeserver. Either a host name orIP address
StringNTP-SERVER-1
First operator NTP timeserver. Either a host nameor IP address. Manual reboot of AP required inorder for a change to this parameter to take effect.
StringOPERATOR-NTP-SERVER-1
Second operator NTP timeserver. Either a hostname or IP address. Manual reboot of AP requiredin order for a change to this parameter to take effect.
StringOPERATOR-NTP-SERVER-2
Comma-separated list (maximum length 32) ofstrings.
StringREM-3G-PLMN-LIST
Comma-separated list of strings. Each item is aUMTS Band to measure.
StringREM-3G-BAND-LIST
Enables or disables Radio EnvironmentMeasurement during the FAP start up.
BooleanFC-REM-3G-SCAN-ON-BOOT
Enable Periodic Radio Environment Measurementon all enabled RAT.
BooleanFC-REM-3G-SCAN-PERIODICALLY
An absolute time reference in UTC to determinewhen the CPE will initiate the periodic REM.
DateTimeFC-REM-3G-PERIODIC-TIME
When ScanPeriodically is true, this value indicatesthe interval in seconds which REM is performedwhile the FAP service is enabled.
IntegerFC-REM-3G-PERIODIC-INTERVAL
Cisco RAN Management System Administration Guide, Release 4.x8 OL-32398-01
Primary CPICH Tx power in dBm. Actual valuesof the power are -10.0 dBm to 50.0 dBm in stepsof 0.1 dB. The value of PCPICHTxPower dividedby 10 yields the actual value of the power.
IntegerFC-SC-INTER-FREQ-i-PCPICH-TX-POWER
Indicates whether the cell is using transmit diversityBooleanSC-INTER-FREQ-i-TX-DIVERSITY-INDICATOR
Max permitted UE Tx power: -50-33 (dBm) asbroadcast in SIB 3 3GPP-TS.25.331 10.3.6.39
IntegerSC-INTER-FREQ-i-MAX-UL-TX-POWER
Enables or disables this entry.BooleanFEMTO-NEIGHBORING-FILTERING-ENABLE
Enables or disables this entry.BooleanSTATIC-NEIGHBORING-FILTERING-ENABLE
The FQDN or IP address of the server where thePost Event Diagnostics tarballs should be uploadedto. An empty string will indicate that uploading (asopposed to collection and packaging) is disabled.
StringPOST-EVENT-UPLOAD-URL
Route definition 0StringZAP-ROUTE-IP-ADDRESS
IP address or FQDN of timing serverStringIP-TIMING-SERVER-IP
Cisco RAN Management System Administration Guide, Release 4.x OL-32398-01 11
