Professional Documents
Culture Documents
Solidus eCare
INSTALLATION INSTRUCTIONS
Introduction
This document describes installation and integration of Aastra Connectivity
Server (ACS) with Solidus eCare. ACS provides call control connectivity to
Call Managers supporting the SIP protocol. For this configuration, ACS is
used instead of Open Application Server (OAS) for call and media control.
Call Managers supported for this configuration include the following:
Aastra 400
Cisco
Aastra MX-ONE
*Note: MX-ONE can be connected to ACS for mixed Call Manager
environments, such as MX-ONE and Lync
System Architecture
Figure 1 represents an overview of the system architecture when Solidus
eCare is integrated with ACS.
Media Server
The CMG Media Server provides media integration, such as playing
messages, collecting DTMF digits, and conferencing multiple parties
together.
BSA
BluStar Agents running as SIP Soft clients register as SIP clients
toward the SIP Registrar in the TAS service.
Solidus eCare
Call Manager
The Call Manager supports SIP trunks which are configured to route
into TAS. This allows incoming service group calls to be routed to
BSA agents via TAS.
In addition, the Call Manager can configure BSA extensions to route
into TAS so that agents extensions may be dialed directly from the
other extensions in the Call Manager.
Installation Instructions
Following are the steps required to install Solidus eCare with ACS.
3.1
The installation will default to using localsystem for the service account or a domain
account can be specified.
3.2
TAS Installation
NOTE: TAS Installation is done silently if done from the package browser.
If the setup is launched from the .msi package on the installation media the following
dialogs will be seen.
10
11
Once installed, TAS and the Media Server can be stopped and started from the
Services control panel
12
3.3
13
After installation the Media Server configuration can be left at default (except for the
AudioFiles Prefix setting) unless otherwise conflicting with ports in use. An example
Media Server configuration is seen above:
NOTE: Be sure to take note of the backslash after the Audio Files Prefix path. This
is necessary because of the need to now use a set default container block in
Scripts and the leading backslash is not accepted in that block. Be sure to test
router SAs with this change to make sure the prompts associated with those are
played OK.
An example of how the prompt files and folders might be seen on the disk is shown
following:
14
3.3.1
15
3.3.2
Setting
SIP port
Dialog TTL
RTP port
range
RTCP
MOH file
Trim
Recordings
Codec
Preference
Audio Files
Prefix
SRTP SDP
Offer
SRTP Best
Effort
Description
The port TAS will use
to connect to the
Media Server. :port
for the default Ethernet
interface,
<interface>:port for a
specific Ethernet
interface.
The interval for a
simple session timer
that uses OPTIONS
SIP message to
periodically check if
the call is still up
Ports used for RTP
Default Value
:5065
Unchecked
10 mins.
40000-50000
<InstallDir>\Ringing.wav
Checked
Unchecked
Unchecked
16
Default
Recording
Rate
Log Path
Log Level
Max size
Discard after
16kHz
<InstallDir>\Logs
Trace
0
7 days
** Please note that for SRTP there is no way to force it one way or the other.
If an INVITE with (or without) crypto attribute is received then the media
server will always answer with (or without) crypto attribute regardless of the
settings. For calls without SDP, SRTP will be enforced if SRTP SDP Offer is
selected and SRTP Best Effort is not selected.
If any configuration changes are made other than the log level, the
Media Server does need to be restarted.
3.4
Setting
Registrar SIP
Listening Port
Description
Listening Port. TAS will
listen on this port for both TCP
and UDP
Default Value
5060
CSTA3 Service
Listening Port
8732
17
Media Server
Always In Call
Unchecked
Default Domain
aastra.com
sip:127.0.0.1:5065,transport=TCP
40000-40009, 80000-80009
Default Route
Agent Number
Ranges
LogPath
LogLevel
3.5
sip:127.0.0.1:5060;lr,transport=TCP
30000-30009
C:\logs
9
18
It is also possible to modify the Call Manager type from Solidus eCare Setup
as shown below.
Changing the Call Manager will require a restart of the Solidus eCare
services.
3.6
3.6.1
19
3.6.2
20
21
Call Manager data including BVDs, Languages and Play Messages can now
be configured.
3.6.3
BVD Configuration
Add the Basic Virtual Devices, or BVDs, which will be used to route service
group calls to Solidus eCare from the Call Manager. Each BVD number
should correspond to the SIP trunk configured to route from the Call
Manager to TAS (refer to the ACS Configuration tool for BVD Number
Ranges).
3.6.4
3.6.5
22
on the system and the relative path of the language specified media files are
passed to the media server.
3.6.5.1
Play Messages
After the Play Message List is defined, Play Messages can be added to the
list. The message prompt files provided with Solidus eCare can be utilized in
the Play Messages, or it is possible to record new message files and use
those.
On the General tab of the Play Message Properties, enter the Identification
number for the Play Message. This number should be unique within the
Play Message List.
Enter a description for the Play Message to help you identify its meaning.
The Media Objects tab can be used to configure the content of the Play
Message. For details on the various options available, consult the Play
Messages User Guide (4-1553 FAS10455).
3.6.5.2
Languages
After the Play Message List and Play Messages are defined, a Language
can be configured. At least one Language is required.
23
Once a SeC/TAS based system has been installed and configured for a
particular call manager, the following set of test cases should be performed to
verify the functionality of the system.
For this set of test cases, an ACS Site is defined with one TAS based Solidus
eCare system. DM, CCAS, ROS and SM AppMediaService communicate with
TAS through the CallControlServiceLink.dll, which then sends the request to
the Solidus Call Control Service.
These test cases are designed to test call manager interaction with an ACS
site, as well as call and media control through the ACS interface. The target
call manager shall have at least one SIP trunk configured towards the
Solidus/ACS system.
The access numbers for the trunk will be used in the configuration of Solidus
eCare service access and system requeue device. The access numbers for
the SIP trunk applications as well as the agent device extension numbers will
be defined and configured in the ACS Configuration tool on the SeC/ACS
system.
4.1
4.1.1
Configure a SeC SA using the SIP trunk access number as the number to
monitor. Confirm in the TAS log that a monitor can be started when the SA
is activated with a unique monitor cross reference ID generated. Confirm
6/1531-LXA 119 154 Uen A5 2014-05-01
24
that this unique monitor cross reference ID is used to stop the monitor on the
configured SA device when the SA is deactivated.
4.1.2
Disrupt the SIP trunk connection from the call manager to SeC and confirm
that the monitor is stopped and that it is restarted when the SIP connection
from the call manager is re-established.
4.1.3
4.1.4
With connected SIP trunks, restart the Call Control service. Verify that the
SAs lose the monitors and that upon restart of the Call Control service that
the SA monitors are successfully restarted.
4.2
4.2.1
Verify BSA starts up properly, and the extension can be monitored via ACS.
4.2.2
Queued Call
Place an incoming call to the SA via the SIP trunk access number and have
it queue for a Service Group such that repeat queue messages defined for
the group are heard repeatedly.
4.2.3
Place an incoming call to a Router SA via the SIP trunk access number and
have the call routed to BSA and answer. Verify that the agent enters Talking
state and that an audio path is established between the caller and the BSA
agent.
4.2.4
Place an incoming call to a Script Manager SA via the SIP trunk access
number and have the call routed to BSA and answer. Verify that the agent
6/1531-LXA 119 154 Uen A5 2014-05-01
25
enters Talking state and that an audio path is established between the caller
and the BSA agent.
4.2.5
Outgoing Call
Place an outbound call on the SIP trunk from BSA and answer at the far end.
Verify that the agent enters Talking state and that an audio path is
established between the BSA agent and the external endpoint.
4.2.6
Hold/Retrieve
Hold and retrieve incoming and outgoing SIP trunk calls call between BSA
and the external endpoint. Verify the state is correct and that the audio path
is correct for each state.
4.2.7
Clear Call
Clear a call from BSA in various states: Calling, Talking, Conference. Verify
that the call is removed from the SA and is seen as terminated from the
perspective of the external call manager.
4.2.8
Consultation Call
With an existing call in Talking state, place a new call over the SIP trunk to
an endpoint on the external call manager. Verify that the new call can be
answered and displays in Talking state, while the original call is in Held
state.
4.2.9
From BSA, transfer an existing incoming SIP trunk call to another BSA
agent. Repeat transferring before answer and after answer by the other
BSA agent. Verify that original BSA is idle when the transfer is complete and
that the audio path is established correctly between the other BSA agent and
the incoming SIP trunk caller.
4.2.10
From BSA make an outbound call over the SIP trunk to an extension on the
call manager that is not monitored by TAS. This will be a call using the
default route defined for TAS. Once this outbound call is established and
speech path is confirmed, transfer the call to another BSA agent (repeat for
both announced and blind transfers) and again confirm speech path with the
connected parties. Verify that the call is torn down properly regardless of
whether the BSA agent or the external caller disconnect first.
4.2.11
Receive an incoming SIP trunk call by BSA and then create a conference
between BSA, the incoming SIP trunk caller and another extension defined
6/1531-LXA 119 154 Uen A5 2014-05-01
26
on the call manager. Verify speech path and call window state display is
correct for all parties.
Clear BSA from the conference and verify that the BSA call window shows
as Idle and that the audio path is maintained between the two remaining
parties. Clear the call between the two remaining parties.
4.2.12
Create an outgoing SIP trunk call by BSA and then create a conference
between BSA, the outbound call and another extension defined on the call
manager. Verify speech path and call window state display is correct for all
parties.
Clear BSA from the conference and verify that the BSA call window shows
as Idle and that the audio path is maintained between the two remaining
parties. Clear the call between the two remaining parties.
4.2.13
Deflect Call
4.2.14
DTMF Digits
From BSA, enter DTMF digits for an existing call. Verify that the digits are
sent to the opposite party. Various combinations of play message
interruption by digits, inter digit timeout, termination digit, and flush buffer
options in the Script Manager Collect Digits block are to be verified.
4.2.15
After-Call Handling
Configure After-Call handling for a service group, and configure to send the
agent ID with the call. Place an incoming SIP trunk call to BSA and then
send the call to the after-call handling destination. Confirm that the call is
properly deflected, that correct call window states and displays are seen and
that correct audio path is established between the SIP trunk caller and the
After Agent Handing destination.
4.2.16
Deflect an incoming SIP trunk call to another service group. Verify that the
call is correctly deflected and routed through the service group.
4.2.17
Reject an incoming service group call, and verify that the call routes to the
requeue destination, and it is routed to another agent.
Repeat allowing the call to timeout and be handled by the requeue device.
27
4.2.18
Associate Data
Use a Script Manager Service Access and associated Script Designer script
that utilizes an Associate Data block and configure the contents of the
block to be a maximum length string of 512 digits (this block in Script
Designer is limited to 100 characters). Confirm that the data is tagged to the
call and displayed on another BSA when the call is transferred to another
agent.
4.2.19
Assist
From a BSA agent, request Assist from another agent. Verify that the
assisting agent is able to intrude on the call properly and the state display is
correct on both agents, during the assist as well as after the assisting agent
disconnects and when the incoming caller disconnects.
4.2.20
From a BSA agent, request to Monitor another BSA agent for a single call.
Verify that the monitoring agent is able to intrude on the call properly and the
state display is correct on both agents.
4.2.21
4.2.22
Callback Handling
Configure a service group to ask for callbacks, and add a call to the queue
that is changed to a callback. Verify that the agent is prompted to make the
callback, and the callback can be initiated correctly from BSA.
4.2.23
Add web callbacks to the system. Verify that the agent is prompted to make
the web callback, and the callback can be initiated correctly from BSA.
4.2.24
Verify that campaign calls (regular and progressive) can be handled by BSA
agents.
4.2.25
28
Verify that an incoming call can be directed to a dispatch SG and that the
call can be retrieved from the dispatch window.
4.2.26
4.2.27
29
5.1
30
5.2
31
32
5.3
SIP Profile
33
5.4
same page
34
35
5.5
36
37
6.1
The SIP trunk from the A470 should be configured as SIP Provider as opposed to
SIP Networking.
6.1.1
38
6.1.2
39
6.1.3
6.1.4
40
The trace output can be specified to go to the screen or to a file. Under the rolling
trace menu there is a toggle for trace output destination.
When the output is to screen the contents of the telnet window can be copied to the
clipboard and when the destination is specified as file, the output is written to a log
on the A470 server file system. Once the output destination is set, start the predefined rolling trace.
41
When the destination output is set to file, after the trace activity has been done, stop
the rolling trace and locate the file via ftp to the A470. FTP access is via a browser
to the IP address of the A470 server.
Once logged on, browse to the logs folder and see mmtrace.txt
42
43
Limitations
One TAS Server can be installed in the system. Multiple TAS servers
are not supported.
ASR and TTS are not supported with the ACS solution.
Tone Generator resources are not supported with the ACS solution.
44