SPMI 8.5.2 Admin Guide
SPMI 8.5.2 Admin Guide
SPMI 8.5.2 Admin Guide
2/23/2015
Table of Contents
SpeechMiner Administration Guide 3
Introduction 4
New in this Release 5
Deploying SpeechMiner 7
Installing SpeechMiner 8
Required Third-Party Software 12
Setting Up the SQL Server for SpeechMiner 15
Installing IIS on the Web Server or Interaction Receiver Server 14
Pre-installation Checklist 52
Installing the SpeechMiner Components 52
Uninstalling SpeechMiner 87
Configuring SpeechMiner 8
Using the SMConfig to Configure SpeechMiner 100
Additional Configurations 142
Configuring Permissions 161
Working with Chat Interactions 167
SpeechMiner Administration Guide
Find out about SpeechMiner: Find out about how to deploy the components:
Admin Guide 3
Introduction
Introduction
SpeechMiner , Genesys Telecommunications Laboratories’s speech-analytics platform
analyzes call content as well as text-based interactions such as e-mails and chats. Speech-
analytics leverages recorded customer interactions (from any recording system) and
analyzes each interaction for critical business topics and events. With unmatched accuracy,
the system "listens" to conversations between customers and contact-center agents,
precisely identifies the topics that were discussed, and categorizes what took place within
each interaction.
• Analytics and Recording UI: SpeechMiner plays back and analyzes interactions
recorded with Genesys Interaction Recording.
• Recording UI Only: SpeechMiner plays back the call audio for each interaction in
the search results. The contents of the interactions are not processed by the speech-
analytics system.
• Analytics Only: SpeechMiner imports interactions and their recorded call audio from
any recording system. Once the interactions and their audio is imported
SpeechMiner processes the contents of each interaction.
Important
If you have purchased both Recording and Analytics
licenses, it is recommended that you review the
specific SpeechMiner setup instructions in the
Genesys Interaction Recording documentation prior
to commencing with the installation procedure. There
may be some changes required to the generic
analytics procedures in this SpeechMiner
Administration Guide.
Admin Guide 4
Introduction New in this Release
This manual explains how to install and configure SpeechMiner. It is intended for system
administrators. Most of the steps described are only performed once, usually with the help of
Genesys Customer Care.
8.5.2 Release
• New Responsive Style User Interface: In this release, the Main page, Menus, Media
Player, Search pages and grids have been updated with the new design.
• New Media Player with Video Playback Capability: The updated media player, now
supports screen recordings. When working with GIR, audio and screen recordings
can now be synchronized.
• Multiple QM Forms per Interaction: Multiple QM form evaluations can now be
attached to a single interaction.
• Categorization Based on Spatial Relationships: Text interactions can now be
categorized based on rules such as: "found abc within X words of xyz.".
• Wildcard Support for Text Interaction Topic Definitions: Like Voice interaction topic
definitions, Text interaction topic definitions can now utilize wildcards.
• Recognition Improvements: Continuous recognition improvements were made in this
release based on new customer and vertical training material.
8.5.001 Release
• Ability to add text interactions to saved lists: Similar to voice interactions, text
interactions can now be added to saved lists.
• Ability to add comments to text interactions: Similar to voice interactions, comments
can now be added to text interactions.
• Ability to search for numbers in text interactions: Numbers and special characters
can now be used in search term definitions for text interactions.
• Events are displayed in text interactions: Similar to voice interactions, topic events
are highlighted when they occur in text interactions.
Admin Guide 5
Introduction New in this Release
• Topic filters in reports supports text interactions: The topic parameter in the Data Set
Filters on the reports now works for text interactions.
• Support for wildcards in Spanish: Similar to English, wildcards are now supported for
Spanish voice interactions.
• High Availability improvement for indexing: In the event of an index failure, the
system will automatically switch to a backup index.
8.5.0 Release
• Interaction Recording Integration: SpeechMiner 8.5.x provides the UI for Genesys
Interaction Recording - Voice Edition. This enables out of the box integration with
Genesys’ new recording product.
• Chrome Support: Support for Chrome on Windows for the Interaction Recording
features.
• Chat Support: Support for chat interactions with multiple speakers.
• Genesys Branding: The web UI has been re-branded with the Genesys name, logos
and colors.
• Configuration Server Integration: SpeechMiner now integrates with Genesys
Configuration Server for centralized user management.
• Language Recognition Support: Support for Brazilian Portuguese and German
language calls.
Admin Guide 6
Deploying SpeechMiner New in this Release
Deploying SpeechMiner
This section describes the SpeechMiner system and how to configure each component for
your enterprise.
Components
SpeechMiner Components
The SpeechMiner system makes use of the following components:
System Software
Users employ the following software to work with SpeechMiner:
Admin Guide 7
Deploying SpeechMiner Installing SpeechMiner
Install
Installing SpeechMiner
This section explains how to install SpeechMiner at your enterprise. This section includes
pre-installation steps; setting up the system components, database, and the software steps
that users employ to interact with the system. The components can be installed on a single
machine, or on separate machines, as required by the particular configuration of your
system.
Configure
Configuring SpeechMiner
This section explains how to configure SpeechMiner after it is installed. Most of the
configuration is performed in the SMConfig application. This is a Windows application that
can be installed on any machine on your network. Once it is installed, it can be used, from
any machine on which it is installed, to configure the entire SpeechMiner system.
Installing SpeechMiner
This section describes how to prepare your environment before you install SpeechMiner,
and how to install the SpeechMiner software. The SpeechMiner components can be
installed on one or more servers, as required by the particular configuration of your system.
Admin Guide 8
Deploying SpeechMiner Installing SpeechMiner
Important
Since the SpeechMiner supported environment may
be different for each SpeechMiner version, the
current SpeechMiner Administration Guide may
contain information that does not apply to your
version of SpeechMiner. For detailed information
about supported operating environments, see the
Supported Operating Environment Reference Guide.
Getting Started
Before you install SpeechMiner, make sure of the following:
Then, review the Pre-installation Checklist before you begin the installation process.
System Requirements
Disk Space
Each server in the system should have at least the following amounts of available disk space
before installing SpeechMiner:
Important
Admin Guide 9
Deploying SpeechMiner Installing SpeechMiner
• Web server: About 20 MB for the SpeechMiner virtual folder, plus additional space
for call audio. (The exact amount required for caching depends on user activity.)
• Interaction Receiver: About 15 MB for the Interaction Receiver virtual folder.
• Machines running SMART: About 1 GB of disk space for the recognition engine
Database
The database must run on a machine on which one of the following SQL servers is installed:
• Microsoft SQL Server 2008 with Reporting Services, SP1 or above (Enterprise
edition is recommended for large installations.)
• Microsoft SQL Server 2012 with Reporting Services
Operating Systems
All machines must have Windows operating systems.
For detailed information about the Windows operating systems that are compatible with each
SpeechMiner component refer to Supported Operating Environment Reference Guide.
Browser
The SpeechMiner web interface is compatible with Google Chrome and Internet Explorer
(IE) versions 10 and 11.
Users of the SpeechMiner web application must have a functioning audio device on their
desktop. Users browsing using Internet Explorer should have Windows Media Player version
10 or 11 installed.
Admin Guide 10
Deploying SpeechMiner Installing SpeechMiner
Memory (RAM)
Machines running SpeechMiner servers and applications should have at least the following
amounts of memory:
What Is Installed?
The following software will be installed on the machines in your system:
Machine Components
On All Servers • MS .NET Framework 4.5.1 with SP1 (aka 4.5.1)
On the Recognition • UPlatform service
Server(s) • Nuance recognition engine
• MS-SQL 2008 or 2012 Server, including MS Reporting
Services (normally installed by the customer beforehand)
On the DB Server
• SpeechMiner database
• UConnector service (when not working with GIR).
On the Web Server • SpeechMiner virtual folder
On the Interaction
• Interaction Receiver virtual folder
Receiver Server
On Every Machine • Recognition engine
Running SMART • SMART executable and runtime files (dlls)
Important
The ports listed are the default ports. Most of them
can be changed upon request.
Admin Guide 11
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 12
Deploying SpeechMiner Installing SpeechMiner
Tip
You should install the required software before you
install SpeechMiner.
.NET Framework
Microsoft .NET Framework 4.5 SP1 (4.5.1) and .NET 2.0 must be installed on all machines
that will run SpeechMiner components or interact with SpeechMiner
If you are installing the .NET Framework on machines that are running Windows Server
2008 R2 or Windows Server 2012:
• Enable .NET framework using the Add Features option in the Server Manager (Start
> Administrative Tools > Server Manager).
• Verify that Windows Update is enabled.
If Windows Update is not enabled or you are using an operating system other than Windows
Server 2008 R2 or Windows Server 2012, manually download and install .NET 4.5.1 from
the following location: http://www.microsoft.com/en-us/download/details.aspx?id=40779
Microsoft Visual C++ 2013 Redistributable must be installed on all machines that will run
SpeechMiner components or interact with SpeechMiner. You can download the installation
package at http://www.microsoft.com/en-us/download/details.aspx?id=40784.
Important
Admin Guide 13
Deploying SpeechMiner Installing SpeechMiner
SQL Server
Before you begin installing SpeechMiner, you must install the SQL server on the database
server. You can use either Microsoft SQL Server 2008 with Reporting Services or Microsoft
SQL Server 2012 with Reporting Services.
For information about installing and configuring the SQL Server for SpeechMiner, see
Setting Up the SQL Server for SpeechMiner.
The Internet Information Server (IIS) must be installed and operational on the servers that
will be used to run the SpeechMiner Web and the Interaction Receiver. You can install and
configure:
Notes:
• The SpeechMiner and Interaction Receiver Application Pool must use .NET
framework version 4.0. After you install the SpeechMiner web server, you should
check that this is the version in use.
• It is recommended to enable HTTP Compression on the IIS server. For additional
information, see http://technet.microsoft.com/en-us/library/cc771003(v=ws.10).aspx.
Report Viewer
Admin Guide 14
Deploying SpeechMiner Installing SpeechMiner
SpeechMiner can be configured to use Microsoft's Report Viewer to run saved reports at
night and cache their results. Using Microsoft's Report Viewer can significantly reduce the
time required to load the SpeechMiner Views page, if it contains a large number of reports.
If you want to use this feature, you have to install it and then configure it to run the jobs you
want it to run. You can download the installation file at http://www.microsoft.com/en-us/
download/details.aspx?id=21916.
For additional information about Report Caching see: Defining Caching Reports
1. Run the installation program. The SQL Server Installation Center window opens,
with the Planning screen open.
Admin Guide 15
Deploying SpeechMiner Installing SpeechMiner
2. From the menu on the left, select Installation. The Installation screen opens.
Admin Guide 16
Deploying SpeechMiner Installing SpeechMiner
5. From the Setup Role screen, select SQL Server Feature Installation.
Admin Guide 17
Deploying SpeechMiner Installing SpeechMiner
7. From the Server Configuration screen, in the Service Accounts tab, for the SQL
Server Agent, SQL Server Database Engine, and SQL Server Reporting
Services, do the following:
◦ Enter the user account and password of the service account.
◦ Under Startup Type, select Automatic.
Admin Guide 18
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 19
Deploying SpeechMiner Installing SpeechMiner
8. From the Server Configuration screen, in the Collation tab, under Database
Engine, select SQL_Latin1_General_CP1_CI_AS (the default value).
9. From the Database Engine Configuration screen, in the Data Directories tab,
select the locations for the database folders. If possible, put the User database
directory, the Temp DB directory, and the Backup directory on a separate drive from
Admin Guide 20
Deploying SpeechMiner Installing SpeechMiner
10. From the Reporting Services Configuration screen, select Install the native
mode default configuration.
11. When you finish installing the SQL Server, restart the machine on which you installed
it.
1. Run the installation program. The SQL Server Installation Center window opens,
with the Planning screen open.
2. From the menu on the left, select Installation. The Installation screen opens. Select
New installation or add features to an existing installation. The installation
wizard opens.
Admin Guide 21
Deploying SpeechMiner Installing SpeechMiner
3. Follow the on-screen instructions. When the screens mentioned below open, follow
the instructions below to select the required settings and options for SpeechMiner.
4. From the Setup Role screen, select SQL Server Feature Installation.
5. From the Feature Selection screen, select the following options:
◦ Database Engine Services
◦ Reporting Services
◦ Client Tools Connectivity
◦ SQL Server Books Online
◦ Management Tools Basic
◦ Management Tools Complete
Admin Guide 22
Deploying SpeechMiner Installing SpeechMiner
6. From the Server Configuration screen, in the Service Accounts tab, for the SQL
Server Agent, SQL Server Database Engine, and SQL Server Reporting
Services, do the following:
◦ Enter the user account and password of the service account.
◦ Under Startup Type, select Automatic.
Admin Guide 23
Deploying SpeechMiner Installing SpeechMiner
7. From the Server Configuration screen, in the Collation tab, under Database
Engine, select SQL_Latin1_General_CP1_CI_AS (the default value).
8. From the Database Engine Configuration screen, in the Data Directories tab,
select the locations for the database folders. If possible, put the User database
directory, the Temp DB directory, and the Backup directory on a separate drive from
Admin Guide 24
Deploying SpeechMiner Installing SpeechMiner
9. From the Reporting Services Configuration screen, select Install the native
mode default configuration.
10. When you finish installing the SQL Server, restart the machine on which you installed
it.
Admin Guide 25
Deploying SpeechMiner Installing SpeechMiner
Important
After you install SpeechMiner, you also have to
deploy the CLR assembly and set its permissions.
See Installing the SpeechMiner Components >
Installing the SpeechMiner Database > SQL CLR.
1. From the Start menu, navigate to Microsoft SQL Server 2008 > Configuration
Tools > SQL Server Configuration Manager. The SQL Server Configuration
Manager opens.
2. On the left side of the window, select SQL Server Services.
3. On the right side of the window, for SQL Server Agent, check that the Status is
Running, and the Start Mode is Automatic.
4. If one or both of these values are not as they should be, do the following:
◦ Double-click the row. The Properties window opens.
◦ In the Service tab, set the Start Mode to Automatic.
◦ If the service is not running, in the Log On tab, select Start.
◦ Click OK to implement the changes.
Admin Guide 26
Deploying SpeechMiner Installing SpeechMiner
5. On the left side of the SQL Server Configuration Manager window, select SQL
Server Network Configuration > Protocols for MSSQLSERVER.
6. On the right side of the window, for TCP/IP and for Named Pipes, check that the
Status is Enabled.
7. For each of these protocols, if it is not enabled, do the following:
◦ Double-click the row. The Properties window opens.
◦ In the Protocol tab, under Enabled, select Yes.
◦ Click OK to implement the changes.
1. In the Start menu, under All Programs, select SQL Server 2008 R2 >
Configuration Tools > Reporting Services Configuration Manager. The
Reporting Services Configuration Connections window opens.
2. Enter the report server name and the instance name (if they are not already there),
and click Connect. The Reporting Services Configuration Manager opens, with
the Report Server Status screen displayed.
Admin Guide 27
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 28
Deploying SpeechMiner Installing SpeechMiner
5. Configure the account name and password of the service account that will be used to
run the report-server service, as required. Use either a local administrator account or
an account that can log in as a service and run services on the local machine.
6. On the left side of the window, select Web Service URL; make sure the settings in
the screen match the settings as follows:
Admin Guide 29
Deploying SpeechMiner Installing SpeechMiner
7. On the left side of the window, select Database. If you created a report-server
database when you installed SQL Server, it appears under Current Report Server
Database. If you did not, create it now.
Admin Guide 30
Deploying SpeechMiner Installing SpeechMiner
8. On the left side of the window, select Report Manager URL; make sure the settings
in the screen match the settings as follows:
Admin Guide 31
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 32
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 33
Deploying SpeechMiner Installing SpeechMiner
appropriate for your system). Click Next to progress from screen to screen until you
have finished creating the database.
Important
In addition to the "server memory" that is limited by
this value, the SQL server uses 2-4 GB of other
memory. For this reason, it is recommended to set
the max server memory to a value that is 2-4 GB
lower than the maximum memory you want to allow
the server to use. For additional details, see
http://msdn.microsoft.com/en-us/library/
ms178067.aspx.
You can see the current max server memory value, and modify it as required, in the SQL
Server Management Studio.
Admin Guide 34
Deploying SpeechMiner Installing SpeechMiner
1. From the SQL server, open the SQL Server Management Studio. (For example, in
the Start menu, under All Programs, select Microsoft SQL Server 2008 R2 > SQL
Server Management Studio.)
2. On the left side of the window, right-click the SQL server and then select Properties.
The Server Properties window opens.
3. On the left side of the window, select Memory. The memory settings are displayed.
4. Under Maximum server memory (in MB), enter the value you want to use.
5. Click OK. The setting is implemented, and the window closes.
If you prefer, you can also set the max server memory property by executing a query:
Admin Guide 35
Deploying SpeechMiner Installing SpeechMiner
1. On the SQL server, open the SQL Server Management Studio. (For example, in
the Start menu, under All Programs, select Microsoft SQL Server 2008 R2 > SQL
Server Management Studio.)
2. On the left side of the window, right-click the SQL server and then select New
Query. A blank text area opens on the right side of the window.
3. Copy the following commands and paste them into the text area:
4. The code sets the max server memory to 4GB (4096MB). If you want to set it to a
different value, in the text area, change 4096 to the required value.
5. Above the text area, select Execute. The commands are executed. When the
process is completed successfully, Query executed successfully appears at the
bottom of the window.
Admin Guide 36
Deploying SpeechMiner Installing SpeechMiner
On Windows Server 2008, you can install and configure the Internet Information Services
(IIS) in the Server Manager.
1. From the Start menu, select All Programs > Administrative Tools > Server
Manager. The Server Manager opens.
2. On the left side of the window, select Roles.
Admin Guide 37
Deploying SpeechMiner Installing SpeechMiner
3. On the right side of the screen, select Add Roles. The Add Roles Wizard opens.
4. From the list of roles, select Web Server (IIS), and then select Next. An
Introduction to the Web Server is displayed.
Admin Guide 38
Deploying SpeechMiner Installing SpeechMiner
6. Under Role Services, make sure the following services are selected:
a. Under Common HTTP Features:
▪ Static Content
▪ Default Document
▪ Directory Browsing
▪ HTTP Errors
▪ HTTP Redirection
b. Under Application Development:
▪ ASP.NET
▪ ISAPI Extensions
▪ ISAPI Filters
Important
Admin Guide 39
Deploying SpeechMiner Installing SpeechMiner
c. Under Security:
▪ Windows Authentication
d. Under IIS 6 Management Compatibility:
▪ IIS 6 WMI Compatibility
▪ IIS 6 Metabase Compatibility
7. Click Next. A Confirm Installation Selections screen opens.
8. Select Install. The installation process begins, and the Installation Progress screen
is displayed. When the installation is completed, an Installation Results screen is
displayed.
Admin Guide 40
Deploying SpeechMiner Installing SpeechMiner
9. Click Close. The Add Roles Wizard closes, and the Server Manager lists the Web
Server (IIS) role as installed.
Admin Guide 41
Deploying SpeechMiner Installing SpeechMiner
10. From the Server Manager, in the left pane, select Features, and then, in the right
pane, select Add Features. The Add Features Wizard opens.
11. From the list of features, expand the Background Intelligent Transfer Service
(BITS), and then select IIS Server Extension. A window pops up, asking you to
confirm that you want to Add role services required for IIS Server Extension.
Admin Guide 42
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 43
Deploying SpeechMiner Installing SpeechMiner
Click Next three times, and then click Install. The installation process begins, and
the Installation Progress screen is displayed. When the installation is completed,
the Installation Results screen is displayed.
Admin Guide 44
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 45
Deploying SpeechMiner Installing SpeechMiner
15. Click Close. The Add Features Wizard closes, and the Server Manager lists the
features you selected as installed.
On Windows Server 2012, you can install and configure the Internet Information Services
(IIS), version 8, in the Server Manager.
Admin Guide 46
Deploying SpeechMiner Installing SpeechMiner
2. From the upper-right side of the window, in the Manage menu, select Add Roles
and Features. The Add Roles and Features Wizard opens.
Admin Guide 47
Deploying SpeechMiner Installing SpeechMiner
3. Select Include management tools (if applicable), and then select Next. The
Installation Type screen opens.
4. Select Role-based or feature-based installation, and then select Next. The Server
Selection screen opens.
5. Select the server on which you will be installing the SpeechMiner web server, and
then select Next. The Server Roles screen opens.
6. From the list of roles, select Web Server (IIS). A window pops up, and asks you to
confirm that you want to add the role services required for the web server.
Admin Guide 48
Deploying SpeechMiner Installing SpeechMiner
7. From the popup window, select Add Features. The pop-up window closes.
8. Select Next. The Features screen opens.
9. From the list of features, expand Background Intelligent Transfer Service, and
then select IIS Server Extention. A window pops up, and asks you to confirm that
you want to add the role services required for the IIS server extension.
10. From the popup window, select Add Features. The pop-up window closes.
11. From the list of features, select SMTP Server. A window pops up, and asks you to
confirm that you want to add the role services required for the SMTP server.
Admin Guide 49
Deploying SpeechMiner Installing SpeechMiner
12. From the popup window, select Add Features. The pop-up window closes.
Admin Guide 50
Deploying SpeechMiner Installing SpeechMiner
14. From the list of Role services, make sure the following services are selected:
a. Under Common HTTP Features:
▪ Static Content
▪ Default Document
▪ Directory Browsing
▪ HTTP Errors
▪ HTTP Redirection
b. Under Application Development:
▪ ASP.NET
▪ ASP.NET Extensibility
▪ ISAPI Extensions
▪ ISAPI Filters
c. Under Security:
▪ Windows Authentication
d. Under IIS Management tools:
Admin Guide 51
Deploying SpeechMiner Installing SpeechMiner
Pre-installation Checklist
Before you begin installing SpeechMiner, ensure the following:
Admin Guide 52
Deploying SpeechMiner Installing SpeechMiner
machine, you can select both of them in the setup wizard. In most systems, SMConfig is
installed on all server machines.
Admin Guide 53
Deploying SpeechMiner Installing SpeechMiner
7. In the list of components, select the components you want to install on the machine.
8. Click Next. Which screen you see next depends on the components you selected in
the previous screen.
◦ If you are installing the Uplatform, see Installing the UPlatform Server.
◦ If you are installing SMART, see Installing SMART.
◦ If you are installing the database, see Installing the SpeechMiner Database.
Admin Guide 54
Deploying SpeechMiner Installing SpeechMiner
Important
By default, 64-bit SpeechMiner is installed in the
following location: C:\Program Files
(x86)\Genesys\Software.
9. Modify the default installation location if necessary, and then click Install. The
installation process begins. When the process is completed, the following screen
appears:
Admin Guide 55
Deploying SpeechMiner Installing SpeechMiner
10. Select Restart Now, and then click Finish. A warning message appears, and
reminds you to configure SpeechMiner before you open it.
Admin Guide 56
Deploying SpeechMiner Installing SpeechMiner
Setup Wizard
To begin the installation of the database server, run the setup wizard as described under
Installing the Components.
1. On the database server machine, run the Setup Wizard, as described under Install
Using the wizard.
Admin Guide 57
Deploying SpeechMiner Installing SpeechMiner
2. Follow the instructions there, until the Database Credentials screen opens.
Field Description
Select this option to use the Windows username and password
Windows
you used to log into the machine as the DB User and DB
Authenticated
Password. When you select this option, the DB User and DB
User
Password become unavailable.
Enter the name of the server on which you want to install the
SpeechMiner database. If you want to install the database on an
DB Server
SQL Named Instance, the server name should be entered as
server_name\instance_name.
Enter the name of the database in the format
DB Name
speechminer_verX_Y (for example, speechminer_ver8_5).
Enter SA. (The credentials of the user name entered here will be
DB User
used for the process of creating the SpeechMiner database.)
Admin Guide 58
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 59
Deploying SpeechMiner Installing SpeechMiner
Manual Installation
• For both the Data and Log files, change Options\Recovery Mode to Simple and
change the Files\Autogrowth\File Growth parameter to 10%.
• In addition, run the following commands to create the dbuser user:
◦ On the master database: create login [dbuser] with
password='dbuser',check_policy=OFF
◦ On the new database: EXEC sp_change_users_login 'Auto_Fix',
'dbuser'
Important
When you manually install the SpeechMiner
Database, you must run the database purge using
the SQL Server Service Broker.
The SP will try to enable the service broker with ENABLE_BROKER. If it does not
succeed, it will run the command with NEW_BROKER. This SP will also use the current
DB name correctly.
Admin Guide 60
Deploying SpeechMiner Installing SpeechMiner
3. Run the following query to verify that SQL Server Service Broker is enabled:
3. Run the following query to verify that SQL Server Service Broker is enabled:
SELECT is_broker_enabled FROM sys.databases WHERE
database_id=DB_ID()
If you want to change the default database user in SpeechMiner, you must assign the user
the rights required to access the relevant tables in the database. The UTOPY and Reports
roles give the user those rights. If you want to work with the pre-configured database user
(dbuser), or a user that already has full access (for example, an administrative user) you do
not need to assign the user new or different rights.
Admin Guide 61
Deploying SpeechMiner Installing SpeechMiner
Storage Partitions
If the database server is an Enterprise Edition, you must create the storage partitions on the
database. To do this, after you install the database server, run the following SQL query on
the SpeechMiner database:
EXEC sp_create_DB_storage_partitions
Important
For information about how to open SQL Server
Management Studio and run a query, see Setting the
Maximum Memory Usage.
Maintenance Jobs
Admin Guide 62
Deploying SpeechMiner Installing SpeechMiner
• From SQL Server Management Studio, under Databases > SQL Server Agent >
Jobs, double-click the job.
Admin Guide 63
Deploying SpeechMiner Installing SpeechMiner
Important
If information about the agents and their hierarchy is
not available through the UConnector, you can
include the sp_createAgentsFromPartitions
job in this job.
Admin Guide 64
Deploying SpeechMiner Installing SpeechMiner
@owner_login_name=N'dbuser'
SQL CLR
After you install the database, you should deploy the SQL Common Language Runtime
(CLR) assembly on the SQL server. To do this, on the Master, you must set the permissions
of the XmlSerializers.dll and enable xp_cmdshell and CLR integration, as
explained below.
Important
In order to set the permissions, the user running the
SQL services must have modify permissions on
sqlclr.XmlSerializers.dll.
1. On the SQL server, open the SQL Server Management Studio. (For example, in
the Start menu, under All Programs, select Microsoft SQL Server 2008 R2 > SQL
Server Management Studio.)
2. On the left side of the window, right-click the SQL server and then select New
Query. A blank text area opens on the right side of the window.
3. Copy the following commands and paste them into the text area:
Admin Guide 65
Deploying SpeechMiner Installing SpeechMiner
use [master]
CREATE ASYMMETRIC KEY SQLCLRTestKey FROM EXECUTABLE FILE =
'\\<Machine_Name>\c$\Program Files (x86)\Genesys\Software\
Support\sqlclr.XmlSerializers.dll'
GO
use [master]
CREATE LOGIN SQLCLRTestLogin FROM ASYMMETRIC KEY SQLCLRTestKey
GO
use [master]
GRANT EXTERNAL ACCESS ASSEMBLY TO SQLCLRTestLogin
4. In the text area, change <Machine_Name> to the name of the machine on which the
SpeechMiner database was installed.
5. Above the text area, select Execute. The commands are executed. When the
process is completed successfully, Query executed successfully appears at the
bottom of the window.
Important
If you get an error message that says, "The
certificate, asymmetric key, or private key file
does not exist or has invalid format," try
changing the path to point at the local drive—for
Admin Guide 66
Deploying SpeechMiner Installing SpeechMiner
8. Above the text area, select Execute. The commands are executed. When the
process is completed successfully, xp_cmdshell and CLR integration are enabled,
and Query executed successfully appears at the bottom of the window.
9. Open another New Query.
10. Browse to C:\Program Files (x86)\Genesys\Software\Support.
11. Run the SQLCLR.sql script.
Recovery Model
In order to save disk space, it is recommended to set the recovery model of the
SpeechMiner database to Simple.
Important
Admin Guide 67
Deploying SpeechMiner Installing SpeechMiner
1. On the SQL server, open the SQL Server Management Studio. (For example, in
the Start menu, under All Programs, select Microsoft SQL Server 2008 R2 > SQL
Server Management Studio.)
2. On the left side of the window, right-click the database and then select Properties.
The Database Properties window opens.
3. On the left side of the window, select Options.
Admin Guide 68
Deploying SpeechMiner Installing SpeechMiner
4. On the right side of the screen, under Recovery model, select Simple.
Autogrowth
Important
Admin Guide 69
Deploying SpeechMiner Installing SpeechMiner
1. On the SQL server, open the SQL Server Management Studio. (For example, in
the Start menu, under All Programs, select Microsoft SQL Server 2008 R2 > SQL
Server Management Studio.)
2. On the left side of the window, right-click the database and then select Properties.
The Database Properties window opens.
3. On the left side of the window, select Files.
Admin Guide 70
Deploying SpeechMiner Installing SpeechMiner
4. On the right side of the screen select Autogrowth in the Data File row. The
Change Autogrowth dialog box opens.
QM Manager Role
Admin Guide 71
Deploying SpeechMiner Installing SpeechMiner
When installing SpeechMiner, the following query should be run on all 8.5.3 databases to
avoid role ID conflicts with the new QM Manager role.
Important
Once SpeechMiner is installed and configured, users
can open the web-based interfaces from their
browsers at
http://<webserver_name>/speechminer (where
<web server> is the name of a machine on which the
SpeechMiner is installed.
The SpeechMiner application pool uses v4.0 of the .Net framework. After you install the
SpeechMiner web server on a machine verify that the SpeechMiner Application Pool is
configured with:
Admin Guide 72
Deploying SpeechMiner Installing SpeechMiner
1. In the Start menu, select Administrative Tools > Internet Information Server (IIS)
Manager. The Internet Information Server (IIS) Manager opens.
2. In the left pane, expand the server name, and select Application Pools. The
currently defined application pools are listed in the middle pane.
Admin Guide 73
Deploying SpeechMiner Installing SpeechMiner
3. Under .NET Framework Version, check the version number listed for the
SpeechMiner application pool. If the number is 4.0, you do not have to make any
changes. If it is not, double-click the version number. The Edit Application Pool
dialog box opens.
4. Under .NET Framework version, select v4.0.
5. Click OK.
1. In the Start menu, select Administrative Tools > Internet Information Server (IIS)
Manager.
2. In the left pane, expand the server name, and select Application Pools.
3. Right click the SpeechMiner Application Pool and select Advanced Settings
Admin Guide 74
Deploying SpeechMiner Installing SpeechMiner
Important
For additional details about the SMUSER account
refer to Configuring Permissions
Admin Guide 75
Deploying SpeechMiner Installing SpeechMiner
To allow Genesys Interaction Recording (GIR) to send a long audio file to SpeechMiner,
configure the Request Filtering Feature in the IIS server, as explained in http://www.iis.net/
configreference/system.webserver/security/requestfiltering/requestlimits, and set the
Maximum allowed content length to 345600000.
The Interaction Receiver application pool uses v4.0 of the .Net framework, and not a later
version. After you install the SpeechMiner web server on a machine verify that the
Interaction Receiver Application Pool is configured with:
1. In the Start menu, select Administrative Tools > Internet Information Server (IIS)
Manager. The Internet Information Server (IIS) Manager opens.
2. In the left pane, expand the server name, and select Application Pools. The
currently defined application pools are listed in the middle pane.
Admin Guide 76
Deploying SpeechMiner Installing SpeechMiner
3. Under .NET Framework Version, check the version number listed for the Interaction
Receiver application pool. If the number is 4.0, you do not have to make any
changes. If it is not, double-click the version number. The Edit Application Pool
dialog box opens.
4. Under .NET Framework version, select v4.0.
Admin Guide 77
Deploying SpeechMiner Installing SpeechMiner
5. Click OK.
1. In the Start menu, select Administrative Tools > Internet Information Server (IIS)
Manager.
2. In the left pane, expand the server name, and select Application Pools.
3. Right click the Interaction Receiver Application Pool and select Advanced
Settings
Admin Guide 78
Deploying SpeechMiner Installing SpeechMiner
Important
For additional details about the SMUSER account
refer to Configuring Permissions
Admin Guide 79
Deploying SpeechMiner Installing SpeechMiner
Important
• After you have installed the UPlatform server
and created the required folders, it is
recommended to turn off error reporting on
the server. For additional information, see
http://technet.microsoft.com/en-us/library/
cc754364.aspx.
• Regional settings in the Recognition server
should be English US or the decimal point
separator must be "." and the group
separator must be ",", otherwise the
recognition will not work well.
Procedure
1. To begin the installation of the Uplatform server, run the setup wizard as described
under Installing Using the Wizard on the Uplatform server machine.
2. Follow the instructions, until the Choose Components screen opens.
3. Select the following components:
◦ Uplatform
◦ ULogger
◦ Interaction Receiver
◦ Nuance License
◦ SMConfig
4. Click Next.
Important
◦ If you included Nuance License in the
components, the Language Selection
screen opens. Skip the next step.
◦ If you did not include Nuance License,
the Nuance License screen opens.
5. In the Nuance License screen, enter the names of one or more Nuance license
servers you want to use, as explained in the screen, and then click Next.
Admin Guide 80
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 81
Deploying SpeechMiner Installing SpeechMiner
6. In the Language Selection screen, select the languages you want to install.
Installing SMART
Installing SMART
The SpeechMiner Administration Tool (SMART) enables users to configure the Speech
Analytics system to search interactions for specific topics and other characteristics. SMART
should be installed on the work station of each user.
Admin Guide 82
Deploying SpeechMiner Installing SpeechMiner
1. On the Uplatform server machine, run the Setup Wizard, as described under
Installing Using the Wizard.
2. Follow the instructions until the Choose Components screen opens.
3. Select the following components:
◦ Smart
◦ ULogger
◦ Nuance Licence
◦ SMConfig
4. Click Next.
◦ If you included Nuance License in the components you selected, the
Language Selection screen opens. Skip the next step.
◦ If you did not include Nuance License, the Nuance License screen opens.
5. In the Nuance License screen, enter the names of one or more Nuance license
servers you want to us, then click Next.
Admin Guide 83
Deploying SpeechMiner Installing SpeechMiner
6. In the Language Selection screen, select the languages you want to install.
Required Folders
After you install the SpeechMiner components, manually create the shared folders as listed
in the table. These folders will be used by SpeechMiner to store the audio, index, and
backup files used by the system.
Admin Guide 84
Deploying SpeechMiner Installing SpeechMiner
Important
Ensure that enough storage space is available for
these purposes on the machines on which you
create the folders. By default, the minimum space
required for each folder is 15GB. The minimum value
is configurable in the minimumFolderSpaceMB field
in the monitorTbl table in the SpeechMiner database.
All SpeechMiner machines should have access to these shared folders, and they should be
shared with all groups and users that require access to them. It is recommended to create
the folders on the same LAN as the SpeechMiner system components.
The folder names listed below are recommended, for convenience, but you can actually use
any names you choose. In addition, you can create multiple folders for most of the folder
types, as explained below. For information about configuring SpeechMiner to use these
folders, see Sites & Machines.
Important
When you configure the shares, make sure to
specifically give write permissions to the user
installing SpeechMiner and to the system user
(SMUSER), both under Sharing and under Security.
Folder
Description Quantity
Name
Folder in which interactions
One folder for each fetcher task; if there
data and metadata will be
are multiple recording systems, or
placed by Uconnector when it
multiple storage media used for storing
retrieves them from the
the unprocessed data, a fetcher task
recording system; fetchers
Input must be created for each data source
collect the data from input
and for each input folder. For information
folders, prepare it for
about deciding how many fetchers to
processing by SpeechMiner,
create, see Configuring Machines and
and then place it into store
Tasks.
folders.
Admin Guide 85
Deploying SpeechMiner Installing SpeechMiner
Admin Guide 86
Deploying SpeechMiner Configuring SpeechMiner
Uninstalling SpeechMiner
SpeechMiner components can be installed on one machine or numerous machines. If
SpeechMiner components are installed on more than one machine, you must perform the
following procedure on each machine.
Procedure
Important
Configuring SpeechMiner
This topic explains how to configure SpeechMiner after it is installed. SMConfig is used to
perform the majority of the SpeechMiner configuration. For information about installing
SMConfig, see Installing the Components.
Admin Guide 87
Deploying SpeechMiner Configuring SpeechMiner
SMConfig is a Windows application that can be installed on any machine on your network.
Once installed it can be used to configure the entire SpeechMiner system.
The following sections describe the steps that you must perform before you can begin
working with SMConfig:
Permissions
Required Permissions
The user account from which SMConfig is opened must have read, write, and modify
permissions on the local installation folder and files.
For most of the configuration changes you can perform using SMConfig, you will need
Administrator privileges on the current machine or on other machines. For each
configuration task described below, the required permissions are listed. If you are running
SMConfig as a non-administrator user, and errors are generated during the configuration
process, make sure that you have the right permissions for the task.
In Windows Vista and later versions of Windows, if User Access Control is enabled,
SMConfig will automatically require you to run it with administrator privileges. If User
Access Control is disabled, it is recommended to manually run SMConfig with administrator
privileges. To do this, right-click the SMConfig icon, and then select Run as administrator.
For more information on the permissions required for the other SpeechMiner components,
see Configuring Permissions.
Database Connection
Encrypting the Connection to the Database
The connection between SMConfig and the database can be encrypted to ensure that
confidential data cannot be intercepted and viewed by unauthorized people. This option is
configured by the system administrator on the SQL database server. Three encryption
settings are defined there:
If the latter setting is implemented in your system, you can choose to use an encrypted
connection when you log into SMConfig. If the database server is configured to always
Admin Guide 88
Deploying SpeechMiner Configuring SpeechMiner
encrypt or not to encrypt at all, you cannot change this option when you log into SMConfig,
and selecting one of the options has no affect.
Starting SMConfig
Starting SMConfig
SMConfig can be run on any machine in your system in which it is installed. During
installation, an SMConfig icon is placed on the desktop of the machine.
Important
Genesys Authentication is only implemented if
SpeechMiner is deployed with GIR.
To open SMConfig:
Admin Guide 89
Deploying SpeechMiner Configuring SpeechMiner
2. Select the type of user account you want to use to log into SpeechMiner:
◦ SpeechMiner Authentication: Use a username and password that are
managed by SpeechMiner.
◦ Windows Authentication: Use the username and password you used to log
into Windows.
◦ Genesys Authentication: Use a Genesys username and password.
Important
Genesys authentication users can only be set in
Genesys Administration Extension (GAX).
3. In the Username and Password fields, type your username and password.
Important
If you are logging in using Windows
Authentication, your username and password
are inserted automatically, and the username is
in the form domain\username.
Admin Guide 90
Deploying SpeechMiner Configuring SpeechMiner
4. If this is the first time you are opening SMConfig on this computer, or if you want to
change the existing database settings, click the DB Settings arrow. The Login
dialog box expands and displays the database settings.
Important
If you do not need to set or modify the database
settings, skip this and the next step.
Field Description
Select SQL Server Authentication if the username and password
for accessing the database are managed on the SQL server.
SQL Server SelectWindows Authentication if you log into the database using
Authentication the same username and password you used to log into Windows.
/ Windows
Authentication Note: If you are not sure which option to choose, consult your
system administrator.
Admin Guide 91
Deploying SpeechMiner Configuring SpeechMiner
Admin Guide 92
Deploying SpeechMiner Configuring SpeechMiner
Important
If you do not need to set or modify the Genesys
authentication settings, skip this and the next
step.
7. Enter the name of the server and the port to use to verify the user information, as
follows:
◦ Server—Enter the name of the configuration server.
◦ Port—The port to use to connect to the configuration server in order to verify
the user information.
After setting or updating the configuration server host and port in SMConfig (either in
the Login window, or in the Sites and Machines panel), the IIS should be restarted.
8. Click OK. You are logged into the system, and the SpeechMiner Configuration
Tool (SMConfig) window opens with the first screen, Sites and Machines,
displayed.
Admin Guide 93
Deploying SpeechMiner Configuring SpeechMiner
The SMConfig interface contains panels (Sites and Machines, Reports, etc.) in which
various categories of configuration settings can be accessed.
To open a panel:
• On the left side of the window, select the icon of the panel. The panel opens on the
right side of the window.
Saving Changes
Admin Guide 94
Deploying SpeechMiner Configuring SpeechMiner
After you click Save, before the settings are actually saved, some settings go through a
validation process. Validation ensures that the locations specified for folders and files exist
and can be accessed, and checks that certain important parameters are configured properly.
Certain key settings are always validated when Save is selected; you can choose to have
the system validate certain others if you wish.
During the validation process, a Progress window is displayed. The window lists the stages
of the validation process as they are completed, with an icon indicating the status of each
stage.
Icon Description
Success: Validation of the stage was successful.
Warning: Validation of the stage was successful, but some problematic issues
were detected.
Failure: Validation of the stage failed, because of the problems indicated. No
changes to the configuration were saved.
When the process is complete, the Close button at the bottom of the window becomes
active. If validation was successful, the last line of the log says Done. If the Progress
window contains any stages that failed (indicated by ), the entire save process is
cancelled. The following screenshots depict examples of each status:
Admin Guide 95
Deploying SpeechMiner Configuring SpeechMiner
Admin Guide 96
Deploying SpeechMiner Configuring SpeechMiner
Admin Guide 97
Deploying SpeechMiner Configuring SpeechMiner
• In the Progress window, select the item. Details are displayed at the bottom of the
window.
Admin Guide 98
Deploying SpeechMiner Configuring SpeechMiner
After the configuration changes are successfully saved, a Restart Services message
appears.
Admin Guide 99
Deploying SpeechMiner Configuring SpeechMiner
Select Yes to restart all of the services, or No if you prefer to restart them later (either after
you make additional configuration changes, or manually from the Services panel.)
Using SMConfig
This section describes how to use SMConfig to configure the Enterprise.
The first panel of the SMConfig application, Sites & Machines, is used to configure the
layout of the system as well as some other system-wide parameters.
This tool enables you to configure sites, machines and tasks, and system index searches.
Configuring Sites
A site is a single geographical location in which SpeechMiner servers are installed. One
SpeechMiner system, which has one database, can have a number of sites. All the sites
configured in the Site section of the Sites & Machines panel are locations that connect to
the SpeechMiner database. If your SpeechMiner is set up in more than one location,
configuring each location as a site helps to minimize the bandwidth needed for call
processing.
Every SpeechMiner system has at least one site. The first site is created automatically, and
is initially called "default." Immediately after SpeechMiner is installed, the "default" site is
automatically configured to include all the servers in the local network. You can change the
name of the default site, and add sites, as required. If you create new sites, you can move
servers that are listed under the default site to other sites.
Permissions
Required Permissions
Validation of the input, filtered, store, and installation folders can only be
performed if the user account used to log into SMConfig has administrator permissions on
the machine that is being configured. This is because SMConfig must use the $ share to
check that the installation folder exists.
Default Site
Some of the settings in the Sites & Machines panel are configured per site, and others are
configured for the entire system. This section explains how to configure the default site by
configuring the site and system settings defined in the Sites & Machines panel.
After you configure the settings, and click Save to save them, SMConfig automatically
validates the key folders you specified by checking that they exist and are configured with
the required permissions. Validation is always performed on the items listed under Machines
and Tasks. Validation of other settings is optional, as indicated below. For additional
information, see Saving Changes.
Field Description
The name of the site. Initially, the site is called "default." Modify
Site Name
this field to change the name.
Enter the location of the folder called filtered that you created (see
Filtered Dir Creating the Required Folders). For example, the required path
format is \\computer\data\input.
Click to add a line to the list. Then, modify the line to give the
location of the input folder you created (see Creating the Required
Folders).
Input Folders
If you will be using multiple input folders for this site, repeat this
procedure to add additional lines to the list, as necessary. For
example, the required path format is \\computer\data\input.
Click to add a line to the list. Then, modify the line to give the
location of the store folder you created (see Creating the Required
Store Folders).
Folders
If you will be using multiple store folders for this site, repeat this
procedure to add additional lines to the list, as necessary.
Validate
input,
Select this option if you want SMConfig to validate the input,
filtered,
filtered, store, and installation folders after you click
store, and
Save (see Saving Changes).
installation
folders
If your system will have more than one site, select this option to
enable processing of interactions from other sites at this site.
When this option is selected, the Recognizers at this site will give
Cross site
priority to processing local files, but no local files need to be
processing
processed, they will process calls from remote locations.
allowed
Selecting this option can improve the overall performance of the
system, but it does mean that audio files will be transmitted over
the network.
If cross-site processing is activated, select this option to give
priority to compressed audio files if they are available. If this
option is selected, when call data is transmitted from a remote site
Prefer
to this site for processing, the system will send the compressed
compressed
versions of calls if they are available. In this case, the compressed
remote audio
audio will be decompressed before being processed by the
Recognizer. Even so, the quality of the audio input may be
diminished slightly, and this may impact the recognition quality.
List all the SpeechMiner machines at the site, and configure the
Machines
tasks that will run on each machine, as explained under
and Tasks
Configuring Machines and Tasks.
Click to add a line to the list. Then, modify the line to give the
location of the grammars folder you created (see Creating the
Required Folders).
Package
Folders If you will be using multiple grammars folders in your system,
repeat this procedure to add additional lines to the list, as
necessary. For example, the required path format is
\\computer\data\input.
Click to add a line to the list. Then, modify the line to give the
location of the backup folder you created (see Creating the
Required Folders).
Backup
If you will be using multiple backup folders in your system, repeat
Folders
this procedure to add additional lines to the list, as necessary. For
example, the required path format is \\computer\data\
input.
Note: If you select this option, SMConfig will try to validate that
Validate the user who is running SMConfig has access to the report web
Report service and can call methods using this web service. Therefore,
Server the user account that was used to run SMConfig must have the
Content Manager role on the report server (see Configuring
Permissions for UPlatform). Folders Select this option if you want
SMConfig to check whether the Package, Backup, and Index
folders exist and are configured properly.
Report
Fill in the fields in this area as follows:
Server
Note: If you plan to use the report server, select Validate Report
Server.
Click to add a line to the list. Then, modify the line to give the
location of the index folder you created (see Creating the
Required Folders).
Index Folder
For example, the required path format is \\computer\data\
index.
Select the default language for new Programs that are opened in
SMART. (If additional languages are installed in SpeechMiner, the
languages of individual Programs can be changed in SMART
Default when the Programs are created.)
Language
Note: Only the languages selected under Select Languages
appear in the dropdown list.
Select all of the languages for which you will want to perform
Select
speech recognition. These languages will appear as language
Languages
options in SpeechMiner and in SMART.
2. Click Save. The system validates the settings, and then, if the validation is
successful, implements them. The Progress window opens and shows information
about the implementation process.
Add a Site
Adding a Site
If your system will have servers at more than one site, you can add additional sites to the
configuration in SMConfig. A new tab is added to the Sites & Machines panel for each site
you create. The settings in the upper half of the panel, under Sites and Machines and
Tasks are configured for each site. The settings in the lower half of the panel are configured
for each system, and thus are not changed when you add an additional site.
Before you begin adding the site, create filtered, input, and store folders on a
machine at the new site (see Creating the Required Folders).
To add a site:
1. In the upper-left of the Sites & Machines panel, select . A new tab is added to
the site-setting area in the upper part of the panel.
2. Under Site Name, modify the name as required. The name of the tab is
automatically updated.
3. Under Sites and Machines and Tasks, fill in the fields for the new site.
Important
In SMConfig, in the Sites and Machines panel, when
the system tasks are saved, warning messages
indicate that the system does not include
Categorizer, Active Search and Exploration tasks.
These messages can be ignored when working in
Recording UI Mode, since these tasks are not
available in this mode.
Before you can configure the machines and their tasks, you must decide which tasks to
assign to each machine. Each machine can have a number of different roles at one site. The
entire system must include machines that fill all of the following roles:
• Exploration: Performs the data analysis required for the Exploration feature of the
web-based interface.
• Recategorizer: Assigns Categories to the processed interactions in accordance with
the Category definitions defined in the system.
• Text Recognizer: Processes written interaction input data and identifies Topics and
other events in it.
Important
The Exploration and Active Search tasks use the
Index folder. Machines that perform these tasks must
be physically connected to the same LAN as the
Index folder and the Index task).
Important
Monitors run on all computers in the system.
Because of this, there is no option to assign the
Monitor task to specific machines, and it does not
appear in the list of roles above.
To optimize the rate at which interaction data is fetched, multiple fetchers can run
simultaneously. You can configure SpeechMiner to employ multiple fetchers on one or more
machines. However, if too many fetchers run on a single machine simultaneously, the CPU
may not be able to run all of its tasks efficiently. The optimal number of fetchers to run on a
single machine is a function of how powerful the CPU of the machine is. A general starting
point on a new SpeechMiner installation is to assign 0.5 fetcher tasks per core on each
fetcher machine. Normally, two fetchers will maximize the CPU usage on a quad-core
machine.
To maximize the speed of interaction processing, multiple Call Recognizers can run
simultaneously. You can configure SpeechMiner to employ multiple Call Recognizers on one
or more machines. However, if too many Call Recognizers run on a single machine
simultaneously, the CPU may not be able to run all of its tasks efficiently. The optimal
number of Call Recognizers to run on a single machine is a function of how powerful the
CPU of the machine is and how many Topics must be recognized concurrently. A general
starting point on a new SpeechMiner installation is to assign 1.5 Recognizer tasks per core
on each Recognition machine. Normally, six Call Recognizers will maximize the CPU usage
on a quad-core machine.
Important
The total number of recognition tasks cannot exceed
the number in the SpeechMiner license under
<maxCallProcessing>xx</maxCallProcessing>.
The Call Recognizers in your system are run by a special Recognition process
(uRecognizer.exe) that is distinct from the Platform process (uPlatform.exe). Each
Recognition process can manage multiple Call Recognizers. You can configure the
maximum number of Call Recognizers that should be managed by each Recognition
process. If the number is too low, performance may be impacted; if it is too high, the process
may run out of memory. Running more than six Call Recognizers per process is not
recommended. Unless you are running the processes on a virtual machine(VM), it is
recommended to configure the system to run at most six Call Recognizers per process.
Then, if you encounter memory problems, reduce this number as necessary to eliminate the
problems. On a virtual machine, it is highly recommended to run only two Call Recognizers
per process. If you run more than two Call Recognizers simultaneously on a VM, they slow
one another down considerably. This recommendation is relevant for virtual machines
running either on VMware or Hyper-V servers.
You configure the properties of a machine by selecting the tasks it should perform.
1. Under Machines & Tasks, double-click the machine. A Properties window opens
and displays the properties of the machine.
3. If you selected Web Server, select the protocol, specify the port and virtual folder,
and select the langauge of the web-based interface.
In addition, if the index folder used by the system is on a different network, it is
recommended that you configure your web server to work with the remote web
service. For additional information about this option, see Remote Index Search.
4. If you selected Interaction Receiver, click the Parameters button to its right. In the
dialog box, enter the location of the Interaction Receiver Input folder in
which the audio files received from the Genesys Interaction Recording solution will
be placed , and then click OK. Note that the Interaction Receiver Input
folder is not the same folder as the Input folder used by the fetchers.
5. If you selected Fetcher, configure the Fetcher settings as explained below.
6. If you selected Call Recognizer, configure the Call Recognizer settings as
explained below.
7. Click OK. The machine is added to the list of machines at the site.
1. To the right of the Fetcher checkbox, select the number of fetchers that should run
on the machine.
2. Click the Parameters button. The Fetcher Parameters window opens and displays
a list of all the input folders that are configured for the site.
3. Under Number of Fetchers, specify how many fetchers should retrieve interaction
data from each input folder. Modify the values so that the sum of all the fetchers
defined matches the number of fetchers that you specified should run on the
machine.
4. Click OK.
1. To the right of the Fetcher checkbox, select the number of Call Recognizers that
should run on the machine.
2. Click the Parameters button. The Recognizer Parameters window opens and
displays a list of all the input folders that are configured for the site.
Field Description
Maximum
number of
recognizers How many Call Recognizers can be handled by each process.
per
process
The ports that will be used by the Call Recognizers; the system will
Server port use multiple ports, as necessary, beginning with the port entered in
range start this field. By default, this is port 2001. You can change this number
if it conflicts with other port settings in your system.
Limit Active Search is a feature that users can access from the
number of SpeechMiner web-based interface. It allows users to reprocess
Active calls in order to search for new terms that were not sought in the
4. Click OK.
Whenever the index folder is on a different machine from the Web server performing the
search, Windows sharing is used to enable the Web server to access the index files. If both
machines are on the same LAN, this arrangement should not cause any performance
issues. But when the Web machine and the index machine are on different sites that
connect to one another over the internet, accessing the system files on the index machine
directly, via Windows sharing, can be slow, especially if the index files are large.
To solve this issue, each Web machine can be configured to either search the index files
directly or to use Web service calls.
Consider, for example, a SpeechMiner system that has two sites: Both sites have Web
servers, and the second site also stores the index files. In this system, we configure the Web
server at Site 2 to search the index files directly, because the index files are located on the
same machine as the Web server. On the other hand, we configure the Web server at Site 1
to search the index using Web service calls to the Web server at Site 2. This arrangement is
illustrated in the following diagram:
This configuration is set up in the Properties windows of each of the machines in the
system.
• In the Properties window of the Web server, clear the Search using remote web
service checkbox.
To configure a Web server to search the system files by calling the Web service on another
machine:
• In the Properties window of the Web server, select the Search using remote web
service checkbox. The Computer field becomes active.
• In the Computer field, select the Web server to which search requests should be
sent.
Licenses
Licenses
For the system to process calls, enter the licenses you received from Genesys must be
entered in the Licenses panel. The licenses are not included in the SpeechMiner installation
folder.
Important
If the license texts are stored in separate files, as an
alternative to the procedure described above, you
can browse to locate the files. When you open the
relevant file, its contents are automatically copied
into the appropriate field.
Services
Services
The Services panel is used to manage the SpeechMiner services. You can use it to:
You must perform these actions at the end of the installation process, and also whenever
you add, change, or remove services or machines to or from the system. You can also use
the Services panel to restart or stop services whenever necessary.
Initial Configuration
After you install SpeechMiner and configure its components in SMConfig, you must register
all of the SpeechMiner services, update the SpeechMiner configuration files on each
machine, and start all Uplatform servers. In addition, whenever you make changes to the
system, you should follow the same procedures, as explained below. To configure the
services in your system:
Field Description
Notes:
Update
◦ Select this option for all machines when you first install
Nuance
SpeechMiner. If you relocate the license server to a
license
different machine, add additional servers, or remove
server
existing ones, run this option and select all the machines in
your system.
◦ If you are updating the Nuance license servers on remote
machines, the Remote Registry service must be running on
those machines. If it is not running on one of the machines,
the error "Failed to update Nuance license on [MACHINE
NAME]. The network path was not found." will appear in
the Progress window.
◦ If you want a machine to work with a local license server,
clear the text box, verify that the check box is selected and
save.
Select/ Select the checkbox to select all of the machines in the list below
Deselect all for updating. Clear it to clear all of the selections in the list.
Select the machines for which you want to implement the options
Machine
you selected on the left side of the panel.
2. Click Save. The system begins to implement the settings you selected, and the
Progress window opens and shows information about the implementation process.
Required Permissions
The user account used to log into SMConfig must have the required permissions in order for
SMConfig to perform the actions selected in the Services panel. Some of the requirements
are for permissions on the local machine (the machine on which SMConfig is currently
running); others are for permissions on the selected remote machines. The various options
in the panel have different permission requirements, as explained in the following table:
Required
Option Additional Details
Permissions
• For remote
machines:
Administrator
privileges on
the selected
Create machines
Performance • For the local
Counters machine:
Under
Windows
Server 2008,
Power User
privileges
Administrator privileges on the selected machines
are required in order to register the Uplatform
Administrator
Register service. These privileges are required for running
privileges on the
Services remote commands on the selected machines and
selected machines.
for registering the services using the Windows
Services API.
Administrator privileges on the selected machines
Administrator are required in order to update the configuration
privileges on the files on the local machine and on the remote
Update
local machine and machines. These privileges are required for
Config Files
on all selected accessing the files using the $ share and for
machines. encryption and decryption (if Encrypt config files is
selected).
• For remote
machines: • To change the Uplatform service status on
Administrator remote machines, Administrator
privileges on permissions are required in order to get the
Restart/Stop the selected service information and change it's status
Services machines remotely using the Windows Services API.
• For the local • To change the Uplatform service status on
machine: the local machine Power User privileges on
Power User the local machine are sufficient.
privileges
• For remote
machines:
Administrator
privileges on
the selected
Update
machines. Administrator permissions are required in order to
Nuance
• For the local update the registry key that controls the Nuance
license
machine: environment variables.
server
Under
Windows
Server 2008,
Power User
privileges.
Important
You can also toggle between "idle" status and "run"
in the SpeechMiner web interface, in the System
Monitor page.
Audio
Audio
The Audio panel of SMConfig is used to configure the call-audio recognition and playback
formats, retention periods for each format and site, and playback rates. Below is a summary
of the audio formats that are supported for each audio function.
The Audio panel contains the basic audio setting options for the system.
Important
This panel includes the most common audio
configurations. If you require a more complex
configuration, you must manually define it in the
Field Description
Select the format of the call audio that must be used by
SpeechMiner during the recognition process. If the audio received
Select the from the recording system is not in the format selected here, the
audio fetchers will automatically convert it to this format (after they
format for retrieve it from the input folders) before they save it in the store
recognition folders to await processing by SpeechMiner. If the system is used
in the Recording UI mode or Recording and Analytics mode, the
format must be set to WAV_PCM.
Select the format of the call audio that must be used by
SpeechMiner for playback in the web-based interface. After the
audio of a call is processed, an additional compressed copy is
Create
made in this format and saved in a file in the store folders.
compressed
audio file
If the system is used in the Recording UI mode, or Recording and
Analytics mode, this must be set to Do Not Generate.
Specify the retention policy, per site, for each of the audio formats
selected above. Call data is deleted from the store folder
automatically when it has been in the folder as long as the
specified retention period. The values chosen should be based
mainly on the disk space available for storing the call audio. Bear in
mind that 1 MB of disk space can contain roughly one minute of
uncompressed audio data or 15 minutes of compressed audio
data.
Notes:
. A new line is added to the list. Modify the value in the line as
required, and then press Enter.
Select this option if you want the audio files to be encrypted before
they are saved in the store folder.
Encrypt
audio files When you select this option, the New Password field becomes
active. Enter the encryption password in the field.
2. Click Save. The system implements the settings, and the Progress window opens
and shows information about the process.
Summary
The Audio panel summary lists the preferred formats that SpeechMiner supports:
Index
Index
The Index panel enables you to manage index-related tasks: backup, restore, and index
optimization.
You can back up the index automatically on a daily basis or manually as required. Note that
no incremental backup is available; every time the backup is started, all of the index files are
copied to the backup folder.
Daily Backup
You can set a time and specify a backup folder, and SpeechMiner will automatically back up
the index every day at the specified time to the specified folder.
1. In the Index panel, in the Daily Index Backup region, fill in the fields as follows:
Field Description
Backup Select the checkbox to activate the automatic daily backup, and then,
every in the time field, select the time at which you want to the backup to
day at begin.
Keep
Select the number of backups to keep. Older backups will be deleted
only
automatically.
last...
Daily
backup Select the folder in which to store the backup data.
folder
2. Select Save. The changes are saved, and a Progress window shows information
about the saving process.
Manual Backup
You can select a folder and back up the index to that folder manually as necessary.
1. In the Index panel, in the Manual Index Backup region, fill in the fields as follows:
Field Description
Backup to
Select the folder in which to store the backup data.
folder
Use If different credentials are required to access the index folder, select
different the Use Different Credentials check box, and then enter the
credentials required user credentials.
2. Select Backup Now. The backup is performed, and a Progress window shows
information about the backup process.
If you have a backup of the index, it is generally preferable to restore the index from it.
Restoring the index from a backup is generally a much quicker process than creating it from
scratch, especially if the database is large. The index task re-indexes the database at a pace
of about 3,500 calls per minute. If you restore the index from a backup, only those calls that
were indexed after the backup was created must be re-indexed. Calls that are included in
the backup do not have to be re-indexed. As a result, you can start using the index almost
immediately.
Two alternative methods for restoring the index from a backup are available:
In either case, you should not restore the index folder manually. Instead, use SMConfig to
perform the restoration. Using SMConfig ensures that the process is performed properly,
and, in addition, SMConfig also takes care of re-indexing all the calls that were indexed after
the backup was created.
1. In SMConfig, in the Index panel, select Restore Index Folder. The Restore Index
Folder dialog box opens.
Field Description
Select (Minimum WEB down time) Make the latest valid backup
folder the new index folder to use the backup folder as the new
index folder, or (Recommended for the long run) Restore the
backup to a new index folder location to create a new folder to
To index use as the index folder.
folder
If you chose the second option, under New index folder path,
select the folder to use as the new index folder. Note that this folder
must be empty when you begin the restoration process.
Select Restore the latest valid daily backup to restore the index
From from the folder that contains the automatically generated backups of
backup the index (specified in the Index panel under Daily Backup
folder Folder), or Restore from a manual backup folder to use a
manually generated backup.
Use If different credentials are required to access the index folder, select
Different the Use Different Credentials checkbox, and then enter the
Credentials required user credentials .
3. Click OK. The index is restored to the new index folder, and a Progress window
shows information about the restoration process.
During the process, SMConfig will also do the following:
◦ Checks the validity of the new index folder, and, if it is not valid, abort the
process.
◦ Inserts indexing requests into the index queue for all the calls that were
processed or updated after the backup was created.
◦ Notifies the Web servers that the index folder was changed.
4. When the restoration process is finished, restart the platform servers.
If you do not have a backup of the index, you can restore it by deleting the existing index
and creating a new one. In addition, if the database is quite small, you may prefer to restore
the index in this way even if you do have a backup.
Restoring an index by creating it from scratch is generally a much slower process than
restoring it from a backup, especially if the database is large. The index task re-indexes the
database at a pace of about 3,500 calls per minute. If you re-create the index from scratch,
all of the calls in the database must be indexed.
Important
Re-indexing the text interactions is only
relevant in SpeechMiner versions from 7.3
and on, and only if your system handles
text interactions as well as calls.
5. Restart the Uplatform services that you stopped before. After a minute or two, the
index task will start to index the calls. Newer calls will be indexed first.
The Index Optimization task optimizes the index files of the system, thus reducing their size.
It is recommended to configure it to run at a time when the system is not in use, such as
Sunday at midnight.
1. In SMConfig, in the Index panel, in the Weekly Index Optimization region, select
the Optimize every week at checkbox.
2. Select the day of the week on which to perform the optimization, and specify the time
to begin the process.
3. Click Save. The setting is saved, and the Progress window opens and shows
information about the saving process.
High Availability
High Availability is an automatic process for restoring an index backup. When the High
Availability feature is selected in the SMConfig Index panel, the system will detect when the
Index folder is not accessible and perform the following:
1. Switch the roles of the Index folder and the Daily Backup folder, so that the current
backup becomes the primary folder and the current index becomes a secondary
backup folder.
2. Re-index all the interactions that were indexed after the latest daily backup was
created.
Whenever the primary folder becomes inaccessible, the folder roles will change.
The time between when the index is detected as inaccessible and when the switch
over is performed can be configured in the High Availability section of the Index
Tab. (That is, Switch after # minutes)
Reports
Reports
If you want to use any of the SpeechMiner reports, you must deploy both the MRS Library,
which is a DLL that provides support for various report features, and all the required reports,
on the report server. You can do this from the Reports panel of SMConfig. The DLL and the
reports will be deployed on the machine that is identified in the Sites & Machines panel,
specified as the Server Name parameter under the Report Server panel.
Required Permissions
To check if the MRS Library has been deployed on the report server, and to deploy the MRS
LIbrary, SMConfig reads the report server's Registry to locate the report server’s bin folder
and then accesses the folder using the $ share. Therefore, to deploy the MRS Library and
any or all of the reports, the user account used to log into SMConfig must have administrator
permissions on the report server.
To deploy reports on the report server, you must first deploy the MRS Library on the server,
and then deploy the required report templates. You can perform both actions simultaneously
by selecting both options in the Reports panel. Once the MRS Library is deployed on the
server, you can deploy additional reports without redeploying the library.
Important
When you select the Reports panel, SMConfig
checks whether the MRS Library is already deployed
on the machine.
Field Description
If you chose to use report caching in the Sites & Machines panel,
specify how long report results should be cached, in minutes. The
Set reports results of reports that are included in active users' Views pages will
caching be saved for the specified period of time. Users who open their
time Views pages during that time period will see the cached results.
The recommended time period is 24 hours (i.e., 24*60=1440
minutes), because the report caching runs once every 24 hours.
If the MRS Library has not yet been deployed on the report server,
select this option.
Deploy Note: If this option is not selected, but the checkboxes in the
MRSLibrary Report/Resource list below are active, this means that the MRS
Library is already deployed on the machine. In this case, it is not
necessary to select this option.
Report/ Note: If this option is not available, this means that the MRS Library
Resource has not yet been deployed on the machine. In this case, select
Deploy MRSLibrary, and this option will become available.
2. Click Save. The system begins to deploy the reports on the report server, and the
Progress window opens and shows information about the deployment process.
Recording
Recording
When working with a Recording mode, the following configurations are required in the
Recording panel. The Recording panel only appears when you are working in a Recording +
Analytics environment or a Recording Only environment:
• Configuration
◦ Tenant
◦ Application Name
◦ Users Access Group
• Interaction Receiver
In systems with Call Recording mode or Call Recording and Analytics mode licenses,
the Program ID is normally assigned to calls by the recording processor.
The recording processor adds the Program ID to the call’s metadata. If the call
arrives in the SpeechMiner system without a Program ID, SpeechMiner assigns
If you want to change this default value to a different value, perform the following:
Set Extension Speaker Type and Trunk Speaker Type as configured in the GIR
system.
Important
For additional information see Recording
Modes.
• RP Authorization
Set the User and Password to the values configured for the RP.
• MCP Authorization
Set the User and Password to the values configured for the MCP.
The MCP authorization option is only available when working in an environment with
SpeechMiner Analytics.
• Playback
◦ Set the RCS URI value using the format: http://rcs_host:port/rcs,
or https://rcs_host:port/rcs (Web Server connection).
◦ Set the External RCS URI value (when working with encrypted Screen
Recording), using the format: http://rcs_host:port/rcs, or
https://rcs_host:port/rcs (Browser connection).
◦ Set the HTCC URL value (when working with Screen Recording), using the
format: http://htcc_host:port, or https://htcc_host:port
(Browser connection).
If you are not working with Screen Recording, leave the HTCC URL field
empty.
Important
Use https for the RCS and HTCC connections if
the connection to the SpeechMiner web server
was configured with https.
Additional Configurations
The following configurations are recommended for the successful completion of the
SpeechMiner configuration process:
Browser
Tip
To run SpeechMiner 8.5.3 you must use a minimum
resolution of 1366X768. We recommend that you
work with a 1680x1050 resolution.
Internet Explorer
1. In the Internet Options dialog box, in the Security tab, select Local Intranet.
2. Add the SpeechMiner domain to the list of web sites in the Local Intranet zone.
3. Click Custom Level and select Miscellaneous > Access data sources across
domains.
4. Under Access data sources across domains, select Enable.
5. In the Privacy tab, add the SpeechMiner domain to the list of web sites that are
permitted to open pop-ups.
6. In the General tab, under Browsing history, select Settings.
Important
If the SpeechMiner domain is treated as part of the
local intranet, Local intranet should appear in the
Status Bar at the bottom of the Internet Explorer
window whenever the browser is displaying a
SpeechMiner page.
Turning Off the Enhanced Security Configuration Feature on Windows Server 2008 / Windows Server
2012
1. In the Server Manager, in the home page (the top level), expand the Security
Information section. The current settings for the Enhanced Security Configuration
feature appear under IE Enhanced Security Configuration (ESC).
2. If the current settings are not Off for Administrators and Off for Users, click
Configure IE ESC. The Internet Explorer Advanced Security Configuration
dialog box opens.
Chrome
Configuring Chrome
1. In the Chrome browser, select Customize and control Google Chrome, and then
select Settings.
2. Select Show advanced settings..., and then under Network, click Change proxy
settings... The Internet Property dialog box opens.
2. Under Java Script, select Allow all sites to run Java Script (recommended).
The webServiceParam table has two fields for configuring the date and time display:
When SpeechMiner's Spanish interface is used for the Web interface, the only formats
supported for globalDateTimeFormat are the following 24-hour formats: H:mm:ss or H:mm.
When configuring SpeechMiner you can give users the option of recovering forgotten
passwords.
If you choose to enable users to recover their forgotten passwords, the SpeechMiner log in
screen will contain a Forget Password? link.
When the user clicks the Forget Password? link, the user will be required to enter his email
address.
The user will then receive an email with a Reset Password link.
By default the Reset Password link is only available for 4 hours. This default number can be
changed.
Important
If more than one user has the same email address,
the Forget Password option will not be available.
Resource Type
The resourceTypeId table contains a list of all the possible resource types.
VMWare
If you are installing SpeechMiner on virtual machines and using VMWare Server VSphere4,
it is recommended to use the Scheduling Affinity feature, which dedicates specific logical
CPUs for the virtual CPUs of particular VMs. Doing this can improve Recognition
performance.
1. For each active Virtual Machine, check the VM Settings to see how many CPUs are
configured for the machine.
2. In Setting\Resources tab\Advanced CPU\Scheduling Affinity, enter the serial
numbers of the VMWare server's logical CPUs.
Important
The following procedure is intended for a WIndows
2008 Server
h. Click Next
i. Under Active Directory Enrollment Policy, Select Computer.
j. Click Enroll and Finish.
11. Configure the Report Server:
a. Open the Reporting Services Configuration Manager.
b. Select Web Service URL.
c. Select Advanced.
d. Under Multiple SLL Identities, click Add and select the certificate you
created.
e. Click OK and select the https URL.
f. Under Multiple SSL Identities, click Add and select the certificate you
created.
g. Click OK and select the Report Manager URL.
Important
If the following error occurs after you restart the
IIS Server, it maybe due to the fact that your
Skype process is using the same ports and
should be stopped:
Recording Modes
• Create a new application for SpeechMiner with a Genesys Generic Server template
in the Genesys Administration Extension:
Configure a new SpeechMiner Web application when your default web site is not sufficient
for your systems demands.
SMConfig
SMART
All Caching tasks are listed in the Report Caching Params table.
In the default database there is one Caching task that caches all the reports in the expanded
widgets for all the active partition sets during the last 30 days.
You can select different reports to cache then those defined by default. You can also delete
the existing cache and create a new cache.
1. Access the Report Cache Params table in the database and insert a new row.
2. Define the following parameters:
Parameter Description
Enable True
Report The query that retrieves the report id’s and the partition strings
Query associated with the report you want to cache.
Within the Report Query you can use the following parameters:
Parameter Description
@templatesToExclude The templates to exclude from caching.
@usersToExclude The users to exclude from caching.
The users that should be cached. For example, if this is
@daysUserIsActive 7, then only users that are active in the last 7 days
should be cached.
The number of parallel threads that should be cached (at
numberOfProcesses
the same time).
The number of days log messages associated with
keepLogMessages
caching tasks be should be kept.
The email address belonging to the users to whom the
NotificationMail caching task report should be sent when the caching is
complete.
The name of the web server to which the reports are
webComputerName
cached.
Defines when the caching task will run within 24hrs. The
maximum is 1440 minutes for 24hrs. For example, if you
want the cache task to run at 12 midnight and your UTC
RunAtTime
difference is +2, enter -120. It is the difference between
UTC and the local time you want it to run in. The
difference is in minutes.
The next time the Caching task is set to run. Set this
nextTimeToRun parameter to a low value. During the initial run the task
automatically sets the correct value.
If you select more than one machine the Caching task will be divided equally
between the machines that run simultaneously. The more machines the faster the
Caching task will be completed.
5. Click Edit.
10. In the Set reports caching time (minutes) field enter 1440 (this number represents
24 hours).
11. Select all the report templates and click Save.
12. Verify that the Caching task is running:
a. Access the reportCachingLog table.
b. Select the table records and verify that the Caching task ran.
c. Access the ulogger and verify that it is caching the selected reports.
Important
Configure the Report Server email as follows so that the report schedule and report
deliverable functions operate as expected.
Integrated Windows Authentication enables you to ensure that your SpeechMiner users are
not required to log into SpeechMiner every time they want to access the application.
Tip
1. Open IIS Manager and navigate to the level you want to manage. For information
about opening IIS Manager, see Open IIS Manager (IIS 7).
For information about navigating to locations in the UI, see Navigation in IIS Manager
(IIS 7).
...
<system.web>
...
<authentication mode="Windows"/>
...
</system.web>
...
Configuring Permissions
This section describes the permissions that must be set for the functional SpeechMiner
domain user (SMUSER) and for users of SMART.
UPlatform
SpeechMiner uses a domain user account as the credentials for all the registered
SpeechMiner services. Your IT department must be able to create this account for you. The
domain user must have assigned permissions on all machines on which the UPlatform
service will run, as described below. The user account must be created and assigned the
required permissions before you begin configuring SpeechMiner.
Important
In this guide, this functional user account is called
SMUSER.
Groups
• Power Users
• Performance Monitor Users (if this group exists on the machine)
Folder Properties
Important
Tab indicates the tab in the Properties dialog box in
which the permission can be assigned.
Report Server
On the report server, assign the Content Manager role to SMUSER, as follows:
Important
If the Windows UAC (User Account Control) is
active on the server, open the browser by right-
clicking its icon and then selecting Run as
administrator.
Important
If you cannot access this folder, because you
are repeatedly asked for your credentials, and
then the screen turns blank, do the following: In
rsreportserver.config, remove the value
RSWindowsNegotiate and ensure that
RSWindowsNTLM is specified. (For more
information about this problem, and some other
solutions, see http://blogs.msdn.com/b/lukaszp/
archive/2008/03/26/solving-the-reporting-
services-login-issue-in-the-february-ctp-of-sql-
server-2008.aspx)
3. If SMUSER is not on the list, click New Role Assignment and add it. If it is on the
list, click Edit to edit the existing account settings.
4. Select speechminer database > sme.
5. In the Security tab, click New Role Assignment. The New Role Assignment tab
opens.
6. In Group or user name, enter the user name (SMUSER).
7. Select the Content Manager checkbox.
Give SMUSER access permissions to the IIS metabase and other directories used by
ASP.NET. To do this, an administrator can run this command:
Uconnector
A functional UConnector user should be assigned the permissions listed below. Note that
you can use SMUSER for this purpose; it is not necessary to create a dedicated domain
user for this.
SMART
Any user who will run SMART should have the following permissions:
In addition, all SMART users should have permission to use .net encryption. To add this, an
administrator can run the following command:
Web Server
Once you have installed the SpeechMiner web server, you should set the following
permissions:
This page describes the required system specifications for the successful implementation of
chat interactions.
Supported Formats
• Text File
• Chat XML file (.chtx)
File Format
Text File
A chat interaction in a text file format only requires a subject and the conversation. The file
does not require information about the participants.
The first line in the text file should be the subject. The second line in the text files should be
empty. The remaining lines should contain the chat conversation.
For example:
Billing Issue
When using an XML file (.chtx format), the chat interactions should be configured as
follows:<textFormat>XML</textFormat>
Additional information can be added as meta data in the interaction XML file.
Important
The .chtx format and specification that is described
here is not an official format or standard. This file
format was specifically created for SpeechMiner
purposes. The assumption is that the UConnector or
any other ETL tool will create the chat conversation
in this format before sending the file to SpeechMiner.
A chat conversation in .chtx format can contain one subject, multiple conversation messages
and a description of the parties in the conversation. The subject and each message is not
limited to one line (they can contain multiple lines).
party ID cannot be found in one of these places it will be ignored and identified as a
different party in the call.
◦ In the 'speakers' element in the meta data xml file
◦ In the 'parties' element in the chtx file (see below)
Messages without a party ID or messages with a party ID that were not found, will be treated
as one party. This configuration is similar to the channels speakers configuration in dual
channel calls
If one of these attributes are missing this party configuration will be ignored.
Important
The additional information in each message is not
mandatory.
Example 1:
Example 2:
Important
Any white space around the message content or
subject content will be removed (including the first
and last new lines). New lines inside the content will
be preserved. Since the format is XML, any reserved
XML characters need to be encoded if they appear in
the subject content, message content or attributes.
Any other XML information will be ignored
PartyID Configuration
PartyID Configuration
• In the chat meta xml file, in the speakers element. The speakers element in the
meta xml file is used for mapping the interaction to an agent and work group. Since
speakerType is defined in the meta xml file, the file is used as part of the parties
configuration.
• In the parties element in the chtx file. The parties element contains parties that
are not linked to the interaction as agents or work group (for example, a customer).
The chtx fetcher will search for each PartyId used in the message in the speakers
configuration. If the PartyId does not exist in the speakers element, the chtx fetcher
will check the parties element. If the PartyId is not defined in both places the PartyId will
be ignored.
In this example, the agent is defined as the speaker and the customer is defined in the
parties element.
<textFormat>XML</textFormat>
<textTime>2014-01-07T10:54:04</textTime>
<programID>english</programID>
<speakers>
<speaker id="ag1" speakerType="agent">
<workgroup>/W1/W2</workgroup>
</speaker>
</speakers>
</callInformation>
CHTX File:
As shown in the above example the agent with ag1 ID is configured in the speakers
element, in the meta xml file and the customer with the customer1 ID is configured under
parties in the chtx file.
In this scenario there are two options. You can configure the supervisor as a speaker (the
common scenario) or as the party in the chat. When configured as the party a link to an
agent or work group is not possible.