Back to Articles

This section describes all NXT Engine Tenant Configuration values.

Table 1. BILLING
KEYDescription
Autocreate SL on No MatchIf the value is enabled, then Merge of Billing and Topology files will generate Auto service location if the MAC address did not match to any Service location.
Autocreate TopologyIf enabled, then will attempt to auto-connect any Service Location within CONNECT_RADIUS if no link was found.
Auto-Link Topology Point Link TypesList of valid topology points to automatically link service locations to if auto linking is required. Valid types “TAP, AMP, ENDPOINT, FIBERNODE”. List is applied in ORDER with the first type in the CONNECT_RADIUS being used. For example if both a FIBERNODE and a TAP are 10 feet away from a service location then if the list is “TAP, FIBERNODE” then the TAP will be use if the list is “FIBERNODE, TAP” then the FIBERNODE is used. If a type is not in the list then it is NOT a valid type to autolink and will be ignored regardless of distance to the service location. Note if TOPOLOGY_LINK is available that will supersede AUTOLINK.
Clustering Scale FactorScale the tolerance for clustering issues from auto-generated Service Locations; decrease scale factor for stricter clusters, and increase for more lenient ones.
Connect RadiusFind closest Tap for provided radius.
Customer Address LinkIs used to create Mapper to match with Topology.
Clustering K Factor for epsilon calculationThe K Factor required to calculate the epsilon value used for clustering alarms.
Merge DelayTime in milliseconds to delay before performing a merge. Each Topology / Billing file will reset the delay. Used to delay until all files have been ingested.
Merge Log PercentageIn merge summary, log a warning for the FiberNode if the number of modems that failed to merge with the topology has exceeded this percentage.
Minimum CM to FiberNodeMinimum number of devices a CMTS must contribute to a FiberNode before the cmtsJob will send a message to the associated FiberNode.
Clustering minimum Neighboring PointsMinimum number of auto-generated Service Locations within a dynamic radius (scaled by Cluster Scale Factor) required to form or contribute to a cluster.
Percentile for epsilon calculationThe percentile of devices that can form an independent cluster with neighbors. Lower this value to remove outliers that result in a larger than required epsilon.

The percentile must be >=0 and <= 100. The default is 0. If set to 0, the calculation uses 100 percent, or the maximum possible.

Service Location Top FieldsOrder of fields to be used when hashing address records for Service Locations
Topology LinkUsed to create a Mapper to match with Topology.
Topology Merge Change PercentageRejects topology and/or address ingest if the percentage of changed FiberNodes in one complete topology and/or address change have been exceeded by this percentage. Helps prevent accidental ingest of the wrong file.
Topology Merge Error PercentageRejects topology and/or address ingest if the percentage of FiberNodes that failed to pass merge validation have been exceeded by this percentage. Helps prevent accidental ingest of the wrong file.
Table 2. GENERAL
KEYDescription
NetworkView cmts query batch sizeThe number of days and CMTSs to batch query for CMTS utilization summary in Analyze Network View.
In Home Exponential Alpha AvgExponential average used to calculate in-home issues.
Max Data DaysIf Data Retain Days is not 0 (zero), this value is used to determine how far back in time queries look for data.
Proxy URLNotification Endpoint URL. If configured, this proxy is used for external requests, such as LDAP and Notifications.
RF Stats Data Retain HoursNumber of hours to reuse stale RF stats when new stats are absent for modems.
RF Set Time DelayNumber of milliseconds to allow different timestamps of RF stats to be grouped together.
Solr Purge RateDelay in milliseconds to purge stale Solr data after a new version is ingested.

Default value is 5,000,000 milliseconds. Set to 3,000,000 milliseconds when billing and topology ingest is performed at the maximum rate of once every two hours.

Stale topology utilization processWill use process non full channel topology channel utilization process.
Support User Active TimeMilliseconds to keep temporary NXTSUPPORT user.
Suppress Clear Soak TimeMilliseconds to soak a Suppressed Alarm.

If set to a non-zero value, suppressed alarms are automatically cleared after the specified amount time.

Cluster Node Check RateInterval in milliseconds to perform cluster wide node checks.
Enable Local User Access

When enabled, allows local user log ins. This feature is enabled by default.

Enable LDAP Configuration
LDAP configuration changes are disabled by default. Choose enable to temporarily enable LDAP configuration changes if changes are required or requested.
NOTE: LDAP configuration will be disabled (change to "false") automatically after 24 hours of enabling.
Table 3. REALTIME_ANALYSIS
KEYDescription
CMTS Spectrum RetryThe number of retries allowed if there is a timeout from CMTS spectrum analysis.
Weight for spectrum exponential smoothingFor spectrum analysis in Upstream Spectrum Sessions only, the weight value for exponential smoothing. Valid values are between 0 and 1, inclusive. 1 indicates all weight is given to the current value, implying no smoothing.
High Rate Poll Interval in SecondsAmount of time in the delay interval between each request for high rate polling, in seconds. The default is 10 seconds.
Maximum number of parallel CMTS SPECTRUM SESSIONMaximum number of parallel CMTS Upstream Spectrum sessions running in the background.
Maximum Spectrum Session Duration in SecondsMaximum duration of an Upstream Spectrum Session, in seconds. The default is 6 hours.
Maximum number of parallel websocket requestsMaximum number of active parallel websocket requests, including live Upstream Spectrum analysis, Upstream Spectrum Sessions, CM Analysis, and Impulse Noise tests. The default is 40.
Maximum Concurrent Users For CM AnalysisMaximum number of concurrent users on CM Analysis, such as TapCoefficient and CmCapabilities.
Spectrum Initial DelayDelay between the starting of spectrum amp data analysis and the amp data requests, in milliseconds.
Spectrum Processing DelayDelay between spectrum amp data requests, in milliseconds.
CM Spectrum RetryNumber of retries on a CM Spectrum, if a timeout is received from the modem.
Start Frequency for Low SplitThe low value for the quick setting Low Split frequency range, in MHz, for the Upstream Spectrum Capture graph X-Axis. The default is 0.
End Frequency for Low SplitThe high value for the quick setting Low Split frequency range, in MHz, for the Upstream Spectrum Capture graph X-Axis. The default is 65.
Start Frequency for Mid SplitThe low value for the quick setting Mid Split frequency range, in MHz, for the Upstream Spectrum Capture graph X-Axis. The default is 0.
End Frequency for Mid SplitThe high value for the quick setting Mid Split frequency range, in MHz, for the Upstream Spectrum Capture graph X-Axis. The default is 100.
Start Frequency for High SplitThe low value for the quick setting High Split frequency range, in MHz, for the Upstream Spectrum Capture graph X-Axis. The default is 0.
End Frequency for High SplitThe high value for the quick setting High Split frequency range, in MHz, for the Upstream Spectrum Capture graph X-Axis. The default is 220.
Maximum number CM batch for tapcoefficientdataNumber of Cable Modems per batch for tapcoefficientdata. Current configuration supports a maximum of 550.

To support a higher maximum value, change the nxt-app.websocket.text.size value in nxt-app.default.properties.

Websocket Idle TimeoutTime to keep an idle websocket, in milliseconds.
Table 4. ALARM_CENTRAL
KEYDescription
Amp Min Transmit Power For OFDMA Minimum Tx power required for a modem to be factored into the amp average calculation for ofdma channels.
Amp Min Transmit PowerMinimum Tx power required for a modem to be factored into the amp average calculation.
Exponential Alpha AvgUsed to calculate the exponential average of SNR deviation.
Exponential Avg Sample CountMinimum number of proactive scans before it starts calculating SNR deviation and in-home issues.
Exponential Alpha DeltaUsed to calculate the exponential delta of SNR deviation.
Enable CMTS Outage Alarms Enable CMTS Outages; default is enabled.
Enable OUTAGE_FAST_SOAK_ENABLEEnable additional FN outage verification for fast outage alarm soaking; default is enabled.
Enable Hub AlarmsEnable or disable Hub Alarms
Enable SNMP_NODATAMarks a modem as SNMP_NODATA (instead of UNKNOWN) if its active CMTS stopped reporting modem status.

Defaults to enabled for base install system. If this value is disabled before an upgrade, it will remain disabled after the upgrade. A manual change is required in this scenario to set this value to enabled.

Enable SNMP_UNREACHABLEMarks a CM as SNMP_UNREACHABLE if its RF data is absent, defaults to False.
Tenant Locale Locale used for datetime format, supported types include: en, nl.

Top Alarm Query Size

The maximum number of alarms, of each type, displayed in the Alarm Central Top Alarms table. The default and maximum is 500, resulting in a maximum of 1000 rows in the table.

Table 5. HISTORICAL_GRAPH
KEYDescription
Graph Max IterationHistorical graph pruning algorithm number of iterations.
Graph Max Points ReturnedHistorical graph pruning algorithm will return max this value points.
Graph Threshold Percentage IncreaseHistorical graph pruning algorithm that will increase the threshold value to this percentage if the points exceed the maximum points.
Table 6. JOB_RATE
KEYDescription
FN Max Size LimitMaximum devices supported by a fiber node.
FiberNode Job OnDemand RateTime in milliseconds to delay before delivering incoming OnDemand data. Used to combine data from multiple CMTSs.
FiberNode Job Outage RateTime in milliseconds to delay before delivering incoming high-rate Outage data. Used to combine data from multiple CMTSs.
FiberNode Job Proactive RateTime in milliseconds to delay before delivering incoming low-rate Proactive data. Used to combine data from multiple CMTSs.
FiberNode Job Trap RateTime in milliseconds to delay before delivering incoming trap data. Used to efficiently process trap data.
FiberNode Job Trap SizeSize of traps required to short circuit FIBERNODE_JOB_TRAP_SIZE. If this size trap is received, then traps will be delivered immediately.
Hub Job Amp RateTime in milliseconds to delay before processing Hub level AMP data. Used to combine data from multiple Fibernodes.
Hub Job Outage RateTime in milliseconds to delay before processing Hub level Outage data. Used to combine data from multiple Fibernodes.
Priority Group Message Time Delay CheckTime to check priority group message has exceeded size limit or not
Table 7. LICENSE
KEYDescription
All keys can either be enabled or disabled. Keys default to enabled.
Alarmcentral keyLicense for ServAssure NXT Alarm Central core functionality.
Alarmcentral Outage keyLicense for ServAssure NXT Alarm Central Outage alarm feature.

Alarmcentral Outage key must be enabled to enable CMTS Outages.

Alarmcentral PNM keyLicense for ServAssure NXT Alarm Central Spectrum pnm feature.
Alarmcentral Proactive keyLicense for ServAssure NXT Alarm Central Proactive alarm feature.
Alarmcentral Spectrum keyLicense for ServAssure NXT Alarm Central Spectrum feature.
Alarm DashboardLicense for ServAssure Dashboard for Alarm Central.
Analyzer KeyLicense for ServAssure NXT Analyzer.
CMTS US Spectrum Key License for CMTS Upstream Spectrum Analyzer.
Enrichment KeyLicense for enrichment.
FieldPro License to enable FieldPro.
Insight KeyLicense for Insight.
Voice Service Key License to enable MTA device discovery and voice service information.
When Voice Service Key is disabled,
  • All MTA count values are displayed as '--' on the UI
  • All MTA related information is hidden in the notification
Table 8. RESTRICTED
KEYDescription
Restricted Categories ListCategories restricted users cannot access. Current categories are: cpeinterfaces, geolocation, subscriber, and customer.
Table 9. ANALYZE_PARAMETERS
KEYDescription
CMTS number of data bytes to be sentNumber of data bytes to be sent with a ping to the CMTS; default is 56.
CMTS Number of ping packetsNumber of ping packets to send to the CMTS; default is 2.
CM number of data bytes to be sentNumber of data bytes to be sent with a ping to the cable modem; default is 56.
CM Number of ping packetsNumber of ping packets to send to cable modems; default is 2.
Table 10. INSIGHT
KEYDescription
Alarm Dashboard URLThe URL for the Alarm Dashboard
Export Sensitive Customer InformationDetermines whether sensitive customer information (such as GEO position, address, etc) is exported to Insight Views. Possible values are enabled and disabled(default). If enabled, sensitive customer data is exported. If disabled, sensitive customer data is not exported.
NOTE: You must enable this option to see customer data in ServAssure NXT Insight Views and ServAssure Dashboard for Alarm Central.
Insight API PasswordPassword to access ServAssure NXT Insight Views APIs.
Insight API URLURL to access ServAssure NXT Insight Views APIs. Supports only HTTPS.
Insight Reporting LDAPIf enabled, LDAP authentication is used for ServAssure NXT Insight Reporting access.
Insight Reporting SiteServAssure NXT Insight Reporting site name.
Insight Reporting URLServAssure NXT Insight Reporting Tableau login page URL.
Insight ExportExport type for ServAssure NXT Insight Views.
Insight SchemaSchema name used to export Insight data. If not specified, Tenant name from ServAssure NXT is used.
Kafka Bootstrap Server PortIf Insight is enabled, this port is used.
Kafka Schema Registry PortIf Insight is enabled, this port is used.
Kafka Server HostnamesIf Insight is enabled, this port is used as a comma-separated string with a list of Kafka Server hostnames.
Table 11. FIELD_PRO
KEYDescription
FieldPro Default Profile Provides the profile name. By default, “Default” is used as the profile name when this field is not configured.