A System Settings Summary

This chapter provides a summary of the Oracle Communications Operations Monitor system settings.

302 Redirected: To-URI suffix length

How many characters of the user part of the Contact: and Request URI must match to merge a call. Use 0 to disable this option.

APID request interval for querying SBCs

Number of seconds interval for retrieving informations about autodiscovered SBCs. It is not recommended to alter this value.

Alerting delay after core restart

The length of time alerts are suppressed after a core restart, in minutes.

Allow regeneration of registration events for user updates

If a user is registered in core once, its realm will not be re-checked until the registration expires and gets renewed. If realms are changed continuously and/or customer needs to have registrations always matched to the current realms configuration, enable this option. Be aware that this has some performance impacts on core registration processing.

Append a string at the end of User Tracking searches

When using User Tracking, also look for aliases that have this suffix appended to the number.

Authentication token (shared secret between MEC and ME)

Secret used by the Mediation Engine Connector to sign requests proxied to this Mediation Engine.

Auto-refresh interval for grids

Number of seconds between auto-refresh (if enabled) for grids with this feature.

B2B incoming backlog search for merging

The number of seconds to search the outgoing call leg in the past when an incoming leg is received.

B2B outgoing backlog search for merging

The number of seconds to search the incoming call leg in the past when an outgoing leg is received.

Bind user sessions to IP addresses

Bind each session to an IP address.

Bulk counters/KPIs maximum limit

The maximum limit of counters being added in bulk.

CDR Interim Update Interval

This value represents the interval in minutes for which partial Call Detail Record (CDR) data will be created. The allowed range of this interval is from 0 - 10 minutes. If 0 is given then the partial CDR generation feature is turned off. Warning: Turning on this feature has an impact in performance.

CPM Transaction time range

The default limit in minutes to cutoff Control Plane Monitor transaction queries. A value of 600 will result in the transactions grid showing transactions in the range of [ NOW(), NOW() - 10 Hours].

Cache time interval in minutes for User Agent statistics

If User Agent Statistics is active, the results are stored in an internal application cache that is refreshed at the interval defined in this system setting. The value is defined in minutes and the default is 60 minutes. There is no upper time limit for this setting and a value less than five minutes disables the cache which is not recommended for performance reasons.

Call Report Maximum Messages

Maximum number of messages to include in the call report messages section.

Call Report Style

Additional Cascading Style Sheet (CSS) rules can be defined here that will be included when generating a call report PDF.

Call Report Theme Color

Color of the headings and footer on PDF call reports. Can be the name of a color, or a hexadecimal representation of the color: #ff0000.

Call Transfer: Seconds for correlating calls using REFER

The number of seconds the Mediation Engine looks back for calls containing a REFER causing the current call. If 0, correlating the referred and referring call is disabled for the Call Transfer information.

Call Transfer: correlate using Replaces

Set to true to match calls involved in a call transfer using the Replaces header.

Call flow max height

The maximum height of the call flow diagram in pixels.

Call flow max width

The maximum width of the call flow diagram in pixels.

Call flow messages

The maximum number of messages displayed in a call flow.

Call flow parallel loading

When set, the in-browser call flow diagrams will be loaded in several stages, with progressively more information for some messages. This might improve rendering performance.

Call flow timestamp for fragmented messages

Use last fragment's timestamp as the timestamp for the message.

Call flow tree's expanded levels

Expanded levels in the popup for a message.

Cleanup Actions Syslog logging facility

Which logging facility should be used for the Mediation Engine's cleanup actions. Leave negative if this should be disabled. Allowed values are zero through to seven.

Custom header for realm definition

Specify a SIP header field name that is used to match the "Custom Pattern" definition for a realm.

Custom SIP headers in CDR file

A space-separated list of custom SIP header fields to be included in the CDR file. The customization of CDR generation uses these fields. For more information, see "Customizing CDR Generation".

Day on which the week should begin

Defines the day at which the week should begin. A page reload is required for this setting to take effect.

Days until inactive account expires

Expire inactive accounts after the given number of days.

Device Map Limit

Above this number of devices, device counters will be removed.

Digest delay time

The time between sending out digests of recurring alerts in minutes.

Disable logo changes

If enabled, users cannot make logo changes.

Disable user changes

If enabled, users cannot make password or logo changes.

Dumper raw buffer size

The size of the raw buffer in MB. This buffer is used for creating traces starting in the past. Warning: Increasing this setting might require adjusting memory quotas. Please contact Oracle or your system integrator.

Enable call events publisher

Enables publishing periodic call events for established calls. Enable this setting in order to allow the connection between OCOM and OCFM (Fraud Monitor)

Enable CDR writer

Enable if you want the Mediation Engine to generate CDR files. Please see the user manual for details about the format used and how to get the files.

Enable MEGACO BGF

Enables the processing of BGF messages in MEGACO.

Enable sharing saved calls

If enabled, saved calls can be shared globally. If you run a multi-tenancy setup, this feature should be DISABLED.

Enabled Device Map

If enabled (the default), Operations Monitor can display a real-time map of the configured platform devices and of the interactions between them. Please note that due to browser and backend performance reasons, this map cannot work for a large number of configured device counters. It is therefore recommended to disable this setting when configuring more than 20 devices or realms. In order to configure the maximum number of devices supported, adjust the Device Map Limit setting.

External authentication enabled

Enables or disables HTTP header authentication driven by the reverse proxy (NGINX or Apache).

Enforce stringent password rules

A set of higher security rules for user passwords.

Expire passwords periodically

If enabled, non-admin users will be required to change their passwords periodically. This option can be overridden from the Mediation Engine Connector.

Export metrics to OCDM

Enable to export selected KPIs via the Oracle Communications Data Model file based integration.

Extend calls by hash inspection

During call legs discovery across multiple sites, a neighboring Mediation Engine can be interrogated multiple times, rather than only once.

Find similar aliases in User Tracking by using a suffix of this many characters

If this value is non-zero, the User Tracking page first searches the alias list for similar usernames/phone numbers and then displays the calls and registration events for all of them. To usernames/phone numbers are considered similar if the last N number of characters are identical, where N is the value of this setting.

Get updated call states

If enabled, the fronted will query the core process on each request to get the very latest state information. This can increase the delay before the answer is made, but generally makes the information more up to date.

Global partitions size

How many hours a database partition should hold. There can be at most 1024 partitions.

Grey out non-preferred numbers

Numbers that haven't been derived from a configured number determination source will be displayed in gray in the calls table.

Group new registrations from the same user

Group new registrations from the same user.

Guarantee sorting of VSI traces

Due to the distributed nature of the Mediation Engine, it is possible that the packets in the traces buffer are out of order. If this option is enabled, the Mediation Engine will re-sort the packets by their timestamp.

HTTP address of the Mediation Engine Connector

HTTP address where to reach the Mediation Engine Connector. This is automatically set from the Mediation Engine Connector.

Headers in which to look for realm URIs

A space separated list of SIP header fields, for example, Diversion P-Asserted-Identity. Realm matching will include these fields (in addition to To and From).

Hide Megaco messages before off-hook

This option helps if the MEGACO transactions IDs are reused very quickly. It will hide the messages that are assigned to the leg before the off-hook event.

Hide active user sessions

Hide active user session info when limit is reached.

Hide hardware addresses input from devices configuration

If set to true, the hardware addresses field will be hidden from the platform devices wizard.

High threshold for MOS

The high threshold for determining the MOS.

Ignore internal registrations

If disabled, registrations from inside the platform will be recorded. This might make some REGISTER transactions to be incorrectly considered unauthorized because the 401/407 answer is seen more than once.

Ignore internal registrations for User Devices statistics

If enabled, the internal registrations (starting from a platform device) will be ignored when computing the User Devices statistics.

Ignore mismatch on contact URI (registrations)

Some registrars change the Contact URI in a reply to a REGISTER. This tells the Mediation Engine to ignore mismatching URIs, but might lead to merging multiple registrations into one.

Ignore non RFC 3261 params in SIP URI username

If set to true, the Mediation Engine will remove the parameters appended to the username before matching the SIP URI username.

Ignore plus prefix number when matching realms

By default the "+" number prefix is ignored in realm matching, when turned on, this option will assign numbers containing + only to the default realm.

Initial search range

The initial search range (in seconds) for calls, registrations etc to search before asking if the search should continue. If 'Paging query range' is bigger, that value will be used.

KPI - RTCP Jitter threshold

Defines a threshold for jitter KPIs (in ms) based on RTCP. Any jitter value above this threshold is ignored for the KPI computation. 0 means no threshold.

Limit select queries to this many seconds

Stop SELECT queries if they take more than this many seconds. Set to 0 to disable.

Log user authentication failures

Log information when a user fails to login.

Login Splash Page

A splash page which is shown after login. Removing all content will disable the splash page.

Loose user searching

If enabled, when searching users by using the live search feature, the last digits of the number act as wildcards to suggest similar numbers from the same range.

Low threshold for MOS

The low threshold for determining the MOS.

Match registration events by comparing a suffix of the username

The Mediation Engine matches the related registration attempts by the SIP username. If this value is zero, then the whole username is used. If more than zero, the number defines how many digits/characters must match.

Max concurrent sessions

The maximum number of times a user can login in parallel.

Max concurrent users

The maximum number of users that can be logged in at the same time.

Maximum concurrent traces

The maximum number of traces that can be running at the same time.

Maximum frequency for raising alerts

Determines at what point raised alerts that are not read can be raised again. If an alert has been continuously raised for more than this amount of seconds, it is eligible for being raised again.

Maximum lines of a CDR file

The maximum number of lines that a CDR file can contain. When this limit is reached, the Mediation Engine automatically creates a new CDR file.

Maximum number of calls exported with bulk export

The maximum number of calls that can be exported with one bulk export.

Maximum number of items returned by each request to the REST interface

Maximum number of items returned by each request to the REST interface.

Maximum number of legs in one call

If a call already has this many calls, the Mediation Engine won't merge new legs in the same call, even if they match according to the merging algorithm. The purpose of setting a maximum is to avoid infinite calls.

Maximum number of lines exported with CSV export

The maximum number of lines that can be exported with one CSV export.

Maximum number of messages per leg

Configure maximum number of messages to be stored per leg.

Maximum number of number alert definitions per user

Maximum number of number alert definitions that a user can create.

Maximum script output size

The maximum output size by script run in bytes that is shown. It's stored in memory.

Maximum simultaneous script runs

The maximum number of script runs that can run simultaneously.

Maximum stored script runs

The maximum number of script runs that are stored. If this number is exceeded the oldest script runs are removed as needed to stay under this limit.

Mediation Engine Connector hash on P-Charging-Vector icid-value parameter

To enable call merging in Mediation Engine Connector, you hash the INVITE message of the corresponding leg. By default, the Mediation Engine hashes the full INVITE message. When enabled, and the INVITE message contains a P-Charging-Vector header with an icid-value parameter, the value of the icid-value parameter is used to find a match instead of a hashing the full INVITE message.

Field Value
type Boolean
flags Browse
default False

Mediation Engine Connector hash search on all external legs

To enable call merging in Mediation Engine Connector, you hash the INVITE message of the corresponding leg. By default, the mediation engine hashes all the call legs that traverse between neighboring mediation engines. When enabled, a hash is added to all call legs to or from unknown IP addresses. This option exists for backward compatibility: enabling this option is not recommended if you require call correlation.

Field Value
type Boolean
flags Browse
default False

Note:

Oracle recommends that the Mediation Engine Connector hash search on all external legs system setting is set to disabled.

Merge globally by Call-ID

If this setting is enabled, Mediation Engine will merge two legs that have the same Call-ID even if they are not incoming/outgoing to the same device.

OCDM connection string

The Oracle database connection string to be used for querying Oracle Communications Data Model.

Omit Gray Bars

Omit the gray bars in charts.

Paging query range

Time range a query covers in a single paging request (in seconds).

Partitions to display in Recent calls

Number of partitions to display at once in Recent calls.

Partitions to display in User tracking

Number of partitions to display at once in User tracking calls.

Password strength

If enabled, the users will be required to respect a set of rules for their passwords (minimum 8 characters, one non-lowercase letter character, no reference to the user name).

Passwords expire duration for non-sensitive enabled users

Number of days after which users without access to sensitive information are required to change their password.

Passwords expire duration for sensitive enabled users

The number of days after which users with access to sensitive information are required to change their password.

RUDP quick push

Choose the RUDP decoding mode: when 'quick push' mode is activated, the data chunks will be processed as soon as they are read, rather then waiting for the corresponding ACK. This allows better operation of the Mediation Engine in cases where ACKs are delayed excessively, but it will also prevent the detection of some malfunctions in the protocol (like lost packets).

Recurrent alerts threshold

Days during which a new alert identical to a raised unread one will not be created.

Refer: Merging calls requires full Contact match

If call merging on REFER is enabled this option controls whether the full Contact URI must match between the INVITEs of the original call and the referred one. If enabled the complete Contact URIs of both INVITEs are compared, if disabled only the user name parts are compared.

Refer: Seconds for merging calls

The number of seconds the Mediation Engine looks back for calls containing a REFER causing the current call. If 0, merging the referred and referring call is disabled.

Refer: To-URI suffix length

How many characters of the user part of Refer-To: and To: must match to merge a call. Set to 0 to compare the full user part.

Refresh interval for portlets

The refresh interval in seconds that overrides the default one in each portlet when the user reloads the dashboard. Set to 0 to use each portlet's default interval.

Registration expired events

When a REGISTER transaction occurs and a registration binding is expired, generates 'Expired' registration events for the expired contacts. No messages are associated with this type of event.

This system setting allows you to configure whether or not the expired registration events should be displayed in the Registrations panel. By default, this system setting is enabled.

Registrations gone events

If enabled, a REGISTER transaction in which not all previous known contacts of the user are seen in the successful answer generates gone events for the missing contacts. Leave disabled if this is expected in your network.

Rotate CDR files every N seconds

If this option is non-zero, the CDR files are rotated every N seconds, where N is the value of the setting.

SCTP quick push

Choose the SCTP decoding mode: when quickpush mode is activated, the data chunks will be processed as soon as they are read, rather then waiting for the corresponding SACK. This allows better operation of the Mediation Engine in cases where SACKs are delayed excessively, but it will also prevent the detection of some malfunctions in the protocol (like lost packets).

SIP packet deduplication

This option sets & enables packet deduplication for SIP on the ME. The value represents the time limit (in ms) for which a packet is considered duplicate. 0 means off. Warning: enabling deduplication has performance impacts.

SS7 default flavor

Choose the default standard for the MTP3/ISUP protocols. Supported are ITUT and ANSI.

SS7: Prefer ported number to callee (in IAM)

If IAM contains GAP for Ported number, display this as callee number. The matching algorithm is not affected by this setting.

Search for matching registration segments

When viewing the diagram of a Registration event, Mediation Engine will search for other registration events that are related. This option controls the time span in which it searches, in seconds. If set to 0, the searching of related registration events is disabled.

Seconds for merging 302 calls

The number of seconds the Mediation Engine looks back for related 'redirected by 302' calls. If 0, merging the redirected calls is disabled.

Seconds for remembering INVITE when merging 302 and REFER calls

The number of seconds the Mediation Engine looks forward for an INVITE if merging calls on 302 and REFER messages. Keep this value low. 0 disables just the forward-looking functionality.

Session-timeout for calls

The number of seconds after which the Mediation Engine will consider a call as Timed-Out if no SIP messages are received.

Set customer id for VSI FDP module

Specify a customer ID for VSI FDP module.

Show ISUP abnormal termination in details

For certain Q850 codes, add '- abnormal termination' on the details field.

Show OCDM widget

Display data gathered from the Oracle Communications Data Model in the User tracking page.

Strict SIP CSeq handling for unauthorized calls

When unset, some non-RFC-conformant but successful calls will be treated as successful instead of failed.

Stringent passwords expiration duration

Number of days after which passwords expire when the stringent password policy is enabled.

Suffix length (H.248, MGCP, Diameter, ENUM correlation)

Define the suffix length for correlation on DIAMETER Public ID, H.248/Megaco, MGCP, and ENUM. Set to 0 to only remove leading + from the Request URI/the Public ID.

TCP quick push

Choose the TCP decoding mode: when 'quick push' mode is activated, the data chunks will be processed as soon as they are read, rather then waiting for the corresponding ACK. In normal operation, you should not activate this option. If Agents see only one half of TCP traffic (and hence no ACKs are received), enable this option.

TDR enabled

Enable the Transaction Data Record.

Time difference in probes that will trigger an alert

Time difference in milliseconds between a probe and the ME that will trigger an alert.

Time window for each chunk of records when exporting

Number of seconds defining the interval for sql-querying a chunk of records to be exported.

Time window for records when exporting

Number of seconds (back from the last record) used for limiting the records to export.

Timeout for Mediation Engine querying

Number of seconds to wait for an answer from the Mediation Engine peers. If one of them becomes unavailable, the timeout ensures that the local results are still available.

Trace delay time

The time to wait between starting a new trace from the same alert definition, in minutes.

Transport MAC aware

This setting is used when matching a message to an existing call leg. If this setting is 'true', in case the source IP or destination IP of a new message is not configured as a device, Operations Monitor checks the MAC address before matching this packet to an existing call leg. However, if both source and destination IPs of the new packets can be matched to an existing device, this setting will be ignored and the device MAC address configuration will have precedence when matching the packets to the call leg.

Transport VLAN aware

This setting is used when matching a message to an existing call leg. If this setting is true, in case the source IP or destination IP of a new message is not configured as a device, Operations Monitor checks that both source and destination MAC addresses are the same before matching this packet to an existing call leg (if one of the endpoints was already matched via device lookups, the MAC address check for that endpoint is skipped). However, if both source and destination IPs of the new packets can be matched to an existing device, this setting will be ignored and the device VLAN configuration will have precedence when matching the packets to the call leg.

Transport ports aware

Consider ports when comparing packet and device addresses.

Use the hash of preferred number config to link it to Caller/Callee

If Number Determination Sources rules are configured and the calling or called number of a call is determined by one of the rules, a tag identifying the used rule will be stored in the call record in the database. The CDR CSV fields src_user_pref_tag and dst_user_pref_tag contain the tag of the rule used for the calling and called number respectively.

Note:

The tag is not visible in the Session Monitor GUI, the tag is only visible in the database and in CDRs.

If the setting is enabled, the tag value of a Number Determination Sources rule does not change if you delete a rule and add it again with the same parameters. This is because the tag is calculated using a hash on the rule parameters.

If the setting is disabled, the tag value of a Number Determination Sources rule is based on the Database ID of the Number Determination Sources rule, which may change if the rule is deleted and added again.

Use user domains

Set to true to match users based on the SIP URI (domain name), in addition to the user name (number). Changing this value restarts the core process.

User Actions File logging

Refers whether or not the Mediation Engine's user action should belogged into the dedicated file logging facility. By default, the Linux operating system provides the custom logging from local0 to local7. The number in the setting corresponds to which local syslog facility you want to use. For more information on syslog, refer to the link,

http://docs.oracle.com/cd/E52668_01/E54670/html/ol7-log-sec.html

User Actions Syslog logging facility

Refers to which logging facility should be used for the Mediation Engine's user action. By default, the Linux operating system provides the custom logging from local0 to local7. The number in the setting corresponds to which local syslog facility you want to use. For more information on syslog, refer to the link, http://docs.oracle.com/cd/E52668_01/E54670/html/ol7-log-sec.html

User Roles

Assign users roles containing predefined permissions.

User default locale

Assign newly created users this locale.

User devices chart history limit

Fetches only calls not older than specified number of seconds.

User tracking paging query range for

Time range a query covers in a single paging request (in seconds) for user tracking. Should typically be larger than the normal paging query range.

Voice Quality Chart scale in minutes/minute

If true, the Voice Quality Chart scale will be minutes/minute instead of minutes/15 minutes.