This page contains comprehensive information dealing with configuration issues. Please read carefully. Contact Sytel Support if you have any questions.
Fig. 1 - SCC Deployment Plan for Hosted Deployment (v10.6)
- Box at end of connection indicates that the process is listening for connections.
- (*) Softdial Scripter™ Designer, Softdial Scripter™ Client and Softdial Reporter™ 2 use HTTP Channel (Long Polling)
Fig. 1 shows a generic deployment plan for medium to large scale hosted deployments. Consult with Sytel Support to determine the most suitable deployment for your specific requirements.
Platform and OS Compatibility
Softdial Contact Center and Softdial Telephony Gateway are validated for use on the Windows Server 2012 OS.
At the time of writing (V10.6.262) STG runs as a 32 bit process on an x64 OS, including Windows 2008 R2. A native x64 version is currently in Q.A.
Virtualisation platform support (See also Virtualisation Issues):
Only hypervisors and processor architectures that support reservation of processor power and memory for a VM may be used to host SCC. This means Nehalem or Sandy Bridge architecture Intel processors.
Softdial Contact Center has been validated against the following Hypervisors
- VMWare ESX
- VMWare ESXi
- Hyper-V Server 2008 R2
- Windows Server 2008 R2 Enterprise/DataCenter edition with Hyper-V role.
Installing Windows Server 2008/R2:
- In Server Manager install Application Server Role
- Install the full standalone copy of .NET framework version 4
- If you're deploying virtualised delete the swap file
- For all server roles other than web server, disable Windows firewall *
- Disable UAC *
* - It is possible to use Windows Firewall and UAC if your IT policy dictates this. It will make administering your SCC install more cumbersome.
Server Sizing and Configuration Issues
Installations should be distributed across 2 or more servers, depending on the initial number of agents and scale up that may be required.
Some understanding of the limiting factors applicable to the individual applications will be helpful in deciding the most appropriate configuration for your system.
Softdial CallGem™
Softdial CallGem™ caches dialing information for each number, agent and campaign as well as the last hour's enumeration message history. Softdial CallGem™ is a 32 bit application so the limiting factor here is the 2 GB available memory. Theoretically this should support up to 2000 agents but the actual number will be dependent on the no. of agents per campaign and the amount of data that is embedded with the data messages.
On a dedicated server a safe upper limit would be 1000 agents with typical data payload. (Data payload may be significantly higher depending on the business application e.g. Market Research). For most modern Server hardware (2GHz+ Core 2 CPU) CPU usage should not be an issue.
Note that the dialer simulation engine will try to use as much CPU resource as is available but this is run as a low priority process such that it will not restrict other OS processes that require CPU resources.
Softdial Campaign Manager™ / Softdial Scripter™
The limiting factor as far as Softdial Campaign Manager™ is concerned is the available network bandwidth therefore the number of agents that can be supported on a single server will largely be determined by the data bandwidth between Softdial Campaign Manager™ and the database server. As a 'rule of thumb' for 1Gb/s NIC we would suggest up to 500 agents on a dedicated CM Server. Since Softdial Scripter™ has similar network bandwidth based limits, this would drop to 250 agents if Softdial Campaign Manager™ and Softdial Scripter™ were installed on the same server.
Publisher
Due to the non-deterministic CPU loading, memory usage and bandwidth characteristics it is always recommended that Publisher is installed on a dedicated server (with the exception of the 'single box' solution described above).
Softdial Telephony Gateway™
Softdial Telephony Gateway™ and its media stack is also a 32 bit process. In this case the agent limit is imposed by the no. of available OS handles which we increase from the default 10000 to 18000. This equates to 1000 channels of voice media processing or 300 agents with some redundancy. It is possible to configure a Softdial Telephony Gateway™ cluster with up to 8 STG instances to provide support for a theoretical maximum 2400 agents.
There are other factors which can limit the number of supported agents below this theoretical max:
- As the number of servers in the cluster increases, the likelihood of cross-server connections being required (call comes in on one server and is connected to an agent on another server) also increases. When this happens, the number of channels used per connection doubles reducing the practical maximum no. of agents supported.
- The number of channels used per connection depends on the range of media processing options that are used. For example, if call transfers and call recording is common, this will reduce the number of agents supported (See Telephony Issues).
In practice we have found that a realistic average for the number of agents supported per server is around 200 - 220.
For more information see the Sytel Media Server page.
For backup and fast recovery we recommend thatSoftdial Contact Center™ is run 'virtualised' where possible.
Here is a baseline spec for 100 and 200 agent systems supporting all SCC functionality:
Up to 100 Agents
- Intel Xeon E5 -2420 (or higher) 6C/12T processor
- 16GB memory
- 480/512GB SSD (for OS & logs)
- 2TB 7200RPM HDD (for recording storage)
- VMWare VSphere 5 free edition running 3 to 5 VMs
- 1 Windows Server 2008 R2 license required + 1 Windows 7 x64 license.
- 1 Server running CallGem, applications and web server. (Server 2008 R2)
- 1 Server running MongoDB on Linux
- 1 Server running STG (Windows 7)
And optionally
- 1 Server running an Asterisk registrar
- 1 Server running a RDBMS (Customer's choice)
Up to 200 Agents
- 2 x Intel Xeon E5 -2420 (or higher) 6C/12T processor
- 32GB memory
- 480/512GB SSD (for OS & logs)
- 2TB 7200RPM HDD (for recording storage)
- VMWare VSphere 5 free edition running 4 to 6 VMs
- 1 Windows Server 2008 R2 license required + 1 Windows 7 x64 license.
- 1 Server running CallGem, applications and web server. (Server 2008 R2)
- 1 Server running MongoDB on Linux
- 2 Servers running STG (Windows 7)
And optionally
- 1 Server running an Asterisk registrar
- 1 Server running a RDBMS (Customer's choice)
Configuring Windows for High Network Connection Rates
When a TCP/IP socket is closed, it goes into TIME_WAIT state before closing, for a period of time determined by the operating system. A socket in TIME_WAIT state cannot be reused; this can limit the maximum rate at which network connections can be created and disconnected.
The client application normally closes the socket; if the application is on a different machine, the limitation usually applies to the machine running the application. The symptoms of a machine that is reaching these limits include:
All of the TCP/IP resources of the operating system are in use, and requests for new connections fail. Running the netstat -a command on the application machine shows a large number of sockets in TIME_WAIT state.
Performance deteriorates.
To improve the ability of the Windows operating system to deal with a high rate of network connections, add the following registry entries in
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\TCPIP\Parameters
| Key | Description |
|---|---|
| TcpTimedWaitDelay | A DWORD value, in the range 30-300, determines the time in seconds that elapses before TCP can release a closed connection and reuse its resources. Set this to a low value to reduce the amount of time that sockets stay in TIME_WAIT. |
| MaxUserPort | A DWORD value that determines the highest port number that TCP can assign when an application requests an available user port. Set this to a high value to increase the total number of sockets that can be connected to the port. |
For example, a system making a large number of connection requests might perform better if TcpTimedWaitDelay is set to 30 seconds, and MaxUserPort is set to 32678.
Windows OS Limitations and Restrictions
There are some Windows OS resource issues that will restrict the number of tenants / services that can be supported on a single server, whether physical or virtual.
As well as the usual disk space, CPU and Memory limitations, you also need to consider limitations imposed by the OS on the desktop heap used by the various Softdial services.
For guidance, our testing with Windows Server 2012 32 bit OS showed that running 25 tenants on a single server with each tenant simultaneously running the following tenant services,
- Softdial Campaign Manager™
- Publisher
- Softdial Scripter™ (publishing 5 scripts simultaneously)
- Scheduler
resulted in approximately 90% desktop heap usage.
This is something you should consider if you are intending to deploy multiple tenants per server.
Other Application Specific Configuration Issues
Particular care should be taken with some key issues highlighted here:
Browser Support
The latest versions of Softdial Contact Center web applications are compatible with
- Google Chrome
- Mozilla Firefox
- Microsoft Edge (but not Internet Explorer)
Reserved Ports
The following port numbers are used by CallGem. To avoid port conflicts, they must not be used by any other application:
- 6498, 6499,6500, 6501, 6502, 6503
- 6808, 6809, 6810
- 7400, 7401
Registry Keys
Refer to the Help documentation for a list of Registry settings that may be modified for configuration purposes. Registry Keys that are not listed in the Help documentation must not be changed except where advised by Sytel engineers - see the CallGem Registry Settings page.
NameSpaceChanges to the
See Name Space Editor.
Invalid Characters
Softdial applications connecting to CallGem must avoid using illegal characters in object and address identifiers. Identifiers are used to index collections of objects such as campaigns, tenants, agents, queues etc. Any string that is used as an identifier for one of these objects must be validated against a consistent set of 'Illegal Characters' so that wherever these identifiers are used, transformed or cross API boundaries they will remain valid.
Identifiers may be used freely in 4 contexts: the OS, XML, SQL and SDMP. This means that the range of invalid characters is the superset of:
- Bad file system characters / \ : * ? " < > |
- XML framing characters < > \ & % !
- SQL framing characters " ' . ;
- SDMP framing characters \ :
We need to exclude the '.' character since it may be used for user identifiers for active directory e.g. user@sytelco.com and for DNS names in SIP addresses e.g. sip:user@sytelco.com.
Therefore the set of illegal characters for object identifiers is:
/ \ : * ? " < > | & % ! ' ;
and the set of illegal characters for address identifiers is:
/ \ * ? " < > | & % ! ' ;
Illegal characters can sometimes be inadvertently passed to Softdial CallGem™ from user generated input. For example, this can happen if input text is copied or sent from a third party application which may insert hidden illegal characters causing the Softdial application to generate an alert containing these characters. This alert is passed to Softdial CallGem™ which, in some circumstances, may cause Softdial CallGem™ to fail.
From V10.6.395 we have improved validation of alerts received by CallGem to eliminate failures caused by alerts containing user generated illegal characters.
Log File Configuration
(See also .NET Service Log Configuration)
On 64-bit machines where you see HKEY_LOCAL_MACHINE\Software replace with HKEY_LOCAL_MACHINE\Software\Wow6432Node.
Softdial Campaign Manager™
Note that even though CM runs native 64-bit we still use the 32-bit registry redirect for compatibility.
HKEY_LOCAL_MACHINE\Software\Wow6432Node\Sytel\CMServer\<tenant>\
3 registry values, all REG_DWORD
LogPurgeDays- default is 28, controls purge cycle for SCM log and TXlog files.LogSQLErrorPurgeDays- default is 28, controls purge cycle for SQL error logs.AuditPurgeDays- default is 28, controls purge cycle for audittrail data in SQL database
Softdial CallGem™
HKEY_LOCAL_MACHINE\Software\Wow6432Node\Sytel\Dialer\
2 registry values, all REG_DWORD
LargeLogDays- default is 28, controls purge cycle for msglog filesLogDays- default is 28, controls purge cycle for syslog, transactionlog and statlog files.
Note: Abandon logs are hard coded to 6 months for regulatory reasons (UK and US). The volume of data stored in these logs is trivial.
Scheduler & Softdial Scripter™
The log purge cycle is controlled by a setting in the .exe.config file located in the same directory as the executable.
<add key="MaxDaysOld" value="28" />
The value can be changed but must be enclosed in quotes.
All of these settings require a service restart to take effect.
See the Softdial Logs page for more details of configuring logging levels on .NET services.