- Contents
Interaction Administrator Help
Media Server Properties
Interaction Media Server properties are name-value pairs that control the operations of the media server.
These properties can be set in four different places – two in the Media Server configuration pages and two in Interaction Administrator. The properties are used in a hierarchical relationship order, which enables an administrator to have specific control over the scope of these properties, as needed. The default properties are established on each media server, but each property can be overridden by defining it and assigning a different value in Interaction Administrator. Any property can be set from any location, depending on the scope of the property (i.e., which media servers and CIC servers it applies to). If you don't set any media server properties in Interaction Administrator, the default properties apply, or whatever you set locally on each media server.
Note: When you define media server properties with a different value in Interaction Administrator, those properties are not visibly displayed in the Interaction Media Server's interface, as they are when you define them locally on the media server. To see the complete set of all properties in effect on a media server, look in Interaction Administrator and the Interaction Media Server interface.
The four property configuration locations and the scope and purpose of each are summarized in the following table:
Evaluation Order |
Property Configuration |
Purpose and Scope |
1 |
Global media server properties – defined on the media server from the Config -> Properties configuration page |
These properties apply to all CIC servers connected to this media server. This is the lowest level of priority in the hierarchy as all other property settings can override these. Even properties that are not displayed here have a default value and they may be overridden if set elsewhere. Click here for a location example. |
2 |
Server properties – defined on the media server from the Properties page linked from the Config -> Servers configuration page |
These properties apply only to the connection between the selected CIC server and that media server. If there is overlap, properties defined here override the same property defined in the Global Properties page. Click here for a location example. |
3 |
IC server Global Properties – defined in Interaction Administrator Media Servers/ Configuration on the Properties tab |
These properties apply to all media servers logged in to this CIC server. If there is overlap, these properties override all of the properties set on the web configuration pages of all connected media servers. Click here for a location example. |
4 |
IC server properties – defined in Interaction Administrator, in Media Servers/Server/ <servername> Properties tab |
These properties apply only to the selected media server logged in to this CIC server. If there is overlap, these properties override the CIC server Global Properties, as well as all properties defined on the web configuration pages of the specified media server.. Click here for a location example. |
When the CIC server performs a media server operation (e.g., start a recording), the Interaction Media Server uses the aggregate set of properties to determine the current configuration. It evaluates the properties in this order:
-
Start with all of the properties defined in its global Properties page (1st in the table)
-
Add all of the properties defined in the Server Properties page (2nd in the table). If any of the server properties are also set in the global properties, use the server properties.
-
Add all of the properties defined in the global Media Server Properties in Interaction Administrator (3rd in the table). If any of these properties are also defined on the media server, use the global properties from Interaction Administrator.
-
Add all of the properties defined in the specific Media Server <servername> Properties page in Interaction Administrator (4th in the table). Use these properties to override any other property defined with the same name.
-
Add all of the properties together for a specific operation.
Using this hierarchy, you can have a default configuration but choose to override any part of it for a specific operation or server combination. If the properties you need to set are identical on all media servers, you can set them all once in Interaction Administrator and you won't have to set them at all in the Interaction Media Server interface.
Property Configuration Example:
Consider the RecordingMimeTypeDefault property, which controls the audio recording format when Interaction Recorder is configured to use “μ-Law (Mono)” as its compression format, or when a custom handler initiates a recording and does not specify a “Mime Type” parameter.
Suppose you specified audio/PCMA as the recording format in the Config --> Properties page of the Media server. That means when a recording is created, it is in that format unless specifically overridden. If you later realize the need to record all calls on a particular CIC server in the audio/GSM format, you can add the RecordingMimeTypeDefault property with the audio/GSM value to the Config --> Server --> Properties page. However, if a CIC server uses several media servers, you would have to go to each media server and add that property to the Properties page of that CIC server’s configuration on the media server. Instead, you can use Interaction Administrator and add that property/value to the Properties tab on the Media Servers --> Configuration --> Properties dialog. Now all recordings created by that CIC server will be recorded in audio/GSM. If you discover that you really need all but one of the media servers to use audio\GSM, you can open the configuration container for that particular media server in Interaction Administrator and specify a different format for that server on the Properties tab.
Related topics
Media Server General Configuration
Media Server Web Configuration
SIP Line Configuration - Session
SIP Station Configuration - Session