cc/td/doc/product/access/sc/rel7
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

XECfgParm.dat File Parameters

XECfgParm.dat File Parameters

This chapter describes parameters found in the dat file XECfgParm.dat. This includes different file descriptions for the Release 7.3 and 7.4 XECfgParm.dat files, with the information for the more current release presented first. This information is not provided for users to edit the file. Rather, it is because these parameters are used throughout the Media Gateway Controller network element and this chapter enables users to better understand what these parameters are and how they are used.

XECfgParm.dat parameters are used by every process of the MGC network element. Parameters take the following syntax:

    facilityName.parameterName = parameterValue
    

Valid facility names are:

If no match is found for a facility-specific parameter, the file is searched for a match on the default facility.

XECfgParm.dat File Parameters for Release 7.4

The XECfgParm.dat file configuration parameters for Release 7.4 are presented alphabetically in Table 4-1.

This list of parameters is provided as a reference. Do not edit any parameters that are not listed in the Cisco Media Gateway Controller Software Release 7 Installation and Configuration Guide unless instructed by Cisco technical support, or your system might not work as intended.


Table 4-1: XECfgParm.dat File Configuration Parameters for Release 7.4
Configuration Parameter Definition

*.autonomous

Enables a process, for example the engine, to be started without the system.

Default: false


Note Do not change this value.

*.CDBOutputSel

Specifies ouput format for certain CDB Tag information fields. If no value is available, the module defaults output to the ANSI format for the affected tag fields.

Values:

  • AnsiCDB = North American

  • ItuCDB = European

  • CustCDB = Custom

Default: AnsiCDB

*.chkPtPort

Port number used between peer components or processes for check-pointing.

Value: Any unused port number.

Default: 2001

Leave this value as the default.


Note If you have two Cisco MGC hosts in a failover configuration, both fields in the XECfgParm.dat files should contain the same value.

*.dataDir

Location of the data directory.

Default: ../var


Note Do not change this value.

*.dataSourceName

Used by the MMDB to obtain the data source name for the ODBC connection.

Default: howdydb


Note Do not change this value.

*.debugLevel

Determines level of debugging detail if debugging is initiated.

Default: high


Note Do not change this value.

*.desiredPlatformState

Determines the desired platform state.

Values:

  • master, if you have two (active and standby) Cisco MGC hosts

  • slave, if you have two (active and standby) Cisco MGC hosts

  • standalone, if you have a single-host system

Default: none


Note The value used is site specific. For example, use the values master and slave if you have two (active and standby) Cisco MGC hosts. Enter standalone if you have a single-host system.

*.disableMeas

Disables the collection of measurement data.

Values:

true = disables data collection

false = data is collected

Default: false


Note Do not change this value.

*.homeDirRoot

Location of the home directory.

Default: /opt/CiscoMGC


Note Do not change this value.

*.IP_Addr1

IP address of interface 1; used for signaling.

*.IP_Addr2

IP address of interface 2; used for signaling.

*.IP_Addr3

IP address of interface 3 (if installed); used for signaling.

*.IP_Addr4

IP address of interface 4 (if installed); used for signaling.

*.ipAddrLocalA

First local IP address; used for checkpointing and failover heartbeats if you have active/standby MGC hosts.


Note This is typically the same value as *.IP_Addr1.

*.ipAddrLocalB

Second local IP address; used for checkpointing and failover heartbeats if you have active/standby MGC hosts.


Note If your configuration does not use an external card, leave this setting as the default value, 0.0.

*.ipAddrPeerA

First corresponding peer IP address; used for checkpointing and failover heartbeats.


Note If you have two Cisco MGC hosts in a failover configuration, this value is the IP address of the second host.

*.ipAddrPeerB

Second corresponding peer IP address; used for checkpointing and failover heartbeats.


Note If your configuration does not use an external card, leave this setting as the default value, 0.0.

*.logDirectory

Location of the active and rotated log files.

Default: ../var/log


Note Make sure the log file has write permission for the LogServer.

*.logFileNamePrefix

Combined with the .log extension, defines the filename for log files.

Default: platform

Example: engine


Note This setting can also redirect process messages from the default log file to a specified log file. For example, engine.logFileNamePrefix = engine instructs the log server to redirect messages from the engine process to the dedicated engine.log file. This functions with or without *.logDirectory.

*.logMsgDrop

Controls whether the log server drops debug-level messages when the UNIX domain socket used for log server communication is full.

Values:

  • true = debug messages are dropped

  • false = debug messages are not dropped

Default: true


Note If you set this parameter to false for the engine and the engine logging level is Debug, the system can fail at high call rates.

*.logPrio

Defines the initial default logging level used by logging clients when sending messages to the logging server. Use the set-log MML command to change logging levels after installation.

You can specify different logging levels for each process. For example, engine.logPrio = Info


Note This setting is the only way to modify the logging level of the current MML process. The set-log command does not affect current MML process logging levels.

Values:

  • Debug---This priority is used only for detailed debugging messages. Logging at this priority is not recommended during production because this causes a large volume of messages to be logged, which degrades system performance and can cause failover problems.

  • Trace---These messages capture protocol traffic. This priority is used for debugging.

  • Info---These messages indicate an operation that is proceeding as expected.

  • Warning---These messages indicate a problem exists that does not prevent the system from operating. This is the normal, default logging level for production.

  • Error---These messages indicate an unexpected error that is recoverable but degrades performance.

  • Critical---These messages indicate errors so severe that a process cannot continue operating.

Default: Warning


Note Do not change this value unless you are debugging.

*.LongCallTime

Monitors call length and sets the system to trigger an alarm when a call length reaches a certain level.

Value: Any integer.

Default: 21600000 milliseconds (6 hours)


Note Typically, leave this value as the default. You can change it, if necessary, based on billing requirements.

*.numberOfThreads

Specifies the number of threads generated by multi-threaded processes such as the engine, the log master, and so on. Corresponds to the number of CPUs in your configuration.

Values:

  • 0 = single CPU

  • 1 = two CPUs

  • 2 = four CPUs

Default: 0


Note If you have a multi-CPU system (1 or 2), you must set engine.SysGeneratedCode to true.

*.Ovl1AbateThresh

Controls engine overload levels. This setting depends on the maximum call rate (95% CPU utilization) of your environment. If the Ovl1OnsetThreshold is reached, raising an alarm, the Ovl1RejectPercent action abates until this threshold value is reached, clearing the alarm.

Value:

Use the following formula, where X = calls per second and Y = messages per call:

*.Ovl1AbateThresh = (X * Y * 0.6)

Default: 780


Note This value must be less than Ovl1OnsetThresh.

*.Ovl1OnsetThresh

Controls engine overload levels. This setting depends on the maximum call rate (95% CPU utilization) of your environment. If this threshold value is met, an alarm is raised and calls are rejected at the percentage defined by Ovl1RejectPercent.

Value:

Use the following formula, where X = calls per second and Y = messages per call:

*.Ovl1OnsetThresh = (X * Y * 0.7)

Default: 910

*.Ovl1RejectPercent

Controls engine overload levels. This setting depends on the maximum call rate (95% CPU utilization) of your environment.

A percentage of new calls is rejected at this level. For example, 20% means that 1 out of 5 new calls are rejected at this level.

Value: 0 to 100 percent

Default: 25 percent

*.Ovl2AbateThresh

Controls engine overload levels. This setting depends on the maximum call rate (95% CPU utilization) of your environment. If the Ovl2OnsetThreshold is reached, raising an alarm, the Ovl2RejectPercent action abates until this threshold value is reached, clearing the alarm.

Value:

Use the following formula, where X = calls per second and Y = messages per call:

*.Ovl2AbateThresh = (XY * 0.7)

Default: 910


Note This value must be less than Ovl2OnsetThresh.

*.Ovl2OnsetThresh

Controls engine overload levels. This setting depends on the maximum call rate (95% CPU utilization) of your environment. If this threshold value is met, an alarm is raised and calls are rejected at the percentage defined by Ovl2RejectPercent.

Value:

Use the following formula, where X = calls per second and Y = messages per call:

*.Ovl2OnsetThresh = (X * Y * 0.8)

Default: 1040

*.Ovl2RejectPercent

Controls engine overload levels. This setting depends on the maximum call rate (95% CPU utilization) of your environment.

A percentage of new calls is rejected at this level. For example, 20% means that 1 out of 5 new calls are rejected at this level.

Value: 0 to 100 percent

Default: 50 percent

*.Ovl3AbateThresh

Controls engine overload levels. This setting depends on the maximum call rate (95% CPU utilization) of your environment. If the Ovl3OnsetThreshold is reached, raising an alarm, the Ovl3RejectPercent action abates until this threshold value is reached, clearing the alarm.

Value:

Use the following formula, where X = calls per second and Y = messages per call:

*.Ovl3AbateThresh = (XY * 0.8)

Default: 1040


Note This value must be less than Ovl3OnsetThresh.

*.Ovl3OnsetThresh

Controls engine overload levels. This setting depends on the maximum call rate (95% CPU utilization) of your environment. If this threshold value is met, an alarm is raised and calls are rejected at the percentage defined by Ovl3RejectPercent.

Value:

Use the following formula, where X = calls per second and Y = messages per call:

*.Ovl3OnsetThresh = (X * Y)

Default: 1300

*.Ovl3RejectPercent

Controls engine overload levels. This setting depends on the maximum call rate (95% CPU utilization) of your environment.

A percentage of new calls is rejected at this level. For example, 20% means that 1 out of 5 new calls are rejected at this level.

Value: 0 to 100 percent

Default: 100 percent

*.OwnClli

Common language location identifier; used for circuit query validation when circuit queries are supported.

Value: Alpha-numeric string, up to 11 characters.

Default: TTTT-SS-BB-XXX

Example: 1111-22-33-444

*.ownTranspathId

Identifies the local Cisco MGC host in a redundant configuration (same value as *.transpathID). The IDs must be unique in an active and standby pair.

Value: Any integer up to 2 digits.

Default (for the active Cisco MGC host): 01


Note If you have two Cisco MGC hosts in a failover configuration, enter this value in the *.peerTranspathID field in the XECfgParm.dat file on the second host server.

*.peerTranspathId

Identifies the peer Cisco MGC host in a redundant configuration. The IDs must be unique in an active and standby pair.

Value: Any integer up to 2 digits.

Default (for the standby Cisco MGC host): 02


Note If you have two Cisco MGC hosts in a failover configuration, enter the *.ownTransPathID value from the XECfgParm.dat file of the second host server in this field. If you have a standalone configuration, leave it blank.

*.platformId

Enables the signaling controller to run more than one instance of the Cisco MGC software concurrently.

Default: 1


Note Do not change this value.

*.runAsDaemon

Enables processes to run in the background.

Default: false

  • logger.runAsDaemon = false

  • procM.runAsDaemon = true (runs in the background)

  • MML.runAsDaemon = false


Note Do not change the default values for these settings or the system might not operate correctly. For Release 7.4(7) and later, logger.runAsDaemon should be false. For earlier releases, this should be true.

*.sm_meas_baseaddr

Indicates the memory size of the base address.

Default: 2048


Note Do not change this value.

*.stPort

Port number used between peer components or processes.

Enter any unused port number, for example, 7000. If your configuration uses a Cisco SLT, enter the port number on the Cisco SLT.


Note If you have two Cisco MGC hosts in a failover configuration, enter a different number for this value in the XECfgParm.dat file on the secondary host, for example, 7001.

*.SyscheckpointEnabled

Enables or disables checkpointing.

Values:

  • false = Disables checkpointing. Calls are not preserved during a switchover, and status messages are not sent to the replicator.

  • true = Enables checkpointing. Calls that are in the talking state are preserved and survive a control switchover. All status checkpointing information is sent to the replicator on the active side.

Default: false


Note If you have two Cisco MGC hosts in a failover configuration, enter true. If you have a standalone configuration, enter false.

*.tablesFile

Location of the database directories.

Default: ../etc/tables.dat


Note Do not change this value.

*.tempDir

Location of the temporary files.

Default: /tmp


Note Do not change this value.

*.transpathId

Identifies the local Cisco MGC host in a redundant configuration. The IDs must be unique in an active and standby pair.

Value: Any integer up to 2 digits.

Default (for the active host): 01


Note If you have two Cisco MGC hosts in a failover configuration, this number must be different in the XECfgParm.dat file for each host.

*.VSCNetworkPlacement

Determines Cisco MGC placement (AT or IXC) and bias routing accordingly.

Values:

  • Nanp_AT

  • Nanp_IXC

  • NULL

  • 0

Default: NULL


Note If you do not set this property, all calls will route according to called number or some other criteria, not Carrier ID.

cfgM.recovDbFile

Storage location of the configuration manager recovery information.

Default: ../var/cfgMRecovery


Note Do not change this value.

diskmonitor.Limit

Number of days to preserve before disk trimming is initiated.

Default: 7


Note Do not change this value.

diskmonitor.OptFileSys

List of optional file systems to monitor.

Default: (blank)

diskmonitor.SoftLimit

Works with diskmonitor.Threshold to prevent the disk from filling up and stopping the Cisco MGC. If true, an override of the preserve limit is allowed.

Values:

  • true

  • false

Default: false


Note Do not change this value.

diskmonitor.Threshold

Erases old log files to free disk space. The threshold is the percent the disk is full before trimming starts.

Value: Any integer from 1 to 100 (% of threshold).

Default: 80

diskmonitor.CdrRmFinished

Controls removal of CDRs that have been processed. This parameter controls whether files should be deleted immediately (the default) or kept for X days. This parameter is valid only when a BAM system is pulling CDR files and renaming them".finished" upon successful transfer.

Value: 0 (default - delete immediately), or non-zero integer indicated days to delay before being deleted

Default: 0

cdrDmpr.callDetail

Specifies that call detail record (CDR) files may be automatically converted from binary format to ASCII, comma-delimited format.

Default: /opt/CiscoMGC/local/cdbscript.sh

Optional: /opt/CiscoMGC/bin/converter (if binary CDR files need to be converted to ASCII)


Note The default CDR file format has changed from an ASCII format in Release 4 to a binary format in Release 7. The ASCII file has a .csv extension. For more information on generating and viewing CDR files, see the Cisco Media Gateway Controller Software Release 7 Operations, Maintenance, and Troubleshooting Guide.

dmpr.openCDR

Specifies whether the standard data dumper should write out CDR files.

Values:

  • true = Standard data dumper opens a CDR file and log the call data blocks (CDB).

  • false = Standard data dumper does not open a CDR file and does not log CDBs.

Default: true


Note The default format for CDR files has been changed since release 4 from an ASCII format to a binary format. Use the dmpr.callDetail parameter to convert the files to an ASCII format, if necessary.

engine.AuditOverloadLvl

Specifies a queue level where audit processing is deferred to reduce the load on the system. When the queue capacity is at this level or higher, auditing is not canceled, but it is deferred until the queue capacity returns to below this level.

Values: 0 to 100 percent

  • 0 = auditing is disabled, regardless of the system load.

  • 100 = auditing is enabled, regardless of the system load.

Default: 25 percent


Note This is a platform-specific value and depends on your system installation. No auditing is available for nailed trunks.

engine.AuditTimerInterval

Time interval in milliseconds between two batches of audits.

Value: Any positive integer.

Default: 500


Note This is a platform-specific value and depends on your system installation. No auditing is available for nailed trunks.

engine.CALL_MEM_BLOCK_SIZE

Block of memory allocated per call; used by MDL.

Value: Integer

Default: 0


Note For memory-critical configurations, use the default value. For performance-critical configurations, set this value to 110000.

engine.CALL_MEM_CHUNK_SIZE

Memory chunks allocated from the block of memory designated with engine.CALL_MEM_BLOCK_SIZE.

Value: Integer

Default: 0


Note For memory-critical configurations, use the default value. For performance-critical configurations, set this value to 110000.

engine.CDRencodingFormat

Specifies the call detail record (CDR) file encoding format.

Values:

  • AnsiCDB = North American

  • ItuCDB = European

  • CustCDB = Custom

Default: AnsiCDB

engine.CDRmessageTypes

Specifies which call detail blocks (CDBs) are recorded during a call.

Default: "1010, 1020, 1030, 1040, 1050, 1060, 1070"

Example: "1060, 1110"

Each number represents a point in a call. 1060 is required. 1080 is an external value, used for TCAP.


Note 1110 to generates a CDR file containing all CDBs for a call (end of call). If you choose 1110, you must specify milliseconds in the CDRtimeStamp parameter.

engine.CDRtimeStamp

Specifies the time stamp unit in seconds or milliseconds. If a BAM is being used for billing and measurements, the value must be "M".

Values:

  • S = seconds (Default)

  • M = milliseconds

engine.CMMdlFile

Location of call processing libraries.

Default: ../lib/cc


Note Do not change this value.

engine.LCMMdlFile

Location of call processing libraries.

Default: ../lib/lcm


Note Do not change this value.

engine.MaxAuditCics

Number of circuit identification codes (CICs) that can be audited at a specified interval.

Values:

  • 24 = North America (T1)

  • 32 = Europe (E1)

Default: 32


Note Do not change this value.

engine.mdoDir

Location of call processing libraries.

Default: ../lib/


Note Do not change this value.

engine.SysCdrCollection

Designates the format of call detail records (CDRs).

Values:

  • true = Invalid for Release 7.4 and above.

  • false = generates binary format CDRs (default)

Default: false


Note Do not change this value.Setting this to a value of true for Release 7.4 and above is not valid and may have deleterious effects on the system.

engine.SysCLIval

Enables or disables Calling Line Identity (CLI) validation processing on calls.

Values:

  • true = enables CLI validation

  • false = disables CLI validation

Default: false

engine.SysGeneratedCode

Determines whether compiled or interpreted code is used.

Values:

  • true = system uses compiled code

  • false = system uses interpreted code

Default: true


Note Compiled code runs faster than interpreted code. Typically, this value should be true. If your configuration uses multiple CPUs, this value must be true.

engine.SysGRSBlockSize

Specifies the number of simultaneous GRS messages to send when the engine starts.

Value: Any integer

Default: 0

Example: 1

engine.SysGRSTimerInterval

Specifies the interval, in milliseconds, between group service (GRS) messages.

Value: Any integer.

Default: 0

Example: 1000

engine.SysMaxOverlap

Maximum amount of digits required before a call is considered complete; used in overlap signaling.

Default: 28


Note Do not change this value.

engine.SysMdlMemoryReduction

Controls use of MDL memory reductions.

Values:

  • 0 = MDL memory reductions not used (maximum performance)

  • 1 = MDL memory reduction improvements used

Default: 0


Note For performance-critical configurations, use the default value. For memory-critical configurations, set this value to 1.

engine.SysMinOverlap

Minimum amount of digits required before a call is considered valid; used in overlap signaling.

Default: 0


Note Do not change this value.

engine.SysPropagateChanAvail

In a classic signaling controller configuration, propagates service messages between channels in the event of a channel failure.

Values:

  • true = messages propogated

  • false = messages not propogated (default)


Note Do not change this value.

engine.SysScreeningCheck

Enables or disables the call screening database. If you do not have the database environment set with all the required data populated, set this value to false. Set this value to true if you have the database and want the system to access it.

Values:

  • true = enabled

  • false = disabled

Default: false

engine.SysSGCPRetryCount

Maximum number of SGCP retry messages after a failure.

Default: 3


Note Do not change this value.

engine.SysSGCPREtryTimerInterval

The interval between SGCP message transmissions, in milliseconds.

Default: 1000


Note Do not change this value.

engine.SysTraceLevel

A debugging tool that allows for different levels of engine tracing.

Default: 3


Note Do not change this value.

engine.SysVirtualSwitch

Indicates whether the Cisco MGC host functions as a signaling controller or a virtual switch controller.

Values:

  • 0 = signaling controller (nailed trunks, no auditing is initiated)

  • 1 = virtual switch controller (switched trunks)

Default: 0

engine.VersionTimeoutValue

Defines the timeout interval in number of milliseconds for version messages sent to the MGW. This delay determines how long the Cisco MGC will wait for response from the MGW during the exchange of features prior to the audit.

Value: Any integer.

Default: 10000

foverd.abswitchPort

Port used for communication with the A/B switch.

Value: /dev/term/x

Example: /dev/term/b


Note If your configuration does not use an A/B switch, use the default value (/dev/null).

foverd.abswitchTestInterval

Time interval in milliseconds between attempts to verify that an A/B switch is present.

Default: 30000


Note This parameter only applies if your configuration uses an A/B switch.

foverd.ackTimeout

Maximum time, in milliseconds, that the failover daemon will wait for an ACK or NOACK message to be received from the peer failover daemon. For each message the failover daemon sends, the peer failover daemon sends an ACK or NOACK message to indicate that the peer is still functioning.

Default: 1000 milliseconds (1 second).


Note You can change the default value to a value more appropriate for your system installation.

foverd.commRetryInterval

Time interval in milliseconds between attempts to open a connection.

Connection types include:

  • Connection to the peer failover daemon

  • Connection to the A/B switch

  • Connection to the ARU

Default: 30000 milliseconds (30 seconds).


Note You can change the default value to a value suited more to your system installation.

foverd.conn1Type

Sets the connection type for connection number 1.

Values:

  • serial

  • socket


Note Typically, set this value to socket.

foverd.conn2Type

Sets the connection type for connection number 2.

Values:

  • serial

  • socket


Note Typically, set this value to socket.

foverd.conn3Addr

Specifies the address of the peer system.

Example: /dev/term/b

If your configuration does not use connection number 3, enter /dev/null (default).


Note If your configuration uses an 8-port connector as a serial connection for failover, you must modify the read-write permissions for the connection. For more information, see the Release Notes for the Cisco Media Gateway Controller Software Release 7.

foverd.conn3Type

Sets the connection type for connection number 3.

Values:

  • serial

  • socket


Note Typically, set this value to serial.

foverd.delayTimeout

Maximum time in milliseconds that the failover daemon can delay at startup before sending messages to its peer. This is also the delay offset that is added when the two failover daemons become too closely synchronized.

Default: 1000 milliseconds (1 second)

foverd.forceShutTimeout

Maximum time in milliseconds that the failover daemon waits before forcefully shutting down the platform.

Default: 1000 milliseconds (1 second)

foverd.graceShutTimeout

Maximum time in milliseconds that the failover daemon waits before gracefully shutting down the process manager, which shuts down the processes it controls.

Default: 6000 milliseconds (6 seconds)

foverd.heartbeatInterval

Maximum time in milliseconds between heartbeat messages from the peer failover daemon. This interval defines the frequency that the failover daemon exchanges heartbeat messages with its peer.

Default: 4000 milliseconds (4 seconds).

foverd.ipLocalPortA

Port number used for IP communication.

Default: 0


Note If you have two Cisco MGC hosts in a failover configuration, enter this value for the foverd.ipPeerPortA field in the XECfgParm.dat file on the secondary host.

foverd.ipLocalPortB

Port number used for IP communication.

Default: 0


Note If you have two Cisco MGC hosts in a failover configuration, enter this value for the foverd.ipPeerPortB field in the XECfgParm.dat file on the secondary host.

foverd.ipPeerPortA

Port number used for IP communication.

Default: 0


Note If you have two Cisco MGC hosts in a failover configuration, enter this value for the foverd.ipLocalPortA field in the XECfgParm.dat file on the secondary host.

foverd.ipPeerPortB

Port number used for IP communication.

Default: 0


Note If you have two Cisco MGC hosts in a failover configuration, enter this value for the foverd.ipLocalPortB field in the XECfgParm.dat file on the secondary host.

foverd.peerCommTimeout

Maximum time in milliseconds without communication with the remote system. At the expiration of this period, the remote system is assumed to be unavailable and failover is triggered automatically.

Default: 10000 milliseconds (10 seconds)


Note A timeout value that is too small can cause a false failover, resulting in possible service interruptions.

foverd.statusRptInterval

Time interval in milliseconds that governs the frequency with which the failover daemon logs statistics on the different connections and any failures it encountered exchanging messages with its peer. Logs are created in the log directory.

Default: 600000 milliseconds (10 minutes)

foverd.transitionTimeout

Maximum time in milliseconds allowed for transitions between different states of the failover daemon. This timeout determines how long the system waits for a graceful transition to a new state before forcing the transition. If a timeout occurs, the system is restarted.

Default: 10000 milliseconds (10 seconds).

ioChanCtl.DPNSSTestFrames

Enables DPNSS to generate test frames.

Values:

  • true = if DPNSS is running, test frames are generated

  • false = test frames are not generated

Default: true


Note Do not change this value.

ioChanMgr.alarmTimer

This parameter is obsolete and should be set to 0.

ioChanMgr.evtTimer

Frequency, in milliseconds, at which the queue is scanned for messages.

Default: 100


Note Do not change this value.

ioChanMgr.hbTimer

This parameter is reserved for future use.

ioChanMgr.sendThreshold

Maximum number of events sent from the queue at one time.

Default: 10


Note Do not change this value.

ioChanMgr.statDiscardThreshold

Size of the control queue that triggers discarding of all queued stat events.

Default: 40


Note Do not change this value.

ioChanMgr.statTimer

Frequency, in milliseconds, at which measurements are collected in TIOS.

Default: 30000 milliseconds


Note Do not change this value.

ioChanMgr.trace

Creates unit test tracing of line and channel state machines. Generates a considerable amount of information to the log. Set to a value only when debugging a particular problem with line or channel service state problems.

Values:

  • 0 x 0 = default

  • 0 x 1 = trace


Note Do not change this value.

logger.daemonAddr

Specifies the name of the local socket used by the log server daemon. The daemon listens for connections on this address, and client programs attempt to connect to the daemon at this address.

Default: ../var/log/lsd_addr


Note If this setting is missing from the XECfgParm.dat file, the log server daemon does not run.

logger.fileRotateInterval

Triggers a file rotation based on the time elapsed since the previous rotation.

Default: 1440 minutes (24 hours)


Note This timer is reset after any rotation occurs, regardless of the cause or trigger of the rotation.

logger.fileRotateSize

Triggers a file rotation based on the size of the active file. A file rotation triggered by this parameter also resets logger.fileRotateInterval timer.

Default: 100 (megabytes)


Note The file size may grow somewhat larger than this prameter indicates due to the verbosity of the logging levels currently in effect.

logger.numThreads

Determines whether the PXE logger should run in a separate thread from the rest of the application. A value of zero runs the logger synchronously with the application; a value of 1 runs the logger in a separate thread.

Value: 0/1 (Values less than 0 get reset to zero; values greater than 1 get reset to 1.)

Default: 0

Example: 0      # Run logger synchronously with rest of client application.

MML.chg-cfg

Timeout value for the chg-cfg MML command in milliseconds; overrides MML.timeout.

Default: 10000 milliseconds


Note Do not change this value. This MML command is obsolete.

MML.set-sc-state

Timeout value for the set-sc-state MML command in milliseconds; overrides MML.timeout.

Default: 8500 milliseconds


Note Do not change this value.

MML.snd

Timeout value for the snd MML command in milliseconds; overrides MML.timeout.

Default: 600000 milliseconds


Note Do not change this value.

MML.startPM

Timeout value for the startPM MML command in milliseconds; overrides MML.timeout.

Default: /etc/init.d/CiscoMGC start


Note Do not change this value.

MML.stopPM

Timeout value for the stopPM MML command in milliseconds; overrides MML.timeout.

Default: /etc/init.d/CiscoMGC stop


Note Do not change this value.

MML.timeout

Timeout for MML commands, in milliseconds.

Default: 10000 milliseconds


Note Do not change this value.

MML.vld-cic

Timeout value for the vld-cic MML command in milliseconds; overrides MML.timeout.

Default: 25000 milliseconds


Note Do not change this value.

pom.dataSync

Indicates that the Provisioning Object Manager (POM) should synchronize the provisioning data at startup.

Values:

  • true = POM is enabled, data is synchronized

  • false = POM is disabled, no data synchronization (default)


Note If you have two Cisco MGC hosts in a failover configuration, set this value to true. If you have a standalone Cisco MGC, set this value to false.

pom.port

In a failover configuration, indicates the port number the POM uses to communicate with its peer.

Value: Any integer from 4001 to 4050

Default: 4001 or default


Note This is a platform-specific value and depends on your system installation. You should only modify this value if the default port (4001) is being used by another process or application.

procM.almDwellInterval

Seconds that the process manager must wait before clearing an alarm.

Default: 15 seconds


Note Do not change this value.

procM.logDBFile

Specifies the location of the log level storage.

Default: ../var/procMLogTable

procM.minCheckHealthInterval

Seconds at which a process can generate heartbeats.

Default: 10 seconds


Note Do not change this value.

procM.minCheckHealthTimeout

Seconds at which a timeout can occur.

Default: 2 seconds


Note Do not change this value.

procM.minKillGracePeriod

Seconds that the process manager must wait before killing a process after a heartbeat timeout.

Default: 5 seconds


Note Do not change this value.

procM.recovDbFile

Storage location of the process manager persistent information.

Default: ../var/procMRecovery


Note Do not change this value.

procM.servFmt

Format of the process manager temporary files.

Default: PM_%d_%d_input


Note Do not change this value.

procM.servicesDir

Location of the process manager temporary files.

Default: ../var


Note Do not change this value.

procMprocHealthDfltAlmCat

This parameter is no longer used.

product.time

Software time stamp.


Note Do not change this value.

product.vendor

Software vendor name.


Note Do not change this value.

product.version

Software release version number.


Note Do not change this value.

replicator.portCommChannelRecv

Communication port for the replicator.

Default: 2974


Note Do not change this value.

replicator.portCommChannelSend

Communication port for the replicator.

Default: 2972


Note Do not change this value.

replicator.portDataChannelRecv

Communication port for the replicator.

Default: 2970


Note Do not change this value.

replicator.portDataChannelSend

Communication port for the replicator.

Default: 2968


Note Do not change this value.

replicator.reconnectInterval

Defines the reconnect interval in number of seconds for the replicator during a switchover.

Value: Any integer

Default: 15 seconds


Note Set this value to 0 for a standalone Cisco MGC.

XE.ARUWriteDevice

Name of the device from which the alarm relay unit (ARU) expects to read the alarm strings.

Example: /dev/null


Note This setting is required if your configuration does not use an ARU. If you do not set this device, the system uses # /dev/tty. Do not change this value unless your configuration uses an ARU.

XE.heartBeatRate

Heartbeat rate, in seconds, used with an alarm relay unit (ARU).

Default: 60 seconds


Note Do not change this value unless your configuration uses an ARU.

XE.systemType

Indicates the system type for alarm LEDs.

Values:

  • NETRA-FT = Sun Netra ft 1800

  • NETRA = Sun Netra t 1100, t 1120 (internal LEDs, alarm relays)

  • SPARC = Generic box (no alarm relays)

  • SPARC-ARU = Generic box (external alarm relays)

Default: SPARC

XECfgParm.dat File Parameters for Release 7.3

The XECfgParm.dat file configuration parameters for Release 7.3 are presented in Table 4-2.


Table 4-2: XECfgParm.dat File Configuration Parameters for Release 7.3
Configuration Parameter Definition

*.autonomous

Enables a process, for example the engine, to be started without the system.

Default: false


Note Do not change this value.

*.CDBCustPref

Specifies CDB event handling (to handle or ignore the event). If no value is specified, all CDB events are ignored.

Default: Generic


Note This is a client-specific value and depends on your system installation.

*.CDBOutputSel

Specifies ouput format for certain CDB Tag information fields. If no value is available, the module defaults output to the ANSI format for the affected tag fields.

Values:

  • AnsiCDB = North American

  • ItuCDB = European

  • CustCDB = Custom

Default: AnsiCDB

*.chkPtPort

Port number used between peer components or processes for check-pointing.

Values: Any unused port number.

Default: 2003

Leave this value as the default.


Note If you have two Cisco MGC hosts in a failover configuration, both fields in the XECfgParm.dat files should contain the same value.

*.dataDir

Location of the data directory.

Default: ../var


Note Do not change this value.

*.dataSourceName

Used by the MMDB to obtain the data source name for the ODBC connection.

Default: howdydb


Note Do not change this value.

*.debugLevel

Determines level of debugging detail if debugging is initiated.

Default: high


Note Do not change this value.

*.desiredPlatformState

Determines the desired platform state.

Values:

  • master, if you have two (active and standby) Cisco MGC hosts

  • slave, if you have two (active and standby) Cisco MGC hosts

  • standalone, if you have a single-host system

Default: none


Note The values used are site specific. For example, use the values master and slave if you have two (active and standby) Cisco MGC hosts. If this host is the active Cisco MGC, then set this parameter to master. Also, make sure that the standby host is set to slave. Enter standalone if you have a single-host system.

*.disableMeas

Disables the collection of measurement data.

Values:

  • true = disables data collection

  • false = data is collected

Default: false


Note Do not change this value.

*.eventTrace

Default: false

*.homeDirRoot

Location of the home directory.

Default: /opt/TransPath


Note Do not change this value.

*.IP_Addr1

IP address of interface 1; used for signaling.

*.IP_Addr2

IP address of interface 2; used for signaling

*.IP_Addr3

IP address of interface 3 (if installed); used for signaling.

*.IP_Addr4

IP address of interface 4 (if installed); used for signaling.

*.ipAddrLocalA

First local IP address; used for checkpointing and failover heartbeats.


Note This is typically the same value as *.IP_Addr1.

*.ipAddrLocalB

Second local IP address; used for checkpointing and failover heartbeats.


Note If your configuration does not use an external card, leave this setting as the default value, 0.0.0.0.

*.ipAddrPeerA

First corresponding peer IP address; used for checkpointing and failover heartbeats.


Note If you have two Cisco MGC hosts in a failover configuration, this value is the IP address of the second host.

*.ipAddrPeerB

Second corresponding peer IP address; used for checkpointing and failover heartbeats.


Note If your configuration does not use an external card, leave this setting as the default value, 0.0.

*.logDest

Specialized logging destination where operational messages are routed.

Values:

  • file---Local platform file in the /var directory.

  • stdErr---Standard error I/O stream, which defaults to the local console screen. Does not display when the runAsDaemon parameter is set to true.

  • sysLog---UNIX system log mechanism.

  • all---Enables routing to all three destinations.

Default: sysLog


Note For MML.logDest, set this parameter to syslog or file. Do not use all because it scrambles the screen unless stdErr is redirected.

*.logFacility

Name of the default log file.

Default: Platform (platform.log)


Note Do not change this value.

*.logFileFmt

Determines logging levels.

Default: ../var/log/platform.log


Note Do not change this value.

*.logPrio

Defines the initial default logging level used by logging clients when sending messages to the logging server. Use the set-log MML command to change logging levels after installation.

You can specify different logging levels for each process. For example, engine.logPrio = Info.


Note This setting is the only way to modify the logging level of the current MML processes. The set-log command does not affect current MML process logging levels.

Values:

  • Debug---This priority is used only for detailed debugging messages. Logging at this priority is not recommended during production because this causes a large volume of messages to be logged, which degrades system performance and can cause failover problems.

  • Trace---These messages capture protocol traffic. This priority is used for debugging.

  • Info---These messages indicate an operation that is proceeding as expected.

  • Warning---These messages indicate a problem exists that does not prevent the system from operating.

  • Error---These messages indicate an unexpected error that is recoverable but degrades performance. This is the normal, default logging level for production.

  • Critical---These messages indicate errors so severe that a process cannot continue operating.

Default: Error


Note Do not change this value unless you are debugging.

*.LongCallTime

Monitors call length and sets the system to trigger an alarm when a call length reaches a certain level.

Value: Any integer.

Default: 21600000 milliseconds (6 hours)


Note Typically, leave this value as the default. You can change it, if necessary, based on billing requirements.

*.numberOfThreads

Specifies the number of threads generated by multi-threaded processes such as the engine, the log master, and so on. Corresponds to the number of CPUs in your configuration.

Values:

  • 0 = single CPU

  • 1 = two CPUs

  • 2 = four CPUs

Default: 0


Note If you have a multi-CPU system (1 or 2), you must set engine.SysGeneratedCode to true.

*.Ovl1AbateThresh

Controls engine overload levels. This setting is the percentage of total queue capacity at which the overload level will no longer be in effect.

Default: 20


Note This value must be less than Ovl1OnsetThresh.

*.Ovl1OnsetThresh

Controls engine overload levels. The setting is the percentage of total queue capacity at which the overload level will be in effect.

Default: 25

*.Ovl1RejectPercent

Controls engine overload levels. This setting is the percentage of new calls that will be renected at this overload level. For example, 20% means that 1 out of 5 new calls are rejected at this level.

Value: 0 to 100 percent

Default: 25 percent

*.Ovl2AbateThresh

Controls engine overload levels. This setting is the percentage of total queue capacity at which the overload level will no longer be in effect.

Default: 40


Note This value must be less than Ovl2OnsetThresh.

*.Ovl2OnsetThresh

Controls engine overload levels. The setting is the percentage of total queue capacity at which the overload level will be in effect.

Default: 50

*.Ovl2RejectPercent

Controls engine overload levels. This setting is the percentage of new calls that will be renected at this overload level. For example, 20% means that 1 out of 5 new calls are rejected at this level.

Value: 0 to 100 percent

Default: 50 percent

*.Ovl3AbateThresh

Controls engine overload levels. This setting is the percentage of total queue capacity at which the overload level will no longer be in effect.

Default: 60


Note This value must be less than Ovl3OnsetThresh.

*.Ovl3OnsetThresh

Controls engine overload levels. The setting is the percentage of total queue capacity at which the overload level will be in effect.

Default: 75

*.Ovl3RejectPercent

Controls engine overload levels. This setting is the percentage of new calls that will be renected at this overload level. For example, 20% means that 1 out of 5 new calls are rejected at this level.

Value: 0 to 100 percent

Default: 100 percent

*.OwnClli

Common language location identifier; used for circuit query validation when circuit queries are supported.

Value: Alpha-numeric string, up to 24 characters.

Default: TTT-SS-BB-XXX

Example: 1-22-33-444

*.ownTranspathId

Identifies the local Cisco MGC host in a redundant configuration (same value as *.transpathID). The IDs must be unique in an active and standby pair.

Value: Any integer up to 2 digits.

Default (for the active Cisco MGC host): 76


Note If you have two Cisco MGC hosts in a failover configuration, enter this value in the *.peerTranspathID field in the XECfgParm.dat file on the second host server.

*.peerTranspathId

Identifies the peer Cisco MGC host in a redundant configuration. The IDs must be unique in an active and standby pair.

Value: Any integer up to 2 digits.

Default (for the standby Cisco MGC host): 77


Note If you have two Cisco MGC hosts in a failover configuration, enter the *.ownTransPathID value from the XECfgParm.dat file of the second host server in this field. If you have a standalone configuration, leave it blank.

*.platformId

Enables the signaling controller to run more than one instance of the Cisco MGC software concurrently.

Default: 1


Note Do not change this value.

*.runAsDaemon

Enables which of the following processes runs in the background.

  • logger.runAsDaemon = true

  • procM.runAsDaemon = true (runs in the background)

  • almM.runAsDaemon = false

  • MML.runAsDaemon = false

  • foverd.runAsDaemon = false


Note Do not change the default values for these settings or failover might not operate correctly.

*.sm_meas_baseaddr

Indicates the memory size of the base address.

Default: 2048


Note Do not change this value.

*.stPort

Port number used between peer components or processes.

Default: 7000

If your configuration uses a Cisco SLT, enter the port number on the Cisco SLT.


Note If you have two Cisco MGC hosts in a failover configuration, enter a different number for this value in the XECfgParm.dat file on the secondary host, for example, 7001.

*.SysCheckpointEnabled

Enables or disables checkpointing.

Values:

  • false = Disables checkpointing. Calls are not preserved during a switchover, and status messages are not sent to the replicator.

  • true = Enables checkpointing. Calls that are in the talking state are preserved and survive a control switchover. All status checkpointing information is sent to the replicator on the active side.

Default: true


Note If you have two Cisco MGC hosts in a failover configuration, enter true. If you have a standalone configuration, enter false.

*.tablesFile

Location of database directories.

Default: ../etc/tables.dat


Note Do not change this value.

*.tempDir

Location of temporary files.

Default: /tmp


Note Do not change this value.

*.transpathId

Identifies the local Cisco MGC host in a redundant configuration. The IDs must be unique in an active and standby pair.

Value: Any integer up to 2 digits.

Default (for the active host): 76


Note If you have two Cisco MGC hosts in a failover configuration, this number must be different in the XECfgParm.dat file for each host.

*.VSCNetworkPlacement

Determines Cisco MGC placement (AT or IXC) and bias routing accordingly.

Values:

  • Nanp_AT

  • Nanp_IXC

  • NULL

  • 0

Default: "  "


Note If you do not set this property, all calls will route only according to called number, not Carrier ID.

cdrDmpr.callDetail

Specifies that call detail record (CDR) files will be automatically converted from binary format to ASCII, comma-delimited format.

Default: /opt/TransPath/bin/converter

Example: /opt/TransPath/local/cdbscript.sh


Note The default CDR file format has changed from an ASCII format in Release 4 to a binary format in Release 7. This setting automatically generates CDR files in an ASCII, comma-delimited format in addition to the default, binary format. The ASCII file has a .csv extension. For more information on generating and viewing CDR files, see the Cisco Media Gateway Controller Software Release 7 Operations, Maintenance, and Troubleshooting Guide.

cdrDmpr.openCDR

Specifies whether the standard data dumper should write out CDR files.

Values:

  • true = Standard data dumper opens a CDR file and log the call data blocks (CDB).

  • false = Standard data dumper does not open a CDR file and does not log CDBs.

Default: false


Note The default format for CDR files has been changed since release 4 from an ASCII format to a binary format. Use the dmpr.callDetail parameter to convert the files to an ASCII format, if necessary.

cdrDmpr.seqFile

Identifies the file to store/retrieve the cdr sequence number.

Values: a string indicating file location

Default: ../var/.cdr.seq


Note Do no change this value.

cfgM.recovDbFile

Storage location of the configuration manager recovery information.

Default: ../var/cfgMRecovery


Note Do not change this value.

diskmonitor.Limit

Number of revisions of a file that can exist before disk trimming is initiated.

Default: 7


Note Do not change this value.

diskmonitor.OptFileSys

List of optional file systems to monitor.

Default: /opt (base directory)

diskmonitor.SoftLimit

Works with diskmonitor.Threshold to prevent the disk from filling up and stopping the Cisco MGC.

Values:

  • true

  • false

Default: false


Note Do not change this value.

diskmonitor.Threshold

Erases old log files to monitor disk space.

Value: Any integer from 1 to 100 (% of threshold).

Default: 80

engine.AuditOverloadLvl

Specifies a queue level where audit processing is deferred to reduce the load on the system. When the queue capacity is at this level or higher, auditing is not canceled, but it is deferred until the queue capacity returns to below this level.

Values: 0 to 100 percent

  • 0 = auditing is disabled, regardless of the system load.

  • 100 = auditing is enabled, regardless of the system load.

Default: 25 percent


Note This is a platform-specific value and depends on your system installation. No auditing is available for nailed trunks.

engine.AuditTimerInterval

Time interval in milliseconds between two batches of audits.

Value: Any positive integer.

Default: 500


Note This is a platform-specific value and depends on your system installation. No auditing is available for nailed trunks.

engine.CDRencodingFormat

Specifies the call detail record (CDR) file encoding format.

Values:

  • AnsiCDB = North American

  • ItuCDB = European

  • CustCDB = Custom

Default: AnsiCDB

engine.CDRmessageTypes

Specifies which call detail blocks (CDBs, statistics taken at various points in a call) are recorded during a call.

  • "1010, 1020, 1030, 1040, 1050, 1060, 1070"

  • "1060, 1110"

Each number represents a point in a call. 1060 is required. 1080 is an external value, used for TCAP.


Note 1110 to generates a CDR file containing all CDBs for a call (end of call). If you choose 1110, you must specify milliseconds in the CDRtimeStamp parameter.

engine.CDRtimeStamp

Specifies the time stamp unit in seconds or milliseconds.

Values:

  • S = seconds

  • M = milliseconds

engine.CMMdlFile

Location of call processing libraries.

Default: ../lib/cc


Note Do not change this value.

engine.InterfacesToAudit

Defines the number of interfaces to audit in one time interval.

Value: Integer > 1

engine.LCMMdlFile

Location of call processing libraries.

Default: ../lib/lcm


Note Do not change this value.

engine.MaxAuditCics

Number of circuit identification codes (CICs) that can be audited at a specified interval.

Values:

  • 24 = North America (T1)

  • 32 = Europe (E1)

Default: 32


Note Do not change this value.

engine.mdoDir

Location of call processing libraries.

Default: ../lib/


Note Do not change this value.

engine.SysCdrCollection

Designates the format of call detail records (CDRs).

Values:

  • true = generates ASCII format CDRs

  • false = generates binary format CDRs (default)

Default: false


Note Typically, do not change this value.

engine.SysCLIval

Enables or disables Calling Line Identity (CLI) validation processing on calls.

Values:

  • true = enables CLI validation

  • false = disables CLI validation

Default: false

engine.SysGeneratedCode

Determines whether compiled or interpreted code is used.

Values:

  • true = system uses compiled code

  • false = system uses interpreted code

Default: true


Note Compiled code runs faster than interpreted code. Typically, this value should be true. If your configuration uses multiple CPUs, this value must be true.

engine.SysGRSBlockSize

Specifies the number of simultaneous GRS messages to send when the engine starts.

Value: Any integer

Default: 0

Example: 1

engine.SysGRSTimerInterval

Specifies the interval, in milliseconds, between group service (GRS) messages.

Value: Any integer.

Default: 0

Example: 1000

engine.SysMaxOverlap

Maximum amount of digits required before a call is considered complete; used in overlap signaling.

Default: 28


Note Do not change this value.

engine.SysMinOverlap

Minimum amount of digits required before a call is considered valid; used in overlap signaling.

Default: 0


Note Do not change this value.

engine.SysNumTrans

Default: false

engine.SysPropagateChanAvail

In a classic signaling controller configuration, propagates service messages between channels in the event of a channel failure.

Values:

  • true = messages propogated

  • false = messages not propogated (default)


Note Do not change this value.

engine.SysScreeningCheck

Enables or disables the call screening database. If you do not have the database environment set with all the required data populated, set this value to false. Set this value to true if you have the database and want the system to access it.

Values:

  • true = enabled

  • false = disabled

Default: false

engine.SysSGCPRetryCount

Maximum number of SGCP retry messages after a failure.

Default: 3


Note Do not change this value.

engine.SysSGCPREtryTimerInterval

The interval between SGCP message transmissions, in seconds.

Default: 1000


Note Do not change this value.

engine.SysToneDetect

This parameter is obsolete.

engine.SysTraceLevel

A debugging tool that allows for different levels of engine tracing.

Default: 3


Note Do not change this value.

engine.SysVirtualSwitch

Indicates whether the Cisco MGC host functions as a signaling controller or a virtual switch controller.

Values:

  • 0 = signaling controller (nailed trunks, no auditing is initiated)

  • 1 = virtual switch controller (switched trunks)

engine.VersionTimeoutValue

Defines the timeout interval in number of milliseconds for version messages sent to the MGW. This delay determines how long the Cisco MGC will wait for response from the MGW during the exchange of features prior to the audit.

Value: Any integer.

Default: 10000

foverd.abswitchPort

Port used for communication with the A/B switch.

Value: /dev/term/x

Example: /dev/term/b


Note If your configuration does not use an A/B switch, use the default value (/dev/null).

foverd.abswitchTestInterval

Time interval in milliseconds between attempts to

Default: 30000


Note This parameter only applies if your configuration uses an A/B switch.

foverd.ackTimeout

Maximum time, in milliseconds, that the failover daemon will wait for an ACK or NOACK message to be received from the peer failover daemon. For each message the failover daemon sends, the peer failover daemon sends an ACK or NOACK message to indicate that the peer is still functioning.

Default: 1000 milliseconds (1 second).


Note You can change the default value to a value more appropriate for your system installation.

foverd.commRetryInterval

Time interval in milliseconds between attempts to open a connection.

Connection types include:

  • Connection to the peer failover daemon

  • Connection to the A/B switch

  • Connection to the ARU

Default: 30000 milliseconds (30 seconds).


Note You can change the default value to a value suited more to your system installation.

foverd.conn1Type

Sets the connection type for connection number 1.

Values:

  • serial

  • socket


Note Typically, set this value to socket.

foverd.conn2Type

Sets the connection type for connection number 2.

Values:

  • serial

  • socket


Note Typically, set this value to socket.

foverd.conn3Addr

Specifies the address of the peer system.

Value: Any address

Example: /dev/term/b

If your configuration does not use connection number 3, enter /dev/null (default).


Note If your configuration uses an 8-port connector as a serial connection for failover, you must modify the read-write permissions for the connection. For more information, see the Release Notes for the Cisco Media Gateway Controller Software Release 7.

foverd.conn3Type

Sets the connection type for connection number 3.

Values:

  • serial

  • socket


Note Typically, set this value to serial.

foverd.delayTimeout

Maximum time in milliseconds that the failover daemon can delay at startup before sending messages to its peer. This is also the delay offset that is added when the two failover daemons become too closely synchronized.

Default: 1000 milliseconds (1 second)

foverd.forceShutTimeout

Maximum time in milliseconds that the failover daemon waits before forcefully shutting down the platform.

Default: 1000 milliseconds (1 second)

foverd.graceShutTimeout

Maximum time in milliseconds that the failover daemon waits before gracefully shutting down the process manager, which shuts down the processes it controls.

Default: 6000 milliseconds (6 seconds)

foverd.heartbeatInterval

Maximum time in milliseconds between heartbeat messages from the peer failover daemon. This interval defines the frequency that the failover daemon exchanges heartbeat messages with its peer.

Default: 4000 milliseconds (4 seconds).

foverd.ipLocalPortA

Port number used for IP communication.

Default: 1051


Note If you have two Cisco MGC hosts in a failover configuration, enter this value for the foverd.ipPeerPortA field in the XECfgParm.dat file on the secondary host.

foverd.ipLocalPortB

Port number used for IP communication.

Default: 1053


Note If you have two Cisco MGC hosts in a failover configuration, enter this value for the foverd.ipPeerPortB field in the XECfgParm.dat file on the secondary host.

foverd.ipPeerPortA

Port number used for IP communication.

Default: 1052


Note If you have two Cisco MGC hosts in a failover configuration, enter this value for the foverd.ipLocalPortA field in the XECfgParm.dat file on the secondary host.

foverd.ipPeerPortB

Port number used for IP communication.

Default: 1054


Note If you have two Cisco MGC hosts in a failover configuration, enter this value for the foverd.ipLocalPortB field in the XECfgParm.dat file on the secondary host.

foverd.peerCommTimeout

Maximum time in milliseconds without communication with the remote system. At the expiration of this period, the remote system is assumed to be unavailable and failover is triggered automatically.

Default: 10000 milliseconds (10 seconds)


Note A timeout value that is too small can cause a false failover, resulting in possible service interruptions.

foverd.procMCmdLine

This parameter is obsolete.

foverd.statusRptInterval

Frequency, in milliseconds, at which the failover daemon generates status messages.

Default: 600000 miliseconds


Note Do not change this value.

foverd.statusRptInterval

Time interval in milliseconds that governs the frequency with which the failover daemon logs statistics on the different connections and any failures it encountered exchanging messages with its peer. Logs are created in the syslog directory.

Default: 360000 milliseconds (6 minutes)

foverd.transitionTimeout

Maximum time in milliseconds allowed for transitions between different states of the failover daemon. This timeout determines how long the system waits for a graceful transition to a new state before forcing the transition. If a timeout occurs, the system is restarted.

Default: 10000 milliseconds (10 seconds).

ioChanCtl.DPNSSTestFrames

Enables DPNSS to generate test frames.

Values:

  • true = if DPNSS is running, test frames are generated

  • false = test frames are not generated

Default: false


Note Do not change this value.

ioChanMgr.alarmTimer

This parameter is obsolete.

ioChanMgr.evtTimer

Frequency, in milliseconds, at which the queue is scanned for messages.

Default: 100


Note Do not change this value.

ioChanMgr.hbTimer

This parameter is reserved for future use.

ioChanMgr.sendThreshold

Maximum number of events sent from the queue at one time.

Default: 10


Note Do not change this value.

ioChanMgr.statDiscardThreshold

Size of the control queue that triggers discarding of all queued stat events.

Default: 40


Note Do not change this value.

ioChanMgr.statTimer

Frequency, in milliseconds, at which measurements are collected in TIOS.

Default: 30000 milliseconds


Note Do not change this value.

ioChanMgr.trace

Creates unit test tracing of line and channel state machines. Generates a considerable amount of information to the log. Set to a value only when debugging a particular problem with line or channel service state problems.

Values:

  • 0 x 0 = default

  • 0 x 1 = trace


Note Do not change this value.

logger.cp

Log file used for call processing log messages.

Default: ../var/local.log

Example: ../var/log/Syslog.CallProc

logger.daemonAddr

Specifies the name of the local socket to be used by the log server daemon. The daemon listens for connections on this address, and client programs attempt to connect to the daemon at this address.

Default: ../var/lsd_addrr

Example: "/tmp/log_server_nbc" # File for a specific user


Note If this property is missing from the XECfgParm.dat file, the log server daemon does not run.

logger.env

Log file used for environment log messages.

Default: ../var/local.log

Example: ../var/log/Syslog.Environment

logger.gen

Log file used for general log messages.

Default: ../var/local.log

Example: ../var/log/Syslog.Platform

logger.mgmt

Log file used for management log messages.

Default: (../var/local.log)

Example: logger.mgmt = ../var/log/Syslog.Management

logger.mml

Log file used for MML.

Default: ../var/log/mml.log


Note Do not change this value.

logger.numThreads

Determines whether the PXE logger should run in a separate thread from the rest of the application. A value of zero runs the logger synchronously with the application; a value of 1 runs the logger in a separate thread.

Value: 0/1 (Values less than 0 get reset to zero; values greater than 1 get reset to 1.)

Default: 0

Example: 0      # Run logger synchronously with rest of client application.

logger.prot

Log file used for call protocol log messages.

Default: ../var/local.log

Example : ../var/log/Syslog.Proto

logger.tios

Log file used for protocols.

Default: ../var/log/tios.log


Note Do not change this value.

MML.chg-cfg

Timeout value for the chg-cfg MML command in milliseconds; overrides MML.timeout.

Default: 10000 milliseconds


Note Do not change this value.

MML.set-sc-state

Timeout value for the set-sc-state MML command in milliseconds; overrides MML.timeout.

Default: 8500 milliseconds


Note Do not change this value.

MML.snd

Timeout value for the snd MML command in milliseconds; overrides MML.timeout.

Default: 600000 milliseconds


Note Do not change this value.

MML.startPM

Timeout value for the startPM MML command in milliseconds; overrides MML.timeout.

Default: /etc/init.d/transpath start


Note Do not change this value.

MML.stopPM

Timeout value for the stopPM MML command in milliseconds; overrides MML.timeout.

Default: /etc/init.d/transpath stop


Note Do not change this value.

MML.timeout

Timeout for MML commands, in milliseconds.

Default: 10000 milliseconds


Note Do not change this value.

MML.vld-cic

Timeout value for the vld-cic MML command in milliseconds; overrides MML.timeout.

Default: 25000 milliseconds


Note Do not change this value.

pom.dataSync

Indicates that the Provisioning Object Manager (POM) should synchronize the provisioning data at startup.

Values:

  • true = POM is enabled, data is synchronized

  • false = POM is disabled, no data synchronization


Note If you have two Cisco MGC hosts in a failover configuration, set this value to true. If you have a standalone Cisco MGC, set this value to false.

pom.port

In a failover configuration, indicates the port number the POM uses to communicate with its peer.

Value: Any integer from 4001 to 4050

Default: 4001 or default


Note This is a platform-specific value and depends on your system installation. You should only modify this value if the default port (4001) is being used by another process or application.

procM.almDwellInterval

Seconds that the process manager must wait before clearing an alarm.

Default: 15 seconds


Note Do not change this value.

procM.logDBFile

Specifies the location of the log level storage.

Default: ../var/procMLogTable

Example: ../tmp/procMLogTable

procM.minCheckHealthInterval

Seconds at which a process can generate heartbeats.

Default: 10 seconds


Note Do not change this value.

procM.minCheckHealthTimeout

Seconds at which a timeout can occur.

Default: 2 seconds


Note Do not change this value.

procM.minKillGracePeriod

Seconds that the process manager must wait before killing a process after a heartbeat timeout.

Default: 5 seconds


Note Do not change this value.

procM.recovDbFile

Storage location of the process manager persistent information.

Default: ../var/procMRecovery


Note Do not change this value.

procM.servFmt

Format of the process manager temporary files.

Default: PM_%d_%d_input


Note Do not change this value.

procM.servicesDir

Location of the process manager temporary files.

Default: ../var


Note Do not change this value.

procMprocHealthDfltAlmCat

This parameter is no longer used.

product.time

Software time stamp.


Note Do not change this value.

product.vendor

Software vendor name.


Note Do not change this value.

product.version

Software release version number.


Note Do not change this value.

replicator.portCommChannelRecv

Communication port for the replicator.

Default: 5012


Note Do not change this value.

replicator.portCommChannelSend

Communication port for the replicator.

Default: 0


Note Do not change this value.

replicator.portDataChannelRecv

Communication port for the replicator.

Default: 5014


Note Do not change this value.

replicator.portDataChannelSend

Communication port for the replicator.

Default: 0


Note Do not change this value.

replicator.reconnectInterval

Defines the reconnect interval in number of seconds for the replicator during a switchover.

Value: Any integer

Default: 15 seconds


Note Set this value to 0 for a standalone Cisco MGC.

XE.ARUWriteDevice

Name of the device from which the alarm relay unit (ARU) expects to read the alarm strings.

Example: /dev/null


Note This setting is required if your configuration does not use an ARU. If you do not set this device, the system uses # /dev/tty.

XE.ARUWriteDevice

Device from which an ARU reads alarms.

Default: /dev/null


Note Do not change this value unless your configuration uses an ARU.

XE.heartBeatRate

Heartbeat rate, in seconds, used with an alarm relay unit (ARU).

Default: 255 seconds


Note Do not change this value unless your configuration uses an ARU.

XE.systemType

Indicates the system type for alarm LEDs.

Values:

  • NETRA-FT = Sun Netra ft 1800

  • NETRA = Sun Netra t 1100, t 1120 (internal LEDs, alarm relays)

  • SPARC = Generic box (no alarm relays)

  • SPARC-ARU = Generic box (external alarm relays)

Default: SPARC


hometocprevnextglossaryfeedbacksearchhelp
Posted: Tue Jun 6 07:47:45 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.