Aculab Application Note - 23
Aculab Application Note - 23
Abstract
This document contains instructions for installing and configuring Aculab functionality on your IC Server.
Please note: This is a work in progress.
This document applies to one or more Interactive Intelligence and/or Vonexus products. Vonexus is a wholly
owned subsidiary of Interactive Intelligence.
Copyright and Trademark Information
©1994 – 2005 Interactive Intelligence Inc./ Vonexus Inc. All rights reserved. Vonexus is a wholly-owned subsidiary of
Interactive Intelligence Inc. Interactive Intelligence®, Interaction Center Platform®, Communité®, Enterprise Interaction
Center®, Interactive Intelligence Customer Interaction Center®, e-FAQ®, e-FAQ Knowledge Manager, Interaction Dialer®,
Interaction Director®, Interaction Marquee, Interaction Recorder®, Interaction SIP Proxy, Interaction Supervisor,
Interaction Tracker, Mobilité®, Vocalité®, Interaction Administrator®, Interaction Attendant®, Interaction Client®,
Interaction Designer®, Interaction Fax Viewer, Interaction FAQ, Interaction Melder, Interaction Screen Recorder, Interaction
Scripter®, Interaction Server, Wireless Interaction Client, InteractiveLease®, and the “Spirograph” logo design® are all
trademarks or registered trademarks of Interactive Intelligence Inc.
veryPDF is Copyright © 2000-2005 by veryPDF, Inc. Other brand and/or product names referenced in this document are the
trademarks or registered trademarks of their respective companies.
Interactive Intelligence Inc.
7601 Interactive Way
Indianapolis, Indiana 46278
Telephone/Fax (317) 872-3000
www.ININ.com
Vonexus
7601 Interactive Way
Indianapolis, Indiana 46278
Telephone/Fax (888) 817-5904
www.vonexus.com
DISCLAIMER
INTERACTIVE INTELLIGENCE (INTERACTIVE) HAS NO RESPONSIBILITY UNDER WARRANTY, INDEMNIFICATION OR
OTHERWISE, FOR MODIFICATION OR CUSTOMIZATION OF ANY INTERACTIVE SOFTWARE BY INTERACTIVE, CUSTOMER OR
ANY THIRD PARTY EVEN IF SUCH CUSTOMIZATION AND/OR MODIFICATION IS DONE USING INTERACTIVE TOOLS,
TRAINING OR METHODS DOCUMENTED BY INTERACTIVE.
Authors: If you are making a change to this document, update the cover page date to match the date of your
latest changes.
Change Date
Updated sections 8.6 “Putback\Takeback Transfers” and 9 “Protocol Feature 7/2/04 (PL)
Configurations”, which includes Supported Protocols.
Updated ISDN Matrix Numerical Indicator Key in section 9.2 7/13/04 (SM)
Added section 4.4.1 “(Windows 2003) Disable Microsoft Unsigned Driver Warnings” 8/19/04 (PL)
before installing Aculab 5.11.x.
In section 8.2, removed last line in list of verified channel banks – ADIT 600 (E1) - a 9/30/04 (PL)
redundant entry.
Added new section 8.2.6 “Achieving Proper E1 Flashhook Capabilities”. 9/30/04 (PL)
Added new sections 9.3.1.2 Calling Name – Display IE (NI2) and 9.3.1.3 Re- 10/12/04 (PL)
establishing Layer 2 after Layer 1 Deactivation and Activation (ETS300).
In section 7.7 “Voice Modules”, added that pulse digit detection is not supported. 11/1/04 (PL)
In section 8.3.4, changed tsserver command line parameter from “Command Line 11/4/04 (PL)
Arguments” to “CommandLineArguments”.
Reorganized section 9 “Protocol Feature Configurations”, added new section 9.2.6 12/6/04 (PL)
“Configuring Extended Features”.
Changed title of section 8.6.3.2 from “Wink Duration Options” to “Timing Options.” 4/7/05 (PL)
Added new option in section 8.6.3.2 called “Digit Delay Timeout.”
In section 8.3.4, added new info to procedure on enabling a-law firmware encoding for 5/31/05 (PL)
voice modules.
Added new section 7.6.6 for new server parameter Call Analysis Tendency. 6/6/05 (PL)
Made changes throughout to specify when a cold boot (as opposed to restart) is 7/14/05 (PL)
needed, and to change references of “TsServer” to “Telephony Services subsystem”.
Updated Section 3.1. Now called “IC Server Certification and Recommendations”. 11/15/05 (PL)
The following is a comprehensive list of implementation notes and known issues with this release related to
Aculab. Appendix A extends each item in detail.
1. Expected Feature Pack 1 (FP1) Changes
2. Expected Service Release 1 (SR1) Changes
3. Voice Module Firmware Refresh
4. CAS Module Usage
http://www.inin.com/support/dialogic/boards.asp
H100 Termination
Jumpers(not H100 Connection
seen on version
1.5 Prosody
boards.
CAS Module
SHARC
LED
PCI Connector DSP
s
CAS Module
PCI Connector
Note: Version 1.5 Prosody boards do not have jumpers; they are software terminated. You can
determine if your Prosody boards are 1.5 because they will not have hardware termination jumpers.
See Section 5.4.2 for more information concerning the termination of the H100 Bus.
2. Load Factor
Any combination of network adapters and prosody boards can be mixed as long as the load factor
remains under 20. Please note the following information:
• Version 1.1 Prosody Cards imply load factor of 3
• Version 1.5 Prosody Cards imply load factor of 2
• Aculab Trunk-Only (Network Adapter) Cards imply load factor of 1
• The H100 bus specification imposes a maximum system load factor of 20
To calculate the resources needed for your system, use the “2.2 Hardware Resource Calculators”
spreadsheet provided on the Partner Web site
(http://www.inin.com/partners/partnerarea/library/partnerlibrary.asp?#White%20Papers).
Activity
The eight LED lights located on the back of the card (seen from the back of the server) indicate port
activity (red) and Sharc processor state (green). Although they indicate activity, (they have firmware
downloaded) they do not indicate connectivity. The red LED lights correspond to the ports on the board
(4 lights for a 4 port board, the first 2 lights for a 2 port board, and the first LED light for a 1 port
board) and will blink to indicate port activity. The green LED lights show Sharc processor activity (4
lights will be enabled if the card has 4 Sharc DSPs, 2 for 2 Sharcs and 1 for 1 Sharc) and will normally
blink while in operation. Error states are usually indicated by a permanent on or off state. Their
operation is firmware dependent; check the System and Application Event logs for problems.
Connectivity
The four rows of LED lights on the side of the card can usually, only be seen from the inside of the
server, indicate a number of things but most importantly, connectivity (see How to Verify the Proper
Connection of Lines/Ports). The LED lights are arranged in 4 rows, one for each Port.
LED A; LED B; LED C for port 3;
LED A; LED B; LED C for port 2;
LED A; LED B; LED C for port 1;
LED A; LED B; LED C for port 0;
LED A is a red LED B & C are green.
While a port is in a reset state, the LED light A is on. During firmware download (IC startup), LED A will
go out and LED B will turn on briefly.
With ISDN Protocols, LED B flashes when layer one transmits a frame and LED C flashes when layer
one receives a frame. LED B & C indicate the state of layer one, when both are off, layer one is inactive
and will blink on to indicate frames; when both are on, layer one is active and will blink off to indicate
frames.
With CAS Protocols, the state of LED B & C indicates line state. When both are off, there is a line
problem (i.e. loss of sync or no signal). When both LED lights are on, the line is active, LED B will blink
off when a digit is transmitted and LED C will blink off when a digit is received.
Termination
The Termination LED (only on 1.5 Aculab cards) displays termination of the card. It is located near the
H100 bus connector, on the side of the card. The first and last cards in the H100 chain should have this
light (for 1.5 Aculab boards only).
Restrictions:
1. Prosody cards without LIMs must not be in same system as trunk-only Aculab cards
Note: If additional resources must be added to an Aculab system with trunk-only card then a LIM
should be removed from a trunk-only card and added to the additional Prosody card. This provides
the most efficient use of available hardware resources.
2. Prosody cards without LIMs must be listed in contiguous order after all Prosody cards with LIMs.
Additional References:
Mixed Aculab \ SIP Configurations: 2.2 Aculab Application Note – Appendix F
Clocking Considerations:
When using a Prosody card without a LIM telephony services will internally resolve correct clocking. In
the case, where additional Prosody cards with fitted LIMs exist in the system telephony services will
resolve the user-configured settings applied by the applicable server parameters (see sections 8.2.1,
8.2.2, and 8.2.3). If no external telephony trunks exist in the system then clocking will resolve to one
internal master and multiple H100 bus slaves. No user configuration is required for this to occur.
Problem 2: The Aculab Configuration Tool will not allow a Prosody card (with or without LIM) to be
placed before and after a trunk-only card. The following error (Figure 3.2.2) will occur when attempting
Aculab 5.11.2 New install of 1. Install and configure Aculab 5.11.2 (from Telephony
CIC 2.3 Drivers disc 2 or on Support Web site). For instructions,
see sections 4.4 and 5.
EIC 2.3
2. Install CIC or EIC 2.3 GA. For instructions, see the New
Installation Checklist and Installation and Configuration
Guide.
4.2.2 Upgrades
The following table describes the current upgrade scenarios and presents the instructions for each. The table
will change as service releases are added.
Aculab 5.11.2 Upgrade from: 1. Uninstall existing Aculab software, see section 4.3.
CIC or EIC 2.2 2. Install and configure Aculab 5.11.2 (from Telephony
to Drivers disc 2 or on Support Web site). For instructions,
see sections 4.4 and 5.
CIC or EIC 2.3
3. Upgrade to CIC or EIC 2.3. GA For instructions, see the
Upgrade Checklists and Upgrade Guide.
Aculab 5.11.2 Upgrade from: 1. Uninstall existing Aculab software , see section 4.3.
CIC or EIC 2.3 GA 2. Install and configure Aculab 5.11.2 (from Telephony
Release Candidate 2 Drivers disc 2 or on Support Web site). For instructions,
to see sections 4.4 and 5.
CIC or EIC 2.3 GA 3. Contact the Beta coordinator for CIC or EIC 2.3 GA
install instructions.
Note
• Use the user end selections for ISDN based protocols. User and Network settings for ISDN are
configurable in the Interaction Administrator interface.
5. If you want to apply this protocol selection to every port on the card, select the "All the same as
this one" option. If you want to assign a different driver to each port, select "I want to assign
protocols manually."
Note: If selecting different protocols for each port a mixed protocol driver will be required. After
making the configuration selections you will be prompted to provide the location of the desired
driver. See Section 5.4 concerning the use of mixed drivers.
6. Repeat step 5 for each port, and repeat steps 2 through 5 for each card.
Note: The Aculab Configuration Tool will provide the following warning under certain circumstances.
This warning will appear when a port is configured for a CAS based protocol (T1RB, E1LS, or R2T1) and
it does not have the appropriate available CAS resources (CAS DSP) to provide for the protocol. Certain
IC \ Aculab configurations, such as channel bank integrations, are valid, and in such cases this warning
can be safely ignored.
No option is available to turn this warning off. However, if it is preferred that this warning not be
displayed for configured ports the next time the tool is used add the –s98 switch to the port’s protocol
configuration as shown below on the ‘overview’ page. Please note that this will only avoid the warning
message for this particular port and will be reverted anytime the port is reconfigured using the Aculab
Configuration Tool.
1. From the Aculab Configuration Tool’s Card Overview tab select (double-click) the first card listed.
Note, that if the cards were added to the configuration tool in order as they appear in the chassis
this will be an end point card. Figure 5.4.2.1 indicates which cards should be the end points in a
system with only Aculab cards.
Important Notes
• Prosody 1.1 boards are hardware terminated. If your Prosody board has hardware termination
jumpers, it is a 1.1 and you must hardware terminate the card in addition to the software
termination. See Figure 5.4.2.2 to locate the jumpers on a Prosody 1.1 card.
• If the system has AudioCodes IP cards then reference section 8.3 concerning its setup
considerations.
http://www.inin.com/support/aculab/drivers.asp
Note: Be sure to download the appropriate package for the particular Aculab release installed on the
server.
2. Copy the desired mixed-mode drivers (or unzip the downloaded mixed driver package) into the
‘MixedDrivers’ directory.
1. For example, a configuration containing two CAS and two AT&T protocols would be configured as
follows:
2. After selecting the proper configuration mixture for the desired mixed-mode driver click the ‘OK’
button. The following warning will appear:
3. Use this warning to verify that the listed configuration is the desired protocol configuration for the
desired mixed-mode driver. If this is correct then click the ‘OK’ button. The following file selection
window will appear:
4. Browse the file system looking for the ‘MixedDriver’ directory. Select the proper mixed-mode
driver for the provided Aculab GUI Installer configuration. Double-click or open the file. At this
point the installer will make the association between the configuration and the selected file and
this driver will be loaded.
Continue as described in the New Installation Checklists and Installation and Configuration Guide, or
the IC Server install online help.
3. In the same dialog, select Aculab under Fax Platform if you want to configure Aculab Prosody
modules for faxing (by changing DSP resources to fax). It is a good idea to always select fax support
so a re-install is not needed if the site wants to add Aculab fax later.
4. When the IC Server install is complete, you are prompted to Reboot.
The next steps are:
• Connect the IC Server to the customer network if you have not already done so.
• Run IC Setup Assistant to configure the IC Server. If you use Aculab resources for station support
you will create channel banks and stations at this time.
6.3 Part 2: Run IC Setup Assistant (Configure Channel Banks and Stations)
The IC Setup Assistant is a wizard that asks a series of questions to configure your IC Server and performs
the configuration based on the settings you chose. IC Setup Assistant will not run without a valid CIC or EIC
2.3 license file.
To start IC Setup Assistant, select Start…Programs…Interactive Intelligence…Setup Assistant. Continue as
described in the New Installation Checklists and Installation and Configuration Guide, or the IC Setup
Assistant online help.
IC Setup Assistant guides you through station configuration based on Aculab boards it has detected on the
IC Server. For an Aculab platform, this means configuring a channel bank interface and digital lines
before creating stations. See section 6.3.2.
Alternatively you can skip station and channel bank configuration in IC Setup Assistant, perform these
configurations later in Interaction Administrator. See section 7.
Note: For SIP station configuration instructions, see section 8.3 and the SIP Application Note.
This section contains:
• 6.3.1 Device Detection
• 6.3.2 Configure Stations (and Channel Bank Interfaces)
• 6.3.3 Configure Fax Stations
Click Configure Stations to launch the Add Stations Assistant, a wizard that guides you through
the creation of multiple station types.
2. The Add Stations Assistant Welcome dialog appears.
Click Next.
If you use Aculab resources for station support, select these two options:
• Workstation, Stand-alone Phones, or Stand-Alone Faxes
• Stations are connected by a channel bank
4. The Select a Channel Bank Interface dialog appears. There may be one or more channel bank
interfaces listed, or none may be listed.
Important: Only CAS protocol boards (Aculab T-1 and/or E-1), used for channel banks, are listed.
ISDN protocol boards are not listed. You configure ISDN boards for lines as a post-installation task. See
section 7.2.
Select an interface from the list and click Next. Skip to step 12.
If there are no interfaces listed, click Add new channel bank interface to launch the Add
Interfaces and Digital Lines Assistant.
Click Next.
6. The Create Interfaces dialog appears.
The dialog contains the default settings for the lines associated with the interface. In most cases, the
only adjustment you may need to change the Name Prefix or perhaps Phone Number. If you change
the Name Prefix, it is reflected in Line Names Preview. For details, see the online help.
Click Next.
Type an ANI/DNIS format string for inbound calls, or select one from drop-down list. For details, see
the online help.
Click Next.
10. Depending on the interface selected, the Confirm SMDI dialog may appear.
If your lines are connected to a PBX that supports SMDI, you can set the default values on this page.
Select the SMDI Enabled check box if the CO or PBX has enabled SMDI support on this line. For
details, see the online help.
Click Next.
If you wish to configure an additional interface for a channel bank, click the I want add additional
interfaces checkbox and click Next.
When you are finishing creating interfaces, click Finish.
The dialog contains the default settings for the stations associated with the channel banks lines.
In most cases, the only adjustments you may need to make are:
• Name Prefix. If you change the Name Prefix, it is reflected in Station Names Preview.
• Phone Type: You may wish to set Phone Type to MWI or Caller ID. For information about support
for Aculab connected station caller ID and MWI, see section 8.5.
For details, see the online help.
Highlight all the stations (or just selected stations) in Station Names Preview, and click Next.
You can choose to assign station extensions automatically or skip automatic assignment of station
extensions and assign them later in Interaction Administrator. For details, see the online help.
16. The Preview Created Stations dialog appears.
Review the stations that will be created based on the interface and lines, and the station attributes.
Click Next. The configuration is saved.
17. The Add Stations Assistant has completed.
Select Fax devices attached to the system bus and click Next.
2. The Create Aculab Fax Bus Device Stations dialog appears. There may be one or more voice
modules listed.
This dialog contains the default settings for the fax modules associated with the voice module selected
(eight fax stations). In most cases, the only adjustment you may need to make is Name Prefix. If you
change the Name Prefix, it is reflected in Fax Names Preview.
Click Next.
4. The Set Extensions for IC Stations Appears.
You can choose to assign fax station extensions automatically or skip automatic assignment of station
extensions and assign them later in Interaction Administrator. For details, see the online help.
Click Next.
Review the fax stations that will be created based on the voice module selected and the station
attributes.
The dialog shows the Module Identifier, Switch, and Serial Number for the voice module selected.
Module Changes indicates whether the DSP resource is being reallocated from another type, for
example, IVR, to fax.
Update Disposition:
• Will Add: A new Directory Service entry will be created.
• Will Skip: A fax module with that port number already exists and Directory Services does not need
to be updated.
Click Next. The configuration is saved.
6. The IC Setup Assistant Configure Stations dialog appears, populated with the fax stations you
created.
7.3 Stations
Create stations for workstations, stand-alone phone and stand-alone fax, and fax systems connected
by a system bus using the Add Stations Assistant in the Stations container.
The Add Stations Assistant is a wizard that creates multiple stations based on station type and how
the stations are connected to the IC Server. You can choose to auto-assign station extensions.
You may already have created stations using Add Stations Assistant when you ran IC Setup
Assistant.
For more information on:
• Workstation configuration, see section 6.3.2 or Interaction Administrator online help.
• Fax station configuration, see section 6.3.3 or Interaction Administrator online help.
You can also create individual stations by selecting New in the Stations container.
• Internal: Use internal board oscillators as a timing source. Use this setting when no external
clock source is available, such as when no trunks from the CO are connected to your IC Server.
Usage Notes: There is a setting to configure all cards as slaves. This would be used if there is
another vendor’s board present acting as a clock master source. In an Aculab-only installation, such
as this release, you will not use this value. Use “Internal”, when no external clock source is available,
such as when no trunks from the CO are connected to your IC Server. (This is not a recommended
configuration.)
The valid values for this server parameter represent a sliding scale (values 1 through 9 – figure below)
of expected accuracy results of the favored category. Value 1 is the most favorable configuration for
positive answering machine detection. When using this option it is to be expected that many live voice
answers will be categorized as answering machines. Value 9 is the most favorable configuration for
positive live voice answer. When using this option it is to be expected that many answering machines
(and IVRs) will be categorized as live voice answers. Value 10 resets the system’s parameters to the
supporting vendor’s default values. It is not recommended that a value of 10 be used unless directed
by Interactive Intelligence Support Services.
Please note that the values do not represent a perfect scale, meaning that the degree of favorability
towards answering machine for value 4 may not be the exact same degree of favorability towards live
voice that value 6 will provide – however they are closely represented. It is recommended that a
change of value from the default be made on an incremental format. Move from a default of value 5 to
an incremental value of 6, then, if these results do not suit the site’s needs move to the next value of
7. Furthermore, between each incremental change insure that the number of calls placed and the
amount of result data gathered is representative of typical conditions.
If after using this parameter the desired results can not be obtained reference section 11.4 for
information concerning trouble shooting call analysis issues. This section also provides a checklist of
the proper information to gather before open an incident with Interactive Intelligence Support Services.
After auto-detecting the voice modules a dialog as shown in Figure 7.4.2 will appear. This dialog shows
you the list of all the voice modules available in the IC server and to the telephony services application.
From this dialog you may either add each module configuration one by one, or use the *[All] selection
to add all configurations to the container. After add voice module to the configuration container their
specific configuration attributes may still be changed.
7.7.1 Audio
Audio resources provide standard IVR capabilities to the system in a count of 60 per module. They are
used to perform such operations as play files, play tones, digit detection, and audio recording. Each
digital external line will permanently utilize one of these resources; the remaining resources will be
shared by all telephony system operations.
7.7.2 Conference
Conference resources provide the ability to mix multiple audio streams. This is commonly used to
create multi-party conferences and support listen-in and supervision functionalities. Conference
resources can be configured with or with echo cancellation applied using the ‘echo cancellation’ option.
It is recommended for standard capabilities that echo cancellation always be applied. Using the echo
cancellation option a count of 26 is provided, without this option 64 resources are provided to the
system.
To support large party participation conferencing, a system may be configured to handle conferences of
up to 96 full participation parties. To accommodate this feature the system combines DSP resources
configured for conferencing. The combined resources must all reside on the same Aculab Prosody Card
resource in order for the system to recognize them as being available for large party conferences. To
determine the hardware location of a DSP resource, reference the switch number of the listed available
resources in the Voice Module container. Resources with the same switch number are located on the
same Prosody Card and are therefore eligible for this configuration. It is recommended that
conference resources be configured on the same Prosody Card when possible to maximize the use of
available resources.
Note: There currently are not any configuration options available to reserve conference resources for
any particular conference in the system. The system attempts to best allocate the available resources
taking into account all currently active conferences. Listed below are some restricting scenarios that
may occur on a system when multiple large conferences (26+ parties) are active. In such scenarios,
additional conference parties may be denied due to “no conference resources available” even though
7.7.3 Fax
Fax resources provide the ability to send and receive faxes without stand-alone fax machines. Each
configuration provides 8 bi-directional fax resources to the system (to be configured as fax stations).
7.7.8 ADSI
ADSI resources provide the ability to support caller ID and MWI functionality for line connected
stations on Aculab systems. Each configured module provides 64 simultaneous operations to the
system. These resources are not fixed to any particular station and each individual use is minimal in
duration.
8 General Configurations
This section identifies common configuration tasks for an Aculab IC server to support proper functionality
and particular features sets.
Caution: Clocking is essential to the successful operation of the H.100 bus. If you set clocking
incorrectly you will experience many problems with normal telephony operations.
To Configure Clocking:
• We recommend the master clock be a PRI because, which by default, has coding and framing
of B8ZS/ESF.
• Most IC servers are able to clock off the first port in the system (i.e. H100ClockMaster 1).
However, with the implementation of mixed carriers, tie lines to PBXs, and other equipment,
increased issues concerning "jitter" which can cause "pops and clicks," static on incoming calls,
strange dial tone and inconsistent faxing are possible.
In a system that is experiencing clocking issues it may be beneficial to set the
H100ClockMaster to the center of the H100 bus load factor. For example, in a system with 4
v1.5 Prosody cards and 3 Trunk Only cards (total load of 11) 5.5 would be the approximate
middle. This means that the clock may be more consistent if configured using a port on the 3rd
Prosody card.
Clocking Verification:
To verify your clocking configuration, you can use a program called swcmd.exe giving it a –e
command-line option. This will print to the screen what the current clock settings are for each
board in the system.
The swcmd.exe utility is included in the Aculab Tools package that is available to download from
the Support Web site at the following location:
http://www.inin.com/support/aculab/index.asp
Caution:
It is recommended that swcmd.exe utility is only used with the –e option unless explicitly
requested by support services. The use of this utility’s other functionalities can result in IC system
failure if used incorrectly.
Use:
Run “swcmd –e”
C:\WINNT\system32\drivers\aculab>swcmd -e
0: last 0x0002 (CLOCK_REF_LOCAL); system_init <default>
1: last 0x0007 (CLOCK_REF_H100); system_init 7 (CLOCK_REF_H100)
The example above is creating the clocking internally on board 0, and board 1 is deriving clock off
of it.
In the Protocol Parameter Switches field of the Interface configuration (Figure 9.2.1.1) add the appropriate
value in the following format:
Important Notes:
• +ADD is required
• Do not add –s54 without a denoting n-value
• Do not use this setting on ISDN configured interfaces
A robust command line interface is also available to access these configurations. Personal preference may
determine which method is used. However, it is best practice to set the DIP switches, and then, if there are
any problems use the CLI and Restore Default and Reset the channel bank. Please consult the CD manual that
came with your channel bank.
Note:
Contact your Channel Bank supplier for direct support on your unit. Interactive Intelligence Support
Services can assist you to verify the correct settings for your Aculab IC Server
Entry Level: 5
Password: MAINSTREEM
Note:
Interactive Intelligence does not provide support for channel banks, so unless instructed to do so, please
do not make any changes. (A normal request may entail a change in Alarm settings to fix an issue.)
RJ45 Connector is
connected with J10
terminal of Channel
Bank
Simple
Networking
Patch Cable
RJ45
DB9 Connector is
connected with COM2 of
CIC Server
DB
Com Port
2 of
Aculab
CIC server
8.2.6.1 Requirements
2. Phone Model – Interactive Intelligence does not system test or certify particular phone models to be
used with the IC system. To achieve correct flashhook functionality using the E1 channel bank station
configuration solution the phone must have a flash button duration of 500ms or less. If this is not the
case the flash button will result in the current active call disconnecting. To further verify this issue,
attempt a flashhook using the manual (hook) trigger with a quick release; if this correctly results in a
flashhook then it may be used in place of the phone’s button.
3. IC Software – Functionality is dependant on the use of the correct protocol parameter option switches
for the Aculab firmware. The proper switches are loaded by default for an E1 Channel Bank interface
configuration in IC TsServer software revisions 2.3.2 and later. In prior releases the proper switch
changes must be made in Interactive Administrator for each such channel bank interface configuration.
To do so add the following to the interface’s protocol parameter switch field:
“+ADD –s26,200”
11 11
37 38
05 57
IP IP IP
1 2 3
The first card listed (113705) should be terminated either in hardware (Prosody version 1.1), or in
software using the Aculab Configuration Tool.
At the completion of the hardware and software component configuration the standard IC configuration
instructions may be used with the exception of one scenario. In a system where a-law encoding is to
be used (typically E-1 networks), and the Aculab cards do not have LIMs, additional configurations
must be made concerning voice resource integration.
Explanation of Issue:
The voice module functionality for any system which uses Aculab PCI Prosody cards without line
interface modules (LIMs) will always default to u-Law firmware encoding. This presents a problem for
SIP systems using AudioCodes cards and Aculab Prosody cards in an E-1 (a-Law) environment. The
default to u-Law encoding will cause instability on the H100 bus, and audio on the server from resource
usage (such as plays or conferencing) will experience severe static.
Solution
EC Convergence Period (Section 8.3.3) – Ignores a specified period of time at the beginning of each
cancellation session. This may need to be modified if premature barge-in occurs during the initial
750ms of the playing of a prompt.
1. At least one ADSI voice module must be configured in the IC system. After configuring this
module the Telephony Services subsystem must be restarted before its resources will be
available to the IC system. Please reference Section 7.7.8 for further details concerning
making this configuration change.
2. Reconfigure all stations that are to be enabled for either Caller ID or MWI functionalities. This
is done by changing the station configuration phone type in Interaction Administrator from
Analog to Analog (Caller ID). Note that Analog (ADSI) is not supported in Aculab IC systems.
Implementation Note:
The putback transfer request will be issued on the object identified in the Call Identifier field, and thusly will
be issued on that objects active line. Therefore, its line interface must be configured for transfer capabilities
(reference Sections 8.6.2.2 and 8.6.3.1). If the line is not putback capable, then the request will be issued
using a standard two line (bowing) transfer mechanism.
SPECIFICATION IDS:
Putback Transfers
AT&T NS NS NS NS
E1 NS NS 2.3 GA NS
T1 NS NS 2.3 GA NS
Analog NS NS NS 2.3 GA
Takeback Transfers
ETS300 NS NS NS NS
AT&T NS NS NS NS
DPNSS NS NS NS NS
QSIG NS NS NS NS
NI2\1 NS NS NS NS
E1 NS NS 2.3 GA NS
T1 NS NS 2.3 GA NS
8.6.3.2 Configuration
To enable transfer functionality on a particular ISDN interface select the “Enable Call Putback” option box on
the interface’s ISDN PRI Configuration page in Interaction Administrator. Note that the subsequent selector
box will not have any options and should be left empty or blank. Reference Figure 8.6.3.2.1.
Implementation Note: Transfer capabilities based on wink and flash transitions are highly dependant on the
characteristics of those events. Particular attention should be paid to the integrations expectations for bit state
changes (A, B, C, and D) as well as wink durations.
2. Enable the interface for transfer functionality by checking the ‘Enable Call Putback’ option on the
interface’s Trunk Configuration page.
3. For take back functionality (inbound transfer) the reception of a wink or flash on externally connected
call the wink initiator will be fired. It is the responsibility of the implementer to create and configure
this handler as desired.
4. For putback functionality (outbound transfer) the sending of the transfer indicator is done using the
Extended Blind Transfer tool step with the User Call Putback option enabled.
8.8.1 Eic_BearerTransferCapability
This attribute provides the call’s Bearer Transfer Capability as provided in the Bearer Information Element on
an inbound call. The value is represented in integer form as described in the protocol’s specification
8.8.2 Eic_CallingPnScreeningInd
This attribute provides the call’s presented screening indicator value if available. The value is represented in
integer form as described in the protocol’s specification
8.8.3 Eic_ConnectDurationTime
An integer value representing the actual connection time for an inbound or outbound call. A call’s true connect
time is determined by calculating the duration from a protocol connect to a protocol disconnect. This value is
represented in seconds.
8.8.4 Eic_ConnectedAddress
This attribute provides the call’s connected address as received from the connecting end if the value is
available. The connected address is often presented after the call setup and may not be available until
connection occurs.
8.8.5 Eic_ConnectedName
This attribute provides the call’s connected name as received from the connecting end on an outbound call.
The connected name is often presented after the call setup and may not be available until connection occurs.
8.8.6 Eic_ConnectedNameIn
This attribute provides the call’s connected name as received from the connecting end on an inbound call. The
connected name is often presented after the call setup and may not be available until connection occurs.
8.8.8 Eic_ConnectEvtTime
This attribute provides a date and time of a call’s true protocol connection event. The value is provided in the
format of date followed by time: “04/11/2005 12:32:55”.
8.8.9 Eic_DestinationSubAddress
This attribute provides the call’s destination sub-address as received from the network.
8.8.10 Eic_DivertingNumber
This attribute provides the call’s diverting number as received from the network. The diverting number is a
representation of the “to” field of the redirecting information element.
8.8.11 Eic_IsdnCauseValue
An integer value representing a call’s interpreted ISDN disconnect cause code value. This value is provided by
the vendor implementation and interpreted by Telephony Services. Though in most cases the provided value is
the same as those described in the protocol’s specification, there may be occasions where there is a variance.
For such occasions the Eic_IsdnRawCauseValue may be used.
8.8.12 Eic_IsdnRawCauseValue
An integer value representing a call’s raw ISDN disconnect cause code value. This value is provided directly by
the vendor implementation of the protocol (as provided by the disconnecting end) and is not interpreted.
8.8.13 Eic_OriginatingSubAddress
This attribute provides the call’s origination sub-address as received from the network.
8.8.14 Eic_OriginalCalledName
This attribute provides the call’s original called name as provided with the presented diverting information.
8.8.15 Eic_OriginalCalledNumber
This attribute provides the call’s original called number as provided with the presented diverting information.
8.8.16 Eic_PresentationIndicator
This attribute provides the call’s presentation indicator value if available. The value is represented in integer
form as described in the protocol’s specification.
8.8.17 Eic_ProtocolId
This attribute provides a protocol ID value for the span that the call is currently active on. This value is
defined by the IC system as follows:
8.8.18 Eic_ReasonForCall
This attribute provides the call’s redirection reason if available. The value is represented in integer form as
described in the protocol’s specification.
8.8.19 Eic_ReasonForCallString
A string description of the integer redirection reason provided for the call.
8.8.20 Eic_RedirectingName
This attribute provides the call’s redirecting name as received from the network. The redirecting name
corresponds to the redirecting TN, or number, provided by Eic_RedirectingTn.
8.8.21 Eic_RedirectingTn
This attribute provides the call’s redirecting number as received from the network. The redirecting number is a
representation of the “from” field of the redirecting information element.
8.9.1 Syntax
Note: In IC versions before 2.4 a secondary syntax in the form of a sequence offset by the ‘!’ character was
permitted to specify certain call information. This method has been deprecated in favor of the syntax specified
in this section.
To specify call information on the dialstring use the ‘!’ character followed by a sequence of names and values
(reference the names and values section) encapsulated in braces { }. A dialstring may contain multiple name
and value pairs either by delimiting them within a group or by sequencing multiple groups together. It is
common to use the second method (example 1) when the string is being set by handler logic which builds the
dialstring on a per call basis.
Currently the dialstring configuration only has options for ISDN protocols. However, to provide the ability for
future dialstring configuration support on multiple protocols each group must specify a protocol identifier. For
ISDN protocols this is accomplished using “isdn:” syntax as noted in this description:
Formal description:
<Phone Number>!{isdn:<name>=<value>;<name>=<value>}!{…}
Example dialstrings:
Example1: 5551212!{isdn:presentationInd=1}!{isdn:screeningInd=1}
Example2: 5551212!{isdn:presentationInd=1;screeningInd=1}
T1 CAS Based
T1RB Aculab T-1 Trunk Select Appropriate Signaling Protocol Variant
Signaling
E1 CAS Based
R2T1 Aculab E-1 Trunk Select Appropriate Signaling Protocol Variant
Signaling
DMS
Select Either ‘User-end’ or ‘Network-end’
(supported NI2 Net or NI2 User* Aculab T-1 ISDN PRI
Protocol
through NI2)
T1 Q.SIG
QSIG T1 Aculab T1 ISDN PRI Select ‘User-end’
Slave/A
T1 Q.SIG
QSIG T1 Aculab T1 ISDN PRI Select ‘User-end’ and use “-cQSB –s96,1”
Slave/B
T1 Q.SIG
QSIG T1 Aculab T1 ISDN PRI Select ‘Network-end’
Master/A
T1 Q.SIG
QSIG T1 Aculab T1 ISDN PRI Select ‘Network-end’ and use “-cQMB –s96,1”
Master/B
E1 Q.SIG
QSIG E1 Aculab E1 ISDN PRI Select ‘User-end’
Slave/A
E1 Q.SIG
QSIG E1 Aculab E1 ISDN PRI Select ‘User-end’ and use -cQSB
Slave/B
E1 Q.SIG
QSIG E1 Aculab E1 ISDN PRI Select ‘Network-end’
Master/A
E1 Q.SIG
QSIG E1 Aculab E1 ISDN PRI Select ‘Network-end’ and use -cQMB
Master/B
*ISDN user-end and network-end provisions are determined by the Interaction Administrator configuration
(firmware dependant). User and network-end specifications in the Aculab Configuration Utility do not need to
match the Interaction Administrator configuration; only the base protocol must agree.
**4ESS protocols are inherently supported by Aculab AT&T firmware. 4ESS Custom is supported depending on
custom features needed - contact Support for more information.
Bearer Transfer S S S S NS S
Capability Bits
(SETUP)
Calling Name – NS S S NS NS SA
Display IE
Calling Name – NS NS NS SB NS NS
Facility IE (receive
only)
Connected Name – NA NA NS S NS NA
GFP
Network Specific S NS NA NA NA NA
Facility (NSF)
Redirecting Number NS SB SB SB NS NS
IE
Redirecting Number SB SB S NS NS NS
IE (receive only)
9.2.4 DMS100
Current and past implementations of DMS100 protocol support are supported using Aculab’s NI2 based driver
and firmware. For standard call control implementations this configuration does suffice. However, for
implementations that require extended features that go beyond basic call control Aculab’s DMS firmware
implementation may be required.
To configure the system to use Aculab’s DMS firmware use the manual override configuration available on the
Interface Configuration page in Interaction Administrator. Navigate the file browse control and select the
appropriate firmware file located in the Aculab firmware directory. Use to following guide to select the correct
firmware:
User-End Standard PM4 – DMS_USR.p4r
Network-End Standard PM4 – DMS_NET.p4r
User-End UPM – DMS_USR.upr
Network-End UPM – DMS_NET.upr
9.2.5 Q.SIG
Q.SIG is a communication protocol used in Private Integrated Services Networks, used mostly to communicate
with PBX’s. The Interactive Intelligence, Aculab platform, supports basic call control of the QSIG protocol in
both E1 and T1 networks. This excludes proprietary protocols such as ESIG and ISIG. Certain Supplementary
Q.SIG services will be made available and are noted in this section. To request particular service support,
contact Interactive Intelligence Support and request information concerning the enhancement process.
See section 9.2.6 for instructions on configuring extended features for Q.SIG.
Description Example
Notes
• Without the +EXTENDED, only QSIG basic call control features are available.
• When using the +EXTENDED feature the +ADD is not needed.
• If the +ADD feature is used for tracing for example, the +ADD must be first in the protocol switch
followed by its options such as +ADD –s25 +EXTENDED –cQMA –cFF. The +ADD, not being first in
the protocol switch, may cause the call to fail. The “A” in the protocol switch “-cQMA” represents
the collision resolution bit priority of high. Depending on your network, this value may be “B”,
collision resolution bit priority of low. Check your network to see the appropriate collision resolution
bit priority setting. Incorrect setting of the collision resolution bit will cause QSIG layer 2 to be
inactive.
• When TX and RX calling and connected name information the argument tag for such transmission
must be set, the default hex value for the IC Server is 0x80. If your CO uses the alternate hex
value 0xA1, the +ARG tag must be set before the +EXTENDED in the protocol switch in AI.
QSIG user side using Feature Diversion comparing +EXTENDED +FD3 –cQSA –cFD
the first 3 digits
ETS300 network side using Feature Diversion +EXTENDED –cNE –cFD –s58,1
ETS300 user side using Feature Diversion +EXTENDED +FD5 –cFD –s58,1
comparing the first 5 digits
NI2 network side using Feature Diversion +EXTENDED +FD9 –cNE –cFD –s58,1
comparing the first 9 digits
9.2.7 DPNSS
DPNSS is a communication protocol used for communication between switching nodes in private networks.
The Interactive Intelligence, Aculab platform, supports basic call control of the DPNSS protocol.
Supplementary DPNSS services will be made available in a future release. To request particular service
support, contact Interactive Intelligence Support and request information concerning the enhancement
process.
Note: This setting is dynamic and will momentarily render the interface unusable to the IC system. It
will take approximately 20 seconds to resynchronize the channel bank and the IC system after
application.
1. Start the IC System Manager. To do this, click Start… Programs… Interactive Intelligence… IC
System Manager. (For the IC System Manager to run, the user starting it needs to have Remote
Control rights under User Rights tab in the User container in Interaction Administrator.) Another
way of setting the tracing is to use TraceConfig.exe
2. In the IC System Manger, right-click the subsystem you want to set Tracing on, such as TsServer,
and click Configure Tracing. The Trace Configuration dialog appears as shown in Figure 10.3.1.
3. Right-click on the topics you want to change tracing levels for, and choose Set Topic Levels from
the menu that appears. The Change Topic Levels dialog appears as shown in Figure 10.3.2.
4. Select the Topic Level at the level you are instructed to do so by the support representative. In
most cases you'll use the settings in the following table.
Note: Turning up these topics to their highest level may create very large log files on high call load
systems. If this is the case please discuss other possibilities with the Interactive Intelligence
support team. It is often the case that a particular issue is isolated to a certain area of the system
and the tracing topics can be tailored to reflect it as such.
Send the log files to support: [email protected] (for European support), [email protected] (for
US support) with a case number mentioned in the subject line.
Note: Please include the *.VwrLog and the associated *.VwrLog.idx file.
2. Double-click the AcuSysInfoU.exe executable to execute the utility on the server. This utility can be
in the \I3\IC\Server\Diagnostics\Aculab directory. Additionally, the utility may be run from the
start menu under Programs … Interactive Intelligence … Diagnostics directory. The following
application dialog will appear (Figure 10.4.1).
4. Select and output format. The default selection is in HTML format as this is the typical format that
support services will request the information in. Support services may request the output in XML
form in which case the XML selection should be made. Both options may be checked at the same
time.
6. Email the produced file(s) to the incident’s support representative or include it with the initial
report of the issue.
Caution: Only use these tools when instructed to do so by Interactive Intelligence support. As these tools are
created and distributed by Aculab concurrent execution with I3 Software may cause conflicts. Using them
incorrectly, or at inappropriate times, could cause performance problems on your IC Server.
Diagnostic Record (Section 7.5.6) – Use this parameter to enable or disable the diagnostic record
functionality.
Maximum Number of Diagnostic Voice Resources (Section 7.5.7) – This parameter sets the
maximum number of voice resources (Audio) that will be used at any given time to record outbound
calls. If more calls are in an active dialing state then resources available by this count then some calls
will not be recorded; this is the usual case and is why only a percentage of calls are recorded. Note,
that the reserve of diagnostic record resources will lower the overall resource count available to the
system for general call operations.
Note: Procedures outlined in this section should not be done attempted in a blind hope of fixing issues.
The encountered problem should be reasonably similar to that describe as a known issue. Running a
procedure in an attempt to resolve an unrelated problem may further complicate the existing problem.
Solution 1:
Solution 2:
1. Open the Windows Device Manager (Right click on My Computer, select the Hardware tab, select
Device Manager).
2. Right Click on an Aculab device with a bang.
3. Select “Update Driver…”
4. Select “Install from a list or specific location (Advanced)” and click OK
5. Select “Search for the best driver in these locations” and “Include this location in the search”. For
the location navigate to the Aculab install path, typically: D:\Program Files\Aculab\Gui
Installer\Drivers – Click NEXT
6. The system will find Aculab.inf. Select this file and click OK
7. After the system completes this process the bang should be eliminated from the device manager
console.
11.1.2 System Does Not Start Correctly After Aculab Driver Upgrade
Problem: After installing a new Aculab Configuration Tool and configuring the following Aculab hardware
errors appear in the Application log when starting Interaction Center.
• Event ID: 5020. An error occurred detecting call driver capabilities for the specified device.
• Event ID: 5021. The detected call driver version is not supported by this version of telephony services.
In addition, Telephony Services fails to initialize. These problems may be due to remnants of the older Aculab
drivers. Please try each of the two solutions in an attempt to resolve the issue.
Solution 1:
1. Start the Aculab Configuration Tool.
2. Remove all of the cards.
3. Click OK.
4. Restart the Aculab Configuration Tool.
5. Add and reconfigure the cards in the Aculab Configuration Tool, using the screen shots and/or the
AcuSysInfo.htm file that you created when you backed up the Aculab configuration. Add each card in
order they are in the server by serial number.
6. Click OK.
Solution 2:
Creating the Loopback Plug for E1/T1 on RJ-45 (a.k.a. T1 Crossover Cable)
If TS or FaxServer are down: bring up TS and FaxServer before re-enabling the fax stations. If fax
groups are configured, reactivate the fax stations before bringing FaxServer up. Also if fax groups are
configured, disabling fax stations is not enough, you will have to bring FaxServer down also. At this
point everything should be up and running. If for some reasons you don't have fax capabilities, please
repeat the steps above.
3. Load Distribution:
You don't need to cold boot to restore fax functions. Try deactivating the fax ports in IA, making sure
that the fax com server is gone (wait for 5-6 seconds and if it's still there, kill it) and if TSServer and
FaxServer are running - if you haven't stopped them for any reasons - re-enable the fax stations and
make sure the fax com server is running.
Note:
All ports are bi-directional, you can force them to only receive or send within the handlers and the fax
monitor. But, we do not support uni directional ports per se as mentioned by Aculab.
• Review interface Connect on Proceeding, Connect on Progressing, and Connect on Dialing settings.
Since call analysis starts on an IC connection these configurations will generally define when call
analysis begins on a call.
• Verify that the call generating source (tool step or client) has call analysis settings set as expected.
• Clear description of the calls that are not returning results as expected – and an explanation as to why
those results should be otherwise.
• Call IDs for calls that have encountered this unexpected call analysis result.
• Diagnostic recordings to match the provided call IDs (as many as possible). The more recordings that
can be gathered and analyzed increases the likelihood of matching the pattern of failure.
• TsServer – HmVoice Topic enabled (and possibly IP) Logs (Section 11.3)
Note that the Firmware Reset button in the Interfaces container does function and may be used.
The Aculab voice system has a limited number of simultaneous voice resource allocations that it provides
applications such as Telephony Services. The current release of 1.4.6 speech drivers has a limitation of 1024
voice resource allocations. This count is adhered to on a global basis within the entire Aculab xIC system.
Every type of resource is counted against this limit. Reference Section 7.7 for resource counts for each
particular type of voice module configuration. Once this ceiling is reached all subsequent resource allocation
attempts will fail and their related telephony operations will not work.
This limitation may only be an issue on large systems which have more than 16 modules configured as IVR.
Even under this circumstance the system may only run out of resources under a high call load. If there any
questions or concerns related to this documented limitation please contact Interactive Intelligence Support
Services.