4.22 Defining expert settings
Under the menu item Expert settings you have the possibility to change some specific settings for different Swyx components.
"Expert settings" are only intended for experienced Swyx administrators and can have a serious impact on the Swyx configuration. Please refrain from making any changes in this area if you are unsure about the possible consequences of your settings.
In earlier Swyx versions these settings were defined via registry keys.
During a system update, parameters defined via registry keys are kept unchanged and transferred to the database. All future changes must be made in the "Expert Settings". This also applies to a new installation of the software.
During a system update, parameters defined via registry keys are kept unchanged and transferred to the database. All future changes must be made in the "Expert Settings". This also applies to a new installation of the software.
Which expert settings are displayed?
The expert settings are grouped on tabs in different/multiple topics. The individual tabs are visible under the following conditions:
|
Tab name
|
Display requirements
|
|---|---|
|
IpPbxPNS
|
Visible when the PNS service has started successfully.
|
|
IpPbxSMTP
|
Visible when SwyxServer is successfully started.
|
|
IpPbxSrv
|
Visible when
at least one client or device is connected,
at least one call is made.
|
|
LinkMgr
|
Visible when at least one SIP trunk has been registered.
|
|
PhoneMgr
|
Visible when
at least one device (HFA) is connected and configured,
at least one firmware update is available for one of the connected devices.
|
Which administrators can see and edit the expert settings?
As system administrator of a Swyx On Premise Installation, you have full access to the expert settings.
The expert settings can only be edited or viewed by the following SwyxON administrators:
|
SwyxON
Administrator profile |
PlatformExpertSettingsRW
|
ServerExpertSettingsRW
|
ServiceExpertSettingsRW
|
ExpertSettingsRO
|
|---|---|---|---|---|
|
Advanced Platform Administrator
|
|
|
|
|
|
Platform Administrator
|
-
|
|
|
|
|
Advanced Partner Administrator
|
-
|
|
|
|
|
Advanced Partner Administrator
(Deutsche Telekom AG) |
|
|
|
|
|
Support Administrator
|
-
|
-
|
-
|
|
|
Partner Administrator
(Deutsche Telekom AG) |
|
|||
|
Partner Administrator
|
-
|
-
|
-
|
|
|
UC Tenant Administrator
|
-
|
-
|
-
|
|
legend: = allowed for this administration profile
To set the expert settings
Expert mode is activated. The warning triangle symbol appears in the title bar.In the fields with Boolean values ("True" or "False"), "0" means the option is disabled. "1" means the option is active.
Tab IpPbxPNS
|
Label
|
Explanation
|
Access level
|
|---|---|---|
|
MaxInactivityTime
|
Maximum inactivity time in days after which a client is removed from the PNS. SIP spoofing to IpPbxSrv is terminated.
If the value is less than 3600, the time is calculated in days, e.g. 3599 days.
If the value is greater than 3600, the time is calculated in seconds, e.g. 3601 seconds.
Default value = 30 days.
|
Service
|
IpPbxSrv tab
|
Label
|
Explanation
|
Access level
|
|---|---|---|
|
CallNotificationOn2ndCallDisabled
|
Specify whether the call notification should still be displayed on the second line if the second call is deactivated.
Default value = 1 (call notification is NOT displayed)
|
Service
|
|
CDRForAuxiliaryCallsDisabled
|
Specify whether CDR entries should also be written for CTI+ auxiliary calls (calls from/to the CTI+ controlled terminal).
Default value is 0 (CDRs for additional calls are NOT written).
|
Service
|
|
ExclusiveMediaFileEP
|
Specify whether to use the Media Manager exclusive mode for playfile endpoints. This mode should be activated if the waiting announcement is always to be played from the beginning in calls on hold.
Default value = 1 (Exclusive mode is enabled).
|
Service
|
|
ExtendedCallJournal
|
Specify whether extended call log including call duration etc. should be activated.
Default value = 0 (extended call log is deactivated).
|
Service
|
|
MaxCallConnectedTimeout
|
Maximum call duration in minutes. Every call in the connected state is ended after this period of time. Direct calls to conference rooms are excluded.
Default value = 180 min. (3 hours).
|
Service
|
|
MaxSipTcpIdleTimeout
|
The SIP-TCP connection must have no incoming data traffic for longer than this time (in seconds) before it is deleted (Garbage Collect).
Default value = 4000 seconds (3 hours).
|
Platform
|
|
PhoneCallListEntryCallForIsFirstRedirector
|
Specify whether the call display in the client should also include the original call destination before forwarding.
Default value = 1 (The original call destination is NOT displayed).
|
Service
|
|
RFC2833DTMFPayloadType
|
Set the RTP payload type for marking DTMF signals according to RFC2833.
Default value = 101 (DTMF)
|
Service
|
|
SkipGroupCallMembersWithActiveAway
|
Specify whether group members with the status "Away" are to be disregarded during a group call.
Default value = 0 (group members with "Away" receive the calls).
|
Service
|
|
SkipGroupCallMembersWithActiveDoNotDisturb
|
Specify whether group members with the status "Do not disturb" are to be disregarded during a group call.
Default value = 0 (group members with "Do not disturb" receive the calls).
|
Service
|
|
SuppressInternalNumbers
|
Specify whether the display of the call number should be suppressed for an internal call if the user has activated the "Hide number" function.
Default value = 0 (The number for internal calls is always displayed).
|
Service
|
|
SuppressNames
|
Specify whether the contact name display should be suppressed for an internal call.
Default value = 0 (The contact for internal calls is displayed)
|
Service
|
|
TrunkCallRetryOnBusyOrReject
|
Specify whether call repetition should also be performed for a call over the trunk that was disconnected by "Busy" or "Reject".
Default value = 0 (no call repetition)
|
Service
|
|
TrunkCallRetryOnTonesAvailable
|
Specify whether to suspend call repetition when a 183 session progress is received with SDP for this line. When stopped, the caller hears "early" tones (alert, etc.) generated by the attendant.
Default value = 0 (call repetition is NOT interrupted).
|
Service
|
|
TrunkRecordingForAuxiliaryCallsDisabled
|
Specify whether to record trunk recordings for auxiliary calls (calls to/from the CTI+ controlled terminal).
Default value = 1 (recordings are recorded)
|
Service
|
|
TrunkOnlyDTMFConfirmation
|
Specify whether a DTMF confirmation should only be requested on external devices. The call is put through to the end devices in the internal network without confirmation.
Default value = 0 (DTMF confirmation is requested on all devices).
|
Service
|
|
WritePhoneCallListEntryOnGroupCall
|
Specify whether group calls are registered in the call journal.
Default value = 1 (group calls are registered).
|
Service
|
LinkMgr tab
These settings appear when
at least one SIP trunk has been created.|
Label
|
Explanation
|
Access level
|
|---|---|---|
|
PlayRecordingNotificationSound
|
Set whether to enable (1) or disable (0) the notification tones at the beginning and end of a trunk recording.
Default value = 1 (notification tones are activated).
|
Service
|
|
SIPNetworkProvidedNumber
|
Define a fixed trunk-specific NPN (network provided number), which overwrites the number transmitted by the server if necessary.
|
Platform
|
|
ForwardAOCMessages
|
Specify whether AOC (Advice of Charge) messages are to be transmitted via trunk.
Default value =1 (AOC messages are transmitted).
|
Platform
|
|
AddExchangeHistoryInfo
|
Specify whether to add the "SIP History-Info" header field to the INVITEs for MS Exchange support on the trunk.
Default value = 0 (no "SIP History-Info" fields)
|
Platform
|
|
StunRefresh
|
Set the refresh time in milliseconds for the STUN connection.
Default value = 10000 (corresponds to 10 seconds).
|
Platform
|
|
SipTransportType
|
Type of transport protocol
Default value = tcp.
|
Platform
|
PhoneMgr tab
|
Label
|
Explanation
|
Access level
|
|---|---|---|
|
AutoFirmwareUpdate
|
Set whether the firmware update is performed by all phones without prompting.
Default value = 0 (The prompt appears).
|
Platform
|
IpPbxSMTP tab
|
Label
|
Explanation
|
Access level
|
|---|---|---|
|
SecurityLevel
|
Degree of mail server certificate verification:
0 = none - not secure
4 = check exhibitor - almost secure
5 = check exhibitor, check hostname - secure
Default value = 5
|
Service
|
|
ConnectTimeout
|
Maximum time to connect to the e-mail server,
For TLS connections, including the time for the STARTTLS phase.
Default value = 15 seconds
|
Server
|
|
MailSendTimeout
|
Maximum transaction time for sending an e-mail to the email server in seconds
Default value = 300 seconds (5 min.)
|
Server
|
|
MinutesBeforeMailWarning
|
Time in minutes after which a warning message is sent if the attempt to send an email fails repeatedly.
Default value = 2880 minutes (2 days)
|
Server
|
|
HoursBeforeMailGiveup
|
Time in hours after which a repeated attempt to send an e-mail is aborted.
Default value = 120 hours (5 days)
|
Server
|
|
MailMaxLinesToCite
|
Number of text lines to be quoted in a warning message from the failed email.
Default value = 15 lines
|
Server
|
|
MaxBase64LineLength
|
Maximum length of a Base64-encoded line (for binary attachments)
Default value = 898 characters
|
Platform
|
|
MinutesBetweenMailRetrys
|
Time in minutes after which an email send attempt should be repeated if the previous attempt failed.
Default value = 30 minutes
|
Platform
|
|
CreateNewSessionForEachMail
|
Establish a new connection to the email server for each email to be sent: 0 -false | 1 -true
Default value = 0 - false
|
Platform
|
|
TimeBetweenMailTransactions
|
Time interval in seconds between e-mail transmissions (can lead to rejectionOH by the mail server if the time interval is too short)
Default value = 5 seconds
|
Platform
|