AudioCodes AC Voca Installation Manual
Installation Manual
AudioCodes Speech-Driven Dialing Solution for Enterprises
AC Voca
Version 7.8
Notice
AC Voca | Installation Manual
Notice
Information contained in this document is believed to be accurate and reliable at the time of
printing. However, due to ongoing product improvements and revisions, AudioCodes cannot guarantee accuracy of printed material after the Date Published nor can it accept
responsibility for errors or omissions. Updates to this document can be downloaded from
https://www.audiocodes.com/library/technical-documents.
This document is subject to change without notice.
Date Published: May-26-2020
WEEE EU Directive
Pursuant to the WEEE EU Directive, electronic and electrical waste must not be disposed of with
unsorted waste. Please contact your local recycling authority for disposal of this product.
Customer Support
Customer technical support and services are provided by AudioCodes or by an authorized
AudioCodes Service Partner. For more information on how to buy technical support for AudioCodes
products and for contact information, please visit our website at
https://www.audiocodes.com/services-support/maintenance-and-support.
Documentation Feedback
AudioCodes continually strives to produce high quality documentation. If you have any comments
(suggestions or errors) regarding this document, please fill out the Documentation Feedback form
on our website at https://online.audiocodes.com/documentation-feedback.
Stay in the Loop with AudioCodes
Related Documentation
Document Name
AC Voca Release Notes
AC Voca Administrator's Guide
Document Revision Record
LTRT Description
23722 Updated document for Version 7.8.0
- ii -
Notice
AC Voca | Installation Manual
LTRT Description
23723 Updated document for Version 7.8.1.
■ New sections: Hardware Requirements; System Capacity; AC Voca
Scheduler Tasks; Configuring AC Voca DNN Speech Recognition Mode
■ Updated sections: Using Clean Windows Installation; Configuring the OSN
IP Address; Configuring the OSN IP Address; Installing AC Voca;
Configuring Enghouse Interactive’s Communication Portal (CP); Configuring
Enghouse CP Additional Language Support; Installing the AC Voca License;
Installing CT Connect Media Gateway License; Acapela non-Hebrew Text to
Speech; Running the LDAP Client Setup in AC Voca Cloud Mode; Running
the LDAP Client Setup in AC Voca On-premises Mode; Entering Fields under
LDAP Connection Tab; Setting up LDAP Client Synchronization;
Troubleshooting LDAP Client Connectivity; Installing LDAP Client Service;
Configuring the LDAP Client File (removed)
23724 Updated document for Version 7.8.2.
■ Updated sections: Getting Started; Installing AC Voca; Configuring Enghouse
CP Additional Language Support (Optional); Installing Text to Speech Engine;
Updated screens for LDAP synchronization
- iii -
Content
AC Voca | Installation Manual
Table of Contents
1 Introduction 1
2 Getting Started 2
Hardware Requirements 2
System Capacity 2
Entries Support 2
Using Clean Windows Installation 3
Additional Software Installation 3
Disabling Virtual Memory Paging File 3
Using AudioCodes Mediant 800 Installation 4
Installing Windows Security Updates 4
Configuring the OSN IP Address 4
Configuring the Server System Time Settings 9
3 Installing AC Voca 11
4 Configuring AC Voca System 14
AC Voca Scheduler Tasks 14
Configuring Enghouse Interactive Communication Portal (CP) 19
Configuring Enghouse CP Additional Language Support (Optional) 29
5 Installing the AC Voca License 36
6 Installing Third-Party Licenses 40
Installing Enghouse Interactive License 40
Installing Control Panel License 40
Installing CTConnect Media Gateway License 42
Installing Text-to-Speech Engine 42
Acapela non-Hebrew Text to Speech 42
7 Configuring AC Voca DNN Speech Recognition Mode 47
8 Configuring AC Voca LDAP Synchronization 48
LDAP Client Requirements 48
Hardware and Operating System Requirements 48
Network Requirements 48
LDAP Synchronization Requirements 48
Running the LDAP Client Setup 48
Running the LDAP Client Setup in AC Voca Cloud Mode 49
Running the LDAP Client Setup in AC Voca On-premises Mode 49
Configuring the LDAP Client 50
Setting up LDAP Client Synchronization 50
Entering Fields under LDAP Connection Tab 51
Entering Fields under LDAP User Attributes Tab 52
Entering Fields Under VocaNOM Connection Tab 53
Configuring Files in LDAP Client On-premises Mode 54
Configuring the Hosts File 55
Testing LDAP Client Connectivity 55
- iv -
Content
LDAP Server Connectivity Testing 55
VocaNOM Server Connectivity Testing 56
AC Voca | Installation Manual
Troubleshooting LDAP Client Connectivity 57
Troubleshooting Customer’s LDAP Server 57
LDAP Client Does not Connect to the VocaNOM Server 59
Error [Run] [LDAP import] edmws exception:Value Cannot be Null 60
Installing LDAP Client Service 61
9 Improving LDAP Synchronization 62
Basic LDAP Filters 62
Advanced LDAP Filters 62
LDAP User Attributes 63
10 Configuring SBC Settings for AC Voca 64
Coder Settings 64
Delayed Offer SDP Settings 64
Terminating SIP OPTIONS Requests 64
Alternative Routing Settings 64
11 Installing Signed Certificates on the IIS 65
Managing Certificates in the MMC Snap-in 65
Adding a Certificate 68
Selecting a Certificate in IIS Manager 68
12 Enabling .NET Framework 3.5 on Windows 70
13 Useful Topics 74
- v -
CHAPTER1 Introduction
1 Introduction
AC Voca provides a state-of-the-art voice recognition service for enterprises, enhancing day-to-day
customer interface and employee productivity by making organizational contacts easily accessible
from multiple user environments by voice.
Combining powerful speech recognition engine with a simple-to-use conversational interface, AC
Voca introduces a reliable, 24x7 call routing solution that reduces costs, increases the employee's
productivity and enhances caller experience and satisfaction.
AC Voca easily integrates with any standard PBX based on analog, digital and IP network
protocols and can be deployed as a secured cloud service or On-premises.
AC Voca | Installation Manual
- 1 -
CHAPTER2 Getting Started
2 Getting Started
There are a number of ways to install the AC Voca system:
■ Clean Windows Installation: A customer provides a clean-installed Windows 2016 (or
Windows 2012 R2) system with the latest security updates. The installation will be provided by
AudioCodes as a downloadable URL.
■ AudioCodes Mediant 800 Installation: AudioCodes provides a Mediant 800 with a pre-
installed Windows 2016. The installation package will be located at C:\ACVoca_Installer.
■ Pre-installed: AudioCodes offers Voca Software as a Service (SaaS) as a cloud deployment.
Please contact your AudioCodes representative for more information on this option.
The default Administrator's password is "pass123". It is highly recommended to change
the password according to the Enterprise's policy. The updated password must be
stored in a secure location, so that it is accessible to those that need to it.
Hardware Requirements
AC Voca | Installation Manual
The AC Voca server requires the following minimal hardware configuration for On-premises installation:
■ CPU: Intel Core i7-5th Gen @ 2.7GHz with 4 cores or higher - dedicate all cores; enable hyper-
threading.
■ RAM: 32 GB
■ SSD: 256 GB
■ NIC: 1GB Ethernet card
■ Operating System: Windows Server 2016
For private cloud installations, the minimal hardware configuration is:
■ For AWS: Use c5.2xlarge instances or higher
■ For other configurations: Contact your AudioCodes representative
Self-installation is designed to support single tenant deployments. For multi-tenant deployments,
please contact your AudioCodes Sales or Technical Support representative.
System Capacity
The system supports the following channels capacity:
■ For Hebrew and German, up to 6 concurrent channels are supported
■ For English, up to 2 concurrent channels are supported
■ For Spanish (United States, Spain, Central and South America), up to 30 concurrent channels
are supported
In cases of mixed languages under a single tenant, the service is limited to the lowest
number of supported channels per language.
Entries Support
■ Up to 17,000 entries
- 2 -
CHAPTER2 Getting Started
Using Clean Windows Installation
It is the customer’s responsibility to provide a clean-installed licensed Windows 2016 (or Windows
2012 R2) system with the following requirements:
■ .NET Framework Features 3.5
If the server has Internet connectivity during installation, the framework will be installed
automatically. Otherwise.NET 3.5 should be pre- installed (see Enabling .NET
Framework 3.5 on Windows on page70).
■ Disabled Virtual Memory paging file
■ Latest security updates
■ Static IP address
Additional Software Installation
The user must not install any additional software on the server, including anti-virus or any real time
scanner. Installation of any third-party software may lead to performance issues, stability problems
and may cause unpredictable results.
AC Voca | Installation Manual
Disabling Virtual Memory Paging File
The procedure below describes how to disable the Virtual Memory Paging file.
➢ To disable Virtual Memory Paging File on a Windows System
1. Press the Windows key and open Control Panel.
2. Navigate to System and Security > System, and then click Advanced system settings in
the left pane.
3. In the System Properties dialog box, click the Advanced tab, and then click Settings…
under the 'Performance' group.
4. Click the Advanced tab, and then click the Change… button.
- 3 -
CHAPTER2 Getting Started
5. Select the drive that it is on, and then click the No paging file option.
6. Clear the 'Automatically manage paging file size for all drives' check box.
7. Click Set, and then click OK.
8. Select Restart Now to apply the changes, and then disable virtual memory.
Using AudioCodes Mediant 800 Installation
Before installing the AC Voca system on AudioCodes Mediant 800, do the following:
■ Install Windows 2012 R2 Security Updates
■ Configure the OSN IP address
■ Configure the Server System Time Settings
Installing Windows Security Updates
Install Windows Security Updates to run the latest service patches and install all missing updates.
Configuring the OSN IP Address
AC Voca | Installation Manual
The AC Voca system must have a static IP address. You can configure a static IP address for the
OSN server on the Mediant 800.
If you are connected remotely, performing this step will disconnect you from the
system. After performing this step, you can re-connect the system with its new location
and IP address.
➢ To configure a static IP address for OSN:
1. Press the Windows key.
2. In the 'Search' text box, enter "View Network connections", and then press Enter.
3. Right-click the Intel(R) Ethernet Connection I217-LM network connection, and then from the
shortcut menu, select Rename.
- 4 -
CHAPTER2 Getting Started
4. Assign the new alias name as Internal.
5. Right-click the Internal network connection, and then from the shortcut menu, choose
Properties.
AC Voca | Installation Manual
6. Double-click Internet Protocol Version 4 (TCP/IPv4).
- 5 -
CHAPTER2 Getting Started
7. Enter the IP address and DNS server addresses.
8. Click Advanced.
AC Voca | Installation Manual
9. Clear the 'Automatic Metric' check box, and then in the 'Interface Metric' field enter "1".
- 6 -
CHAPTER2 Getting Started
AC Voca | Installation Manual
A low metric number indicates higher priority. A high metric number indicates low
priority.
10. Click OK to apply the configuration.
- 7 -
CHAPTER2 Getting Started
AC Voca | Installation Manual
- 8 -
CHAPTER2 Getting Started
11. Click OK to close the Internal Properties window.
12. Close the Network Connections window.
Configuring the Server System Time Settings
For AC Voca system multi-time zone support, Windows 2012 R2 must be configured in the UTC
system time zone. The procedure below describes how to configure your server system time
settings.
Verify that your server time is correctly set to UTC time. Otherwise, perform the
following procedure.
➢ To configure the server system time settings:
1. Right-click the server time and select Adjust date/time.
AC Voca | Installation Manual
2. Assign the correct UTC time zone, date and time and then save the settings.
- 9 -
CHAPTER2 Getting Started
AC Voca | Installation Manual
- 10 -
CHAPTER3 Installing AC Voca
3 Installing AC Voca
The procedure below describes how to install AC Voca. As noted in Getting Started on page2,
there are a number of ways to install the AC Voca system.
A restart may be required during installation. After the restart has completed, log in to
the server and the installation process will continue automatically.
➢ To install AC Voca:
1. Double-click the AC Voca file to start the installation.
AC Voca | Installation Manual
2. After launching the installer, the AudioCodes logo appears:
3. The AC Voca EULA information page appears. You must accept the conditions to continue.
- 11 -
CHAPTER3 Installing AC Voca
4. The AudioLogs directory window appears. The AC Voca system records and saves the speech
request in an audio logs directory. Assign the AudioLogs directory and click Next.
AC Voca | Installation Manual
5. A window appears displaying the components that are to be installed. Click Install.
6. Prerequisites and required third-party applications are being installed.
- 12 -
CHAPTER3 Installing AC Voca
AC Voca | Installation Manual
7. When completed, the installer displays the following screen. Click Close to restart the server.
- 13 -
CHAPTER4 Configuring AC Voca System
4 Configuring AC Voca System
The following describes how to configure the AC Voca system. This configuration procedure should
be performed after completing the AC Voca Installation procedure.
AC Voca Scheduler Tasks
The following describes how to configure the AC Voca system Scheduler tasks:
■ Voca cleanup scheduler task
■ Voca backup scheduler task
➢ To configure Voca Task Scheduler:
1. Press the Windows key, and then open Administrative Tools.
2. Open the Task Scheduler.
3. Right-click Task Schedule Library, and then choose New Folder.
AC Voca | Installation Manual
4. In the 'Name' field, enter "Voca", and then click OK.
➢ To configure Voca cleanup scheduler task:
1. Right-click Voca Task Scheduler library > Import Task.
- 14 -
CHAPTER4 Configuring AC Voca System
AC Voca | Installation Manual
2. Browse to the cleanup task configuration file location - C:\NSC\VOCA_Scripts\Cleanup_
script\Files Cleanup.xml, and then click OK.
3. Click Change User or Group.
4. In the 'Enter the object name to select' field, enter "Voca", and then click Check Names.
- 15 -
CHAPTER4 Configuring AC Voca System
5. Click OK.
6. In the Task Scheduler, enter your credentials (To obtain your credentials, contact your
AudioCodes representative).
AC Voca | Installation Manual
➢ To configure Voca backup scheduler task:
1. Right-click on the Voca Task Scheduler library, and then click Import Task.
- 16 -
CHAPTER4 Configuring AC Voca System
AC Voca | Installation Manual
2. Browse to the backup task configuration file location at C:\NSC\VOCA_
Scripts\BackupScheduler/, and then select your system dialect file.
3. Click Open.
4. Click Change User or Group.
- 17 -
CHAPTER4 Configuring AC Voca System
AC Voca | Installation Manual
5. In the 'Enter the object name to select' field, enter "Voca", and then click Check Names.
6. Click OK.
7. In the Task Scheduler, enter your credentials (To obtain your credentials, contact your
AudioCodes representative).
- 18 -
CHAPTER4 Configuring AC Voca System
AC Voca | Installation Manual
Configuring Enghouse Interactive Communication Portal (CP)
Enghouse Interactive (CP) is a third-party application responsible for SIP connectivity between a
customer's PBX and the AC Voca speech recognition agent.
➢ To configure Enghouse Interactive’s CP:
1. Launch the CP Console 10.3.
2. When prompted to set a password, select the 'I don’t want to use…' check box, and then click
OK.
3. When the configuration wizard starts, click Next.
- 19 -
CHAPTER4 Configuring AC Voca System
AC Voca | Installation Manual
4. When prompted, enter the password AC123456.
5. Click Finish when the configuration completes.
- 20 -
Loading...