Description of voip.conf

The voip.conf file contains configuration parameters that you edit to customize discovery and other aspects of
behavior. The parameters are a subset of attributes defined for the VoIP-Manager object that will run in the
environment.
You use the voip.conf file to change discovery parameters, instrumentation parameters, and tracing and troubleshooting parameters. For example, you can change parameters in this file to accomplish tasks such as disabling automatic topology synchronization and enabling SNMP trap reception.
All of the parameters in the voip.conf file are commented-out (preceded with the # character). When changing the default value for a commented-out parameter, ensure that you also remove its # character.
Parameters in the voip.conf file describes the parameters in the voip.conf file. The parameters and their values are case-sensitive.
Parameters in the voip.conf file
Parameter
Value
Description
SNMP Discovery Parameters
SNMP_timeout
Default: 1000 milliseconds
Timeout for an SNMP poll during Phase 3 of discovery. Phase 3 of discovery is described in the
.
The SNMP_timeout parameter is comparable to the “defaultTimeout” parameter in the discovery.conf file of an
IP Manager
installation. The
provides recommendations about changing the defaultTimeout parameter value.
SNMP_timeout = 0 defaults to 1000 milliseconds.
SNMP_retries
Default: 5 retries
Number of SNMP retry polls to use during Phase 3 of discovery. Phase 3 of discovery is described in the
.
The SNMP_retries parameter is comparable to the “defaultRetries” parameter in the discovery.conf file of an
IP Manager
installation. The
provides recommendations about changing the defaultRetries parameter value.
SNMP_retries = 0 defaults to 5 retries.
NumberOfProbeThreads
Default: 10 threads
Number of discovery threads used by the discovery process. If you are experiencing slow response SNMP discovery polling and your current CPU usage is relatively low (say 5 to 10 percent) consider increasing the number of discovery threads to improve your discovery performance. Increasing this number is one of the best and simplest methods for improving discovery.
Increasing threads to 20, 30 or even 50 discovery threads is acceptable, but keep in mind that more threads may require additional or more capable CPUs and that the requirements during discovery will increase. Increase threads conservatively while monitoring SNMP Processing Statistics changes.
NumberOfProbeThreads = 0 defaults to 10 threads.
EnablePhoneDiscovery
TRUE,FALSE
Default: FALSE
Controls whether
discovers IP phones and IP phone groups for Avaya, Cisco, and Nortel vendors. It also controls whether phone-related topology (like ports, cards, and network adapter performance objects) are imported from
IP Availability Manager
whenever
IP Availability Manager
completes a discovery cycle:
  • A value of TRUE enables discovery for IP phones and IP phone groups.
  • A value of FALSE indicates that discovery does not occur.
If this parameter is set to TRUE, the AnalysisMode polling setting is automatically enabled.
EnableVoiceMailboxDiscovery
TRUE,FALSE
Default: FALSE
Controls whether
discovers voice mailboxes for Cisco.
  • A value of TRUE enables discovery for voice mailboxes.
  • A value of FALSE indicates that discovery does not occur.
EnableBIMIntegration
TRUE,FALSE
Default: FALSE
Controls whether
creates BIM entities and establish dependencies with VoIP topology.
  • A value of TRUE enables the creation of business information.
  • A value of FALSE indicates that business information is not created.
DXA control parameters
AutoDiscover
TRUE,FALSE
Default: TRUE
Controls whether
automatically performs a topology synchronization to import topology from
IP Availability Manager
whenever
IP Availability Manager
completes a discovery cycle:
  • A value of TRUE indicates that automatic topology synchronization does occur.
  • A value of FALSE indicates that automatic topology synchronization does not occur.
“Disabling automatic synchronization” on page 35
provides more information about this parameter.
DiscoverAll
TRUE,FALSE
Default: FALSE
Controls
discovery after
IP Availability Manager
performs discovery.
  • A value of TRUE indicates that
    will discover every managed SNMP-enabled computer system (perform a full discovery) after
    IP Availability Manager
    performs discovery.
  • A value of FALSE indicates that
    will discover only the managed SNMP-enabled computer systems that
    IP Availability Manager
    re-discovered.
Instrumentation parameters
TrapPort
0, 9001, 2049 to 65534
Default: 0
Enables the
built-in trap receiver and specifies the port used by the trap receiver to receive traps:
  • TrapPort = 0 disables the built-in trap receiver.
  • TrapPort = 9001 or a value in the range 2049-to-65534 (inclusive) enables the built-in trap receiver and sets the trap port to the value specified for the parameter.
“Enabling trap reception” on page 36
clarifies the use of this parameter.
For the
,
,
, and
, the built-in trap receiver needs to be enabled so that traps issued by devices can be received and processed.
Tracing and troubleshooting parameters
TraceSNMPInstrumentation
TRUE,FALSE
Default: FALSE
Determines whether SNMP poll tracing is enabled or disabled:
  • A value of TRUE indicates that SNMP poll tracing is enabled.
  • A value of FALSE indicates that SNMP poll tracing is disabled.
TraceSOAPMonitoring
TRUE,FALSE
Default: FALSE
Determines whether the tracing of SOAP monitoring is enabled or disabled.
TraceSOAPDiscovery
TRUE,FALSE
Default: FALSE
Determines whether SOAP discovery tracing is enabled or disabled.
TraceDiscovery
TRUE,FALSE
Default: FALSE
Determines whether discovery probe tracing is enabled or disabled:
  • A value of TRUE indicates that discovery probe tracing is enabled.
  • A value of FALSE indicates that discovery probe tracing is disabled.
    When TRUE, the discovery probes and the post processing software print information about the discovery of topology.
TraceEvents
TRUE,FALSE
Default: FALSE
Determines whether internal event subscriber tracing is enabled or disabled:
  • A value of TRUE indicates that internal event subscriber tracing is enabled.
  • A value of FALSE indicates that internal event subscriber tracing is disabled.
TraceSetting
TRUE,FALSE
Default: FALSE
Determines whether settings tracing is enabled or disabled:
TraceTraps
TRUE,FALSE
Default: FALSE
Determines whether the built-in trap receiver tracing is enabled or disabled:
  • A value of TRUE indicates that trap receiver tracing is enabled.
  • A value of FALSE indicates that trap receiver tracing is disabled.
TraceCLI
TRUE,FALSE
Default: FALSE
Determines whether CLI discovery tracing is enabled or disabled.
When TRUE, the CLI dialog conducted with each Nortel Signaling Server is captured in a file located in the log directory.
TracePMTraps
TRUE,FALSE
Default: FALSE
Determines whether the tracing occurs of
trap receiver processing.
  • A value of TRUE indicates that tracing is enabled.
  • A value of FALSE indicates that tracing is disabled.
SyncDelay
240 to 3600
Default: 300
The number of seconds that the
Trap Processor will wait after the initial
related topology update (after the initial PNODES traps are processed).
The ExternalName attributes of VoipCluster, CallManager, ConvergedCallManager should be progagated after the initial
related topology update. See the VoipPerformanceManager::ConnectedAt attribute to determine the initial connection time.
PMTraps_Timeout
240 to 3600
Default: 240
The minimum value for
Traps Timeout is 240 seconds (4 minutes). The recommended maximum value is 3600 seconds (1 hour).
  • If the assigned value is less than 240 seconds, it will be set to 240 seconds.
  • If the assigned value is not a multiple of 240, it will be rounded up to the closest multiple of 240.
MaxNumPIDMonitors
0 to 500
Default: 500 (maximum)
The maximum number of PID monitors invoked each minute.
PIDPollingInterval
0 to 3600
Default: 240
Number of seconds to wait between attempts to probe the Host resource MIB to detect when an unresponsive process has been restarted.
PIDPollingInterval = 0 disables polling.