Table 29-1 Service Parameter Descriptions
Service Parameter
|
Description
|
Cisco AMC Service
|
Primary Collector
|
Specifies the Primary AMC (AlertMgr and Collector) server that collects real-time information. The value must match one of the configured servers and, preferably, server with no or minimal call processing.
This is a required field.
|
Failover Collector
|
Specifies the Failover AMC (AlertMgr and Collector) server. The server specified in this parameter is used to collect real-time data when Primary AMC is down or unreachable. No data will be collected if FailoverCollector is not specified when Primary Collector is not active.
|
Data Collection Enabled
|
Determines whether collecting and alerting of real-time information is enabled (True) or disabled (False).
This is a required field.
Default: True
|
Data Collection Polling Rate
|
Specifies the AMC collecting rate, in seconds.
This is a required field.
Default: 30 Minimum: 15 Maximum: 300 Unit: sec
|
Server Synchronization Period
|
Specifies the amount of time, in seconds, that backup AMC (AlertMgr and Collector) waits at startup in order to determine if primary AMC is up and actively collecting. This parameter prevents backup AMC from assuming collecting task prematurely.
This is a required field.
Note Restart the AMC service on the backup server for the parameter change to take effect.
Default: 60 Minimum: 15 Maximum: 300 Unit: sec
|
RMI Registry Port Number
|
Specifies the port number to activate RMI registry. This port is used for primary or backup AMC to locate other AMC as well as how RTMT servlet finds primary/backup AMC.
This is a required field.
Note Restart the AMC service for the parameter change to take effect.
Default: 1099 Minimum: 1024 Maximum: 65535
|
RMI Object Port Number
|
Specifies the port number used for RMI remote object. This port is used for AMC to exchange data with other AMC as well as with RTMT servlet.
This is a required field.
Note Restart the AMC service for the parameter change to take effect.
Default: 1090 Minimum: 1024 Maximum: 65535
|
AlertMgr Enabled
|
For AMC troubleshooting purpose only. Enables and disables the alerting (email/epage) feature.
This is a required field.
Note Restart the AMC service for the parameter change to take effect.
Default: True
|
Logger Enabled
|
For AMC troubleshooting purpose only. Enables and disables the logging feature (CSV files for generating reports).
This is a required field.
Note Restart the AMC service for the parameter change to take effect.
Default: True
|
Cisco Database Layer Monitor Service
|
Maintenance Time
|
Specifies the hour to begin CDR database maintenance. Use this parameter in combination with the Maintenance Window parameter. For example, specifying 22 in this parameter means that the CDR maintenance would begin at 10 p.m. If the Maintenance Window parameter is set to 2, it means that CDR maintenance will run every hour from 10 p.m. to midnight. If both parameters are set to 24, CDR maintenance will run every hour all day long. During CDR maintenance, the system deletes the oldest CDRs and associated CMRs, so the maximum number of records, as specified in the Max CDR Records parameter, is maintained. Also during maintenance, the system issues an alarm if the CDR file count exceeds 200 and checks for replication links between servers that have been broken and tries to reinitialize them.
This is a required field.
Default: 24 Minimum: 1 Maximum: 24 Unit: hr
|
Maintenance Window
|
Specifies the window of time during which CDR maintenance is performed on an hourly basis. For example, if this parameter is set to 12, CDR maintenance will run every hour for 12 hours, starting at the time that is specified in the Maintenance Time parameter. For example, if the Maintenance Time parameter is set to 7, and this parameter is set to 12, CDR maintenance will begin at and run every hour until 7 p.m. If both parameters are set to 24, CDR maintenance will run every hour all day long. During CDR maintenance, the system deletes the oldest CDRs and associated CMRs, so the maximum number of records, as specified in the Max CDR Records parameter, is maintained. Also, during maintenance, the system issues an alarm if the CDR file count exceeds 200 and checks for replication links between servers that have been broken and tries to reinitialize them.
This is a required field.
Default: 2 Minimum: 1 Maximum: 24 Unit: hr
|
MaintenanceTaskTrace
|
Sets the Maintenance Task trace. You must turn on this parameter to get a performance counter trace from Maintenance Task.
This is a required field.
Default: Off
|
Cisco RIS Data Collector Parameters
|
RIS Cluster TCP Port
|
Specifies the static TCP port that the Cisco RIS Data Collector services use to communicate with each other.
This is a required field.
Note Restart the Cisco RIS Data Collector service for the parameter change to take effect.
Default: 2555 Minimum: 1024 Maximum: 65535
|
RIS Client TCP Port
|
Specifies the static TCP port that the RIS clients use to communicate with the Cisco RIS Data Collector services.
This is a required field.
Note Restart Cisco Database Layer Monitor service and the Cisco RIS Data Collector services for the parameter change to take effect.
Default: 2556 Minimum: 1024 Maximum: 65535
|
RIS Client Timeout
|
Specifies the time, in seconds, that a RIS client will wait for a reply from the Cisco RIS Data Collector service.
This is a required field.
Default: 15 Minimum: 10 Maximum: 1000 Unit: sec
|
RIS Cleanup Time of the Day
|
Specifies the time of the day that the RIS database will be cleaned up to remove any unused, old device information. During this time, the NumofRegistrationAttempts performance counters for all devices reset to 0.
This is a required field.
Default: 22:00 Maximum length: 5 Allowed values: Specify time in HH:mm format (for example 06:11). Unit: hr:min
|
RIS Unused Cisco CallManager Device Store Period
|
Specifies the RIS database information storage period for any unregistered or rejected device information from the Cisco CallManager service. After the time specified in this parameter expires, the expired entries are removed during the next RIS database cleanup time (specified in the RIS Cleanup Time of the Day parameter).
This is a required field.
Default: 3 Minimum: 1 Maximum: 30 Unit: day
|
RIS Unused CTI Records Storage Period
|
Specifies the RIS database information storage period for any closed provider, device, or line information from the CTI Manager. After the time specified in this parameter expires, Cisco CTI Manager removes the expired entries during the next RIS database cleanup time (specified in the RIS Cleanup Time of the Day parameter).
This is a required field.
Default: 1 Minimum: 0 Maximum: 5 Unit: day
|
RIS Maximum Number of Unused CTI Records
|
Specifies the maximum number of records for closed CTI providers, devices, and lines that will be kept in the RIS database. After the limit specified in this parameter is reached, Cisco CTI Manager does not save any new records for unused CTI providers, devices, or lines to the RIS database.
This is a required field.
Default: 3000 Minimum: 0 Maximum: 5000 Unit: records
|
Maximum Number of Processes and Threads
|
Specifies the maximum number of Processes and Threads allowed for SystemAccess to provide the complete Process and Thread statistics counters. If the total number of Processes/Threads has exceeded this maximum number, SystemAccess only provides up to the maximum number of Processes statistics counters, none of the other Thread statistics counters will be provided.
This is a required field.
Default: 1200 Minimum: 1000 Maximum: 2000
|
Enable Logging
|
Determines whether collecting and logging of troubleshooting perfmon data is enabled (True) or disabled (False).
This is a required field.
Default: True
|
Polling Rate
|
Specifies the troubleshooting perfmon data polling rate, in seconds.
This is a required field.
Default: 15 Minimum: 5 Maximum: 300 Unit: sec
|
Maximum No. of Files
|
Specifies the maximum number of troubleshooting perfmon log files that are saved on disk. If the Maximum No. of Files is set to a large number, we recommend that the Maximum File Size be reduced.
This is a required field.
Note If this value is reduced, excessive log files with the oldest timestamp will be deleted if Troubleshooting Perfmon Data Logging is enabled and RISDC is activated. You can save these files first before changing Maximum No. of Files.
Default: 50 Minimum: 1 Maximum: 100
|
Maximum File Size (MB)
|
Specifies the maximum file size, in megabytes, in each troubleshooting perfmon log file before the next file is started. If the Maximum File Size is set to a large number, we recommend that the Maximum No. of Files be reduced.
This is a required field.
Default: 2 Minimum: 1 Maximum: 500
|
Cisco Serviceability Reporter
|
RTMT Reporter Designated Node
|
Specifies the designated node on which RTMTReporter runs. Note that the RTMTReporter service is CPU-intensive. This field will be automatically filled in with the local node IP at which Reporter is first activated.
This is a required field.
|
RTMT Report Generation Time
|
Specifies the number of minutes after midnight (00:00hrs) when the Real-Time Monitoring Tool (RTMT) reports are generated. To reduce any impact to call processing, run non-real-time reports during non-production hours.
This is a required field.
Default: 30 Minimum: 0 Maximum: 1439
|
RTMT Report Deletion Age
|
Specifies the number of days that must elapse before reports are deleted. For example, if this parameter is set to 7, reports that were generated seven days ago are deleted on the eighth day. A value of 0 disables report generation, and any existing reports are deleted.
This is a required field.
Default: 7 Minimum: 0 Maximum: 30
|