Avaya Interaction Center: Release 7.3 Installation and Configuration

Download as pdf or txt
Download as pdf or txt
You are on page 1of 516

Avaya Interaction Center

Release 7.3
Installation and Configuration

March 2012
© 2012 Avaya Inc. All Rights Reserved. Trademarks
Avaya and the Avaya logo are either registered trademarks or trademarks of
Notice
Avaya Inc. in the United States of America and/or other jurisdictions.
While reasonable efforts were made to ensure that the information in this
All other trademarks are the property of their respective owners.
document was complete and accurate at the time of printing, Avaya Inc. can
assume no liability for any errors. Changes and corrections to the information Downloading documents
in this document might be incorporated in future releases.
For the most current versions of documentation, see the Avaya Support Web
Documentation disclaimer site:
Avaya Inc. is not responsible for any modifications, additions, or deletions to http://www.avaya.com/support
the original published version of this documentation unless such modifications,
Avaya support
additions, or deletions were performed by Avaya. Customer and/or End User
agree to indemnify and hold harmless Avaya, Avaya's agents, servants and Avaya provides a telephone number for you to use to report problems or to ask
employees against all claims, lawsuits, demands and judgments arising out of, questions about your product. The support telephone number
or in connection with, subsequent modifications, additions or deletions to this is 1-800-242-2121 in the United States. For additional support telephone
documentation to the extent made by the Customer or End User. numbers, see the Avaya Support Web site:
http://www.avaya.com/support
Link disclaimer
Avaya Inc. is not responsible for the contents or reliability of any linked Web
sites referenced elsewhere within this documentation, and Avaya does not
necessarily endorse the products, services, or information described or offered
within them. We cannot guarantee that these links will work all the time and we
have no control over the availability of the linked pages.

Warranty
Avaya Inc. provides a limited warranty on this product. Refer to your sales
agreement to establish the terms of the limited warranty. In addition, Avaya’s
standard warranty language, as well as information regarding support for this
product, while under warranty, is available through the Avaya Support Web
site:
http://www.avaya.com/support

License
USE OR INSTALLATION OF THE PRODUCT INDICATES THE END USER'S
ACCEPTANCE OF THE TERMS SET FORTH HEREIN AND THE GENERAL
LICENSE TERMS AVAILABLE ON THE AVAYA WEB SITE
http://support.avaya.com/LicenseInfo/ ("GENERAL LICENSE TERMS"). IF
YOU DO NOT WISH TO BE BOUND BY THESE TERMS, YOU MUST
RETURN THE PRODUCT(S) TO THE POINT OF PURCHASE WITHIN TEN
(10) DAYS OF DELIVERY FOR A REFUND OR CREDIT.
Avaya grants End User a license within the scope of the license types
described below. The applicable number of licenses and units of capacity for
which the license is granted will be one (1), unless a different number of
licenses or units of capacity is specified in the Documentation or other
materials available to End User. "Designated Processor" means a single
stand-alone computing device. "Server" means a Designated Processor that
hosts a software application to be accessed by multiple users. "Software"
means the computer programs in object code, originally licensed by Avaya and
ultimately utilized by End User, whether as stand-alone Products or
pre-installed on Hardware. "Hardware" means the standard hardware
Products, originally sold by Avaya and ultimately utilized by End User.

License type(s)

Copyright
Except where expressly stated otherwise, the Product is protected by copyright
and other laws respecting proprietary rights. Unauthorized reproduction,
transfer, and or use can be a criminal, as well as a civil, offense under the
applicable law.

Third-party components
Certain software programs or portions thereof included in the Product may
contain software distributed under third party agreements ("Third Party
Components"), which may contain terms that expand or limit rights to use
certain portions of the Product ("Third Party Terms"). Information identifying
Third Party Components and the Third Party Terms that apply to them is
available on the Avaya Support Web site:
http://support.avaya.com/ThirdPartyLicense/

Preventing toll fraud


"Toll fraud" is the unauthorized use of your telecommunications system by an
unauthorized party (for example, a person who is not a corporate employee,
agent, subcontractor, or is not working on your company's behalf). Be aware
that there can be a risk of toll fraud associated with your system and that, if toll
fraud occurs, it can result in substantial additional charges for your
telecommunications services.

Avaya fraud intervention


If you suspect that you are being victimized by toll fraud and you need technical
assistance or support, call Technical Service Center Toll Fraud Intervention
Hotline at +1-800-643-2353 for the United States and Canada. For additional
support telephone numbers, see the Avaya Support Web site:
http://www.avaya.com/support
Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Related documents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

Chapter 1: Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
IC installation files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installing IC with Avaya Operational Analyst . . . . . . . . . . . . . . . . . . . . 18
Installation order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Database properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Customizing IC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Chapter 2: Installing IC components . . . . . . . . . . . . . . . . . . . . . . . . . . . 21


Before you install IC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Readme files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
IC prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
License file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Required administrator privileges . . . . . . . . . . . . . . . . . . . . . . . . 23
Hosting servers on Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Hosting servers on AIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Disable Java automatic downloading and updating . . . . . . . . . . . . . . 25
Cautions and tips for installing IC components . . . . . . . . . . . . . . . . . . . 25
Cautions and tips for installing IC servers. . . . . . . . . . . . . . . . . . . . 25
Cautions and tips for Design and Administration Tools . . . . . . . . . . . . 26
Installing IC server and administration components . . . . . . . . . . . . . . . . 28
Installing IC server and administration components on Windows Server 2008 R2 28
Installing IC components on Solaris . . . . . . . . . . . . . . . . . . . . . . . 30
Installing IC components on AIX . . . . . . . . . . . . . . . . . . . . . . . . . 32
Configuring the ORB server environment . . . . . . . . . . . . . . . . . . . . . . 34
Configuring the primary ORB server environment . . . . . . . . . . . . . . . 35
Configuring a secondary ORB server environment . . . . . . . . . . . . . . . 37
Changing ownership for IC on Solaris only . . . . . . . . . . . . . . . . . . . . . 39
Changing ownership of the IC directories and files . . . . . . . . . . . . . . . 40
Changing ownership for Telephony server on Solaris with Avaya switch only 40
Changing ownership for IC on AIX only . . . . . . . . . . . . . . . . . . . . . . . 41
Changing ownership of the IC directories and files . . . . . . . . . . . . . . . 41
Changing ownership for Telephony server on AIX with Avaya switch only . . 42
Setting up Business Advocate . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Installation and Configuration March 2012 3


Contents

Required administrator privileges for Business Advocate . . . . . . . . . . . 43


Prerequisites for Business Advocate . . . . . . . . . . . . . . . . . . . . . . 43
Sharing the Nethome directory . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Configuring a Business Advocate environment . . . . . . . . . . . . . . . . . 44
Building the database schema for the first Logical Resource Manager . . . . 45
Building the database schema for an additional Logical Resource Manager . 49
Verifying permissions for running OA ECB with Business Advocate . . . . . 52
Installing Advocate Component Manager on a separate system. . . . . . . . 52
Installing the IC server SDK. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Upgrading IC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Reinstalling IC components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Upgrading Daylight Saving Time (DST) patches. . . . . . . . . . . . . . . . . . . 56

Chapter 3: Silent Install Interaction Center 7.3 . . . . . . . . . . . . . . . . . . . . . 59


Option 1: Run the installer with default values (no response file) . . . . . . . . . 59
Option 2: Using a response file to supply values for installer variables. . . . . . 60

Chapter 4: Configuring databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65


Before you configure IC databases. . . . . . . . . . . . . . . . . . . . . . . . . . 65
Copying the stored procedure library - DB2 only . . . . . . . . . . . . . . . . . . 66
Setting up a Data server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Cautions and tips for configuring a Data server. . . . . . . . . . . . . . . . . 67
Creating the primary Data server . . . . . . . . . . . . . . . . . . . . . . . . . 67
Creating a secondary Data server . . . . . . . . . . . . . . . . . . . . . . . . 74
IC data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
About data sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Setting the display time for IC databases . . . . . . . . . . . . . . . . . . . . . . 75
Creating IC Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Before you create IC Repository . . . . . . . . . . . . . . . . . . . . . . . . . 76
Building the IC Repository database . . . . . . . . . . . . . . . . . . . . . . . 76
Generating the IC Repository application . . . . . . . . . . . . . . . . . . . . 84
Updating the Directory server with IC Repository . . . . . . . . . . . . . . . . 85
Creating the CCQ database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Modifying the Avaya Agent layout . . . . . . . . . . . . . . . . . . . . . . . . 86
Building the CCQ database . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Generating the Interaction Center application . . . . . . . . . . . . . . . . . . 93

Chapter 5: Configuring core servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 97


Before you configure IC core servers . . . . . . . . . . . . . . . . . . . . . . . . 97
Creating sites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98

4 Installation and Configuration March 2012


Contents

Using IC domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Preconfigured domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
Guidelines for IC domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Creating domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Establishing the failover order for domains . . . . . . . . . . . . . . . . . . . 101
Setting up administrative accounts . . . . . . . . . . . . . . . . . . . . . . . . . 102
About IC passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Using administrative accounts for non-human users . . . . . . . . . . . . . . 103
Using administrative accounts for human users . . . . . . . . . . . . . . . . 105
Creating administrative accounts . . . . . . . . . . . . . . . . . . . . . . . . 105
Using system and sample workflows . . . . . . . . . . . . . . . . . . . . . . . . 107
Sample workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
Using sample workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Workflows in IC seed data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Configuring core servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Server naming guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Recommended tuning parameters for IC servers . . . . . . . . . . . . . . . . 110
Creating an ADU server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Creating a DUStore server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Creating a Directory server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Creating an EDU server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Creating a Report server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
Creating a Workflow server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Creating a Blender server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Creating an HTTP Connector server . . . . . . . . . . . . . . . . . . . . . . . 125
Creating a Notification server. . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Starting and stopping IC servers . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Determining server dependencies . . . . . . . . . . . . . . . . . . . . . . . . 131
Starting and stopping the ORB server . . . . . . . . . . . . . . . . . . . . . . 134
Starting and stopping servers in IC Manager . . . . . . . . . . . . . . . . . . 136
Stopping all servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Starting and stopping servers with the IC Admin utility . . . . . . . . . . . . 137
Starting and stopping IC services . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Starting and stopping services on Windows . . . . . . . . . . . . . . . . . . 139
Starting and stopping services on Solaris . . . . . . . . . . . . . . . . . . . . 139
Starting and stopping services on AIX . . . . . . . . . . . . . . . . . . . . . . 142

Chapter 6: Installing IC licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145


Before you configure IC licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Configuring the Web License Manager . . . . . . . . . . . . . . . . . . . . . . . 146

Installation and Configuration March 2012 5


Contents

Hosting multiple Web applications on one system . . . . . . . . . . . . . . . 146


Advanced properties for the Web LM . . . . . . . . . . . . . . . . . . . . . . 147
Viewing license pick usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Configuring the WebLM on Windows . . . . . . . . . . . . . . . . . . . . . . 147
Configuring the WebLM on Solaris . . . . . . . . . . . . . . . . . . . . . . . . 149
Configuring the WebLM on AIX . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Installing the license file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Configuring the License server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Changing the administrative password . . . . . . . . . . . . . . . . . . . . . . . 159
Managing users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Viewing server properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Viewing information about configured licenses . . . . . . . . . . . . . . . . . 160

Chapter 7: Configuring Telephony . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163


Before you configure Telephony . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Configuring the ACD name parameter . . . . . . . . . . . . . . . . . . . . . . . . 164
Creating the Telephony server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Configuring the Telephony server for Avaya Communication Manager . . . . 166
Configuring the Telephony server for Aspect . . . . . . . . . . . . . . . . . . 168
Configuring the Telephony server for Cisco Unified Contact Center . . . . . . . 170
Configuring Telephony Server for SIP . . . . . . . . . . . . . . . . . . . . . . . . 172
Creating a voice queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Creating the Telephony Queue Statistics server . . . . . . . . . . . . . . . . . . 178
Configuring the TSQS server for Avaya Communication Manager . . . . . . 179
Configuring the TSQS server for Aspect . . . . . . . . . . . . . . . . . . . . . 179
Configuring the TSQS server for Cisco Unified Contact Center . . . . . . . . 180
Starting the Telephony servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Configuring a Workflow server for Telephony . . . . . . . . . . . . . . . . . . . . 182
Creating a Workflow server for Telephony. . . . . . . . . . . . . . . . . . . . 183
Configuring the voice channel for the Workflow server . . . . . . . . . . . . 184
Building and loading workflow for Telephony . . . . . . . . . . . . . . . . . . . . 185
Building the Incoming Call workflow . . . . . . . . . . . . . . . . . . . . . . . 186
Loading workflows in the Workflow server . . . . . . . . . . . . . . . . . . . 186
Creating routing hints for the Incoming Call workflow . . . . . . . . . . . . . . . 187

Chapter 8: Configuring Web Management . . . . . . . . . . . . . . . . . . . . . . . . 189


Web Management support for media channels . . . . . . . . . . . . . . . . . . . 190
Before you configure Web Management . . . . . . . . . . . . . . . . . . . . . . . 190
Configuring servers for Web Management . . . . . . . . . . . . . . . . . . . . . 191

6 Installation and Configuration March 2012


Contents

Creating the WebACD server . . . . . . . . . . . . . . . . . . . . . . . . . . . 191


Creating the Attribute server . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Creating the ComHub server . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Creating the Paging server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Starting the Web Management servers. . . . . . . . . . . . . . . . . . . . . . 201
Configuring Web Management services . . . . . . . . . . . . . . . . . . . . . . . 201
Where to configure Web Management services . . . . . . . . . . . . . . . . . 202
Hosting multiple Web applications on one computer . . . . . . . . . . . . . . 202
Setting memory allocation for Web Management services . . . . . . . . . . . 202
Configuring Web Management services on Windows . . . . . . . . . . . . . 203
Configuring Web Management services on Solaris . . . . . . . . . . . . . . . 207
Configuring Web Management services on AIX . . . . . . . . . . . . . . . . . 213
Integrating Web Management Administration . . . . . . . . . . . . . . . . . . . . 218
Integrating Web Management Administration with IC Manager . . . . . . . . 218
Setting the ServerName property - AIX only . . . . . . . . . . . . . . . . . . . 219
Configuring a Workflow server for Web Management . . . . . . . . . . . . . . . 220
Creating a Workflow server for Web Management . . . . . . . . . . . . . . . 220
Creating the chat channel for the Workflow server . . . . . . . . . . . . . . . 221
Using workflows for Web Management . . . . . . . . . . . . . . . . . . . . . . . 223
Workflows required by Web Management . . . . . . . . . . . . . . . . . . . . 223
Reloading the customer management workflows . . . . . . . . . . . . . . . . 224
Configuring routing hints for the Qualify Chat workflow . . . . . . . . . . . . . . 225
Creating routing hints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Associating routing hints with Web Self-Service documents . . . . . . . . . 227
Configuring the ICM server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Configuring the Central Internet Routing service . . . . . . . . . . . . . . . . . . 230
Configuring the Website . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Configuring IIS server on a separate system . . . . . . . . . . . . . . . . . . 234
Configuring Avaya Full Text Search Engine . . . . . . . . . . . . . . . . . . . . . 235
Configuring Avaya FTSE for Windows . . . . . . . . . . . . . . . . . . . . . . 235
Configuring for Avaya FTSE for Sun Solaris . . . . . . . . . . . . . . . . . . 237
Configuring for Avaya FTSE for IBM AIX. . . . . . . . . . . . . . . . . . . . . 241
Configuring Web Scheduled Callback . . . . . . . . . . . . . . . . . . . . . . . . 245
Cautions and tips for configuring Web Scheduled Callback . . . . . . . . . . 245
Creating a Web Scheduled Callback server . . . . . . . . . . . . . . . . . . . 246
Configuring the Website for Web Scheduled Callback . . . . . . . . . . . . . 247
Configuring Agents for Web Schedule Callback . . . . . . . . . . . . . . . . 248
Configuring Voice Chat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Prerequisites for Voice Chat . . . . . . . . . . . . . . . . . . . . . . . . . . . 250

Installation and Configuration March 2012 7


Contents

VoIP Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251


Configure the Workflow server for Voice Chat . . . . . . . . . . . . . . . . . 255
Build and load workflows for Voice Chat . . . . . . . . . . . . . . . . . . . . 257
Configure the Telephony server for Voice Chat . . . . . . . . . . . . . . . . . 259
Configure the Voice Chat gateway . . . . . . . . . . . . . . . . . . . . . . . . 259
Configure the Voice Media Manager server . . . . . . . . . . . . . . . . . . . 261
Configure the Voice Chat workflow table . . . . . . . . . . . . . . . . . . . . 262
Set the startup options for the VMM server . . . . . . . . . . . . . . . . . . . 262
Configuring IC System for Voice Chat . . . . . . . . . . . . . . . . . . . . . . 263
Configuring IIS server for Windows 2008 R2 server . . . . . . . . . . . . . . . . 264
Configuring SSL security for Web servers (optional) . . . . . . . . . . . . . . . . 267
Prerequisites for configuring SSL . . . . . . . . . . . . . . . . . . . . . . . . 267
Modifying the Website configuration . . . . . . . . . . . . . . . . . . . . . . . 268
Configuring the WebACD server . . . . . . . . . . . . . . . . . . . . . . . . . 268
Editing the configuration file . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Modifying the SSL properties . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Configuring SSL for specific tenants. . . . . . . . . . . . . . . . . . . . . . . 270
Modifying tenant properties for SSL . . . . . . . . . . . . . . . . . . . . . . . 270
Setting up a separate administration Website (optional) . . . . . . . . . . . . . . 272
Creating the Web application for the administration website . . . . . . . . . 272
Configuring an administration Website . . . . . . . . . . . . . . . . . . . . . 272
Integrating the administration Website . . . . . . . . . . . . . . . . . . . . . 273
Setting up a separate customer Website (optional) . . . . . . . . . . . . . . . . . 274
Creating the Web application for the customer Website . . . . . . . . . . . . 274
Configuring the customer Website . . . . . . . . . . . . . . . . . . . . . . . . 274
Deploying multiple ICM servers (optional) . . . . . . . . . . . . . . . . . . . . . . 275
Deployment guidelines for an additional ICM server . . . . . . . . . . . . . . 276
Before you configure an additional ICM server . . . . . . . . . . . . . . . . . 276
Configuring an additional ICM server with a CIRS server . . . . . . . . . . . 277
Configuring an independent additional ICM server . . . . . . . . . . . . . . . 280
Adding ICM servers to the ICM Bridge . . . . . . . . . . . . . . . . . . . . . . 281
Refreshing IC Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281

Chapter 9: Configuring Email Management . . . . . . . . . . . . . . . . . . . . . . . 283


Before you configure Email Management . . . . . . . . . . . . . . . . . . . . . . 284
Configuring an IC Poller Server. . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Guidelines for IC Poller Server . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Creating the IC Poller Server . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Configuring an IC Email server . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Guidelines for an IC Email server. . . . . . . . . . . . . . . . . . . . . . . . . 286

8 Installation and Configuration March 2012


Contents

Creating the IC Email server . . . . . . . . . . . . . . . . . . . . . . . . . . . 286


Configuring Email Template Administration . . . . . . . . . . . . . . . . . . . . . 289
Where to configure Email Template Administration . . . . . . . . . . . . . . 290
Hosting multiple Web applications on one computer . . . . . . . . . . . . . . 290
Advanced properties for Email Template Administration. . . . . . . . . . . . 290
Configuring Email Template Administration on Windows . . . . . . . . . . . 291
Configuring Email Template Administration on Solaris . . . . . . . . . . . . 293
Configuring Email Template Administration on AIX . . . . . . . . . . . . . . 295
Configuring a Workflow server for Email Management . . . . . . . . . . . . . . . 297
Creating a Workflow server for Email Management . . . . . . . . . . . . . . . 297
Creating email channels for the Workflow server . . . . . . . . . . . . . . . . 298
Starting the Workflow server . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Using workflows for Email Management . . . . . . . . . . . . . . . . . . . . . . . 303
Configuring Outbound Email Analysis workflows . . . . . . . . . . . . . . . 303
Creating routing hints for email workflows . . . . . . . . . . . . . . . . . . . . . 305
Configuring the WebACD server for Email Management . . . . . . . . . . . . . . 307
Integrating Email Template Administration . . . . . . . . . . . . . . . . . . . . . 308
Configuring email accounts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Configuring the email accounts for SSL . . . . . . . . . . . . . . . . . . . . . 316
Creating an email status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320
Configuring Avaya Content Analyzer (optional) . . . . . . . . . . . . . . . . . . . 321
Creating the Administrative Content Analyzer server. . . . . . . . . . . . . . 321
Creating the Operations Content Analyzer server. . . . . . . . . . . . . . . . 323
Adding a Knowledge Base . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324

Chapter 10: Configuring agent accounts . . . . . . . . . . . . . . . . . . . . . . . . 327


Required permissions for agents. . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Cautions and tips for creating agent accounts . . . . . . . . . . . . . . . . . . . 329
Agent domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Agent workgroups and tenants . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Agent login IDs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Agent password requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Creating an agent account . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Creating an agent account . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Configuring an agent for media channels . . . . . . . . . . . . . . . . . . . . 335
Setting agent properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Setting global properties for all agents . . . . . . . . . . . . . . . . . . . . . 338
Setting properties for individual agents and workgroups . . . . . . . . . . . 338
Configuring agents for Avaya Agent . . . . . . . . . . . . . . . . . . . . . . . . . 339

Installation and Configuration March 2012 9


Contents

Setting agent properties for Avaya Agent . . . . . . . . . . . . . . . . . . . . 340


Configuring agents for the Unified Agent Directory. . . . . . . . . . . . . . . 341
Configuring agents for Avaya Agent Web Client . . . . . . . . . . . . . . . . . . 343
Configuring the working directory property . . . . . . . . . . . . . . . . . . . 343
Configuring agents for the Address Book . . . . . . . . . . . . . . . . . . . . 344
Creating agents for a Client SDK custom application. . . . . . . . . . . . . . . . 345
Configuring the working directory property . . . . . . . . . . . . . . . . . . . 345
Configuring agents for the Address Book . . . . . . . . . . . . . . . . . . . . 347
Configuring a Workflow server for transfers and conferences. . . . . . . . . . . 347
Required configuration parameters . . . . . . . . . . . . . . . . . . . . . . . 348
Working with transfer workflows . . . . . . . . . . . . . . . . . . . . . . . . . 348
Configuring a Workflow server . . . . . . . . . . . . . . . . . . . . . . . . . . 348

Chapter 11: Deploying Avaya Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . 351


Required privileges for the agent installer . . . . . . . . . . . . . . . . . . . . . . 351
Creating installation files for agent applications . . . . . . . . . . . . . . . . . . 351
Cautions and tips for installation files . . . . . . . . . . . . . . . . . . . . . . 352
Required information for the Agent Site Preparation wizard . . . . . . . . . . 354
Running the Avaya Agent site preparation wizard . . . . . . . . . . . . . . . 355
Copying the server implementation file . . . . . . . . . . . . . . . . . . . . . 356
Preparing for installation by agents . . . . . . . . . . . . . . . . . . . . . . . . . 357
Testing the agent installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Creating installation instructions for agents . . . . . . . . . . . . . . . . . . 358
Configuring WebAgent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Locating Application.properties file . . . . . . . . . . . . . . . . . . . . . . . 359
HTML Editor configuration for Rich Client . . . . . . . . . . . . . . . . . . . . 360
Configure converting email message to an attachment . . . . . . . . . . . . 362
Configure auto flush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Configure number of attachments to be displayed without scrollbar . . . . . 362
Configure the default location for saving attachment. . . . . . . . . . . . . . 363
Configure Default Sorting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Configure UTF-8 Encoding . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Configure viewing E-mail templates . . . . . . . . . . . . . . . . . . . . . . . 364
WebAgent HTML Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Hyperlink settings in Configuration XML . . . . . . . . . . . . . . . . . . . . 365
Configure Hyperlink for HTML E-mail . . . . . . . . . . . . . . . . . . . . . . 368
Configuring the Citrix integration . . . . . . . . . . . . . . . . . . . . . . . . . . 368
About the Citrix integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Installing the agent applications on the Citrix server . . . . . . . . . . . . . . 370
Deploying Avaya Agent Rich Client on the Citrix server . . . . . . . . . . . . 370

10 Installation and Configuration March 2012


Contents

Locating the files for the tools . . . . . . . . . . . . . . . . . . . . . . . . . . 371


Configuring the Avaya Agent INI file . . . . . . . . . . . . . . . . . . . . . . . 372
Configuring the IC Web browser tool . . . . . . . . . . . . . . . . . . . . . . 372
Configuring the executable tool . . . . . . . . . . . . . . . . . . . . . . . . . 375
Sequence for using the Avaya tools for Citrix . . . . . . . . . . . . . . . . . . 379
Creating ICA (Citrix Client) connection with Citrix server . . . . . . . . . . . 379

Chapter 12: Installing Avaya Agent Web Client . . . . . . . . . . . . . . . . . . . . . 383


Prerequisites for Avaya Agent Web Client . . . . . . . . . . . . . . . . . . . . . . 384
IC components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
Agent workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
JRE version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Required administrator privileges . . . . . . . . . . . . . . . . . . . . . . . . 385
Working directory property . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
Installing the Avaya Agent Web Client . . . . . . . . . . . . . . . . . . . . . . . . 386
Creating the application WAR file . . . . . . . . . . . . . . . . . . . . . . . . . . 387
Setting up the Java Application Bridge . . . . . . . . . . . . . . . . . . . . . . . 388
Configuring an agent account for the Java Application Bridge . . . . . . . . 388
Creating a Java Application Bridge . . . . . . . . . . . . . . . . . . . . . . . 390
Setting up UNC to UNIX mapping on Solaris only . . . . . . . . . . . . . . . . 392
Setting up UNC to UNIX mapping on AIX only . . . . . . . . . . . . . . . . . . 394
Installing the Avaya Agent Web Client Connector. . . . . . . . . . . . . . . . . . 397
Re-installing Avaya Agent Web Client . . . . . . . . . . . . . . . . . . . . . . . . 398
Modifying the web.xml file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398

Chapter 13: Configuring and Deploying Avaya Agent Web Client . . . . . . . . . . . 399
Before you configure and deploy Avaya Agent Web Client. . . . . . . . . . . . . 399
Configuring Avaya Agent Web Client . . . . . . . . . . . . . . . . . . . . . . . . 399
Basic Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
Deploying the application WAR file . . . . . . . . . . . . . . . . . . . . . . . 400
Run the configuration tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Changing ownership for Avaya Agent Web Client on Solaris only. . . . . . . 402
Changing ownership for Avaya Agent Web Client on AIX only. . . . . . . . . 402
Starting and stopping Avaya Agent Web Client . . . . . . . . . . . . . . . . . 402
Setting the options in Internet Explorer 8.0 . . . . . . . . . . . . . . . . . . . 403
Testing Avaya Agent Web Client . . . . . . . . . . . . . . . . . . . . . . . . . 404
Advance Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Starting the HTTP server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Configuring SSL security for Avaya Agent Web Client (optional) . . . . . . . 406
Verifying the deployment of AAWC. . . . . . . . . . . . . . . . . . . . . . . . . . 406

Installation and Configuration March 2012 11


Contents

Redeploying the application WAR file (optional) . . . . . . . . . . . . . . . . . . 407

Chapter 14: Deploying Client SDK components. . . . . . . . . . . . . . . . . . . . . 409


Before you deploy Client SDK components . . . . . . . . . . . . . . . . . . . . . 409
Installing the Client SDK components . . . . . . . . . . . . . . . . . . . . . . . . 410
Configuring a secondary ORB server environment . . . . . . . . . . . . . . . . . 410
Client SDK files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
Setting up the Java Application Bridge . . . . . . . . . . . . . . . . . . . . . . . 411
Creating an agent account for the Java Application Bridge . . . . . . . . . . 412
Creating a Java Application Bridge . . . . . . . . . . . . . . . . . . . . . . . 413
Configuring Client SDK services . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
Starting and stopping the Client SDK server . . . . . . . . . . . . . . . . . . . . 416
Starting and stopping the Client SDK server on Windows . . . . . . . . . . . 416
Starting and stopping the Client SDK server on Solaris . . . . . . . . . . . . 417
Starting and stopping the Client SDK server on AIX . . . . . . . . . . . . . . 417
Running a sample client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
Optional advanced configuration for the Client SDK server . . . . . . . . . . . . 420
Configuring the log4j files for the Client SDK server (optional) . . . . . . . . 420
Changing default port range (optional) . . . . . . . . . . . . . . . . . . . . . 421
Enabling the Client SDK server for SSL . . . . . . . . . . . . . . . . . . . . . 421

Chapter 15: Deploying Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . 423


Before you deploy Web Services components . . . . . . . . . . . . . . . . . . . 423
Installing the Web Services components . . . . . . . . . . . . . . . . . . . . . . 424
Configuring a secondary ORB server environment . . . . . . . . . . . . . . . . . 424
Web Services files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
Setting up the Web Services Bridge . . . . . . . . . . . . . . . . . . . . . . . . . 424
Creating an agent account for the Web Services Bridge . . . . . . . . . . . . 425
Creating a Web Services Bridge . . . . . . . . . . . . . . . . . . . . . . . . . 426
Configuring Web Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
Starting and stopping the Web Services server . . . . . . . . . . . . . . . . . . . 430
Starting and stopping the Web Services server on Windows . . . . . . . . . 430
Starting and stopping the Web Services server on Solaris . . . . . . . . . . . 430
Starting and stopping the Web Services server on AIX . . . . . . . . . . . . . 431
Enabling the Web Services server for SSL . . . . . . . . . . . . . . . . . . . 431

Appendix A: Configuring a localized version . . . . . . . . . . . . . . . . . . . . . . 433


About localized versions of IC . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
About the NLS Lang setting for Oracle. . . . . . . . . . . . . . . . . . . . . . . . 434

12 Installation and Configuration March 2012


Contents

About the NLS Lang property. . . . . . . . . . . . . . . . . . . . . . . . . . . 435


Where Oracle specifies the NLS Lang property . . . . . . . . . . . . . . . . . 435
Cautions for the NLS Lang property . . . . . . . . . . . . . . . . . . . . . . . 435
NLS Lang settings for supported languages . . . . . . . . . . . . . . . . . . 435
Enabling Database Designer for localization . . . . . . . . . . . . . . . . . . . . 436
Configuring Avaya Agent for a supported language . . . . . . . . . . . . . . . . 438
Configuring IC for multiple languages . . . . . . . . . . . . . . . . . . . . . . . . 439
Importing localized seed data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
Configuring the Website for supported languages . . . . . . . . . . . . . . . . . 440
Setting language properties for agents . . . . . . . . . . . . . . . . . . . . . . . 441
Localizing string table messages. . . . . . . . . . . . . . . . . . . . . . . . . . . 443
Translating string table messages . . . . . . . . . . . . . . . . . . . . . . . . 443
Deleting string table messages . . . . . . . . . . . . . . . . . . . . . . . . . . 443
Configuring a Notification server for alternate email encodings . . . . . . . . . . 444
Configuring an HTTP Connector server for Traditional Chinese . . . . . . . . . . 445
Configuring an HTTP Connector server for Russian . . . . . . . . . . . . . . . . 445
Configuring the Customer HTML Chat Client for Japanese IMEs (optional). . . . 446

Appendix B: Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447


Troubleshooting installation and configuration . . . . . . . . . . . . . . . . . . . 447
Troubleshooting the Configuration Tool . . . . . . . . . . . . . . . . . . . . . . . 450
Troubleshooting the IC servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
Troubleshooting server communication issues . . . . . . . . . . . . . . . . . 452
Troubleshooting the Data server . . . . . . . . . . . . . . . . . . . . . . . . . 453
Troubleshooting the Workflow server . . . . . . . . . . . . . . . . . . . . . . 455
Troubleshooting the Attribute server . . . . . . . . . . . . . . . . . . . . . . 456
Troubleshooting the refresh in IC Manager . . . . . . . . . . . . . . . . . . . . . 456
Troubleshooting Web Management . . . . . . . . . . . . . . . . . . . . . . . . . 457
Troubleshooting the ICM server . . . . . . . . . . . . . . . . . . . . . . . . . 457
Troubleshooting Website pages . . . . . . . . . . . . . . . . . . . . . . . . . 461
Troubleshooting Web Management integration . . . . . . . . . . . . . . . . . 466
Troubleshooting Web Scheduled Callback . . . . . . . . . . . . . . . . . . . 468
Troubleshooting DataWake . . . . . . . . . . . . . . . . . . . . . . . . . . . . 470
Web Management configuration files . . . . . . . . . . . . . . . . . . . . . . 471
ICM server configuration files . . . . . . . . . . . . . . . . . . . . . . . . . . 471
Web Management log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
ICM server log files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
Web Scheduled Callback log files . . . . . . . . . . . . . . . . . . . . . . . . 473
Troubleshooting Avaya FTSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

Installation and Configuration March 2012 13


Contents

Full text search configuration error messages . . . . . . . . . . . . . . . . . 474


Verifying Web Self-Service configuration . . . . . . . . . . . . . . . . . . . . 475
Troubleshooting Web Self-Service pages . . . . . . . . . . . . . . . . . . . . 476
Troubleshooting Avaya Agent and Web Agent issues . . . . . . . . . . . . . . . 477
Troubleshooting Avaya Agent Web Client . . . . . . . . . . . . . . . . . . . . . . 482
Troubleshooting general Avaya Agent Web Client issues . . . . . . . . . . . 482
Troubleshooting the Java Application Bridge . . . . . . . . . . . . . . . . . . 484
Troubleshooting log in issues . . . . . . . . . . . . . . . . . . . . . . . . . . 486
Changing logging levels for Avaya Agent Web Client . . . . . . . . . . . . . 488
Troubleshooting IC Email issues . . . . . . . . . . . . . . . . . . . . . . . . . 489
Changing default service ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
Changing the default ICM service ports . . . . . . . . . . . . . . . . . . . . . 490
Changing default service ports for servers . . . . . . . . . . . . . . . . . . . 491
Troubleshooting Windows configuration . . . . . . . . . . . . . . . . . . . . . . 493
Troubleshooting IIS applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
Uninstalling IC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
Uninstalling IC components on Windows . . . . . . . . . . . . . . . . . . . . 494
Uninstalling IC servers on Solaris . . . . . . . . . . . . . . . . . . . . . . . . 495
Uninstalling IC servers on AIX . . . . . . . . . . . . . . . . . . . . . . . . . . 496
Uninstalling Web server components . . . . . . . . . . . . . . . . . . . . . . 496
Uninstalling related third-party components . . . . . . . . . . . . . . . . . . 497
Uninstalling Avaya Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497
Uninstalling Avaya Agent Web Client . . . . . . . . . . . . . . . . . . . . . . 498

Appendix C: Configuration Tool advanced properties . . . . . . . . . . . . . . . . . 499


Accessing the advanced properties . . . . . . . . . . . . . . . . . . . . . . . . . 499
Format of the advanced properties. . . . . . . . . . . . . . . . . . . . . . . . . . 500
Advanced properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 501
Using the recommended settings for the advanced properties . . . . . . . . . . 502

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

14 Installation and Configuration March 2012


Preface

This section contains the following topics:


l Purpose on page 15
l Audience on page 15
l Related documents on page 16
l Availability on page 16

Purpose
The purpose of this guide is to provide detailed information about how to install and configure an
out-of-the-box Avaya Interaction Center Release 7.3.
Note:
Note: This is a Beta release document. The content is under review and might change.

Audience
This guide is intended primarily for those who use Avaya Interaction Center (IC). You should
use this guide as an information source for:
l Installing all IC components.
l Configuring an out-of-the-box IC system for a development environment, without
customizing.

Installation and Configuration March 2012 15


Preface

Related documents
The following documents in the IC Release 7.3 documentation set are related to the installation
and configuration of an IC system:

Avaya IC Installation Planning and Prerequisites: This document provides information


about the supported third-party platforms and other prerequisites required for Avaya Interaction
Center, including installation information for those platforms. Avaya IC Installation Planning and
Prerequisites also includes planning and deployment information for Avaya Interaction Center.

OA Installation Planning and Prerequisites: This document provides information about the
supported third-party platforms and other prerequisites required for Avaya Operational Analyst,
including installation information for those platforms. OA Installation Planning and Prerequisites
also includes planning and deployment information for Avaya Operational Analyst.

OA Installation and Configuration: This document provides installation information for all
Avaya Operational Analyst components.

Availability
Copies of this document are available on the Avaya support Web site, http://www.avaya.com/
support.
Note:
Note: There is no charge for downloading documents from the Avaya Web site.

16 Installation and Configuration March 2012


Chapter 1: Introduction

Avaya Interaction Center, Release 7.3, a high quality multi-channel contact center continues to
fulfill the existing requirements of earlier release with additional features enhancements in the
installation wizards and ensures a faster installation process.
Avaya IC installation and configuration guide provide information and procedures about how to
install and configure an out-of-the-box IC system.
If your IC system includes any customizations, install a development system first. You must test
your customizing on the development system before you deploy your production system.
This section describes useful information that you should know before you install and configure
an IC system. This section includes the following topics:
l IC installation files on page 17
l Installing IC with Avaya Operational Analyst on page 18
l Customizing IC on page 19

IC installation files
The application and documentation files for the Avaya Interaction Center (Avaya IC) 7.3 release
are available on http//www.avaya.com/support.
Avaya Interaction Center (IC) provides the installation files on the CD/DVD-ROMs as described
in the following table.

Installation and Configuration March 2012 17


Chapter 1: Introduction

Installing IC with Avaya Operational Analyst


Avaya Operational Analyst (OA) provides reporting functionality for IC.
This section includes the following topics:
l Installation order on page 18.
l Database properties on page 19.

Installation order
You must follow the correct installation order to ensure that IC Repository is correctly configured
for both IC and OA.
Install and configure the components of IC and OA in the following order:
1. Install and configure all prerequisites in the following documentation, including the
installation of your database software and the creation of your database instance:
a. For IC, see Avaya IC Installation Planning and Prerequisites.
b. For OA, see Operational Analyst Installation Planning and Prerequisites.
2. Install the IC servers and administration components, as described in Installing IC server
and administration components on page 28.
3. Configure the additional IC components required for the deployment, as described in this
manual.
4. Install and configure OA for IC, as described in Operational Analyst Installation and
Configuration.

18 Installation and Configuration March 2012


Customizing IC

Database properties
Both IC and OA require access to the IC Repository database.
IC and OA use the values shown in the following table for their database properties.

Property DB2 Oracle SQL Server

Database Administration db2inst1 sys sa level user name


Login
Database Administration db2inst1 password sys password sa level password
Password
IC Repository database Database schema Database name for Database name that
name name that you enter the Oracle user that you enter in
See Configuring the IC in Database you enter in Database Designer.
Repository database Designer. For Database Designer. For example,
connection on page 77. example, For example, repository.
repository. repository.

Customizing IC
If your IC system includes customizing requirements, use this guide to install a development
system. Use the development system to test and, if required, customize your IC system.
For more information on how to customize IC components, see the other documentation in the
IC documentation set. The introduction provided on the IC documentation includes a complete
description of all documentation in the IC documentation set.
The following table describes some of the IC documentation that you can use to customize an
IC system.

IC Component Documents

Avaya Agent l Avaya Agent Integration


l Interaction Center Administration Guide
Avaya Agent Web Client l Avaya Agent Web Client Customization
l Interaction Center Administration Guide
IC databases and data models l IC Database Designer Application Reference
l Data Model files
Client SDK l Avaya IC Client SDK Programmer Guide

Installation and Configuration March 2012 19


Chapter 1: Introduction

IC Component Documents

Servers l Interaction Center Administration Guide


l Agent Data Unit Server Programmer Guide
l Electronic Data Unit Server Programmer Guide
l Avaya IC Telephony Connectors Programmer
Guide
l Core Services Programmer Guide
l Avaya IC Client and Server Programmer Design
Guide
l Avaya IC Integration with VP / IR
Telephony l Interaction Center Administration Guide
l Avaya IC Telephony Connectors Programmer
Guide
l Avaya IC Integration with VP / IR
l External Function Library for Avaya IVR
l IC/OA Software Upgrade and Data Migration
Web Services l Avaya IC Web Services Programmer Guide
Workflows l Avaya IC Workflow Designer User Guide
l Avaya IC Workflow API Reference
l Avaya IC Media Workflow Reference
l Agent Script Workflow Reference
l Avaya IC Scripts Language Reference
l Avaya IC Scripts VBA Scripting Reference
Avaya Business Advocate l IC Business Advocate Configuration and
Administration
l Avaya IC Media Workflow Reference
IC for Siebel 8.0.0.5, 8.1.1.0, 8.1.1.3, l Avaya IC for Siebel 8 Integration
8.1.1.4, 8.1.1.5, and 8.1.1.6

20 Installation and Configuration March 2012


Chapter 2: Installing IC components

Install and configure the IC components in the order of topics appearing in this section. For
example, install and configure the primary servers before you install and configure the Design
and Administration Tools.
This section includes the following topics:
l Before you install IC on page 22
l Cautions and tips for installing IC components on page 25
l Installing IC server and administration components on page 28
l Configuring the ORB server environment on page 34
l Changing ownership for IC on Solaris only on page 39
l Changing ownership for IC on AIX only on page 41
l Setting up Business Advocate on page 42
l Installing the IC server SDK on page 54
l Upgrading IC on page 55
l Reinstalling IC components on page 55
l Upgrading Daylight Saving Time (DST) patches on page 56

! CAUTION:
CAUTION: Do not install IC on computers that also host software that filters or controls
network access. These types of software can cause IC to fail or seriously impact
performance. For example, Website filters or software firewalls can affect network
access in several ways. They can cause a slowdown in network access, cause
applications that open a large number of sockets to fail, or rewrite packets.
For information about deploying IC agent applications, see:
l Deploying Avaya Agent on page 351
l Installing Avaya Agent Web Client on page 383
l Deploying Client SDK components on page 409

Installation and Configuration March 2012 21


Chapter 2: Installing IC components

Before you install IC


This section describes the steps that you must perform before you install IC components. This
section includes the following topics:
l Readme files on page 22
l IC prerequisites on page 22
l License file on page 22
l Required administrator privileges on page 23
l Hosting servers on Solaris on page 24
l Hosting servers on AIX on page 24
l Disable Java automatic downloading and updating on page 25

Readme files
Read the following IC readme files on the CRM Technical Support Web site at http://
www.avaya.com/support/:
l IC Readme file

IC prerequisites
Read the Avaya IC Installation Planning and Prerequisites and install all prerequisite
components.

License file
Obtain the necessary IC license file for your IC system. For more information, see Avaya IC
Installation Planning and Prerequisites.

22 Installation and Configuration March 2012


Before you install IC

Required administrator privileges


All IC users who perform certain tasks require administrator privileges. This section includes the
following topics that describe the administrator privileges required for the different operating
systems:
l Required administrator privileges for Windows on page 23
l Required administrator privileges for Solaris on page 23
l Required administrator privileges for AIX on page 24

Required administrator privileges for Windows


All IC users who perform the following tasks must have a Windows Administrator login or a
Windows login with administrator privileges.
l Install and configure IC servers
l Install or use Design & Administration Tools

Required administrator privileges for Solaris


All IC users who install and configure IC servers require one of the following UNIX accounts,
depending upon which tasks they need to perform.

Root user: You need this account when you:


l Install IC on a computer that will host a Telephony server for an Avaya switch with
Communication Manager.
l Configure the Web applications with the Configuration Tool, including the Web site, Email
Template Administration, and Web License Manager.

Installation user: Use this account to perform all the tasks to configure IC that does not require
the root user. The IC installation directory must be owned by this account.
For example, you can create an installation user account named avaya.

! Important:
Important: If you do not use a root account to install Avaya IC servers on a computer, and
need to configure that computer with a Telephony server for an Avaya switch with
Communication Manager software, reinstall the Avaya IC servers using the root
account.

Installation and Configuration March 2012 23


Chapter 2: Installing IC components

Required administrator privileges for AIX


All IC users who install and configure IC servers require one of the following UNIX accounts,
depending upon which tasks they need to perform.

Root user: You need this account when you:


l Install IC on a computer that will host a Telephony server for an Avaya switch with
Communication Manager.
l Configure the Web applications with the Configuration Tool, including the Web site, Email
Template Administration, and Web License Manager.

Installation user: Use this account to perform all the tasks to configure IC that does not require
the root user. The IC installation directory must be owned by this account.
For example, you can create an installation user account named avaya.

! Important:
Important: If you do not use a root account to install Avaya IC servers on a computer, and
need to configure that computer with a Telephony server for an Avaya switch with
Communication Manager software, reinstall the Avaya IC servers using the root
account.

Hosting servers on Solaris


If you host your servers on Solaris:
l Install a Windowing environment, such as X-Windows.
l Set the DISPLAY parameter.
l Make sure that the server has sufficient space in the /var/tmp directory for installing
Java Virtual Machine. The IC installer requires at least 2048 MB of extra temporary space.
l Install appropriate locales for languages supported by your system. For more information
about the required locales, see Avaya IC Installation Planning and Prerequisites.

Hosting servers on AIX


If you host your servers on AIX:
l Install a Windowing environment, such as X-Windows.
l Set the DISPLAY parameter.
l Make sure that the server has sufficient space in the /tmp directory for installing Java
Virtual Machine. The IC installer requires at least 2048 MB of extra temp space.

24 Installation and Configuration March 2012


Cautions and tips for installing IC components

l Install appropriate locales for languages supported by your system. For more information
about the required locales, see Avaya IC Installation Planning and Prerequisites.

Disable Java automatic downloading and updating


All IC users who install and configure IC components are required to disable the automatic
updating options for java. Perform the following steps:
Note:
Note: For details on the supported version of Java JRE refer to the Avaya IC Installation
Planning and Prerequisites guide.
1. From the Windows Control Panel, run the Java program.
The Java Control Panel window opens.
2. On the Update tab, clear the Check for Updates Automatically check box.
3. Click the Advanced tab.
4. Expand the JRE Auto-Download node.
5. Select Never Auto-Download option.
6. Click OK.

Cautions and tips for installing IC components


This section includes some important cautions and tips that you need to consider when you
install IC components.
This section includes the following topics:
l Cautions and tips for installing IC servers on page 25
l Cautions and tips for Design and Administration Tools on page 26

Cautions and tips for installing IC servers


Consider the following important cautions and tips when you install IC servers:
l Required disk space on page 26
l HP Openview on page 26
l Installation mode on page 26

Installation and Configuration March 2012 25


Chapter 2: Installing IC components

l Backup configuration files on page 26

Required disk space


Ensure that you have sufficient disk space on the target system to install selected files. The IC
installation does not check the free disk space available on your computer until you select the
components to install. For details on the required disk space for IC installation, refer to the
Avaya IC Installation Planning and Prerequisites guide.

HP Openview
If you are installing ORB server on a computer that already hosts HP Openview, you must
turned off the HP Openview before installing ORB server. HP Openview may prevent the Avaya
IC installer from copying all the required files to the IC_INSTALL_DIR\IC73\bin directory.
In the Windows environment, you can turn off HP Openview by stopping the HP ITO Agent
service from the Windows Services control panel.

Tip:
Tip: You can open Windows Services control panel by running the services.msc
command.
For more information about HP Openview, see the documentation provided by HP.

Installation mode
All Avaya IC installers can run in GUI, Console, and Silent mode. GUI is the default installation
mode for all the installers.

Backup configuration files


The IC installer backs up the configuration files in the following directory before making any
changes to those files:IC_INSTALL_DIR\IC73\bin\config\backup.

Cautions and tips for Design and Administration Tools


Consider the following important cautions and tips when you install and use the IC Design and
Administration Tools.
l Components installed with Design and Administration Tools on page 27
l Design and Administration systems on page 27
l Supported operating systems on page 27
l Running multiple instances of IC Manager on page 27

26 Installation and Configuration March 2012


Cautions and tips for installing IC components

Components installed with Design and Administration Tools


IC installs all the Design and Administration Tools on the target system. You cannot select
individual tools to install.
The tools and files that Avaya IC installs with the Design and Administration Tools are:
l IC Manager
l Avaya Workflow Designer with blocks, sample workflows, and related files
l Avaya Database Designer with the Avaya IC Script Editor, design files, and related files
l ICDoctor
l LogCollector
l Config Accelerator

Design and Administration systems


IC Manager and other administrative applications can potentially consume a significant amount
of CPU resources. To ensure that the requirements of IC Manager do not interfere with the
performance of your IC servers, deploy your Design and Administration Tools on a dedicated
system.

Supported operating systems


Design and Administration Tools work only on a supported Windows operating system. For
more information, see Avaya IC Installation Planning and Prerequisites.

Running multiple instances of IC Manager


IC Manager does not support concurrent administration. When an administrator selects and
updates a record, such as a server or an agent, IC Manager does not lock that record. Another
administrator can open and update the same record.

! CAUTION:
CAUTION: Simultaneous administration of servers, domains, and Directory server tables in
more than one IC Manager can cause corruption of the configuration files and
loss of configuration data.
If you plan to have more than one instance of IC Manager, you must clearly define the
administrative policies for IC. For example:
l Use only one instance of IC Manager at a time to administer servers.
l Determine which IC elements an administrator can update, and assign the appropriate
permissions to the login ID for that administrator.

Installation and Configuration March 2012 27


Chapter 2: Installing IC components

l Do not allow administrators to log in to more than one instance of IC Manager with the
same login ID and password.
For more information about multiple instances of IC Manager, see Interaction Center
Administration Guide.

Installing IC server and administration components

Tip:
Tip: For information about the components on each IC CD/DVD-ROM, see IC
installation files on page 17.
This section includes the following topics:
l Installing IC server and administration components on Windows Server 2008 R2 on
page 28
l Installing IC components on Solaris on page 30
l Installing IC components on AIX on page 32

Installing IC server and administration components on Windows


Server 2008 R2
You can install only one component at a time with the IC Windows Servers, Administration
installer. You cannot select multiple components to install simultaneously.
To install IC server and administration components on Windows
1. Log in to the computer with an account that has the required Administrator privileges.
2. Downloading and installing the setup file from the CD/DVD-ROM:
a. Insert IC Release 7.3 CD/DVD-ROM 1.
b. From the CD/DVD-ROM double click the install.html file.
c. The Internet Explorer window opens with Welcome page and a button to download
the installer.
d. Click the Download Installer for Windows button.
The File Download dialog box opens with options for running or saving the installer.
e. Click Run to run the installer from the server.
OR
Click Save to first save the installer on your local computer and then run it.

28 Installation and Configuration March 2012


Installing IC server and administration components

3. When the IC installer opens, read the entire IC license agreement carefully, then accept
the terms of the agreement. Select Next, then follow the prompts in the installer.
Note:
Note: The IC installer exits if you do not agree to the terms of the agreement.
4. In the Choose Install Folder, Click Next. The default installation folder is D:\Avaya if D drive
exists, else the drive letter will be C:\Avaya.
5. In the Product Installation screen, select one of the options from the following table to
install the required component:

Option Installation location Files Installed

Core Servers Core server computers l IC core servers


l Avaya Full Text Search
Engine
l Web Scheduled Callback
l Business Advocate servers
and Administrative Client
l Client SDK components
l Web Services components
l SDK Server
l ConfigTools
IC Design and Design and l IC Manager
Administration Tools administration l Business Advocate
computer Administrative Client
l Database Designer
l Workflow Designer
l ICDoctor
l LogCollector
l Config Accelerator
l ConfigTools
Avaya Agent Web Avaya Agent Web l Vesp and DCO bridges
Connector Connector computer l ConfigTools

Note:
Note: The Visual C++ Redistributable Installation dialog box appears. Click Yes to
install the Visual C++ runtime libraries. VCRedist is a Microsoft re-distributable
package ‘Visual C++ 2005 SP1(MFC security update)’ that installs Visual C++
runtime libraries required to run IC. If Visual C++ 2005 SP1 or a later is already
installed by another application, this installation can be skipped. Click No to skip
VCRedist package installation.

Installation and Configuration March 2012 29


Chapter 2: Installing IC components

6. Continue to follow the prompts in the IC installer.


The IC installer can take several minutes to copy the requested files to the system. If the
target system does not have sufficient space to install the components, the IC installer
displays an error message.
7. The installer displays a message after installing IC successfully.
8. The next step in the IC installation depends upon the components you want to host on the
target system. Perform one of the following steps:

Type of configuration Location of steps

Primary ORB server system Configuring the primary ORB server


environment on page 35
Secondary ORB server system, Configuring a secondary ORB server
including Client SDK server system environment on page 37
Design & Administration
Avaya Agent Web Client Installing Avaya Agent Web Client on
page 383

Note:
Note: Verify that the AVAYA_IC73_HOME environment variable is correctly set to
IC_INSTALL_DIR\IC73\.

Installing IC components on Solaris

! CAUTION:
CAUTION: Do not install IC servers on Solaris if you have not yet installed the appropriate
locales for Solaris operating system. For more information about the required
locales, see Avaya IC Installation Planning and Prerequisites.
You can install only one component at a time with the IC Solaris Servers installer. You cannot
select multiple components to install simultaneously.
To install IC server components on Solaris:
1. Log in to the computer with an account with the required Administrator privileges.
2. Download the installer for solaris:
1. Insert IC Release 7.3 CD/DVD-ROM 2 for Solaris servers.
2. From the CD/DVD-ROM double click the install.html file.
The browser window opens with Welcome page and a button to download the
installer.

30 Installation and Configuration March 2012


Installing IC server and administration components

3. Click the Download Installer for Solaris SPARC button for downloading the Solaris
installer:
The system displays the File Download dialog box with options for running or saving
the installer.
4. Click Run to run the installer from the server.
OR
5. Click Save to first save the installer on your local computer and then run it.

Tip:
Tip: If Avaya IC installer does not start automatically, follow the instructions given on
the Welcome screen.
3. When the IC installer opens, read the entire IC license agreement carefully, then accept
the terms of the agreement. Select Next, then follow the prompts in the installer.
Note:
Note: The IC installer exits if you do not agree to the terms of the agreement.
4. In the Product Installation screen, select one of the options in the following table to install
the required component:

Option Location Files Installed

Core Servers Core server system l IC core servers


l Avaya Full Text Search Engine
l Web Scheduled Callback
l Business Advocate Telephony
Services Adaptor and Web
Advocate Adaptor servers only
l Client SDK components
l Web Services components
l SDK Server
l ConfigTools
Avaya Agent Web Avaya Agent Web l Vesp and DCO bridges
Connector Connector l ConfigTools
computer

Installation and Configuration March 2012 31


Chapter 2: Installing IC components

5. Continue to follow the prompts in the IC installer.


The IC installer can take several minutes to copy the requested files to the computer. If the
target system does not have sufficient space to install the components, the IC installer
displays an error message.
6. The next step in the IC installation depends upon the components you want to host on the
target system. Perform one of the following steps:

System Steps

Primary ORB server Configuring the primary ORB server


computer environment on page 35
Secondary ORB server Configuring a secondary ORB server
computer, including Client environment on page 37
SDK server computer
Avaya Agent Web Client Installing Avaya Agent Web Client on page 383

Note:
Note: Verify that the AVAYA_IC73_HOME environment variable is correctly set to
IC_INSTALL_DIR/IC73/. Set the environment variable if not already set.

Installing IC components on AIX

! CAUTION:
CAUTION: Do not install IC servers on AIX if you have not yet installed the appropriate
locales for AIX operating system. For more information about the required
locales, see Avaya IC Installation Planning and Prerequisites.
You can install only one component at a time with the IC AIX Servers installer. You cannot select
multiple components to install simultaneously.
To install IC server components on AIX:
1. Log in to the computer with an account with the required Administrator privileges.
2. Download the installer for AIX:
1. Insert IC Release 7.3 CD/DVD-ROM 3 for AIX servers.
2. From the CD/DVD-ROM double click the install.html file.
The browser window opens with Welcome page and a button to download the
installer.
3. Click the Download Installer for AIX button for downloading the AIX installer.
The system displays the File Download dialog box with options for running or saving
the installer.

32 Installation and Configuration March 2012


Installing IC server and administration components

4. Click Run to run the installer from the server.


OR
5. Click Save to first save the installer on your local computer and then run it.

Tip:
Tip: If Avaya IC installer does not start automatically, follow the instructions given on
the Welcome screen.
3. When the IC installer opens, read the entire IC license agreement carefully, then accept
the terms of the agreement. Click Next, then follow the prompts in the installer.
Note:
Note: The IC installer exits if you do not agree to the terms of the agreement.
4. In the Product Installation screen, select one of the options in the following table to install
the required component:

Option Location Files Installed

Core Servers Core server system l IC core servers


l Avaya Full Text Search Engine
l Web Scheduled Callback
l Business Advocate Telephony
Services Adaptor and Web
Advocate Adaptor servers only
l Client SDK components
l Web Services components
l SDK Server
l ConfigTools
Avaya Agent Web Avaya Agent Web l Vesp and DCO bridges
Connector Connector l ConfigTools
computer

Installation and Configuration March 2012 33


Chapter 2: Installing IC components

5. Continue to follow the prompts in the IC installer.


The IC installer can take several minutes to copy the requested files to the computer. If the
target system does not have sufficient space to install the components, the IC installer
displays an error message.
6. The next step in the IC installation depends upon the components you want to host on the
target system. Perform one of the following steps:

System Steps

Primary ORB server Configuring the primary ORB server


computer environment on page 35
Secondary ORB server Configuring a secondary ORB server
computer, including Client environment on page 37
SDK server computer
Avaya Agent Web Client Installing Avaya Agent Web Client on page 383

Note:
Note: Verify that the AVAYA_IC73_HOME environment variable is correctly set to
IC_INSTALL_DIR/IC73/. Set the environment variable if not already set.

Configuring the ORB server environment


! Important:
Important: Only for Solaris, the Configuration Tool changes the ownership of the
implementation file (vesp.imp) and the interface file (vespidl.pk) to root. If you do
not want to run IC as root, you must change the ownership of these files. For
more information, see Changing ownership for IC on Solaris only on page 39.

! Important:
Important: Only for AIX, the Configuration Tool changes the ownership of the implementation
file (vesp.imp) and the interface file (vespidl.pk) to root. If you do not want to run
IC as root, you must change the ownership of these files. For more information,
see Changing ownership for IC on AIX only on page 41.
You must run the Configuration Tool on every computer that hosts an ORB server to create a
server environment. The configuration mode that you select in the installer depends upon the
type of ORB server that you plan to host on the computer.
The computer that hosts the primary ORB server requires a primary server environment. All
other computers require a secondary server environment.

34 Installation and Configuration March 2012


Configuring the ORB server environment

This section includes the following topics:


l Configuring the primary ORB server environment on page 35
l Configuring a secondary ORB server environment on page 37

Configuring the primary ORB server environment


This procedure continues from Installing IC server and administration components on page 28.
To configure the primary server environment
1. In the Configuration Tool, click the Initial Configuration tab.
2. From the Select Mode drop-down list, select Primary.
3. Confirm that the IP address in the IP Address drop-down list is the correct IP address for
the computer that hosts the primary ORB server.

! Important:
Important: If the primary ORB server runs on a computer with multiple network interface
cards, you must select the IP address for the first network interface card on the
computer. The primary ORB server cannot run on any other network interface
card.
4. Ensure the port assignment in the Start Port field is an available port on the target system.
Type a new port assignment if necessary.
5. Click Start ORB Server.
6. If the computer is hosting a Telephony server:
a. Select and check the Telephony Switch box.
b. From the Telephony Switch drop-down list, select the name of the switch with which
the Telephony server will communicate.
The Telephony server must communicate with a switch that is supported for the
operating system of the computer. For example, do not select a Nortel switch if you
plan to host the Telephony server on an AIX system. For more information about
switch support, see Avaya IC Installation Planning and Prerequisites.
7. If the IC system includes an Oracle database:
a. Select and check the Oracle Setup box.
b. Type the NLS Lang parameter in the NLS Lang field to specify the character set of the
database.
The NLS Lang setting must match the value used to create the Oracle database. This
value must include UTF8. For example, if your database uses US English language
conventions, enter AMERICAN_AMERICA.UTF8. For more information, see About the
NLS Lang setting for Oracle on page 434.

Installation and Configuration March 2012 35


Chapter 2: Installing IC components

c. Type the home directory of the Oracle client on the system that hosts the core servers
in the Oracle Home field.
For example, type /opt/oracle/Ora_ic
d. For Oracle databases only on Solaris, type the Oracle SID of the database in the
Oracle SID field.
For example, type icutf8db. The Oracle SID field is case-sensitive.
e. For Oracle databases only on Solaris, select the correct version of Oracle from the
Oracle Version field.
8. If the IC system includes a DB2 database:
a. Select and check the DB2 Setup box.
b. Type the home directory of the DB2 client on the computer that hosts the core servers
in the DB2 Home field.
For example, type /usr/lpp/db2_ic
c. Type the name of the DB2 instance in the DB2 Instance field.
For example, type db2inst1
9. If you host the servers on Solaris, select the primary locale from the Locale drop-down list.
The drop-down list includes all of the locales supported by the operating system. For
example, if your servers use an English locale, select en_US.UTF-8.
10. If you host the servers on AIX, select the primary locale from the Locale drop-down list.
The drop-down list includes all of the locales supported by the operating system. For
example, if your servers use an English locale, select en_US.
11. Click Apply Settings in the Configuration Tool to configure and start the core servers.
12. Click OK.
13. Click Exit.
The Configuration Tool closes and returns you to the Avaya IC installer.
14. In the IC installer, follow the prompts.
For Windows, if you leave the View Readme field checked, the IC Readme opens in
Adobe Acrobat. After you have reviewed the Readme, close Acrobat to return to the IC
installer.
On Solaris, the Readme is available on the CD/DVD-ROM.
On AIX, the Readme is available on the CD/DVD-ROM.

36 Installation and Configuration March 2012


Configuring the ORB server environment

15. The next step in the IC installation depends upon the components you want to host on the
target computer. Perform one of the following steps:

Type of servers Location of steps

Core servers without Business Configuring databases on page 65


Advocate
Core servers with Business Setting up Business Advocate on page 42
Advocate
Client SDK server components Deploying Client SDK components on
page 409

Configuring a secondary ORB server environment


This procedure continues from Installing IC server and administration components on page 28.
To configure the secondary server environment
1. In the Configuration Tool, click the Initial Configuration tab.
2. From the Select Mode drop-down list, select Secondary.
3. Confirm that the IP address in the IP Address drop-down list is the correct IP address for
the computer that hosts the secondary ORB server.

! Important:
Important: If the secondary ORB server runs on a computer with multiple network interface
cards, you must select the IP address for the first network interface card on the
computer. The ORB server cannot run on any other network interface card.
4. Make sure the port assignment in the Secondary ORB Port field is an available port on
the target computer. Type a new port assignment if necessary.
5. In the Primary Host Name field, type the IP Address or the fully-qualified domain name of
the computer that hosts the primary ORB server.
6. In the Primary ORB Port field, confirm that the port is the one you configured for the
primary ORB server.
7. In the IC Login field, type the administrative login ID that will run the Avaya IC servers.
For more information, see Setting up administrative accounts on page 102.
8. In the IC Password field, type the password associated with the IC Login.
9. In the IC Domain field, type the name of the IC domain that includes the primary ORB
server. This domain is typically the Default domain.
10. Select Start ORB Server.

Installation and Configuration March 2012 37


Chapter 2: Installing IC components

11. If the computer is hosting a Telephony server:


a. Select and check the Telephony Switch box.
b. From the Telephony Switch drop-down list, select the name of the switch with which
the Telephony server will communicate.
The Telephony server must communicate with a switch that is supported for the
operating system of the system. For example, do not select a Nortel switch if you plan
to host the Telephony server on an AIX system. For more information about switch
support, see Avaya IC Installation Planning and Prerequisites.
12. If the IC system includes an Oracle database:
a. Select and check the Oracle Setup box.
b. Type the NLS Lang parameter in the NLS Lang field to specify the character set of the
database.
The NLS Lang setting must match the value used to create the Oracle database. This
value must include UTF8. For example, if your database uses US English language
conventions, enter AMERICAN_AMERICA.UTF8. For more information, see About the
NLS Lang setting for Oracle on page 434.
c. Type the home directory of the Oracle client on the computer that hosts the core
servers in the Oracle Home field.
For example, type /opt/oracle/Ora_ic
d. For Oracle databases only on Solaris, type the Oracle SID of the database in the
Oracle SID field.
For example, type icutf8db. The Oracle SID field is case-sensitive.
e. For Oracle databases only on Solaris, select the correct version of Oracle from the
Oracle Version field.
13. If the IC system includes a DB2 database:
a. Select and check the DB2 Setup box.
b. Type the home directory of the DB2 client on the computer that hosts the core servers
in the DB2 Home field.
For example, type /usr/lpp/db2_ic
c. Type the name of the DB2 instance in the DB2 Instance field.
For example, type db2inst1
14. If you host the servers on Solaris, select the primary locale from the Locale drop-down list.
The drop-down list includes all of the locales supported by the operating system. For
example, if your servers use an English locale, select en_US.UTF-8.
15. If you host the servers on AIX, select the primary locale from the Locale drop-down list.
The drop-down list includes all of the locales supported by the operating system. For
example, if your servers use an English locale, select en_US.

38 Installation and Configuration March 2012


Changing ownership for IC on Solaris only

16. Click Apply Settings in the Configuration Tool to configure and start the core servers.
17. Click OK.
18. Click Exit.
The Configuration Tool closes and returns you to the Avaya IC installer.
19. In the IC installer, follow the prompts.
For Windows, if you leave the View Readme field checked, the IC Readme opens in
Adobe Acrobat. After you have reviewed the Readme, close Acrobat to return to the IC
installer.
On Solaris, the Readme is available on the CD/DVD-ROM.
On AIX, the Readme is available on the CD/DVD-ROM.
20. The next step in the IC installation depends upon the components you want to host on the
target system. Perform one of the following steps:

Type of servers Location of steps

Core servers without Business Configuring databases on page 65


Advocate
Core servers with Business Setting up Business Advocate on page 42
Advocate
Client SDK server components Deploying Client SDK components on
page 409

Changing ownership for IC on Solaris only


If you installed IC as the root user and do not want to run IC servers and services as root in your
Solaris system, you need to change the ownership of the Avaya IC directories and files.

! Important:
Important: Users must avoid running IC software as the root user wherever possible for
security reasons. Create a user for the IC system before you perform these steps.
For more information, see Avaya IC Installation Planning and Prerequisites.
This section includes the following steps that you must perform if you do not want to run IC as
root:
1. Changing ownership of the IC directories and files on page 40
2. Changing ownership for Telephony server on Solaris with Avaya switch only on page 40

Installation and Configuration March 2012 39


Chapter 2: Installing IC components

Changing ownership of the IC directories and files


To change ownership of the IC directories and files:
1. Log in as root user.
2. Navigate to IC_INSTALL_DIR/IC73/bin.
3. Shutdown all IC servers. For more information, see Stopping all servers on page 136.
4. Navigate to the parent directory of IC_INSTALL_DIR/IC73/.
5. Execute the following command:
chown -R <avayauser>:<avayagroup> IC73
where <avayauser> represents the non-root user that you use to run the IC components
and <avayagroup> is the primary group for <avayauser>.
6. Switch to <avayauser> and restart the IC servers. For more information, see Starting and
stopping servers in IC Manager on page 136.

Changing ownership for Telephony server on Solaris with Avaya


switch only
For a Solaris system that includes an Avaya switch with Communication Manager, change the
ownership of every Telephony server.
You configure the SUID bit and root ownership to ensure that the Telephony server for the
Avaya switch can start up as the root user to enable agent event reporting. The Telephony
server resets its process user ID to <avayauser> immediately after startup.
To change ownership for the Telephony server on Solaris
1. Log in as root user.
2. Navigate to IC_INSTALL_DIR/IC73/bin.
3. Execute the following command:
chown root cvlansrv
4. Execute the following command to verify that the SUID bit is set on cvlansrv:
ls -l cvlansrv
5. Execute the following command:
crle -s IC_INSTALL_DIR/IC73/lib

40 Installation and Configuration March 2012


Changing ownership for IC on AIX only

Changing ownership for IC on AIX only


If you installed IC as the root user and do not want to run IC servers and services as root in your
AIX system, you need to change the ownership of the Avaya IC directories and files.

! Important:
Important: Users must avoid running IC software as the root user wherever possible for
security reasons. Create a user for the IC system before you perform these steps.
For more information, see Avaya IC Installation Planning and Prerequisites.
This section includes the following steps that you must perform if you do not want to run IC as
root:
1. Changing ownership of the IC directories and files on page 41
2. Changing ownership for Telephony server on AIX with Avaya switch only on page 42

Changing ownership of the IC directories and files


To change ownership of the IC directories and files:
1. Log in as root user.
2. Navigate to IC_INSTALL_DIR/IC73/bin.
3. Shutdown all IC servers. For more information, see Stopping all servers on page 136.
4. Navigate to the parent directory of IC_INSTALL_DIR/IC73/.
5. Execute the following command:
chown -R <avayauser>:<avayagroup> IC73
where <avayauser> represents the non-root user that you use to run the IC components
and <avayagroup> is the primary group for <avayauser>.
6. Switch to <avayauser> and restart the IC servers. For more information, see Starting and
stopping servers in IC Manager on page 136.

Installation and Configuration March 2012 41


Chapter 2: Installing IC components

Changing ownership for Telephony server on AIX with Avaya


switch only
For an AIX system that includes an Avaya switch with Communication Manager software,
change the ownership of every Telephony server.
During the IC installation, the SUID bit is automatically set to give root ownership to the
Telephony server for the Avaya switch. Root ownership is not required on AIX.
To remove the root permissions
1. Log in as root user.
2. Navigate to IC_INSTALL_DIR/IC73/bin.
3. Execute the following command:
chmod u-s cvlansrv
4. Execute the following command to verify that the SUID bit is not set on cvlansrv:
ls -l cvlansrv

Setting up Business Advocate


This section includes the following topics:
l Required administrator privileges for Business Advocate on page 43
l Prerequisites for Business Advocate on page 43
l Sharing the Nethome directory on page 44
l Configuring a Business Advocate environment on page 44
l Building the database schema for the first Logical Resource Manager on page 45
l Building the database schema for an additional Logical Resource Manager on page 49
l Verifying permissions for running OA ECB with Business Advocate on page 52
l Installing Advocate Component Manager on a separate system on page 52
For information about Business Advocate components and how to configure Business
Advocate, see IC Business Advocate Configuration and Administration.

! Important:
Important: The Resource Manager server and Resource Manager components support the
Windows 2008 R2 server operating system only. For more information, see
Avaya IC Installation Planning and Prerequisites.

42 Installation and Configuration March 2012


Setting up Business Advocate

Required administrator privileges for Business Advocate


The following table describes the administrator privileges required to install, configure, and run
Business Advocate components on server systems

Implementation mode Required administrator privileges

Workgroup mode Administrative user with "Logon as Service" privileges


Active Directory mode Active Directory user with local server administrator rights and
"Logon as Service" privileges

Note:
Note: To install the Business Advocate components on Windows 7 or Windows 2008 R2
operating system, you must be logged in as a Local Administrator or Domain
Administrator.

Prerequisites for Business Advocate


You can set up Business Advocate only if you complete all the prerequisites including the
installation of Avaya IC.
Before you install Business Advocate components, do the following:
1. Complete all prerequisites for Business Advocate, as described in Avaya IC Installation
Planning and Prerequisites.
2. Install the IC server and administration components on a target computer. For more
information, see Installing IC server and administration components on page 28.

Tip:
Tip: For Business Advocate systems that include Standby Resource Manager servers
or Administration Tools on a remote server from the Resource Manager server,
see Avaya IC Installation Planning and Prerequisites for additional configuration
details.

Installation and Configuration March 2012 43


Chapter 2: Installing IC components

Sharing the Nethome directory


The IC Windows installer creates the Nethome directory for Business Advocate. On a computer
that is hosting the first Logical Resource Manager, you must share the Nethome directory with
the required privileges for Business Advocate to function correctly.
To share the Nethome directory
1. In Windows Explorer, share the Nethome directory as Nethome.
2. Change the permissions on the share to provide Read and Write permissions for the
Business Advocate administrative users.

Configuring a Business Advocate environment


You must configure a Business Advocate environment on all computers that host:
l First Logical Resource Manager
l Standby Resource Manager
l Additional Logical Resource Manager
l Business Advocate administration tools
To create the Business Advocate environment
1. Log in to the computer with an account that has the required administrator privileges. For
more information, see Required administrator privileges for Business Advocate on
page 43.
2. Select Start > Programs > Avaya Interaction Center 7.3 > Advocate Configure.
If the Configuration Tool displays a message box that alerts you to a missing license, click
OK. Verify that your IC license includes Business Advocate.
3. In the Configuration dialog box, select one of the following options from the
Configuration Type group:
l First Logical Resource Manager
l Stand-By Resource Manager
l Additional Logical Resource Manager
l Administrative Client
4. In the Nethome Share field, type the path for the shared nethome directory in UNC format.
UNC format is \\<system_name>\nethome

44 Installation and Configuration March 2012


Setting up Business Advocate

Note:
Note: For Stand-By Resource Manager, in the Nethome Share field specify the
nethome location of the First Logical Resource Manager.
UNC format is \\<system_name>\nethome
If you do not know the path, click Browse and navigate to the directory through Network
Neighborhood. If the shared nethome directory is on the same system, do not select the
local system directly. You must navigate through Network Neighborhood to ensure that the
Browse function uses UNC format.
5. In the Windows User group, complete the following fields:
a. In the Domain\Username field, type the domain and username of the user account
that you created to run Business Advocate services in the following format:

Implementation mode Domain\Username format

Workgroup mode <local_system_name>\


<advocate_administrative_account>
Active Directory mode <Active_Directory_domain>\
<advocate_administrative_account>

b. In the Password field, type the password for the Active Directory user account.
c. In the Confirm password field, re-type the password.
6. Click Start.
7. The next step depends upon the Business Advocate components you want to host on the
target computer. Perform one of the following steps:

Business Advocate component Location of steps

First Logical Resource Manager Building the database schema for the first
Logical Resource Manager on page 45
Additional Logical Resource Building the database schema for an
Manager additional Logical Resource Manager on
page 49

Building the database schema for the first Logical Resource


Manager
To build the Business Advocate database schema for the first Logical Resource Manager, follow
the steps in one of the following topics:
l Building the Business Advocate database schema for SQL Server on page 46

Installation and Configuration March 2012 45


Chapter 2: Installing IC components

l Building the Business Advocate database schema for Oracle on page 47


Note:
Note: Business Advocate databases do not support DB2.

Building the Business Advocate database schema for SQL Server


To build the Business Advocate database schema for SQL Server
1. In the Build Database Schema window, enter the information for the fields mentioned in
the following table.

Field Recommended entry Notes

Select a DBMS Select SQL Server.


Username Type a DBA user name for the For example, a DBA user
Business Advocate databases. name for SQL Server is sa.
Password Type the password for the Do not leave your DBA
DBA user name. password blank.

2. Check the Build box next to the Local System Store field and enter the information for
the fields mentioned in the following table.

Field Recommended entry Notes

Schema file Accept the default. Business Advocate


automatically completes this
field with the network home
directory that you specified
during installation.
Database Server Type the name of the system The database server is the
that hosts the database. system that hosts the
Business Advocate database
you created when you
completed prerequisites.
Database Name Type advocate. The database name is the
Business Advocate database
you created when you
completed prerequisites.

46 Installation and Configuration March 2012


Setting up Business Advocate

3. Check the Build box next to the Shared Resource Store field and enter the information
for the fields mentioned in the following table.

Field Recommended entry Notes

Schema file Accept the default. Business Advocate


automatically completes this
field with the network home
directory that you specified
during installation.
Database Server Type the name of the system The database server is the
that hosts the database. system that hosts the
Business Advocate database
you created when you
completed prerequisites.
Database Name Type advocate. The database name is the
Business Advocate database
you created when you
completed prerequisites.

4. Click Create Schema.


This process can take a few minutes to complete the installation and configuration of the
database schema. Monitor the messages on the status line at the bottom left of the Build
Database Schema window. If desired, select View Log File to view the log file.

Building the Business Advocate database schema for Oracle


To build the Business Advocate database schema for Oracle
1. In the Build Database Schema window, enter the information for the fields mentioned in
the following table:

Field Recommended entry Notes

Select a DBMS Select Oracle. Business Advocate databases


do not support DB2.
Username Type a DBA user name for the For example, a DBA user
Business Advocate databases. name for Oracle is system.
Password Type the password for the Do not leave your DBA
DBA user name. password blank.

Installation and Configuration March 2012 47


Chapter 2: Installing IC components

2. Select the Build check box next to the Local System Store field and enter the information
for the fields mentioned in the following table:

Field Recommended entry Notes

Schema file Accept the default. Business Advocate


automatically completes this
field with the network home
directory that you specified
during installation.
Database Server Type the name of the system The database server is the
that hosts the database. system that hosts the
Business Advocate database
you created when you
completed prerequisites.
Service Type the Oracle Local Net For information on how to
Service for the system. identify the Oracle Local Net
Service, see the
documentation provided by
Oracle.

3. Select the Build check box next to the Shared Resource Store field and enter the
information for the fields mentioned in the following table:

Field Recommended entry Notes

Schema file Accept the default. Business Advocate


automatically completes this
field with the network home
directory that you specified
during installation.
Database Server Type the name of the system The database server is the
that hosts the database. system that hosts the
Business Advocate database
you created when you
completed prerequisites.
Service Type the Oracle Local Net For information on how to
Service for the system. identify the Oracle Local Net
Service, see the
documentation provided by
Oracle.

4. Select Create Schema.


This process can take a few minutes to complete the installation and configuration of the
database schema. Monitor the messages on the status line at the bottom left of the Build
Database Schema window. If desired, click View Log File to view the log file.

48 Installation and Configuration March 2012


Setting up Business Advocate

Building the database schema for an additional Logical Resource


Manager
To build the Business Advocate database schema, follow the steps in one of the following
topics:
l Building the Business Advocate database schema for SQL Server on page 49
l Building the Business Advocate database schema for Oracle on page 50

Building the Business Advocate database schema for SQL Server


To create the Business Advocate database schema:
1. In the Build Database Schema window, enter the information for the fields mentioned in
the following table:

Field Recommended entry Notes

Select a DBMS Select SQL Server.


Username Type a DBA user name for the For example, a DBA user
Business Advocate databases. name for SQL Server is sa.
Password Type the password for the Do not leave your DBA
DBA user name. password blank.

2. Type the location of the shared network home directory that you created for the first
Logical Resource Manager.
Use UNC format, for example, \\<system_name>\nethome
If you do not know the path, click Browse and navigate to the directory through Network
Neighborhood. If the shared network home directory is on the same computer, do not
select the local computer directly. You must navigate through Network Neighborhood to
ensure that the Browse function uses UNC format.
Note:
Note: For Additional Logical Resource Manager configuration, create a new database
for example, advocate_lrm2, by performing the same procedure used to
create database for the first Logical Resource Manager.

Installation and Configuration March 2012 49


Chapter 2: Installing IC components

3. Select the Build check box next to System Store and enter the information for the fields
mentioned in the following table:

Field Recommended entry Notes

Schema file Accept the default. Business Advocate


automatically completes this
field with the network home
directory that you specified
during installation.
Database Server Type the name of the system The database server is the
that hosts the database. system that hosts the
Business Advocate database
you created when you
completed prerequisites.
Database Name Type advocate_lrm2 The database name is the
Business Advocate database,
you created for additional
resource manager when you
completed prerequisites.

4. Click Create Schema.


Monitor the messages on the status line at the bottom left of the Build Database Schema
window. If desired, click View Log File to view the log file.
5. Click Close.
6. Click OK for each of the dialog boxes displayed by the Business Advocate installation.
This process can take a few minutes to complete the installation and configuration of the
database schema.

Building the Business Advocate database schema for Oracle


To create the Business Advocate database schema:
1. In the Build Database Schema window, enter the information for the fields mentioned in
the following table:

Field Recommended entry Notes

Select a DBMS Select Oracle.


Username Type a DBA user name for the For example, a DBA user
Business Advocate databases. name for Oracle is system.
Password Type the password for the Do not leave your DBA
DBA user name. password blank.

50 Installation and Configuration March 2012


Setting up Business Advocate

2. Type the location of the shared network home directory that you created for the first
Logical Resource Manager.
Use UNC format, for example, \\<system_name>\nethome
If you do not know the path, click Browse and navigate to the directory through Network
Neighborhood. If the shared network home directory is on the same computer, do not
select the local computer directly. You must navigate through Network Neighborhood to
ensure that the Browse function uses UNC format.
3. Select the Build check box next to System Store and enter the information for the fields
mentioned in the following table:

Field Recommended entry Notes

Schema file Accept the default. Business Advocate


automatically completes this
field with the network home
directory that you specified
during installation.
Database Server Type the name of the system The database server is the
that hosts the database. system that hosts the
Business Advocate database
you created when you
completed prerequisites.
Service Type the Oracle Local Net For information on how to
Service for the system. identify the Oracle Local Net
Service, see the
documentation provided by
Oracle.

4. Click Create Schema.


Monitor the messages on the status line at the bottom left of the Build Database Schema
window. If desired, click View Log File to view the log file.
5. Click Close.
6. Click OK for each of the dialog boxes displayed by the Business Advocate installation.
This process can take a few minutes to complete the installation and configuration of the
database schema.

Installation and Configuration March 2012 51


Chapter 2: Installing IC components

Verifying permissions for running OA ECB with Business


Advocate
The Event Collector Bridge (ECB) receives information from Business Advocate on a private
MSMQ called pa_admin. OA uses this information to report on Business Advocate.
To enable the primary ECB and the standby ECB to use the pa_admin MSMQ, the user ID that
runs the IC ORB Service 7.3 must have the correct permissions.
To enable OA ECB on Business Advocate, verify that the permissions on the pa_admin MSMQ
are set to Allow for Everyone for the following:
l Receive Message
l Peek Message
l Get Properties
l Get Permissions

Installing Advocate Component Manager on a separate system


Advocate Component Manager and Net Home are installed on the system when the first
Resource Manager (RM) is configured. However, using the following steps, you can install
Advocate Component Manager and Primary and Secondary Resource Manager on separate
system. Installing/Having these components on separate systems provides high availability and
better failover for Resource Manager.

Scenario
Let us consider three systems:

System 1 with Advocatecm: This system host the Component Manager and NetHome which
is required for Administrative Clients.

System 2 with Advocateprimaryrm: This system is used to deploy the First LRM (primary
role).

System 3 with Advocatestandbyrm: This system is used to deploy the Standy LRM
(secondary role).
To install Advocate Component Manager on a separate system:
1. Perform the following on the Advocatecm system:
a. Run the BAConfigtool.exe tool.

52 Installation and Configuration March 2012


Setting up Business Advocate

b. In the Configuration window, under Configuration Type, select First Logical


Resource Manager.
c. Under Nethome Share (\\<hostname>\nethome format), type \\Advocatecm\
nethome.
d. Under Windows User, provide appropriate username and password.
e. Click Start.
2. Perform the following on the Advocateprimaryrm system:
a. Run the BAConfigtool.exe tool.
b. In the Configuration window, under Configuration Type, select Stand-By Resource
Manager.
c. Under Nethome Share (\\<hostname>\nethome format), type \\Advocatecm\
nethome.
d. Under Windows User, provide appropriate username and password.
e. Click Start.
Note:
Note: If the configtool gives an error, then run the following command from the
IC_INSTALL_DIR\IC73\bin path: Mxcomponentmgr.exe /regserver
3. Perform the following on Advocatecm system:
a. Open the Advocate Supervisor application.
b. Expand Component Manager.
c. In the left hand side pane, under Advocate Component Manager, select
Advocatecm.
d. In the right hand side pane, right-click Avaya Business Advocate Resource
Manager and click All Tasks > Disable.
e. In the left hand side pane, under Advocate Component Manager, select
Advocateprimaryrm.
f. In the right hand side pane, right-click Avaya Business Advocate Resource
Manager and click Availability Config....
g. In the Availability Config window, change the Availability Config from Secondary to
Primary.
4. Perform the following on the Advocatestandbyrm system:
a. Run the BAConfigtool.exe tool.
b. In the Configuration window, under Configuration Type, select Stand-By Resource
Manager.
c. Under Nethome Share (\\<hostname>\nethome format), type \\Advocatecm\
nethome.

Installation and Configuration March 2012 53


Chapter 2: Installing IC components

d. Under Windows User, provide appropriate username and password.


e. Click Start.
Note:
Note: If the configtool gives an error, then run the following command from the
IC_INSTALL_DIR\IC73\bin path: Mxcomponentmgr.exe /regserver
5. Configure two Resource Managers in the ICManager, one pointing to Advocateprimaryrm (
select the Host IP of the Advocateprimaryrm) and the other pointing to
Advocatestandbyrm.
6. Start both the Resource Managers.
For more details regarding BAConfigtool.exe, refer to Configuring a Business Advocate
environment on page 44.

Installing the IC server SDK


IC provides a Software Development Kit (SDK) for the IC servers. The SDK includes all of the
files that you require to build your own Avaya IC servers, including:
l Header files
l Libraries
l Sample server project files

Tip:
Tip: For information about how to install the Client SDK, see Installing IC server and
administration components on page 28.
To install the server SDK:
1. Navigate to the following directory in the Avaya Interaction Center CD/DVD-ROM:

Operating system Directory path

Windows <CD/DVD-ROM_drive>\Utils\TSSdk\sdkwin32.zip
Solaris <CD/DVD-ROM_drive>/Utils/TSSdk/sparc_tr.Z
AIX <CD/DVD-ROM_drive>/Utils/TSSdk/rs6k_tr.Z

2. Copy the compressed SDK file to your IC directory.


3. Uncompress the file and extract the contents.
4. Verify that the files have been extracted into the folder that you selected. This folder should
include C files and a makefile.

54 Installation and Configuration March 2012


Upgrading IC

For more information, see Avaya IC Client and Server Programmer Design Guide.

Upgrading IC
For information on how to upgrade your IC system from an earlier release of IC, including an IC
7.x release, see IC/OA Software Upgrade and Data Migration.

Reinstalling IC components
You can reinstall IC Release 7.3 over an existing IC Release 7.3 installation. To uninstall IC files
before you reinstall, see Uninstalling IC on page 494.
To reinstall IC over an existing IC installation:
1. Stop all IC servers and IC services on the target computer.
2. Follow the instructions in the appropriate section below to reinstall the desired IC files:
l Installing IC server and administration components on page 28
l Deploying Avaya Agent on page 351
l Installing Avaya Agent Web Client on page 383

Installation and Configuration March 2012 55


Chapter 2: Installing IC components

Upgrading Daylight Saving Time (DST) patches


IC 7.3 is compliant with the Daylight Saving Time (DST) factor.
The major operating system (OS) vendors have already released patches to support DST. IC
customers must upgrade their operating system versions with the required DST patches from
the respective operating system vendor's Web sites.
You can update the JRE on all the platforms using third-party tools.
For example:
l For Windows: TZUpdater
l For Solaris: TZUpdater
l For AIX: JTZU
To update JRE using the time zone updating tool
1. Stop all IC servers, services and logout Avaya Agent.
2. Update JRE that comes with IC.
3. For Windows:
l You can download the TZUpdater Tool from:
http://java.sun.com/javase/downloads/index.jsp.
l For installation instructions refer to:
http://java.sun.com/javase/tzupdater_README.html.
4. For Solaris:
l You can download the TZUpdater Tool from:
http://java.sun.com/javase/downloads/index.jsp.
l For installation instructions refer to:
http://java.sun.com/javase/tzupdater_README.html.
5. For AIX:
l You can download the JTZU Tool from:
http://www.ibm.com/developerworks/java/jdk/dst/index.html.
l For installation instructions refer to:
http://download.boulder.ibm.com/ibmdl/pub/software/dw/jdk/dst/readme.htm.
Note:
Note: JRE is located in the IC_INSTALL_DIR\IC73\Java directory.

56 Installation and Configuration March 2012


Upgrading Daylight Saving Time (DST) patches

Note:
Note: If you are changing the time zone after installing and configuring IC, update the
adl query and regenerate the database.

Installation and Configuration March 2012 57


Chapter 2: Installing IC components

58 Installation and Configuration March 2012


Chapter 3: Silent Install Interaction Center
7.3

Avaya Interaction Center uses Install Anywhere platform for RTM installers.
You can silent install IC 7.3 in two ways:
l Option 1: Run the installer with default values (no response file) on page 59
l Option 2: Using a response file to supply values for installer variables on page 60

Option 1: Run the installer with default values (no


response file)
To run the installer with the default values:
1. Open command/shell prompt on Windows or Unix system.
2. Goto the installer directory (directory where installer is copied).
3. At the command/shell prompt run the following commands given in the following table as
per the Operating system.

Table 1: Silent install commands

Operating Command
System

Windows To install the application with the required Visual C++ Runtime:
install.exe –i silent -D$CHOSEN_DIALOG_BUTTON_FORVCREDIST$=0
OR
To install the application without the required Visual C++ Runtime:
install.exe –i silent -D$CHOSEN_DIALOG_BUTTON_FORVCREDIST$=1
Oracle Solaris ./install.bin -i silent
IBM AIX ./install.bin -i silent

Installation and Configuration March 2012 59


Chapter 3: Silent Install Interaction Center 7.3

Note:
Note: There are multiple install sets within some installers (for ex. icwinserversuite
contains Server, Design/ Admin and AAWC); only ‘default’ install set will be
installed when the installer is run without using a response file. Table 2 lists the
default Install set for multi-set installer in IC. Use this option only in case default
installs set needs to be installed.

Table 2: IC installer and the default Install sets

IC Installer Install Set Default Install


set

icwinserversuite Server, Design and Admin, and Web Connector Server


icclientsuite Avaya Agent Rich Client and Avaya Agent Web Client Avaya Agent
Rich Client
SiebelNT ASServer and ASDesign ASServer
icsolserversuite Server, Web Connector Server
icaixserversuite Server, Web Connector Server

Option 2: Using a response file to supply values for


installer variables
To use a response file to supply values for installer variables:
1. Create a response file.
a. Open command/shell prompt on Windows or Unix.
b. Goto the installer directory (directory where installer is copied).
c. At the command prompt:

60 Installation and Configuration March 2012


Option 2: Using a response file to supply values for installer variables

l Execute the commands in the following table to create default installer. properties
response file in installer directory.

Table 3: Command to create a default installer. properties response


file in installer directory

Operating Command
System

Windows install.exe -r
Oracle Solaris ./install.bin -r
IBM AIX ./install.bin -r

l Execute the commands in the following table to create default installer. properties
response file in specified file location.

Table 4: Command to create a default installer. properties response file in the


specified file location

Operating Command
System

Windows To install the application with the required Visual


C++ Runtime:
install.exe -i silent -f <absolutepathoffile.txt>
-D$CHOSEN_DIALOG_BUTTON_FORVCREDIST$
=0
OR
To install the application without the required Visual
C++ Runtime:
install.exe -i silent -f <absolutepathoffile.txt>
-D$CHOSEN_DIALOG_BUTTON_FORVCREDIST$
=1
Oracle Solaris ./install.bin -i silent -f<abosolute_path_of_file.txt>
IBM AIX ./install.bin -i silent -f<abosolute_path_of_file.txt>

d. Installer will launch after executing the above command. Change the default values in
the response file as per your requirement.
e. Save the file.
2. Modify the response file.
Note:
Note: This step is required for the installers mentioned in Table 2.

Installation and Configuration March 2012 61


Chapter 3: Silent Install Interaction Center 7.3

a. Once the installation is completed, a response file is created in the same directory
where the installer is located or at the absolute path location if specified.
b. Open the response file in a text editor.
c. Add the lines provided in the Data column from the following table in the response file
for the respective installation. This step is required for all IC installers having multiple
install sets (refer to Table 2). Values related to install set do not get written to the
response file. This is a known issue of IA 2009.
d. Save and close the file.

Table 5: IC installer options

Installer Data

Windows #Choose Install Set


Server #------------------
CHOSEN_FEATURE_LIST=Servers
CHOSEN_INSTALL_FEATURE_LIST=Servers
CHOSEN_INSTALL_SET=Custom
Windows #Choose Install Set
design and #------------------
Admin
CHOSEN_FEATURE_LIST=DesignA
CHOSEN_INSTALL_FEATURE_LIST=DesignA
CHOSEN_INSTALL_SET=Custom
Windows #Choose Install Set
WebConnector #------------------
CHOSEN_FEATURE_LIST=WebConn
CHOSEN_INSTALL_FEATURE_LIST=WebConn
CHOSEN_INSTALL_SET=Custom
Solaris Server1 #Choose Install Set
#------------------
CHOSEN_FEATURE_LIST=servers
CHOSEN_INSTALL_FEATURE_LIST=servers
CHOSEN_INSTALL_SET=Custom
Solaris #Choose Install Set
WebConnector #------------------
1
CHOSEN_FEATURE_LIST=WebConn
CHOSEN_INSTALL_FEATURE_LIST=WebConn
CHOSEN_INSTALL_SET=Custom

62 Installation and Configuration March 2012


Option 2: Using a response file to supply values for installer variables

Table 5: IC installer options

Installer Data

AIX Server1 #Choose Install Set


#------------------
CHOSEN_FEATURE_LIST=servers
CHOSEN_INSTALL_FEATURE_LIST=servers
CHOSEN_INSTALL_SET=Custom
AIX #Choose Install Set
WebConnector #------------------
1
CHOSEN_FEATURE_LIST=WebConn
CHOSEN_INSTALL_FEATURE_LIST=WebConn
CHOSEN_INSTALL_SET=Custom
AIC Siebel Server:
Windows #Select Installer options
(AICSiebelNT) #------------------------
CHOSEN_FEATURE_LIST=ASServer
CHOSEN_INSTALL_FEATURE_LIST=ASServer
CHOSEN_INSTALL_SET=Custom
Design:
#Select Installer options
#------------------------
CHOSEN_FEATURE_LIST=ASDesign
CHOSEN_INSTALL_FEATURE_LIST=ASDesign
CHOSEN_INSTALL_SET=Custom
Windows #Select Installer options
WebClient #------------------------
CHOSEN_FEATURE_LIST=AAWC
CHOSEN_INSTALL_FEATURE_LIST=AAWC
CHOSEN_INSTALL_SET=Custom
AICSiebel N/A
Solaris
AICSiebel AIX N/A
Windows N/A
AgentClient
Siebel Windows N/A

Installation and Configuration March 2012 63


Chapter 3: Silent Install Interaction Center 7.3

Table 5: IC installer options

Installer Data

Siebel Solaris N/A


Siebel AIX N/A

Note:
Note:

[ 1 ] This is specific to Solaris/AIX platform, open the response file to edit and remove
the trailing Avaya/IC73 path from USER_INSTALL_DIR path variable value as Avaya/
IC73 directory structure gets appended to the path during installation.
N/A – Not Applicable (No install sets)
Rows starting with ‘#’ are treated as comments
3. You can now run the installer on a different system (where installation is required).
a. Goto the installer directory.
b. Open the command/shell prompt and run the following command:

Table 6: Commands to run silent install with the response file

Operating Command
System

Windows install.exe -i silent


-f<abosolute_path_of_file.txt>
Oracle Solaris ./install.bin -i silent
-f<abosolute_path_of_file.txt>
IBM AIX ./install.bin -i silent
-f<abosolute_path_of_file.txt>

64 Installation and Configuration March 2012


Chapter 4: Configuring databases

This section describes how to configure the IC data server, databases, and data sources. All IC
systems require an IC Repository database and a CallCenterQ database.
This section includes the following topics. Perform the steps in the order set below.
1. Before you configure IC databases on page 65
2. Copying the stored procedure library - DB2 only on page 66
3. Setting up a Data server on page 66
4. IC data sources on page 74
5. Setting the display time for IC databases on page 75
6. Creating IC Repository on page 76
7. Creating the CCQ database on page 85

Before you configure IC databases


Before you configure the IC databases, complete the following prerequisites:

Install IC servers: You must create and configure the primary server environment, then start
the primary servers before you can configure the IC servers and components.
At a minimum, do the following:
l On a computer that hosts the IC primary ORB server, install the IC server files and
configure the primary server environment.
l On a computer that hosts the Data server, install the IC server files and configure the
server environment. If this computer is different from the one that hosts the primary ORB
server, configure a secondary server environment on this computer.
If you have not installed the server files, see Installing IC server and administration
components on page 28.

Install IC Design and Administration tools: Install these tools on a dedicated computer that
has network access to all server computers. For information on how to install these tools, see
Installing IC server and administration components on page 28.

Install database management system: For more information, see Avaya IC Installation
Planning and Prerequisites and the documentation provided with the database management
system.

Installation and Configuration March 2012 65


Chapter 4: Configuring databases

Install and configure the database client software: The database client software also
includes the vendor libraries, and support files. Install and configure these files on a computer
that hosts the Data server. The Data server requires the database client software to
communicate with the database. For example, if your IC system includes a supported Oracle
database, install the Oracle client for that version on a computer that hosts the Data server.

Database connections: Configure and validate the database software connections on a


computer where you plan to install the Data server.

Copying the stored procedure library - DB2 only


If you host your IC databases on DB2, you must copy the qdb2sp stored procedure library from
the computer that hosts the primary ORB server to the computer that hosts the IC database
instance.
To copy the qdb2sp stored procedure library to the DB2 server installation hierarchy
1. On a computer that hosts the DB2 Data server, navigate to the IC_INSTALL_DIR/IC73/
lib directory where IC installs the qdb2sp stored procedure library.
2. Use the ftp command or the rcp command to copy the qdb2sp stored procedure library
to the following directory on a computer that hosts the DB2 server:
db2inst1/sqllib/function
Note:
Note: Do not copy the stored procedure library to any computer that hosts the DB2
client. The stored procedure library must be copied to the function directory of the
DB2 server.

Setting up a Data server


The Data server is specific to the type of database you use in your IC system. All IC server and
client components use the Data server to communicate with your database. The Data server
uses the IC account for each component or user to link the IC components and the database
server.
All Data servers support connection pooling.
After you configure the Data server, you can configure other IC applications on the same
computer.
This section includes the following topics:
l Cautions and tips for configuring a Data server on page 67

66 Installation and Configuration March 2012


Setting up a Data server

l Creating the primary Data server on page 67


l Creating a secondary Data server on page 74

Cautions and tips for configuring a Data server


When you configure the Data server, note the following:

Database computer: Do not install and configure the Data server on a computer that hosts
your database.
Host your database server on a dedicated computer, so you can tune your database server to
maximize database operations and improve the reliability and performance of the database.

Multiple database types: A Data server can only communicate with one type of database.
Install multiple Data servers if your IC configuration requires more than one type of database.
For example, you need a second Data server if you maintain a legacy database in a different
type of database.
The CCQ database, IC Repository database, and OA database must all be of the same
database type.

DB2 stored procedure library: If you use DB2 for your IC databases, you must copy the
qdb2sp stored procedure library from the computer that hosts the primary ORB server to the
DB2 installation hierarchy. If you do not copy the stored procedure library, the Data server will
not be able to communicate with the DB2 database server, and Database Designer will not be
able to configure the IC databases. For more information, see Copying the stored procedure
library - DB2 only on page 66.

Creating the primary Data server


The primary Data server is typically on the same computer as the primary ORB server.
This section includes the following topics:
l Creating a primary Data server for Microsoft SQL Server on page 67.
l Creating a primary Data server for Oracle on page 69.
l Creating a primary Data server for IBM DB2 on page 72.

Creating a primary Data server for Microsoft SQL Server


To create a primary Data server for Microsoft SQL Server:
1. On a computer where you installed the Design & Administration Tools, select
Start > Programs > Avaya Interaction Center 7.3 > IC Manager.

Installation and Configuration March 2012 67


Chapter 4: Configuring databases

2. Log in to IC Manager with the pre-assigned login ID and password shown in the following
table.

Login Password

Admin admin

The next time you log in, IC Manager prompts you to change the password.
3. Click the Server tab, and:
a. Select Server > New.
b. From the list of servers, select DataServerMSSQL.
c. Click Ok.
4. On the General tab of the Server Editor, enter the information for the fields mentioned in
the following table:

Field Recommended entry Notes

Name Enter a logical name for the Include the type of database on your
Data server. For example, IC system in the name. You need this
DataServerMSSQL. name to configure IC Repository and
the CCQ database.
Domain Select the IC domain for the For example, select Default from
server from the drop-down the drop-down list if the server is in
list. the Default domain.
Host Select the IP address of the When you select the host, IC
system that hosts the server, Manager fills in the fields for
or enter the IP address if it is Directory, Port, and Executable.
not in the list.

5. On the DataServer tab of the Server Editor, enter the information for the fields mentioned
in the following table:

Field Recommended entry Notes

DB Login Enter your DBA user name. The name used by the Data
server to access databases.
DB Password Enter your database The password that corresponds
password. to the database login name
used by the Data server to
access databases.

68 Installation and Configuration March 2012


Setting up a Data server

Field Recommended entry Notes

Request Handler Enter the number of requests Maximum number of threads


Thread Pool Size in the thread pool. that handle client requests in
Default is 30. the Data server. These threads
accept requests from the Data
server clients and queues them
for execution in the database.
DB Connection Enter the number of Maximum number of database
Pool Size connections in the pool. connections to open in a
Default is 15. connection pool.
Minimum is 1.

6. Click the Debug tab and perform the following steps:


a. Click the Ellipsis (…) button next to Trace Levels.
b. In the Trace Levels dialog box, select the following check boxes.

Field Recommended entry Notes

idl l Check this box for idl is a higher level trace that is
development systems more readable than msg. idl
only. writes all method invocations to
l Clear this box for the log file.
production systems.
flush l Check this box for When the server writes to the
development systems log buffer, flush immediately
only. writes the information to the log
l Clear this box for file. Flush does not wait for the
production systems. buffer to fill before writing
entries to the log file.

c. Click OK.
For information about the other options in the Trace Levels dialog box, see Interaction
Center Administration Guide.
7. Click OK to save the Data server configuration.
8. Start the Data server:
a. Right-click the Data server that you have created and select Start.

Creating a primary Data server for Oracle


To create a primary Data server for Oracle
1. On a computer where you installed the Design & Administration Tools, select
Start > Programs > Avaya Interaction Center 7.3 > IC Manager.

Installation and Configuration March 2012 69


Chapter 4: Configuring databases

2. Log in to IC Manager with the pre-assigned login ID and password shown in the following
table.

Login Password

Admin admin

The next time you log in, IC Manager prompts you to change the password.
3. Click the Server tab, then:
a. Select Server > New.
b. From the list of servers, select DataServerOracle.
c. Click Ok.
4. In the General tab of the Server Editor, enter the information for the fields mentioned in the
following table.

Field Recommended entry Notes

Name Type DataServerOracle or Include the type of database on your


another logical name for the IC system in the name. You need this
Data server. name to configure IC Repository and
the CCQ database.
Domain Select the IC domain for the For example, select Default from
server from the drop-down the drop-down list if the server is in
list. the Default domain.
Host Select the IP address of the When you select the host, IC
system that hosts the server, Manager fills in the fields for
or enter the IP address if it is Directory, Port, and Executable.
not in the list.

5. On the DataServer tab of the Server Editor, enter the information for the fields mentioned
in the following table:

Field Recommended entry Notes

DB Login Enter the database account The database login name used
name. by the Data server to access
databases.
DB Password Enter the password for the The password as configured in
database account. the Oracle database.

70 Installation and Configuration March 2012


Setting up a Data server

Field Recommended entry Notes

Oracle Home Enter the pathname of the Oracle Data server only.
Directory home directory of the Oracle This home directory overrides
database. the home directory specified in
the IC Data Source parameter.
Request Handler Enter the number of requests Maximum number of threads
Thread Pool Size in the thread pool. that handle client requests in
Default is 30. the Data server. These threads
accept requests from the Data
server clients and queues them
for execution in the database.
DB Connection Enter the number of Maximum number of database
Pool Size connections in the pool. connections to open in a
Default is 15. connection pool.
Minimum is 1.

6. Click the Debug tab and perform the following steps:


a. Click the Ellipsis (…) button next to Trace Levels.
b. In the Trace Levels dialog box, select the following check boxes.

Field Recommended entry Notes

idl l Check this box for idl is a higher level trace that is
development systems more readable than msg. idl
only. writes all method invocations to
l Clear this box for the log file.
production systems.
flush l Check this box for When the server writes to the
development systems log buffer, flush immediately
only. writes the information to the log
l Clear this box for file. Flush does not wait for the
production systems. buffer to fill before writing
entries to the log file.

c. Click OK.
For information about the other options in the Trace Levels dialog box, see Interaction
Center Administration Guide.
7. Click OK to save the Data server configuration.
8. Start the Data server.
a. Right-click the Data server that you have created and select Start.

Installation and Configuration March 2012 71


Chapter 4: Configuring databases

Creating a primary Data server for IBM DB2


To create a primary Data server for IBM DB2
1. On a computer where you installed the Design & Administration Tools, select
Start > Programs > Avaya Interaction Center 7.3 > IC Manager.
2. Log in to IC Manager with the pre-assigned login ID and password shown in the following
table.

Login Password

Admin admin

The next time you log in, IC Manager prompts you to change the password.
3. Click the Server tab, then:
a. Select Server > New.
b. From the list of servers, select DataServerDB2.
c. Click Ok.
4. On the General tab of the Server Editor, enter the information for the fields mentioned in
the following table:

Field Recommended entry Notes

Name Type DataServerDB2 or Include the type of database on


another logical name for the your IC system in the name.
Data server. You need this name to configure
IC Repository and the CCQ
database.
Domain Select the IC domain for the For example, select Default
server from the drop-down from the drop-down list if the
list. server is in the Default domain.
Host Select the IP address of the When you select the host, IC
system that hosts the server, Manager fills in the fields for
or type in the IP address if it Directory, Port, and Executable.
is not in the list.

72 Installation and Configuration March 2012


Setting up a Data server

5. On the DataServer tab of the Server Editor, enter the information for the fields mentioned
in the following table:

Field Recommended entry Notes

DB Login Enter your database login The name used by the Data
name. server to access databases.
DB Password Enter your database The password that corresponds
password. to the database login name
used by the Data server to
access databases.
Request Handler Enter the number of requests Maximum number of threads
Thread Pool Size in the thread pool. that handle client requests in
Default is 30. the Data server. These threads
accept requests from the Data
server clients and queues them
for execution in the database.
DB Connection Enter the number of Maximum number of database
Pool Size connections in the pool. connections to open in a
Default is 15. connection pool.
Minimum is 1.

6. Click the Debug tab and perform the following steps:


a. Click the Ellipsis (…) button next to Trace Levels.
b. In the Trace Levels dialog box, select the following check boxes.

Field Recommended entry Notes

idl l Check this box for idl is a higher level trace that is
development systems more readable than msg. idl
only. writes all method invocations to
l Clear this box for the log file.
production systems.
flush l Check this box for When the server writes to the
development systems log buffer, flush immediately
only. writes the information to the log
l Clear this box for file. Flush does not wait for the
production systems. buffer to fill before writing
entries to the log file.

c. Click OK.
For more information about trace levels, see Interaction Center Administration Guide.

Installation and Configuration March 2012 73


Chapter 4: Configuring databases

7. Click Ok.
8. Start the Data server:
a. Right-click the Data server that you have created and select Start.

Creating a secondary Data server


An IC system usually requires more than one Data server. For information about recommended
deployments for a secondary Data server, see Avaya IC Installation Planning and Prerequisites.
To create a secondary Data server, follow the instructions in Creating the primary Data
server on page 67.

IC data sources
Application Design Language (ADL) files contain the data models for IC databases, including
tables, table sets, browsers, and modules.
For an out-of-the-box, non-customized IC installation, use ADL files to perform the following
tasks:
l Configure IC databases
l Create IC data sources

About data sources


All IC components that must access a database uses IC data sources. These components
include servers, workflows, and agent applications. You can create an IC data source when you
generate an application from the application ADL file.
All IC systems require the following data sources:
l Repository data source
l Interaction Center data source
Repository and Interaction Center are only data sources that do not have a user interface.
Although you can generate a Windows application to create the data sources, you cannot use
repository or interaction_center as an application.

74 Installation and Configuration March 2012


Setting the display time for IC databases

The following table describes the typical data sources in an out-of-the-box IC installation.

Data Source ADL File Description

repository repository.adl Required for all Avaya IC systems.


Used by the Directory server, Report server, and
DUStore server for access to the IC Repository.
interaction_center ccq.adl Required for all Avaya IC systems.
Used by most IC servers to access the database. This
data source also handles most server-related
transactions, such as workflows.
Note: Use this data source for all IC systems that
integrate with third party applications.

Setting the display time for IC databases


When you create an IC database, you must set the display time for that database. The display
time option determines how Avaya IC handles the difference in time between the agent desktop
computer and the time as reported by the database for all database activities, such as Select,
Insert, and Update.
The following table describes the display time options for IC databases.

Display time option Description

DBMSTIME Select this option if you want the DateTime data to display as
database time, and not adjusted to local time.
With DBMSTIME, IC ignores the difference in time and does not
apply the difference to any database activity.
LOCALTIME Select this option if you want the DateTime data to display as
adjusted to local time on the client.
With LOCALTIME, IC uses the difference in time, rounds it to the
nearest half hour, and applies this difference to all database activity
that involves date and time information.
HOSTTIME Select this option if you want the DateTime data to display as
adjusted to the local host time, including small differences between
system clocks.
With HOSTTIME, IC uses the difference in time and applies this
difference to all database activity that involves date and time
information.

Installation and Configuration March 2012 75


Chapter 4: Configuring databases

Creating IC Repository
IC Repository manages current and historical data in the form of Electronic Data Units (EDUs),
Agent Data Units (ADUs), system configuration, and resource utilization statistics. This data
includes agents, workgroups, queues, and tenants. IC Repository forms the structure that your
database server needs to accept contact data from the IC EDU server and ADU server.
OA queries the data that these IC components write in the IC Repository database and other IC
databases. OA then reports on the results of the queries.
To create IC Repository, complete the steps in the following topics
1. Before you create IC Repository on page 76.
2. Building the IC Repository database on page 76.
3. Generating the IC Repository application on page 84.
4. Updating the Directory server with IC Repository on page 85.

Before you create IC Repository


Before you build the IC Repository database:
l You must know the names that you will give to your IC Repository and CCQ databases.
l For a localized version of IC, enable Localization in Database Designer, as described in
Enabling Database Designer for localization on page 436.

Building the IC Repository database


The following instructions assume that you have reviewed and modified all components of the
IC Repository ADL file in Database Designer. For information about the ADL file, see IC
Database Designer Application Reference.

! Important:
Important: If you use DB2 for your IC databases, you must copy the qdb2sp stored
procedure library from the system that hosts the primary ORB server to the DB2
installation hierarchy.For more information, see Copying the stored procedure
library - DB2 only on page 66.
To build the IC Repository database, perform the steps in the following topics
1. Configuring the IC Repository database connection on page 77.
2. Configuring the IC Repository connection set on page 82.

76 Installation and Configuration March 2012


Creating IC Repository

3. Creating the IC Repository database on page 82.

Configuring the IC Repository database connection


To configure the IC Repository database connection
1. In Database Designer, select File > Open.
2. Open the IC Repository ADL file.
The ADL file is in IC_INSTALL_DIR\IC73\design\repository\repository.adl
If you enabled Database Designer for localization, click OK and ignore the warning.
Database Designer automatically generates the ALF file when you save the ADL file. For
more information, see Enabling Database Designer for localization on page 436.
3. In the tree pane, expand Components > Physical DB Connections and select
repositoryDBConnection.
4. In the DB Connection Properties tab, enter the information for the fields in the General
group mentioned in the following table:

Property Recommended entry Notes

Timeout (sec) Type the maximum number of Default value is 60 seconds.


seconds that the client If no response is returned within the
application waits for a specified time, the client application
response to a database closes the connection to the Data
request before the application server and returns an error. The client
assumes the connection to the application attempts to create a new
Data server is lost. connection to the database on the
next database request.
Description Type a description of the You can leave this field empty.
database connection, if
desired.
Display Time Select a display time option. The display time option determines
how IC handles the difference in time
between the agent desktop system
and the time as reported by the
Database for all database activities,
such as select, insert, and update.
For more information about the
display time options, see Setting the
display time for IC databases on
page 75.

Installation and Configuration March 2012 77


Chapter 4: Configuring databases

5. From the Database Type drop-down list, select the type of database to which you want to
connect.
Database Designer uses the selected database type to generate a SQL statement which
can be applied to the database.
6. Enter the information for the mandatory fields for your database mentioned in the following
table:

Database type Property Recommended entry Notes

All database Data Server Type/ Type the name of the This server is the one that
types Alias primary Data server. you created in Setting up a
Data server on page 66.
For example, defaults are:
l DataServerMSSQL

l DataServerOracle

l DataServerDB2

SQL Server Database server Type the host name of the For the default database
system that hosts your instance, type the host name.
database server. For another database
instance, type
<system>\<db_name>
Database Name Type the name of the IC Use the repository to
Repository database. For reduce the possibility of a
example, repository. migration impact.
Oracle TNS Name Type the server alias from For example, type
the tnsnames.ora file support.xyzcorp.com.
Database Name Type the name of the Use the repository to
Oracle user for the IC reduce the possibility of a
Repository database. For migration impact.
example, repository.
Client Library Type the full directory path For example, type .../opt/
Home Directory for the Oracle client on the oracle/Ora11
system that hosts the Data
server.

78 Installation and Configuration March 2012


Creating IC Repository

Database type Property Recommended entry Notes

DB2 DB2 Database Type the name of the DB2 DB2 allows a maximum of
Name database that includes the eight characters for database
IC schema. names.
For example, type db2IC.
IC Schema Name Type the schema name of Use the repository to
the IC Repository reduce the possibility of a
database. For example, migration impact.
repository.
Database Territory Type the territory that The territory defines the
represents the locale of the language and locale of the
database that includes the database. For more
IC Repository schema. information, see the DB2
documentation.

Installation and Configuration March 2012 79


Chapter 4: Configuring databases

7. If necessary, enter information for the optional fields for your database mentioned in the
following table:

Database type Property Recommended entry Notes

SQL Server Database Leave this field blank. Identifies the logical space
Location where the named
database is stored.
The SQL Server DBMS
specifies the database
location.
Database Size Leave this field blank. The size of the database
location specifies the
amount of space that the
configured application
database occupies.
The SQL Server RDBMS
specifies the database
size.
Log Location Leave this field blank. Database-generated log
files store cumulative
transaction information.
The SQL Server RDBMS
specifies a default location
for the database log.
Log Size Leave this field blank. The size of the location for
database log files specifies
the amount of space that
the database-generated
log files can occupy.
The SQL Server RDBMS
specifies a default size for
the database log.

80 Installation and Configuration March 2012


Creating IC Repository

Database type Property Recommended entry Notes

Oracle Default Type the name of the The database location


tablespace name default tablespace identifies the logical space
where objects are where the named
created for the IC database is stored. If you
databases. For example, leave this field blank, and
type T_CI. the Oracle RDBMS does
not specify a database
location, Oracle uses the
“system” space to define
the database.
Caution: Configuring a
database in the system
space can crash your
database.
Default Type the number of Caution: If you do not
tablespace size bytes for the size of the specify a default
default tablespace. tablespace size here, and
your RDBMS does not
define the default
tablespace size, the
default tablespace can
expand to use all available
space.
Temp tablespace Type the name of the Temporary tables store
name tablespace that stores database-generated
temporary files. For intermediate sorting files
example, type and client session
T_CI_TEMP. information for Oracle
databases. If you do not
specify a location for
temporary tables, the
location is specified by the
Oracle RDBMS.
DB2 Catalogued Node Type the remote node Complete this field if you
on the system that hosts host your Data server on a
the Data server. different system from the
IC databases.
Tablespace Type the name of the Complete this field if you
Name tablespace used by the created a dedicated
IC Repository database. tablespace that the IC
Repository database uses.
Note: OA requires
dedicated tablespaces.
For more information,
see Avaya OA
Installation Planning and
Prerequisites.

Installation and Configuration March 2012 81


Chapter 4: Configuring databases

8. Select File > Save to save the ADL file. Do not close the file.

Configuring the IC Repository connection set


To configure the connection set for IC Repository
1. In the tree pane of Database Designer, expand DB Connection Sets and select
DefaultDBConnectionSet.
2. On the Connection Set Properties tab, select Application from the Logical DB
Connections list.
3. Make sure the properties are set as shown in the following table:

Field Recommended entry

Physical DB Connection Select repositoryDBConnection.


Primary Do not check this box.
Use External Database Check this box.
Database Name Type the name of your application database.
This name must be the exact name that you will
give your application database when you create
it. For example, type ccq.

4. From the Logical DB Connections list, select Repository.


5. Make sure the properties are set as shown in the following table:

Field Recommended entry

Physical DB Connection Select repositoryDBConnection.


Primary Check this box.

6. Select File > Save to save the ADL file. Do not close the file.

Creating the IC Repository database


Creating IC repository database perform the following:
l Create the schema that IC requires for IC Repository
l Seed IC Repository with the configuration data in the seed.cfg file.

82 Installation and Configuration March 2012


Creating IC Repository

You do not need to modify the IC Repository seed data. The following table describes the
contents of the seed data for IC Repository:

Type of data Description

Property data System configuration data for IC Manager and Avaya Agent.
Initialization data Default workgroup, queue, and tenant data for Web
Management and Email Management. This data also includes
templates you can use to create custom workgroups, queues,
and tenants.
Mapping data Default mapping rules for the Report Server. These rules tell
the server how to write data from retired EDUs to IC
Repository.

To create the IC Repository database:


1. In Database Designer, select File > Database Administration.
2. From the DB Connection Set list, select defaultDBConnectionSet.
3. Set the options as shown in the following table:

Field Database type Recommended entry

Configure SQL Server Select Configure.


Oracle Select Configure.
DB2 Select one of the following options:
l If you have run the db2crdb.sh
script to create the database, or
if you have already configured an
IC database, select Schema
Only.
l If you have not run the
db2crdb.sh script and if you
have not yet configured an IC
database, keep Schema Only
unchecked and select
Configure.
Import Seed Data All database types Check this box.
Login Id All database types Type your IC Manager login ID.
Note: Do not use your DBA login
ID and password.
Password All database types Type your password.

Installation and Configuration March 2012 83


Chapter 4: Configuring databases

4. Click Run to configure the database and import the seed data.
Database Designer pauses briefly between configuring the database and importing the
seed data.
5. Click Close to close the Database Administration screen. Do not close the ADL file.

Generating the IC Repository application


You generate the IC Repository application to initialize the database with the ADL and version
information, and to create the Repository data source.
To generate the IC Repository application
1. In Database Designer, select File > Generate Windows Application.
2. Check the following boxes to load the files to the database:
l Messages
l Avaya IC Scripts
3. From the Name list, select repository.
4. Type the path for the directory where you want Database Designer to store the application
files.
For example, type AVAYA_IC73_HOME\apps.
If you do not know the directory path, click the Ellipsis (…) button and navigate to the
directory.
5. From the DB Connection Set drop-down list, select defaultDBConnectionSet.
6. If the fields in the following table do not have entries, re-type your IC Manager account and
password.

Field Recommended entry

Login Id Type your IC Manager login ID.


Note: Do not use your DBA login ID and
password.
Password Type your password.

7. Click OK.
Database Designer creates a new folder with the same name as the application in the
target directory.

84 Installation and Configuration March 2012


Creating the CCQ database

Updating the Directory server with IC Repository


You must initialize the connection between the Directory server and IC Repository. Until this
point in the configuration, your IC ORB environment obtained configuration information from the
local hard drive of the system. After you update the Directory server, the IC ORB environment
obtains and stores configuration information in IC Repository.
To update the Directory server for IC Repository
1. On the Server tab in IC Manager, double-click the Directory server.
2. Click the Directory tab.
3. Verify that the IC Repository data source is selected from the IC Data Source drop-down
list.
4. Click OK.
5. Stop and start the Directory server.
The Alarm Monitor should display a message such as "Server has started:: DS" followed
by the IP address of the system that hosts the Directory server, the port used to
communicate with the server, and an identification string.
6. When the Alarm Monitor indicates that the Directory server started properly, refresh IC
Manager:
a. Select Manager > Refresh.
b. In the Success message, click OK.
If you do not receive a Success message, perform the steps in Troubleshooting the refresh
in IC Manager on page 456.
Note:
Note: If you prefer to create and configure all databases at the same time, you can also
create and configure the other databases used by your IC system at this time. For
the OA databases, see the Operational Analyst Installation and Configuration.

Creating the CCQ database


You must create and seed the CCQ database to run all IC components and applications.
The CCQ database collects, stores, and manages:
l Customer-specific data, including contact information and customer history information
l Application data, including information about Web Management or Email Management

Installation and Configuration March 2012 85


Chapter 4: Configuring databases

Note:
Note: If you use DB2 for your IC databases, you must copy the qdb2sp stored
procedure library from the system that hosts the primary ORB server to the DB2
installation hierarchy. If you do not copy the stored procedure library, Database
Designer will not be able to configure the IC databases. For more information,
see Copying the stored procedure library - DB2 only on page 66.
To create the CCQ database, complete the steps in the following topics
1. Modifying the Avaya Agent layout on page 86.
2. Building the CCQ database on page 86.
3. Generating the Interaction Center application on page 93.

Modifying the Avaya Agent layout


If your system does not include Avaya Agent, do not perform this step. Go to Building the CCQ
database on page 86.
IC installs the default Avaya Agent layout in the following directory:
IC_INSTALL_DIR\IC73\design\QConsole\avaya_agent_<lang>.cdl
where <lang> represents the language that the agent will use on the desktop. For example, if
the agent desktop includes Avaya Agent in English, select avaya_agent_en.cdl. For more
information about Avaya Agent layouts in non-English languages, see Configuring Avaya Agent
for a supported language on page 438.
The default layout includes task lists for all media channels, including Telephony, Web
Management, and Email Management. To customize the Avaya Agent layout for your contact
center, see Avaya Agent Integrator’s Guide.

Building the CCQ database


To build the CCQ database, perform the steps in the following topics
1. Configuring the CCQ database connection on page 87.
2. Configuring the CCQ connection set on page 92.
3. Creating the CCQ database on page 92.

86 Installation and Configuration March 2012


Creating the CCQ database

Configuring the CCQ database connection


To configure the CCQ database connection
1. If you do not already have the CallCenterQ ADL file open in Database Designer, select
File > Open.
You can find this ADL file in IC_INSTALL_DIR\IC73\design\CallCenterQ\
ccq.adl
2. In the tree pane, expand Components > Physical DB Connections and select
ccqDBConnection.
3. In the DB Connection Properties tab, enter the information for the fields in the General
group mentioned in the following table:

Property Recommended entry Notes

Timeout (sec) Type the maximum number of Default value is 60 seconds.


seconds that the client If no response is returned within the
application waits for a response specified time, the client application
to a database request before closes the connection to the Data
the application assumes the server and returns an error. The client
connection to the Data server is application attempts to create a new
lost. connection to the database on the next
database request.
Description Type a description of the You can leave this field empty.
database connection, if desired.
Display Time Select a display time option. The display time option determines
how IC handles the difference in time
between the agent desktop system
and the time as reported by the
Database for all database activities,
such as select, insert, and update.
For more information about the display
time options, see Setting the display
time for IC databases on page 75.

4. From the Database Type drop-down list, select the type of database to which you want to
connect.
Database Designer uses the selected database type to generate a SQL statement which
can be applied to the database.

Installation and Configuration March 2012 87


Chapter 4: Configuring databases

5. Enter the information for the mandatory fields for your database mentioned in the following
table:

Database type Property Recommended entry Notes

All database Data Server Type the name of the This server is the one that
types Type/Alias primary Data server. you created in Setting up a
Data server on page 66.
For example, defaults are:
l DataServerMSSQL

l DataServerOracle

l DataServerDB2

SQL Server Database server Type the host name of For the default database
the system that hosts instance, type the host
your database server. name.
For another database
instance, type <system>\
<db_name>.
Database Name Type the name of the Use the ccq to reduce the
CallCenterQ database. possibility of a migration
For example, ccq. impact.
Oracle TNS Name Type the server alias For example, type
from the tnsnames.ora support.xyzcorp.com.
file
Database Name Type the name of Oracle Use the ccq to reduce the
user for the CallCenterQ possibility of a migration
database. For example, impact.
ccq.
Client Library Type the full directory For example, type .../
Home Directory path for the Oracle client opt/oracle/Ora11
on the system that hosts
the Data server.

88 Installation and Configuration March 2012


Creating the CCQ database

Database type Property Recommended entry Notes

DB2 DB2 Database Type the name of the DB2 allows a maximum of
Name DB2 database that eight characters for
includes the IC schema. database names.
For example, type db2IC.
IC Schema Name Type the schema name Use the ccq to reduce the
of the CallCenterQ possibility of a migration
database. For example, impact.
ccq.
Database Type the territory that The territory defines the
Territory represents the locale of language and locale of the
the database that database. For more
includes the information, see the DB2
CallCenterQ schema. documentation.

Installation and Configuration March 2012 89


Chapter 4: Configuring databases

6. If necessary, enter the information for the optional fields for your database mentioned in
the following table:

Database type Property Recommended entry Notes

SQL Server Database Leave this field blank. Identifies the logical space
Location where the named database is
stored.
The SQL Server DBMS
specifies the database
location.
Database Size Leave this field blank. The size of the database
location specifies the amount
of space that the configured
application database
occupies.
The SQL Server RDBMS
specifies the database size.
Log Location Leave this field blank. Database-generated log files
store cumulative transaction
information. The SQL Server
RDBMS specifies a default
location for the database log.
Log Size Leave this field blank. The size of the location for
database log files specifies
the amount of space that the
database-generated log files
can occupy.
The SQL Server RDBMS
specifies a default size for the
database log.

90 Installation and Configuration March 2012


Creating the CCQ database

Database type Property Recommended entry Notes

Oracle Default Type the name of the The database location


tablespace name default tablespace identifies the logical space
where objects are where the named database is
created for the IC stored. If you leave this field
databases. For blank, and the Oracle
example, type RDBMS does not specify a
T_CCQ. database location, Oracle
uses the “system” space to
define the database.
Caution: Configuring a
database in the system
space can crash your
database.
Default Type the number of Caution: If you do not
tablespace size bytes for the size of specify a default tablespace
the default tablespace. size here, and your RDBMS
does not define the default
tablespace size, the default
tablespace can expand to
use all available space.
Temp tablespace Type the name of the Temporary tables store
name tablespace that stores database-generated
temporary files. For intermediate sorting files and
example, type client session information for
T_CCQ_TEMP. Oracle databases. If you do
not specify a location for
temporary tables, the location
is specified by the Oracle
RDBMS.
DB2 Catalogued Node Type the remote node Complete this field if you host
on the system that your Data server on a
hosts the Data server. different system from the IC
databases.
Tablespace Name Type the name of the Complete this field if you
tablespace used by created a dedicated
the CallCenterQ tablespace that the IC
database. Repository database uses.
Note: OA requires
dedicated tablespaces. For
more information, see
Avaya OA Installation
Planning and
Prerequisites.

7. Select File > Save to save the ADL file. Do not close the file.

Installation and Configuration March 2012 91


Chapter 4: Configuring databases

Configuring the CCQ connection set


To configure the CCQ connection set
1. In the tree pane of Database Designer, expand DB Connection Sets and select
DefaultDBConnectionSet.
2. Click the Connection Set Properties tab.
3. From the Logical DB Connections list, select CallCenterQ and make sure that the
properties are set as shown in the following table:

Field Recommended entry

Physical DB Connection Select ccqDBConnection.


Primary Check this box.

4. Select Repository from the Logical DB Connections list and make sure the properties
are set as shown in the following table:

Field Recommended entry

Physical DB Connection Select ccqDBConnection.


Primary Do not check this box.
Use External Database Check this box.
Database Name Type the name of your IC Repository database.
This name must be the exact name that you
gave your IC Repository database. For
example, type repository.

5. Select File > Save to save the ADL file. Do not close the file.

Creating the CCQ database


These steps create the schema for the CCQ database and seed the database with the
configuration data in the seed.cfg file. You do not need to modify the seed file.
The seed data contains system data for the Web Management servers and Web Self-Service.
You must seed the CCQ database with this data if your system includes Web Management and
Email Management.
To create the CCQ database
1. Select File > Database Administration.
2. From the DB Connection Set list, select DefaultDBConnectionSet.

92 Installation and Configuration March 2012


Creating the CCQ database

3. Enter the information for the fields mentioned in the following table:

Field Database type Recommended entry

Configure SQL Server Select Configure.


Oracle Select Configure.
DB2 Select one of the following options:
l If you have run the db2crdb.sh
script to create the database, or
if you have already configured an
IC database, select Schema
Only.
l If you have not run the
db2crdb.sh script and if you
have not yet configured an IC
database, keep Schema Only
unchecked and select
Configure.
Import Seed Data All database types Check this box.

4. If the fields in the following table do not have entries, re-type your IC Manager account and
password.

Field Recommended entry

Login Id Type your IC Manager login ID.


Note: Do not use your DBA login ID and password.
Password Type your password.

5. Click Run to configure the database.


Database Designer pauses briefly between configuring the database and importing the
seed data.
6. Click Close. Do not close the ADL file.

Generating the Interaction Center application


You generate the Interaction Center application to initialize the database with the ADL and
version information and to create the Interaction Center data source.
If you are configuring a localized version of IC, you must import the localized seed data after
you perform this step. For more information, see Importing localized seed data on page 440.

Installation and Configuration March 2012 93


Chapter 4: Configuring databases

To generate the Interaction Center application


1. In Database Designer, select File > Generate Windows Application.
The Generate Windows Application dialog box opens.
2. Enter the information for the fields mentioned in the following table:

Field Recommended entry

Messages Select this check box.


Avaya IC Scripts Select this check box.

3. If the IC system includes Avaya Agent, enter the information for the fields mentioned in the
following table:

Field Recommended entry

Avaya Agent Layout l Select this check box.


l Type the path and file name for the layout file, as
follows: IC_INSTALL_DIR\IC73\design\
QConsole\avaya_agent_<lang>.cdl
where <lang> is the language of the agent desktop. For
example, if Avaya Agent is in English, select
avaya_agent_en.cdl
EDU Layout l Select this check box.
l Type the path and file name for the layout file, as
follows: IC_INSTALL_DIR\IC73\design\
QConsole\eduviewer_<lang>.xsl
where <lang> is the language on the agent desktop. For
example, if Avaya Agent is in English, select
eduviewer_en_US.xsl

For more information about Avaya Agent layouts in non-English languages, see
Configuring Avaya Agent for a supported language on page 438.
4. From the Name list, select interaction_center.
5. Type the path for the directory where you want Database Designer to store the application
files.
For example, type AVAYA_IC73_HOME\apps.
If you do not know the path, click the Ellipsis (…) button and navigate to the directory.
6. From the DB Connection Set drop-down list, select defaultDBConnectionSet.

94 Installation and Configuration March 2012


Creating the CCQ database

7. If the fields in the following table do not have entries, re-enter your IC Manager account
and password.

Field Recommended entry

Login Id Type your IC Manager login ID.


Note: Do not use your DBA login ID and password.
Password Type your password.

8. Click OK.
Database Designer creates a new folder with the same name as the application in the
target directory. This folder contains the Interaction Center ADL files.
9. Select File > Exit to close Database Designer.

Installation and Configuration March 2012 95


Chapter 4: Configuring databases

96 Installation and Configuration March 2012


Chapter 5: Configuring core servers

Avaya Interaction Center (IC) installation copies all IC server files to the target computer. You
cannot copy only the files for selected servers on a computer. If your IC configuration requires
only certain servers on a computer, run the IC installation on that computer to copy the server
files, then configure only those servers that you want to host on the computer.
This section describes how to configure the core servers, including the IC domains and
accounts required for these servers. This section includes the following topics that provide
information and the steps that you need to follow to configure the core servers:
1. Before you configure IC core servers on page 97.
2. Using IC domains on page 98.
3. Setting up administrative accounts on page 102.
4. Using system and sample workflows on page 107.
5. Configuring core servers on page 108.
6. Starting and stopping IC servers on page 131.
7. Starting and stopping IC services on page 138.

Before you configure IC core servers


Before you configure the IC core servers, make sure that you:
1. Install and configure all prerequisite software and hardware. For more information, see
Avaya IC Installation Planning and Prerequisites.
2. Copy the IC server files to the target computers. For more information, see Installing IC
server and administration components on page 28.
3. Configure the server environment. For more information, see Configuring the ORB server
environment on page 34.
4. Configure the IC databases. For more information, see Configuring databases on page 65.

Installation and Configuration March 2012 97


Chapter 5: Configuring core servers

Creating sites
A site is a physical location that agents or servers can occupy in an IC system. For a single site
system, you can use the Default site that is pre-configured.
For an IC system that includes multiple physical locations, create a site for each physical
location. The site name should identify the physical location. IC uses the site information for
routing decisions. For more information, see Interaction Center Administration Guide.
To create a site
1. In IC Manager, select Tools > Site.
2. In the Site Editor dialog box, click New.
3. In the Create Site dialog box, enter the information for the following fields:
a. Name: Enter the name for the site that identifies the physical location.
b. Description: Enter the description of the site.
4. Click OK.
5. In the Site Editor dialog box, Click OK.

Using IC domains
At a minimum, an IC system should include the pre-configured domains installed with IC.
Create multiple IC domains for your servers and agents to increase performance and allow IC to
handle higher contact rates. For example, use a Voice domain for the servers used for
Telephony.
To use domains, review and perform the steps in the following topics:
1. Preconfigured domains on page 99.
2. Guidelines for IC domains on page 100.
3. Creating domains on page 101.
4. Establishing the failover order for domains on page 101.

98 Installation and Configuration March 2012


Using IC domains

Preconfigured domains
IC includes several domains that are pre-configured with failover paths. The following table
describes the pre-configured domains.

Preconfigured domain Members Failover path

Default l Alarm server l Default


l Directory server
l License server
l ORB server
Email None l Email
l Email_Helper
l Web
l Default
Email_Helper None l Email_Helper
l Email
l Default
Prompter1 None l Prompter1
l Default
l Voice1
User1 None l User1
l Prompter1
l Voice1
l Default
l Email
l Email_Helper
l Web
l Web_Helper
Voice1 None l Voice1
l Default
Web None l Web
l Web_Helper
l Email
l Default

Installation and Configuration March 2012 99


Chapter 5: Configuring core servers

Preconfigured domain Members Failover path

Web_Helper None l Web_Helper


l Web
l Default
Website None l Website
l Web
l Voice1
l Default

Guidelines for IC domains


IC domains can span servers at different locations and multiple domains can share the same
server. A failover order is associated with each domain. The failover order defines how the
members of a domain failovers to servers in other domains. If a server in one domain becomes
unavailable, the requests to that server are routed to a server in the failover domain.

Tip:
Tip: Plan your failover policy carefully. If you specify a failover domain at a remote
site, you must ensure that you have a high-bandwidth connection between the
two sites otherwise system performance might be adversely affected.
While you are deciding on the domains you need in your Avaya IC environment, consider the
following guidelines:
l Use logical names that include identifying information, such as the site, the media channel,
or the agent workgroup.
l Set up the failover paths for domain that include agents to ensure that the domains failover
to one or more domains with an ORB server, Alarm server, and Directory server. If the
domains that contain agents do not failover to domains with these servers, then Avaya
Agent cannot function correctly.
l Do not assign an agent or a server to more than one domain. If you assign an agent or
server to a second domain, IC Manager automatically deletes that agent or server from the
first domain.
l Do not associate multiple servers of the same type with the same domain, with the
possible exception of the ORB server. You can have multiple ORB servers in the same
domain if those servers reside on different computers.

100 Installation and Configuration March 2012


Using IC domains

You should also assign agents to User domains. Typically, you should divide your agents
between two User domains. If you configure the failover of each User domain to the other
domain, then you will have a minimum amount of interruption if a Blender server or agent
Workflow server fails.
For examples of how to divide IC servers between domains, see Avaya IC Installation Planning
and Prerequisites. For more information about domains and failover, see Interaction Center
Administration Guide.

Creating domains
You can add as many domains as you need to handle the agents and servers in your IC system.
For suggested deployments, see Avaya IC Installation Planning and Prerequisites.

! CAUTION:
CAUTION: Do not delete the Default domain. Avaya IC requires the Default domain to
function.
To create a domain
1. On the IC Manager toolbar, click Domains.
2. In the Domain Manager, Select Servers under the Items section.
3. In the left pane, select and right-click All Domains and select New.
4. Enter the new domain name.
The domain name should be maximum of 32 characters, starting with alphabetic
characters. You can use underscores in the domain name but you cannot use spaces.
5. Click OK.
The new domain name is added under All Domains list in the left pane.

Establishing the failover order for domains


If a server becomes unavailable, failover redirects all requests from the clients of the
unavailable server to an alternative server in a failover domain. A server’s client can be an
agent desktop application or another server.
A client or server logs in to the IC system by invoking a DS.Login request. When the
DS.Login request is invoked, there is no information available to identify the group of the client
or domain of the server making the request. IC components assume that the request is come
from the Default domain.

Installation and Configuration March 2012 101


Chapter 5: Configuring core servers

While membership in a domain determines how the domain members communicate to servers,
it also defines how failover is performed. You should take a time to pre-plan your server failover
strategy before proceeding.
You must ensure that your failover plan follows the deployment guidelines, including:

User domain failover: If your User domain does not include a secondary ORB server, the User
domain must failover to a domain that includes an ORB server, such as the Default domain.

Data server failover: When an agent logs in to the Avaya IC system, Avaya IC cannot
determine the agent’s assigned domain until the login request succeeds. Therefore, during the
login process, IC components assume that all agents belong to the Default domain. To ensure
that the Data servers handling login requests failover correctly, these servers must include the
Default domain in their server group.

IC Email server failover: The domain that includes your IC Email server must failover to the
domain that includes your WebACD server.

WebACD server failover: The domain that includes your WebACD server must failover to the
domain that includes your IC Email server.
For more suggestions on how to plan your failover strategy, see the deployment scenarios in
Avaya IC Installation Planning and Prerequisites. You can also establish failover order on a
server-by-server basis. For more information, see Interaction Center Administration Guide.
To establish the failover order for a domain
1. In the Domain Manager, select Servers in the Items section.
2. In the left pane, select a domain for which you want to establish failover.
3. In the right pane, click the Fail Over tab.
4. Select the failover domain from the Available list.
5. Click Add to move the selected domain to the Members list.
You can select multiple domains to add them to failover members. IC uses these failover
domains in the specified order. Use Up and Down arrows located above the Members list
to rearrange failover order. Do not move a failover domain above the primary domain.
6. Click Ok.

Setting up administrative accounts


IC requires two types of administrative accounts:

Human users: These administrative accounts are reserved for human IC users, such as
supervisors and managers. For more information, see Using administrative accounts for human
users on page 105.

102 Installation and Configuration March 2012


Setting up administrative accounts

Non-human users: These administrative accounts are reserved for non-human IC users, such
as servers and IVRs. For more information, see Using administrative accounts for non-human
users on page 103.
This section describes the minimum number of administrative accounts required to install and
configure IC, and how to create those accounts. Topics include:
l About IC passwords on page 103.
l Using administrative accounts for non-human users on page 103.
l Using administrative accounts for human users on page 105.
l Creating administrative accounts on page 105.
For more information about administrative and agent accounts, see Interaction Center
Administration Guide.

About IC passwords
All IC accounts, including administrative accounts and accounts for non-human users, must
have passwords. The password must meet the requirements specified in the Agent/Security
properties for the workgroup or for individual agents.
These requirements include:
l Maximum length
l Minimum length
l Minimum number of alphabetic characters
l Minimum number of numeric characters
For more information, see Interaction Center Administration Guide.

Using administrative accounts for non-human users


The IC components, such as the Configuration Tool and some servers, require administrative
accounts. These accounts should not be used by a human IC user.

! Important:
Important: Configure all IC accounts for non-human users such that the password for these
accounts never expire or change.
These administrative accounts are non-human accounts for IC components only. You do not
need to create these accounts in the User domain. When you create an administrative account
for an IC server or component, such as the ICM server, the account must be in either of the
following domains:

Installation and Configuration March 2012 103


Chapter 5: Configuring core servers

l The same domain as the component that uses the account


l A domain in a failover path from the domain of the component
The following table describes the minimum number of administrative accounts your IC system
requires for non-human IC users.

! Important:
Important: If you plan to use an account created by the seed data, you must change the
password for that account.

Account Component Description Login

New account Avaya IC Create an administrative account in: As defined by user.


servers l The same domain as the Not available in seed
component that uses the data.
account
OR
l A domain in a failover path from
the domain of the component
Note: Do not use the Admin
account created by the seed data,
or an account that you use to log
in to IC Manager.
Admin IC Manager Administration account that you use Login: Admin
login to log in to the Configuration Tool Password: admin
and IC Manager when you configure
IC.
Domain: User1
Role: Administrator
Note: IC Manager forces you to
change the password for this
account.
website Configuration You use this account to configure Login: website
Tool and IC the Web site Web application and Password: website
servers Web Management services.
The IC components in the DMZ use
this account to access other IC
servers and components.
Domain: Website
Role: Operator

104 Installation and Configuration March 2012


Setting up administrative accounts

Account Component Description Login

icmbridge ICM Bridge You use this account to configure Login: icmbridge
the Attribute server. For more Password: icmbridge
information, see Creating the
Attribute server on page 195.
Include a Workflow server in the
same domain as the ICM account.
Domain: Web
Role: Operator
dcobridge1 DCO Bridge The Java Application Bridge uses Login: dcobridge1
this account to access IC servers, Password:
such as the Data server. dcobridge1
Each Java Application Bridge in an
IC system requires a unique DCO
Bridge account.
Domain: User1
Role: Agent

Using administrative accounts for human users


All human IC users who require administrative privileges, such as access to IC Manager and
other Design and Administration Tools, requires administrative accounts. These accounts
should not be used by a non-human IC user. IC user must regularly change the password for
these accounts.

! Important:
Important: When you create an administrative account for a human IC user, the account
must be in the User domain.
You can create an Administration domain that is restricted to administrative accounts for human
users.

Creating administrative accounts


You must create a domain for the administrative accounts before you perform these steps.
You may want to create an additional administrative account in the User domain that can
communicate with the parent directory server. This additional account is useful if you have a
problem with the configuration of one or more domain. After you configure the additional
account, log in to IC Manager using that account and confirm that you can use the account for
administrative access.

Installation and Configuration March 2012 105


Chapter 5: Configuring core servers

To create administrative accounts


1. In IC Manager, click the Agent tab.
2. In the left pane, select Administrator.
If Administrator is not visible, select Manager > Refresh to update the information.
3. Select Agent > New.
4. Click the General tab and enter the information for the fields mentioned in the following
table:

Field Description

First Name Required field


Type agent’s first name.
Last Name Required field
Type agent’s last name.
Preferred Name Required field
Type agent’s preferred name.
Employee ID Type the agent’s company employee ID (optional).
Login ID Required field
Type a login ID that the agent uses for all IC
applications.
Domain Required field
Select the appropriate domain from the list.
Task Load Required field
Set to 0.
Task Ceiling Required field.
Set to 0.
Site Select a site from the drop-down list.
Note: IC uses the Site to compile statistics for
groups or agents or queues.

5. Click the Security tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry

Password Type the password for this account.


Confirm Re-type the password for this account.

106 Installation and Configuration March 2012


Using system and sample workflows

Field Recommended entry

Force password change on Perform one of the following:


login l Check this field for human IC users

l Do not check this field for non-human IC users

Disable login Do not check this field.


Administrator Check this field.
Note: Do not check any of the other roles.

6. Click Ok.

Using system and sample workflows


When you install Workflow Designer, you also install system and sample workflows. IC installs
the project folders for system and sample workflows in subfolders of the following directory:
IC_INSTALL_DIR\IC73\design\IC\Flows\Avaya

! CAUTION:
CAUTION: Do not change a system workflow. If you change a system workflow, one or more
components of your IC system may not function correctly.

Sample workflows
The following table describes the sample workflows for IC.

Workflow project Description

Blender Required for all installations.


ICEmail Required for installations that include Email Management.
Prompter Required for installations that include Prompter.
TS Required for all installations that include Telephony.
WACD Required for all installations that include Web Management or
Email Management.

Installation and Configuration March 2012 107


Chapter 5: Configuring core servers

For a complete list of the workflows in these projects, including the directories where IC installs
the workflows, see Avaya IC Workflow Designer User Guide.

Using sample workflows


You can use sample workflows to set up and test your IC system. When you test your system,
review the settings of the sample workflows for the media channels and components in your IC
system.
You can customize sample workflows to meet the business requirements of your contact center.
For example, the Email Analysis flows in the ICEmail project contains sample routing hints for
testing purposes. You must review and change these properties to the routing hints that meet
your needs of contact center.
After you customize the sample workflows, recompile the workflows and load them in a
database. For more information, see Avaya IC Workflow Designer User Guide.

Workflows in IC seed data


The IC seed data includes compiled system and sample workflows for all projects. When you
create the CCQ database, you import the compiled workflows with the seed data and store
them in that database.
You must update some of these workflows, such as the workflows in the TS project before you
can use them in your IC. For more information, see Avaya IC Workflow Designer User Guide.

Configuring core servers


The IC installation program automatically create some of the core servers when you install the
IC servers and administration components. For more information, see Installing IC server and
administration components on page 28.

! Important:
Important: You have to be careful when you modify the server configuration parameters.
Errors can seriously impact the performance of your IC system.
This section describes the procedures to configure the remaining core servers. You have
already created and configured some core servers. Before you configure media channels and
media-specific servers, perform the steps in the following topics to configure the remaining core
servers:
l Server naming guidelines on page 109.

108 Installation and Configuration March 2012


Configuring core servers

l Recommended tuning parameters for IC servers on page 110.


l Creating an ADU server on page 110.
l Creating a DUStore server on page 111.
l Creating an EDU server on page 116.
l Creating a Report server on page 118.
l Creating a Workflow server on page 119.
l Creating a Blender server on page 123.
l Creating an HTTP Connector server on page 125.
l Creating a Notification server on page 128.
Note:
Note: If you reconfigure a running server in IC Manager, stop and restart the server for
the settings to take effect. Do not check the Auto start option until you
successfully add and configure the servers and start them manually.
These topics contain information about required server parameters. For more information, see
Interaction Center Administration Guide.

Server naming guidelines


Under certain circumstances, the Workflow server fails to connect with a server that uses the
server type as the name of the server. For example, if an ADU server is named "ADU" or a Web
Advocate Adaptor server is named "WAA".
To ensure optimal functioning of your IC system, you must use the following naming
conventions for your IC servers:
l Always use a unique server name, which can be up to 32 characters long without spaces.
l Name your Data servers Data_<databasetype>_<domain>. For example,
Data_Oracle_Default.
l In a single site environment, name all other servers <servername>_<domainname>. For
example: ADU_User1.
l In a multi-site environment, name all other servers
<servername>_<sitename>_<domainname>. For example: ADU_London_User1.
l Do not set the server name to be the same as the server type, or IC may encounter errors
during operation. For example, use TS_Voice1 as the name of your Telephony server, not
just TS.

Installation and Configuration March 2012 109


Chapter 5: Configuring core servers

! Important:
Important: Do not use the name localVDU or localADU for EDU or ADU servers. These are
used when the servers are taken off-line to prevent communication with other
EDU and ADU servers.

Recommended tuning parameters for IC servers


A set of recommended tuning parameters to enhance the performance of an IC system is
available in Interaction Center Administration Guide.

Creating an ADU server


Typically, an IC deployment includes more than one ADU server.
If the IC system includes an ADU server that handles queued ADU entries for a WebACD
server, that ADU server should not accept failover requests from an ADU server that handles
agent accounts. For more information, see Interaction Center Administration Guide.
For Business Advocate the ADU server contains statistics for service classes.
An ADU server must be able to communicate directly with the parent Directory server. For more
information about the parent Directory server, see Creating a Directory server on page 113.
To create an ADU server
1. In IC Manager, select Server > New.
2. From the list of servers, select ADU and Click OK.
3. Click the General tab, and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name ADU_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the server For example, select Voice from
from the drop-down list. the drop-down list if the server
is in the Voice domain.
Host Select the computer’s IP address When you select the host, IC
from the drop-down list, or enter Manager fills in the fields for
the IP address if it is not in the list. Directory, Port, and Executable.

4. Click the ADU tab.

110 Installation and Configuration March 2012


Configuring core servers

5. In the Idle Time (min) field, ensure that the minutes entered are greater than the length of
a shift for an agent.

! Important:
Important: If an agent is logged into an IC agent desktop application for longer than the idle
time set in the ADU server, the ADU for the agent will time-out. An ADU time-out
can cause problems such as inconsistent data in OA reports and the inability to
defer email contacts. Therefore, the idle time should be longer than a typical
agent shift and all agents should log out of IC at the end of a shift.
You can use the default settings for the ADU server. For more information about the
parameters, see Interaction Center Administration Guide.
6. Click OK.
Note:
Note: Do not start this server before you configure all core servers. To ensure that the
servers start correctly, see Starting and stopping IC servers on page 131.

Creating a DUStore server


All IC systems that include Email Management require a DUStore server. You can also add a
DUStore server for Telephony or Web Management. For more information about deployment
scenarios for IC servers, see Avaya IC Installation Planning and Prerequisites.
The IC installation program does not automatically add this server.
To create a DUStore server
1. In IC Manager, select Server > New.
2. From the list of servers, select DUStore, click OK.

Installation and Configuration March 2012 111


Chapter 5: Configuring core servers

3. Click the General tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry Notes

Name DUStore_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the Include the DUStore server in the
server from the drop-down same domain as the EDU server for
list. the channel.
For example, select Email_Helper
from the drop down list if this server
handles email contacts.
For more information about
recommended domains, see Avaya
IC Installation Planning and
Prerequisites.
Host Select the computer’s IP When you select the host, IC
address from the drop-down Manager fills in the fields for
list, or enter the IP address if Directory, Port, and Executable.
it is not in the list.

4. Click the DUStore tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry Notes

IC Data Source Select the IC Data Source, which If you used the default name,
is the ADL file, for the IC select repository.
Repository database.
Default deletion Enter the number of days that Default is 60 days.
age (Days) Avaya IC holds an EDU in After this period, the DUStore
absence of other information. deletes the EDU from the
DUStore table and retires the
EDU to the database.
Deleted per scan Enter the number of EDUs the Default is 1000.
DUStore retires to the database
when it scans the system for
expired EDUs.

112 Installation and Configuration March 2012


Configuring core servers

Field Recommended entry Notes

Scan Interval Enter the period of time, in Default is 15.


(min) minutes, the server scans for Higher values may save some
expired EDUs. CPU time; lower values make
for more predictable behavior
during prototyping and testing.
Assume that other timers in the
EDU could be off by as much as
(this interval + 1) to start.
Purge Alarm Check to raises an alarm if a Default is checked.
delete scan finds any EDUs that
meet the criteria for deletion and
retirement to the database.

5. Click OK.
Note:
Note: Do not start the DUStore server before you configure all the core servers. To
ensure that the servers start correctly, see Starting and stopping IC servers on
page 131.

Creating a Directory server


The Directory server maintains a list of all the servers in Avaya IC. When you create multiple
Directory servers, they share one common directory.
This section includes the following topics:
l Configuring the primary Directory server on page 113
l Creating a secondary Directory server on page 115

Configuring the primary Directory server


You must designate one Directory server to synchronize the directories and ensure that
changes made by one Directory server are reflected throughout the network. This designated
Directory server is called the parent. If there is only one Directory server in Avaya IC, IC
Manager automatically assigns parent status to that server. For more information, see
Interaction Center Administration Guide.
Usually, the primary Directory server is on the same computer as the primary ORB server.
To configure the primary Directory server
1. In IC Manager, click the Server tab.
2. Double-click the Directory server to open the Server Editor.

Installation and Configuration March 2012 113


Chapter 5: Configuring core servers

3. Click the Directory tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

IC Data Source Select the IC Repository data If you used the default name, select
source from the IC Data Source repository.
drop-down list.
Is Parent Check this box as this Directory The parent Directory server
server will be the parent synchronizes the directories for all
directory server. Directory servers.
Backup Enter the name of a backup file Avaya IC appends an .ffd extension
to be created. This file used a to the file name.
backup copy of the directory.
Click the Start button to create
the file in the server’s home
directory.
Restore Enter file name of the backup The file name you enter must be a
file used as the name of the previously created backup directory
directory you want to restore. file.
Click the Start button to restore
the directory.
First update lag Enter the number of seconds During normal operation, set this
(sec) that the Directory server waits value to 0. (A small delay occurs
before sending updates to the automatically.)
first of its children. There is no maximum value.
If this value is greater than 0, the
Advanced tab contains a couple with
the name "PropagationDelay" and a
value equal to the current buffer
updates setting.
Succeeding update Enter the number of seconds During normal operation, set this
lag (sec) that the Directory server pauses value to 0 or 1.
before sending an update to the There is no maximum value.
next child.
If this value is greater than 0, the
Advanced tab contains a couple with
the name "LagBetweenChildren" and
a value equal to the current childlag
setting.

4. Click OK.
5. Stop and restart the Directory server.

114 Installation and Configuration March 2012


Configuring core servers

Creating a secondary Directory server


To create a secondary Directory server:
1. In IC Manager, click the Server tab.
a. Select Server > New.
b. From the list of servers, select Directory.
c. Click OK.
2. Click the General tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Directory_<domain> Include the domain in the server


name to identify the server.
Domain Select the domain from the For example, select Default
drop-down list. from the drop-down list if the
server is in the Default domain.
Host Select the computer’s IP When you select the host, IC
address from the drop-down Manager fills in the fields for
list, or type in a new IP Directory, Port, and Executable.
address.

3. Click the Directory tab and complete the fields as shown in the following table.

Field Recommended entry Notes

IC Data Source Select the IC Repository data If you used the default name, select
source from the IC Data Source repository.
drop-down list.
Is Parent Do not check this box, as this The parent Directory server
Directory server is a secondary, synchronizes the directories for all
or child, Directory server. Directory servers.
Backup Enter the name of a backup file Avaya IC appends an .ffd extension
to be created. This file used a to the file name.
backup copy of the directory.
Click the Start button to create
the file in the server’s home
directory.

Installation and Configuration March 2012 115


Chapter 5: Configuring core servers

Field Recommended entry Notes

Restore Enter file name of the backup The file name you enter must be a
file used as the name of the previously created backup directory
directory you want to restore. file.
Click the Start button to restore
the directory.
First update lag Enter the number of seconds During normal operation, set this
(sec) that the Directory server waits value to 0. (A small delay occurs
before sending updates to the automatically.)
first of its children. There is no maximum value.
If this value is greater than 0, the
Advanced tab contains a couple with
the name "PropagationDelay" and a
value equal to the current buffer
updates setting.
Succeeding update Enter the number of seconds During normal operation, set this
lag (sec) that the Directory server pauses value to 0 or 1.
before sending an update to the There is no maximum value.
next child.
If this value is greater than 0, the
Advanced tab contains a couple with
the name "LagBetweenChildren" and
a value equal to the current childlag
setting.

4. Click OK.
5. Copy the ds.ffd file from the computer that hosts your primary Directory server to the
computer that hosts your secondary Directory server.
6. In IC Manager, start the secondary Directory server.

Creating an EDU server


Create at least one EDU server for each media type in your IC system. For example, using the
pre-configured domains, if your IC system includes all three channels, create the following EDU
servers:
l VoiceEDUServer in the Voice1 domain
l WebEDUServer in the Web_Helper domain
l EmailEDUServer in an Email_Helper domain
The IC installation program does not automatically add these servers.

116 Installation and Configuration March 2012


Configuring core servers

! Important:
Important: IC requires that you place each EDU server in a separate IC domain. An IC
domain cannot include more than one EDU server. For more information about
recommended deployment scenarios and guidelines for the EDU server, see
Avaya IC Installation Planning and Prerequisites.
To create an EDU server:
1. In IC Manager, select Server > New.
2. From the list of servers, select EDU and click OK.
3. In the Initialize EDU dialog box, select the media type from the drop-down list and click
OK.
4. Click the General tab, and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name EDU_<domain>_<media> Include the domain in the server


name to identify the server.
For example, if you must create an
EDU server for voice media, type
EDU_Voice1_Voice.
Domain Select the IC domain for the For voice contacts, add the EDU
server from the drop-down server to the same domain as the
list. associated Telephony server.
For chat contacts and email
contacts, add the EDU server to a
"Helper" domain. For example,
select Email_Helper from the
drop-down list if this server
handles email contacts.
For more information about
recommended domains, see
Avaya IC Installation Planning and
Prerequisites.
Host Select the computer’s IP When you select the host, IC
address from the Manager fills in the fields for
drop-down list, or type in Directory, Port, and Executable.
the IP address if it is not in
the list.

5. Click the EDU tab and review the default settings.


You can use the default settings for the EDU server to get your system up and running. For
more detailed information about these parameters and how to customize them for your
system, see Interaction Center Administration Guide.

Installation and Configuration March 2012 117


Chapter 5: Configuring core servers

6. Click OK.
Note:
Note: Do not start this server before you configure all core servers. To ensure that the
servers start correctly, see Starting and stopping IC servers on page 131.

Creating a Report server


The Report server writes values from EDUs to the IC Repository database. OA uses these
values to generate historical reports.
The IC installation program does not automatically add Report server.
On the Debug tab, if you set the Server Trace Level field to 10, the Report server saves text files
with information about each EDU in the IC_INSTALL_DIR\IC73\temp directory. The Report
server name these text files <eduid>.txt. IC does not automatically delete these files. You
must manually delete them when they are no longer needed for debugging. If you do not reset
the Server Trace Level, the files will continue to accumulate in the IC_INSTALL_DIR\IC73\
temp directory.
To create a Report server
1. In IC Manager, select Server > New.
2. From the list of servers, select Report and click OK.
3. Click the General tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Enter a name for the Report Include the domain in the server
server. name to identify the server.
For example, Report_<domain>
Domain Select the IC domain for the For example, select Voice1
server from the drop-down list. from the drop-down list if the
server is in the Voice domain.
Host Select the computer’s IP address When you select the host, IC
from the drop-down list, or enter Manager fills in the fields for
the IP address if it is not in the list. Directory, Port, and Executable.

118 Installation and Configuration March 2012


Configuring core servers

4. Click the Report tab, and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

IC Data Source Select the IC Data Source for For example, if you used the
the IC Repository database. default name to create the IC
Repository application, the data
source name is repository.

5. Click OK.
Note:
Note: Do not start this server before you configure all core servers. To ensure that the
servers start correctly, see Starting and stopping IC servers on page 131.

Creating a Workflow server


The IC installation program does not automatically add Workflow server. Typically, an IC system
includes more than one Workflow server.
To create the Workflow server, perform the steps in the following topics:
1. Configuring multiple Workflow servers on page 119.
2. Creating a Workflow server on page 120.
3. Completing the Workflow server configuration on page 123.

Configuring multiple Workflow servers


For a large IC system that has a high contact delivery rate and that hosts servers across
multiple computers, you can distribute the workflow responsibilities across multiple Workflow
servers to maximize performance and response.
For example, you can set up the following workflow servers to process contacts in the different
media channels and to handle the different agent-related tasks:

Workflow server for the voice channel: Runs voice contact routing workflows to process
voice contacts. These Workflow servers are in a voice domain. For more information, see
Configuring a Workflow server for Telephony on page 182.

Workflow server for the chat channel: Runs web contact routing workflows to process
incoming chat contacts. These Workflow servers are in a Web domain. For more information,
see Configuring a Workflow server for Web Management on page 220.

Installation and Configuration March 2012 119


Chapter 5: Configuring core servers

Workflow server for the email channel: Runs email contact routing workflows and email
analysis workflows to process incoming and outbound email contacts. These Workflow servers
are in an email domain. For more information, see Configuring a Workflow server for Email
Management on page 297.

Workflow server for agent prompting: Runs Prompter workflows and agent script workflows.
For information on how to configure a Workflow server to run Prompter flows, see Creating a
Workflow server on page 120.

Workflow server for agent searches and transfers: Runs agent search and transfer
workflows for the Unified Agent Directory. These Workflow servers are in a User domain. For
more information about configuration for these servers, see Configuring a Workflow server for
transfers and conferences on page 347.

Creating a Workflow server


The instructions given here create a basic Workflow server. You must configure this Workflow
server to handle the appropriate tasks. For more information, see Configuring multiple Workflow
servers on page 119. For more detailed information about parameters in the Workflow server,
see Interaction Center Administration Guide.
To create a Workflow server
1. In IC Manager, select Server > New.
2. From the list of servers, select Workflow.
3. Click OK.
4. Click the General tab, and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Workflow_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the For example, select Users1
server from the drop-down list. from the drop-down list if the
server is in the Users1 domain.
Host Select the computer’s IP address When you select the host, IC
from the drop-down list, or enter Manager fills in the fields for
the IP address if it is not in the list. Directory, Port, and Executable.

5. Click the Workflow tab and perform the following steps:


a. From the IC Data Source drop-down list, select the data source that this Workflow
server uses.
Most Workflow servers use the Interaction Center data source. The default name for
this data source is interaction_center.

120 Installation and Configuration March 2012


Configuring core servers

Note:
Note: For a Workflow server that runs Prompter flows and agent script workflows, the IC
Data Source must match the database that was used to build and store the
workflows.
b. Review the remaining fields on the tab, as shown in the following table. You will need
to complete some of these fields, such as the Synchronous Startup Flows, when you
create Workflow servers for specific tasks.

Field Recommended entry Notes

Reload Flows Select this button to reload You can choose to update file-based
workflows in the Workflow workflows and workflows stored in
server. the database, and whether to force
an immediate reload rather than wait
for running workflows to complete
execution.
Select Force immediate reload to
reload all currently loaded flows even
if the version numbers are the same.
Unload Flow Select this button to unload a When the workflow is next
workflow from the server. You requested, the latest version of the
will be prompted to enter the workflow will be loaded from the
workflow name. Database or File System.
If the workflow is currently running, it
will complete before being unloaded.
You must manually increment the
workflow version number. If the
version has not been incremented,
the workflow is not reloaded.
Run Flow Select this button to run a Enter the workflow name. The
workflow that updates the queue-workflow information is
variable that contains required by contact routing flows in a
queue-workflow information. Blender environment. Update the
variable whenever any change is
made to the queue.
IC Data Source Select a data source from the For most Workflow servers, select
drop-down list. the Interaction Center data source. If
you used the default name, select
interaction_center.

Installation and Configuration March 2012 121


Chapter 5: Configuring core servers

Field Recommended entry Notes

Preload Flows Select the Ellipsis (…) and If you have a workflow that must
specify the workflow to be react very quickly when the event
loaded when the server is triggering it is received by Avaya IC,
first started. use the Preload Flows option to have
that flow ready and waiting in
memory. When the event actually
occurs, Avaya IC can run the flow
without having to load it first.
Syntax: projectname.flowname
Note: Preloading a large flow can
slow down server startup.
Synchronous Select the Ellipsis (…) and For example, Workflow servers that
Startup Flows specify the workflow to be run contact routing workflows need
loaded before the startup to run
workflows and before the web_routing.update_qw_cache as a
server accepts requests. synchronous startup workflow.
Startup Flows Select the Ellipsis (…) and These workflows are run in addition
specify the workflow to be run to Initial Startup Script. Workflows in
when the Workflow server this list are not guaranteed to
starts. execute in any particular order in
relation to themselves, Initial Script,
or arriving requests.
Note that the Initial Script field also
specifies a flow to be started, but that
parameter can set only one flow. You
can specify multiple Startup Scripts.
Semaphores Select the Ellipsis (…) and For more information about
specify the list of semaphores semaphores, see the Avaya IC
used by the workflows. Media Workflow Reference.
Directory tables Select the Ellipsis (…) and
specify the Directory server
tables to be preloaded in
memory at startup.
Event Threads Accept the default or enter a The default entry is 10.
number of threads. The number of threads that are
listening and available to process
events sent to the server.
Enable Heap Do not check this field unless: This field is for debugging workflows
Validate l Instructed by Avaya
only. Impacts performance of the
Technical Support Workflow server if checked.
l Debugging a workflow
If the Workflow server fails when it
runs a workflow, use this field to
check each block as the workflow
runs to ensure that the block does
not corrupt the Heap.

122 Installation and Configuration March 2012


Configuring core servers

6. Click OK.
Note:
Note: Do not start this server before you configure all core servers. To ensure that the
servers start correctly, see Starting and stopping IC servers on page 131.

Completing the Workflow server configuration


For the Agent Prompting Workflow server, configure your agent desktop and your agents for
Prompter and wrapup functionality. A sample Prompter workflow is included in the seed data.
This sample workflow is only intended to help you to test Prompter and agent wrapup. For
information about how to create and modify Prompter workflows, see Agent Script Workflow
Reference.
You complete the configuration of other Workflow servers when you configure the media
channels and other components, such as the Unified Agent Directory, in your IC system. You do
not need to configure these components at this point in your installation and configuration.

Creating a Blender server


The Blender server controls agent availability across the different channel types and monitors
ADU change events.
The Blender server depends on the Workflow server. Therefore, you cannot configure the
Blender server if you have not already performed the steps in Creating a Workflow server on
page 119. If the Blender server connects to a Workflow server for a media channel, create the
Blender server after you configure the Workflow server.
Do not assign a Blender server to a domain that cannot be reached by agents. If agents cannot
reach the Blender server, the IC system will operate incorrectly.The domain for a Blender server
must meet one of the following guidelines:
l The Blender server must be in the same domain as a Workflow server and an ADU server.
OR
l The failover path for the domain of the Blender server must include a Workflow server and
an ADU server.

! Important:
Important: If the Blender server domain does not include a Workflow server and an ADU
server, or those servers are not in the failover path for the Blender server, you will
not be able to start the Blender server. For more information, see Avaya IC
Installation Planning and Prerequisites.
The IC installation program automatically adds this server.

Installation and Configuration March 2012 123


Chapter 5: Configuring core servers

To create a Blender Server:


1. In IC Manager, select Server > New.
2. From the list of servers, select Blender.
3. Click OK.
4. Click the General tab, and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Blender_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the server For example, select Default
from the drop-down list. from the drop-down list if the
server is in the Default domain.
Host Select the computer’s IP address When you select the host, IC
from the drop-down list, or enter Manager fills in the fields for
the IP address if it is not in the list. Directory, Port, and Executable.

5. Click the Blender tab, and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

WorkFlow Server Select the Workflow server If you only have one Workflow server
used by this Blender server and one Blender server, select
from the drop-down list. Workflow_system.
If your configuration includes
multiple Workflow and Blender
servers, select the Workflow server
that you created to work with this
Blender server.
Flow Set Enter the name of the The default name is blender.
workflow project that contains
the Blender flows.
Initialization Flow Enter the name of the Default name is initialization.
workflow that initializes the
Blender server.

124 Installation and Configuration March 2012


Configuring core servers

Field Recommended entry Notes

Initialization Data You can leave this field blank. Optional field.
Name The initialization data name contains
values to be added to indata when
InitRule is run. InitRule has an indata
Event and outdata Event that fill in
indata with a string (InitName) and
seqcouple (InitData).
Initialization Data You can leave this field blank. Optional field.
The name to add to indata when
InitRule is run.
Client Login Flow Enter the name of the Client Default name is clientlogin.
Login workflow.
Client Logout Enter the name of the Client Default name is clientlogout.
Flow Logout workflow.

6. Click OK.
Note:
Note: Do not start this server before you configure all core servers. To ensure that the
servers start correctly, see Starting and stopping IC servers on page 131.

Creating an HTTP Connector server


The IC installer does not install the HTTP Connector server.
Prompters use the HTTP Connector server. You can create separate HTTP Connector servers
for each of these features.
You can host more than one HTTP Connector server on a same system if the HTTP Connector
servers use different HTTP ports.
To create an HTTP Connector server:
1. In IC Manager, select Server > New.
2. From the list of servers, select HTTPConnector and click OK.

Installation and Configuration March 2012 125


Chapter 5: Configuring core servers

3. Click the General tab, and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name HTTPConnector_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the server For example, select Default
from the drop-down list. from the drop-down list if the
server is in the Default domain.
Host Select the computer’s IP address When you select the host, IC
from the drop-down list, or enter Manager fills in the fields for
the IP address if it is not in the list. Directory, Port, and Executable.

4. Click the HTTPConnector tab and enter the information for the fields mentioned in the
following table.

Field Recommended entry Notes

IC Data Source Select the application name If you used the default name,
associated with the server. This select interaction_center.
name should match the IC Data You created this data source in
Source setting for the Generating the Interaction
corresponding Workflow server. Center application on page 93.
Workflow Server Select the name or type of the
Workflow server that this
connector should use to execute
Workflows and Prompter flows.
Doc Directory Accept the default or enter a new The directory where the server
directory path. looks for java script and error
pages to serve to prompter and
agent applications. Always
consider as the relative path
from the IC_INSTALL_DIR\
IC73\.
Start Page Accept the default or enter a new The name of the file that the
file name. Prompter serves when a client
asks for a director.
Enable SSL Select the check box if you want to
enable the Secure Sockets Layer
(SSL) security.
Certificate File The server certificate file that the The field is visible only when
HTTP Connector server uses. you select the Enable SSL
check box.

126 Installation and Configuration March 2012


Configuring core servers

Field Recommended entry Notes

Key File The key file that the HTTP The field is visible only when
Connector server uses. you select the Enable SSL
check box.
HTTP Port Enter 9170 for default port. The server uses this port for
HTTP requests.
If you must change this port,
see Avaya IC Installation
Planning and Prerequisites for a
list of the default port numbers
used by the other Avaya IC
servers. Port conflicts can
cause serious problems within
the Avaya IC system.
Note: If you run multiple
HTTP Connector servers on
the same computer, ensure
that they use different ports.
Request Timeout Enter the number of seconds that The upper limit of the response
(sec) the HTTP Connector should wait time (in seconds) of the
for a response from one of its Workflow server. The HTTP
clients. Connector assumes the current
HTTP request from the client
has timed out if it did not receive
a response from the Workflow
server within this time interval.
The default is 60 seconds.
Session Timeout Enter the time in seconds that the The maximum idle time for a
(sec) agent has to complete a page and session. Agent needs to
submit the information back to the complete and submit the
server. information of the current page
within the specified interval
value. The HTTP Connector
assumes the session as timed
out if it did not receive any
response from the agent within
this time interval.
The default is 600 seconds.

5. Click OK.
6. If the IC system includes support for:
l Traditional Chinese, configure the language support as described in Configuring an
HTTP Connector server for Traditional Chinese on page 445.
l Russian, configure the language support as described in Configuring an HTTP
Connector server for Russian on page 445.

Installation and Configuration March 2012 127


Chapter 5: Configuring core servers

Note:
Note: Do not start this server before you configure all core servers. To ensure that the
servers start correctly, see Starting and stopping IC servers on page 131.

Creating a Notification server


The IC installation program does not automatically add this server.
Before you create the Notification server, configure the SMTP and POP3 email servers and
verify the configuration, as described in Avaya IC Installation Planning and Prerequisites.
To create a Notification server:
1. Select Server > New in IC Manager.
2. From the list of servers, select Notification and click OK.
3. Click the General tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Notification_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the server For example, select Default
from the drop-down list. from the drop-down list to add
the server to that domain.
Host Select the computer’s IP address When you select the host, IC
from the drop-down list, or enter Manager fills in the fields for
the IP address if it is not in the list. Directory, Port, and Executable.

4. Click the Notification tab and enter the information for the fields mentioned in the
following table.

Field Recommended entry Notes

IC Data Source Select the Interaction Center If you used the default name, select
data source. interaction_center.
You created this data source in
Generating the Interaction Center
application on page 93.
SMTP Server Enter the name of your Email This is the server that Avaya IC uses
Name server. for outbound email. For example,
enter MailSrvExchange.

128 Installation and Configuration March 2012


Configuring core servers

Field Recommended entry Notes

SMTP Domain Enter the domain where your For example, enter xyzcorp.com
IC Email server is located
Default Sender Enter a valid email address For example, enter
Email Address that acts as the sender of the [email protected].
notification emails.
Note: Do not use an agent
address as the Default Sender
Email Address.
Poll Interval 60 Number of seconds between polls.
(sec)
Poll Future (sec) 86,400 Number of seconds for a long poll.
The default equals 24 hours.
Search Limit 250 Number of database records for
Notification Server to process at the
same time.
Work Schedule Enter the name of the work The name of the work schedule the
Name schedule, if desired. server should use to determine
business time.
Notification Accept the default, or enter The number representing the agent
Agent another agent number, if for which this service instance
desired. responds. Agent #0 is the default,
and catches all messages. You can
also configure multiple Notification
server agents, where Agent #1 is for
all escalations and Agent #2 is for
email and printer.
Note: If you configure multiple
Notification server agents, you
cannot specify an Agent #0,
because Agent #0 responds to all
messages.
Fire Direct Check this field, if desired. Select this option if the server should
Notification fire notifications.
Fire Escalations Check this field, if desired. Select this option if the server should
send scheduled escalations.

Installation and Configuration March 2012 129


Chapter 5: Configuring core servers

Field Recommended entry Notes

Fire Scheduled Check this field, if desired. Select this option if the server should
Reports run scheduled reports.
Language Select the language in which The allowable codes are:
data for this server will be l en (English)
written.
l fr (French)

l de (German)

l es (Spanish)

l it (Italian)

l pt (Portuguese)

l zh (Chinese, Simplified)

l ko (Korean)

l ja (Japanese)

l th (Thai)

l zt (Traditional Chinese)

l ru (Russian)

5. Click OK.
6. To configure an alternate email encoding for a language such as Japanese, see
Configuring a Notification server for alternate email encodings on page 444.
Note:
Note: Do not start this server before you configure all core servers. To ensure that the
servers start correctly, see Starting and stopping IC servers on page 131.

130 Installation and Configuration March 2012


Starting and stopping IC servers

Starting and stopping IC servers


After you add and configure the servers, you can modify the server configuration in IC Manager.
However, if you modify multiple servers, you must start and stop the servers in a specific order.
Dependencies between the servers determine the order. If you do not start and stop the servers
in correct order, your IC system may lose data or encounter other problems. For more
information, see Interaction Center Administration Guide.

! CAUTION:
CAUTION: Never stop the DUStore server before you stop the EDU server. If you stop the
DUStore server first, you may lose EDU data. Always stop these servers in the
following order:
1. EDU server
2. ADU server
3. DUStore server
4. Report server
This section covers startup and shutdown for all IC servers, including some servers that you do
not install and configure until later in the installation process.
This section includes the following topics:
l Determining server dependencies on page 131.
l Starting and stopping the ORB server on page 134.
l Starting and stopping servers in IC Manager on page 136.
l Stopping all servers on page 136.
l Starting and stopping servers with the IC Admin utility on page 137.

Determining server dependencies


Starting and stopping servers in IC is a simple process. However, you should exercise caution
because starting or stopping IC processes in the wrong order can lead to data loss or system
errors. In addition, if your IC installation spans multiple computers, you need to pay attention to
the order in which the computers are shut down because of the impact on other IC services.
This section includes the following topics:
l Server startup dependencies on page 132.
l Server shutdown dependencies on page 133.

Installation and Configuration March 2012 131


Chapter 5: Configuring core servers

Server startup dependencies


Servers can be started:
l Explicitly by an administrator
l Automatically when the computer on which they reside is started
l As a result of a request from a client

Tip:
Tip: The start up time for each server depends on factors, such as user population,
number of queued emails, and database size. If your servers take a long time to
start, you can reduce the server load by adjusting some of these dependencies.
To view the state of each server, use the Alarm Monitor in IC Manager. As servers are started,
that server’s state changes to “Up,” and ORB server sends informational messages to the
Alarm Monitor. If IC Manager is running and the Alarm server fails, IC prompts the administrator
to immediately monitor alarms again.
The ICM, IC Web site (Tomcat), CIRS, and ICM Bridge (Attribute server) are dependent on
several IC servers. These components perform a client login that, at minimum, requires the
Directory, Alarm, ORB, and Data servers to be running.
To work with a Web Server such as IIS, IBM HTTP server, and Oracle iPlanet server, IC uses
ISAPI and NSAPI filters respectively. These interfaces are used to enable Web Management,
DataWake, and Tomcat support using plugins that can recover if a dependent component is not
available.
The VOX server interfaces with an IVR (Interactive Voice Response) Unit. If the VOX server
connects to an external IVR, you should start the IVR first. The VOX server will attempt to
connect to the configured IP address and port, for the length of time specified in the VOX
server’s Maximum Wait Time and Disable Wait parameters. If the IVR connects to the VOX
server, the VOX server must be started first.

Tip:
Tip: For an IC deployment that includes IC and OA components on the same
computer, always start the IC components first, then start the OA components to
avoid potential port conflicts.

132 Installation and Configuration March 2012


Starting and stopping IC servers

Server shutdown dependencies

! Important:
Important: Shutting down any IC server process or computer may have an impact on agent
clients and dependent processes. Therefore, you should only do so during
non-business hours unless you are dealing with an emergency situation.
If failover is configured, the clients should revert from their primary to their backup servers. The
connections to the backup server will remain active until the client logs out, is restarted, or
another disruption in service occurs.
If failover is not configured and you stop an IC server, active clients may either raise alarms or
show error dialogs and potentially fail if the server is down long enough.
If you need to shutdown an IC server, you should:
l Do so during a scheduled maintenance period when clients are shutdown and incoming
activity can be restricted.
l Use the IC Manager Shutdown option to ensure the correct communication flow between
IC components, IC clients, and the other services that should be stopped. The Shutdown
option ensures that all IC server processes on that computer are shutdown in the correct
order. It does not shut down dependent IC processes located on other computer. To use
this option, see Stopping all servers on page 136.
Before stopping the services on a computer, you need to consider the impact it will have. Other
dependent clients (both agent clients and IC processes) may need to be shutdown first.
To confirm that an IC process was shutdown properly, use the System Administration tools
provided with your operating system make sure that the process is no longer active. IC Manager
may report some servers as being stopped while they are actually finishing important clean up
tasks such as committing data to the database.
IC processes should be restarted as soon as possible in order to minimize the impact on clients.
In many cases, the processes restarts automatically when the computers comes back, or when
client requests trigger the server to restart.
Dependent clients attempts to reconnect if they lose communication with an IC process. If the
stopped process does not recover in time, requests failover based on the server configuration
and the failover strategy implemented at your site.

Installation and Configuration March 2012 133


Chapter 5: Configuring core servers

If you need to shutdown individual IC servers, follow the correct shutdown order to prevent data
loss. Stopping a server obviously results in a disruption of the services provided by that server.
The following table shows the impact of shutting down certain servers.

Server Impact

Alarm server This server is typically the last to be shutdown so that other servers
can still submit alarms.
Data server Without a Data server, other servers will be unable to commit, read,
or write from the database.
DUStore server If you have configured the ADU and EDU servers to persist data
units, these servers become dependent on the DUStore server.
Shutting down the DUStore server before the EDU or ADU servers
will result in data units not being saved.
Event Collector server Without the Event Collector, real time statistics will not be collected
for the associated domain.
ORB server This server is responsible for process management. If the ORB
server is not running, no other IC server can start.

Starting and stopping the ORB server


The ORB server controls other IC servers. You must start the ORB server to open IC Manager.
When you start the ORB server, the Alarm, Directory, EDU, and ADU servers start up in
sequence.

! CAUTION:
CAUTION: Do not use Stop Server in IC Manager, the Windows Task Manager, or the
Windows Services control panel to start or stop the ORB server.
The IC Configuration Tool starts the ORB server the first time. If you must stop and start the
ORB server again, use the IC Admin utility or the IC Manager Shutdown option.
This section includes the following topics:
l ORB server components on page 135
l Configuring the ORB server to start automatically on Windows on page 135
l Configuring the ORB server to start automatically on Solaris on page 135
l Configuring the ORB server to start automatically on AIX on page 135

134 Installation and Configuration March 2012


Starting and stopping IC servers

ORB server components


The following table describes the components of the ORB server.

Component Description

orbsrv.exe Executable for the ORB server


qntorbsrv.exe Windows service executable that starts the orbsrv
executable.
IC ORB Service 7.3 Windows only.
Helper service that represents the qntorbsrv.exe
executable in the Windows Services control panel

Configuring the ORB server to start automatically on Windows


The ORB server is set to automatically start when you install the server. However, if you reboot
a computer and the ORB server does not start, you can follow these steps to manually configure
the ORB server.
To configure the ORB server to start automatically on a Windows computer:
1. Select Start > Control Panel > Services to open the Windows Services control panel.
2. In the list of services, double-click Avaya IC ORB Service 7.3.
3. In the General tab, select Automatic from the Startup Type drop-down list.
4. Click OK.

Configuring the ORB server to start automatically on Solaris


To configure the ORB server to start automatically on the Solaris system:
1. Log in as root.
2. Navigate to the IC_INSTALL_DIR/IC73/bin directory
3. Execute setup_orb.

Configuring the ORB server to start automatically on AIX


To configure the ORB server to start automatically on the AIX system:
1. Log in as root.
2. Navigate to the IC_INSTALL_DIR/IC73/bin directory
3. Execute setup_orb.

Installation and Configuration March 2012 135


Chapter 5: Configuring core servers

Starting and stopping servers in IC Manager


IC Manager allows you to start multiple servers at the same time. The Status column displays
the server’s new status. If the system cannot start a server, IC Manager displays an error
message.

! CAUTION:
CAUTION: Never stop the DUStore server before you stop the EDU server. If you stop the
DUStore server first, you may lose EDU data.
After you add and configure a server, stop and restart that server.
To start or stop a server
1. In IC Manager, click the Server tab.
2. In the right pane, select a server that you want to stop.
3. Click the Start server or Stop server button on the toolbar.

Stopping all servers


You can simultaneously shut down all servers that reside on a computer. The server shutdown
feature in IC Manager shuts down the servers in the correct order. This process can take
several minutes to complete as all servers must complete their current tasks before shutting
down. For example, if there are a lot of persistent EDUs for email contacts, the DUStore server
can take several minutes to write the EDUs to the database.
To shut down all servers:
1. In IC Manager, select Server > Shutdown.
2. Select the IP address or the name of the computer where you want to shut down the
servers.
3. Click Ok.

136 Installation and Configuration March 2012


Starting and stopping IC servers

Starting and stopping servers with the IC Admin utility


You can use the IC Admin utility to:
l Start the ORB server and all IC servers that have Autostart enabled, as described in
Starting servers with the IC Admin utility on page 137.
l Stop the ORB server and all associated IC servers, as described in Stopping all servers
with the IC Admin utility on page 137.
For information about how to start and stop Web services, such as the ICM server, see Starting
and stopping IC services on page 138,

Starting servers with the IC Admin utility


To start servers with the IC Admin utility
1. In a command window, navigate to the directory shown in the following table.

Operating system Directory

Windows IC_INSTALL_DIR\IC73\bin
Solaris IC_INSTALL_DIR/IC73/bin
AIX IC_INSTALL_DIR/IC73/bin

2. Execute the following command:


icadmin so

Stopping all servers with the IC Admin utility


To stop all servers on a computer with the IC Admin utility
1. Navigate to the directory shown in the following table.

Operating system Directory

Windows IC_INSTALL_DIR\IC73\bin
Solaris IC_INSTALL_DIR/IC73/bin
AIX IC_INSTALL_DIR/IC73/bin

2. Execute the following command:


icadmin tv <IC_administrative_user> <password>

Installation and Configuration March 2012 137


Chapter 5: Configuring core servers

Accessing the help for the IC Admin utility


The IC Admin utility includes additional commands that are not listed in this section. The help
for the IC Admin utility includes Information about those additional commands.
To access the help for the IC Admin utility
1. Navigate to the directory shown in the following table.

Operating system Directory

Windows IC_INSTALL_DIR\IC73\bin
Solaris IC_INSTALL_DIR/IC73/bin
AIX IC_INSTALL_DIR/IC73/bin

2. Execute the following command:


icadmin help

Starting and stopping IC services


When you use the Web tab of the Configuration Tool to configure Web applications, the
Configuration Tool creates services for IC.

Tip:
Tip: You must configure all IC services to autostart.
This section describes how to stop, start, and configure startup options for the IC services, and
how to set startup options for the services. This section includes the following topics:
l Starting and stopping services on Windows on page 139
l Starting and stopping services on Solaris on page 139
l Starting and stopping services on AIX on page 142

138 Installation and Configuration March 2012


Starting and stopping IC services

Starting and stopping services on Windows


Use the Windows Service Panel to start, stop, and configure startup options for IC services.
Note:
Note: Depending upon the components installed on the computer, not all of the
following Windows services are displayed in the Windows Service Panel.
To start, stop and configure IC services on Windows
1. In the Services control panel, right-click on one or more of the following services:
l Avaya IC 7.3 ICM Service
l Avaya IC 7.3 CIRS Service
l IC 7.3 SDK Service
l IC 7.3 Web Services Service
l World Wide Web Publishing Service (for IIS)
l Avaya IC Jakarta Service 7.3
l Avaya IC WebLM Service 7.3
l Avaya IC Web Management Service 7.3
l Avaya IC Email Template Management Service 7.3
l Avaya IC Test Service 7.3
2. From the right-click menu, select one of the options in the following table:

Task Options

Start IC services Select Start.


Stop IC services Select Stop.
Set startup options 1. Select Properties.
2. Select Automatic from the Startup Type drop-down
list.
3. Click OK.

Starting and stopping services on Solaris


This section includes the following topics:
l Starting and stopping the ICM server on page 140
l Starting and stopping the CIRS server on page 140

Installation and Configuration March 2012 139


Chapter 5: Configuring core servers

l Starting and stopping Oracle iPlanet Web server on page 140


l Starting and stopping Tomcat Web applications on page 141
l Setting Tomcat Web applications to autostart on page 142

Starting and stopping the ICM server


Execute all ICM server commands from the IC_INSTALL_DIR/IC73/bin directory. For the
ICM server to be able to log in, the IC servers must start before the ICM server.

Starting the ICM server: To start the ICM server, execute the following command:
nohup ./icm.sh start

Stopping the ICM server: To stop the ICM server, execute the following command where
-force is an optional parameter that terminates the server processes:
nohup ./icm.sh stop -force

Setting the ICM server to autostart: To set the ICM server to autostart, add the following
command to the UNIX startup facility:
nohup bin/icm.sh start

Starting and stopping the CIRS server


Execute all CIRS server commands from the IC_INSTALL_DIR/IC73/bin directory. For the
CIRS server to be able to log in, the IC servers must start before the CIRS server.

Starting the CIRS server: To start the CIRS server, execute the following command:
nohup ./cirs.sh start

Stopping the CIRS server: To stop the CIRS server, execute the following command where
-force is an optional parameter that terminates the server processes:
nohup ./cirs.sh stop -force

Setting the CIRS server to autostart: To set the CIRS server to autostart, add the following
command to the UNIX startup facility:
nohup IC_INSTALL_DIR/IC73/bin/cirs.sh start

Starting and stopping Oracle iPlanet Web server


Starting Oracle iPlanet Web Server: To start Oracle iPlanet Web Server, execute the following
command:
<iplanet_home_dir>/https-instance_name/bin/startserv

140 Installation and Configuration March 2012


Starting and stopping IC services

Stopping Oracle iPlanet Server: To stop Oracle iPlanet Server, execute the stop script
packaged with the Web server:
<iplanet_home_dir>/https-instance_name/bin/stopserv

Setting Oracle iPlanet Server to autostart: To set Oracle iPlanet server to autostart, add the
following command to the UNIX startup script:
<iplanet_home_dir>/https-instance_name/bin/start

Starting and stopping Tomcat Web applications


Execute all Tomcat commands for the Web Applications from the IC_INSTALL_DIR/IC73/
bin directory.

Starting all services on a system: To start services for all Web applications, execute the
following command:
nohup ./ictomcat.sh start all

Stopping all services on a system: To stop all services for Web applications, execute the
following command where -force is an optional parameter that terminates the server
processes:
nohup ./ictomcat.sh stop all -force

Starting an individual Web application: To start an individual Web application, execute the
appropriate command from the following table:

Web application Start command

Web site nohup ./ictomcat.sh start website


Web License Manager nohup ./ictomcat.sh start weblm
Email Template Administration nohup ./ictomcat.sh start rlmanager
Client SDK server nohup ./ictomcat.sh start SDK
Web Services server nohup ./ictomcat.sh start webservices

Stopping an individual Web application: To stop an individual Web application, execute the
appropriate command from the following table. -force is an optional parameter that terminates
the server processes.

Web application Stop command

Web site nohup ictomcat.sh stop website -force


Web License Manager nohup ictomcat.sh stop weblm -force

Installation and Configuration March 2012 141


Chapter 5: Configuring core servers

Web application Stop command

Email Template Administration nohup ictomcat.sh stop rlmanager -force


Client SDK server nohup ./ictomcat.sh stop SDK -force
Web Services server nohup ./ictomcat.sh start webservices -force

Setting Tomcat Web applications to autostart


To set them to autostart, add the following command to the UNIX startup facility:
nohup IC_INSTALL_DIR/IC73/bin/ictomcat.sh start all
For the Tomcat Web applications to be able to log in, the IC servers must start first.

Starting and stopping services on AIX


This section includes the following topics:
l Starting and stopping the ICM server on page 142
l Starting and stopping the CIRS server on page 143
l Starting and stopping IBM http Web server on page 143
l Starting and stopping Tomcat Web applications on page 143
l Setting Tomcat Web applications to autostart on page 144

Starting and stopping the ICM server


Execute all ICM server commands from the IC_INSTALL_DIR/IC73/bin directory. For the
ICM server to be able to log in, the IC servers must start before the ICM server.

Starting the ICM server: To start the ICM server, execute the following command:
nohup ./icm.sh start

Stopping the ICM server: To stop the ICM server, execute the following command where
-force is an optional parameter that terminates the server processes:
nohup ./icm.sh stop -force

Setting the ICM server to autostart: To set the ICM server to autostart, add the following
command to the UNIX startup facility:
nohup bin/icm.sh start

142 Installation and Configuration March 2012


Starting and stopping IC services

Starting and stopping the CIRS server


Execute all CIRS server commands from the IC_INSTALL_DIR/IC73/bin directory. For the
CIRS server to be able to log in, the IC servers must start before the CIRS server.

Starting the CIRS server: To start the CIRS server, execute the following command:
nohup ./cirs.sh start

Stopping the CIRS server: To stop the CIRS server, execute the following command where
-force is an optional parameter that terminates the server processes:
nohup ./cirs.sh stop -force

Setting the CIRS server to autostart: To set the CIRS server to autostart, add the following
command to the UNIX startup facility:
nohup IC_INSTALL_DIR/IC73/bin/cirs.sh start

Starting and stopping IBM http Web server


Execute the IBM http Web server commands from the IC_INSTALL_DIR/IC73/bin directory.

Starting IBM http Web Server: To start IBM http Web Server, execute the following command:
./httpserver.sh start

Stopping IBM http Web Server: To stop IBM http Web Server, execute the following
command:
./httpserver.sh stop

Setting IBM http Web Server to autostart: To set IBM http Web server to autostart, add the
appropriate command to the UNIX startup script. For example, add:
nohup IC_INSTALL_DIR/IC73/bin/httpserver.sh start

Starting and stopping Tomcat Web applications


Execute all Tomcat commands for the Web Applications from the IC_INSTALL_DIR/IC73/
bin directory.

Starting all services on a system: To start services for all Web applications, execute the
following command:
nohup ./ictomcat.sh start all

Stopping all services on a system: To stop all services for Web applications, execute the
following command where -force is an optional parameter that terminates the server
processes:
nohup ./ictomcat.sh stop all -force

Installation and Configuration March 2012 143


Chapter 5: Configuring core servers

Starting an individual Web application: To start an individual Web application, execute the
appropriate command from the following table:

Web application Start command

Web site nohup ./ictomcat.sh start website


Web License Manager nohup ./ictomcat.sh start weblm
Email Template Administration nohup ./ictomcat.sh start rlmanager
Client SDK server nohup ./ictomcat.sh start SDK
Web Services server nohup ./ictomcat.sh start webservices

Stopping an individual Web application: To stop an individual Web application, execute the
appropriate command from the following table. -force is an optional parameter that terminates
the server processes.

Web application Stop command

Web site nohup ictomcat.sh stop website -force


Web License Manager nohup ictomcat.sh stop weblm -force
Email Template Administration nohup ictomcat.sh stop rlmanager -force
Client SDK server nohup ./ictomcat.sh stop SDK -force
Web Services server nohup ./ictomcat.sh start webservices -force

Setting Tomcat Web applications to autostart


To set them to autostart, add the following command to the UNIX startup facility:
nohup IC_INSTALL_DIR/IC73/bin/ictomcat.sh start all
For the Tomcat Web applications to be able to log in, the IC servers must start first.

144 Installation and Configuration March 2012


Chapter 6: Installing IC licenses

Avaya Interaction Center (IC) components will not run if you do not install the license server,
and obtain the appropriate license file. For information on how to obtain a license, see Avaya IC
Installation Planning and Prerequisites.
If IC components cannot access the License server and WebLM, agents may not be able to log
in, and servers may not be able to start.
To provide redundant operation in the event of network or WebLM failure, a grace period of 30
days is provided to rectify the failure. The WebLM failure can be WebLM system is down,
WebLM service is down, License file in the WebLM service is corrupted or expired.
Note:
Note: For License Server to enter in a grace period, the License Server must
communicate with WebLM at least once.
To configure IC licensing, perform the steps in the following topics:
1. Before you configure IC licenses on page 145
2. Configuring the Web License Manager on page 146
3. Installing the license file on page 155
4. Configuring the License server on page 157
5. Changing the administrative password on page 159
This sections also includes the following topics:
l Managing users on page 159
l Viewing server properties on page 160
l Viewing information about configured licenses on page 160

Before you configure IC licenses


Before you install and configure WebLM:
1. Obtain a license file for your IC components from Avaya, as described in Avaya IC
Installation Planning and Prerequisites.
2. Install and configure all prerequisite software and hardware, including a Web server and a
JDK, as described in Avaya IC Installation Planning and Prerequisites.

Installation and Configuration March 2012 145


Chapter 6: Installing IC licenses

3. On Solaris system, install a Windowing environment such as X-Windows on the system


that hosts the WebLM.
4. On AIX system, install a Windowing environment such as X-Windows on the system that
hosts the WebLM.
5. Install and configure an IC server environment on a system that hosts the WebLM.
Note:
Note: You should use the WebLM version 4.7.1.

Configuring the Web License Manager


The Web License Manager (WebLM) is a Web application that hosts your IC licence. You must
configure the Web LM on each computer that hosts an IC or OA license. You use the Web tab of
the Configuration Tool to configure the WebLM.
This section describes how to install and configure the Web License Manager for each
operating system that IC supports. This section includes the following topics:
l Hosting multiple Web applications on one system on page 146.
l Advanced properties for the Web LM on page 147
l Viewing license pick usage on page 147
l Configuring the WebLM on Windows on page 147
l Configuring the WebLM on Solaris on page 149
l Configuring the WebLM on AIX on page 153

Hosting multiple Web applications on one system


If the IC system includes more than one Web application on the same system as the WebLM,
You should configure all of the Web applications on the target system at the same time.

! Important:
Important: If you do not configure all of the Web applications simultaneously, keep all the
Web applications options on the target system checked when you re-run the
Configuration Tool to create the new Web applications. If you do not keep the
options for previously created Web applications checked, the Configuration Tool
may delete those Web applications.

146 Installation and Configuration March 2012


Configuring the Web License Manager

Advanced properties for the Web LM


The Web tab also includes advanced properties for the Java Virtual Machine.
Configure the advanced properties only if you expect a high volume of traffic for the Web
License Manager. For more information, see Configuration Tool advanced properties on
page 499.

Viewing license pick usage


In the Web License Manager, by clicking the product link in the left pane, you can view the
licenses you have acquired for each features in that product. You can also view the pick usage
of the license for each features in a product. For example, if total number of licenses for a given
feature is 10 and if 5 licenses are only used then pick usage is displayed as 5/50%.

Configuring the WebLM on Windows


Use these instructions to host the WebLM on a Windows system. You do not need to stop the
IIS Web server on Windows systems.
To configure the Web License Manager to run on a Windows system:
1. To start the Configuration Tool, select Start > Programs > Avaya Interaction Center 7.3
> Configuration Tool.
2. Log in with your IC Manager login ID and password.
3. On the Web tab enter the information for the fields mentioned in the following table.

Field Description Sample entry

Tomcat Base Port The port used to configure the following ports: Default: 9600
Tomcat HTTP ports for Web applications
Tomcat AJP (Web server connector) ports
IIS Website The name of the IIS Web server that the Web Default Web Site
application will use.
Tip: For a localized version of IIS, type the localized
name for the IIS Web server.
Web Server Host The name of the system that hosts the Web server. testbox
Do not include the DNS domain.

Installation and Configuration March 2012 147


Chapter 6: Installing IC licenses

Field Description Sample entry

DNS Domain The network (DNS) domain of the system that hosts xyzcorp.com
your Web server. Do not enter an IC domain.
Note: Verify the default DNS domain carefully to
ensure that it is correct.
Web Server Port The port that your Web server uses for Default: 80
communication. Make sure that the port matches the
protocol used by your Web server for
communication. The default ports are:
HTTP port is 80.
HTTPS port is 443.
Do not change the default port unless you assign a
different port to the Web server.
IC Test Optional. Checkmark in box
IC Test is a Web application that you can use to test
your Tomcat configuration.
If you install multiple versions of Tomcat, the
Configuration Tool creates an IC Test application on
each version of Tomcat. The Configuration Tool also
creates a separate Tomcat server to host IC Test.
To access IC Test, use the Tomcat HTTP port in the
URL. For example, type:
http://<server>.<domain>.com:9600/
ictest
Note: The port number is not required if you install a
single version of Tomcat, or access IC Test from the
separate Tomcat server for IC Test.

4. Select the Configure Web License Manager check box.


5. Enter the information for the fields mentioned in the following table.

Field Description Sample entry

SSL Port for WebLM The port used to configure the Web License Default: 8443
Manager server
Log File Location for Enter the directory where weblmserver.log file Default:
WebLM needs to be saved. Ensure that the path you AVAYA_IC73_HOME
specify exists. \tomcat\webapps\
WebLM\data\log
Log File Maximum The maximum number of the weblmserver log Default: 1
Backup Index files that can be created.

148 Installation and Configuration March 2012


Configuring the Web License Manager

Field Description Sample entry

Log File Maximum The maximum size of a weblmserver log file. Default: 10 MB
File Size (in MB)
License Allocation The maximum file size of the License Default: 10 MB
Backup File Size (in allocation backup file. This filed is not used.
MB)

6. Click Apply Settings.


7. Click OK.
8. Click Exit.
9. To complete the configuration:
a. Open the Windows Services control panel.
b. Start Avaya IC WebLM Service 7.3.
For more information about how to start and stop Web application services, see Starting
and stopping IC services on page 138.

Configuring the WebLM on Solaris


Use these instructions if you plan to host the WebLM on a Solaris system.

! Important:
Important: To configure the Web License Manager on Solaris, you must log in as a user with
write permissions on the Web server directories and the IC installation directories.
The root user usually has these write permissions.
To configure the Web License Manager to run on a Solaris system:
1. Start the Configuration Tool:
a. Navigate to IC_INSTALL_DIR/IC73/bin
b. Run ./configure
2. Log in with your IC Manager login ID and password.

Installation and Configuration March 2012 149


Chapter 6: Installing IC licenses

3. On the Web tab enter the information for the general fields mentioned in the following
table:

Field Description Sample entry

Tomcat Base Port The port used to configure the following ports: Default: 9600
l Tomcat HTTP ports for Web applications

l Tomcat AJP (Web server connector) ports

Web Server Home The installation path for the Oracle iPlanet /opt/oracle/
Server instance that hosts the Web webserver7
application.
Web Server Name The root name of the server as found in the testbox.xyzcorp.com
Oracle iPlanet Server home directory.
Note: Do not include https- in the Web
server name.
Web Server Host The name of the system that hosts the Web testbox
server.
Do not include the DNS domain.
DNS Domain The network (DNS) domain of the system that xyzcorp.com
hosts your Web server. Do not enter an IC
domain.
Note: Verify the default DNS domain
carefully to ensure that it is correct.

150 Installation and Configuration March 2012


Configuring the Web License Manager

Field Description Sample entry

Web Server Port The port that your Web server uses for Default: 80
communication. Make sure that the port
matches the protocol used by your Web
server for communication. The default ports
are:
l HTTP port is 80.

l HTTPS port is 443.

Do not change the default port unless you


assign a different port to the Web server.
IC Test Optional. Checkmark in box
IC Test is a Web application that you can use
to test your Tomcat configuration.
If you install multiple versions of Tomcat, the
Configuration Tool creates an IC Test
application on each version of Tomcat. The
Configuration Tool also creates a separate
Tomcat server to host IC Test.
To access IC Test, use the Tomcat HTTP port
in the URL. For example, type:
http://
<server>.<domain>.com:9600/ictest
Note: The port number is not required if
you install a single version of Tomcat, or
access IC Test from the separate Tomcat
server for IC Test.

4. Select the Configure Web License Manager check box.


5. Enter the information for the fields mentioned in the following table.

Field Description Sample entry

SSL Port for WebLM The port used to configure the Web Default: 8443
License Manager server
Log File Location for Enter the directory where Default:
WebLM weblmserver.log file needs to be saved. IC_INSTALL_DIR
Ensure that the path you specify exists.
/IC73/tomcat/
webapps/WebLM/
data/log
Log File Maximum The maximum number of the Default: 1
Backup Index weblmserver log files that can be
created.

Installation and Configuration March 2012 151


Chapter 6: Installing IC licenses

Field Description Sample entry

Log File Maximum File The maximum size of a weblmserver log Default: 10 MB
Size (in MB) file.
License Allocation The maximum file size of the License Default: 10 MB
Backup File Size (in MB) allocation backup file. This filed is not
used.

6. Click Apply Settings.


7. Click OK.
8. Click Exit.
9. To complete the configuration, perform the following steps to ensure that all WebLM
services start properly:
a. In the Oracle iPlanet Server installation directory:
l Open the admin-server directory.
l If the directory includes a file called start-ICEnv.backup, execute the following
command to rename the file:
mv start-ICEnv.backup oldstart-ICEnv
b. Start the Oracle iPlanet server that hosts the Web License Manager application with
the following start script:
<iplanet_home_dir>/https-instance_name/bin/startserv
c. Navigate to the IC_INSTALL_DIR/IC73/bin directory.
d. Use the following script to start Tomcat:
nohup ./ictomcat.sh start weblm

! Important:
Important: For Solaris only, the Configuration Tool changes the ownership of the
implementation file (vesp.imp) and the interface file (vespidl.pk) to root. If you do
not want to run IC as root, you must change the ownership of these files as
described in Changing ownership for IC on Solaris only on page 39.

152 Installation and Configuration March 2012


Configuring the Web License Manager

Configuring the WebLM on AIX


Use these instructions if you plan to host the WebLM on an AIX system.

! Important:
Important: To configure the Web License Manager on AIX, you must log in as a user with
write permissions on the Web server directories and the IC installation directories.
The root user usually has these write permissions.
To configure the Web License Manager to run on an AIX system:
1. Start the Configuration Tool:
a. Navigate to IC_INSTALL_DIR/IC73/bin
b. Run ./configure
2. Log in with your IC Manager login ID and password.
3. On the Web tab enter the information for the general fields mentioned in the following
table:

Field Description Sample entry

Tomcat Base Port The port used to configure the following Default: 9600
ports:
l Tomcat HTTP ports for Web
applications
l Tomcat AJP (Web server connector)
ports
Web Server Home The installation path for the IBM HTTP /usr/HTTPServer
server instance that hosts the Web
application.
Web Server Name A Solaris-only field. Not applicable for AIX. Leave this field blank.
Web Server Host The name of the system that hosts the Web testbox
server.
Do not include the DNS domain.
DNS Domain The network (DNS) domain of the system xyzcorp.com
that hosts your Web server. Do not enter an
IC domain.
Note: Verify the default DNS domain
carefully to ensure that it is correct.

Installation and Configuration March 2012 153


Chapter 6: Installing IC licenses

Field Description Sample entry

Web Server Port The port that your Web server uses for Default: 80
communication. Make sure that the port
matches the protocol used by your Web
server for communication. The default ports
are:
l HTTP port is 80.

l HTTPS port is 443.

Do not change the default port unless you


assign a different port to the Web server.
IC Test Optional. Checkmark in box
IC Test is a Web application that you can
use to test your Tomcat configuration.
If you install multiple versions of Tomcat,
the Configuration Tool creates an IC Test
application on each version of Tomcat. The
Configuration Tool also creates a separate
Tomcat server to host IC Test.
To access IC Test, use the Tomcat HTTP
port in the URL. For example, type:
http://
<server>.<domain>.com:9600/
ictest
Note: The port number is not required if
you install a single version of Tomcat, or
access IC Test from the separate Tomcat
server for IC Test.

4. Select the Configure Web License Manager check box.


5. Enter the information for the fields mentioned in the following table.

Field Description Sample entry

SSL Port for WebLM The port used to configure the Web License Default: 8443
Manager server
Local File Location Enter the directory where weblmserver.log file Default:
needs to be saved. Ensure that the path you IC_INSTALL_DIR/
specify exists. IC73/tomcat/
webapps/WebLM/
data/log
Log File Maximum The maximum number of the weblmserver log Default: 1
Backup Index files that can be created.

154 Installation and Configuration March 2012


Installing the license file

Field Description Sample entry

Log File Maximum The maximum size of a weblmserver log file. Default: 10 MB
File Size (in MB)
License Allocation The maximum file size of the License Default: 10 MB
Backup File Size (in allocation backup file. This filed is not used.
MB)

6. Click Apply Settings.


7. Click OK.
8. Click Exit.
9. To complete the configuration, perform the following steps to ensure that all WebLM
services start properly:
a. Navigate to the IC_INSTALL_DIR/IC73/bin directory.
b. Use the following script to start Tomcat:
nohup ./ictomcat.sh start weblm

! Important:
Important: For AIX only, the Configuration Tool changes the ownership of the implementation
file (vesp.imp) and the interface file (vespidl.pk) to root. If you do not want to run
IC as root, you must change the ownership of these files as described in
Changing ownership for IC on AIX only on page 41.

Installing the license file


After you obtain the license file, install the file in the WebLM. For more information on how to
obtain a license file, see Avaya IC Installation Planning and Prerequisites.

! CAUTION:
CAUTION: Do not change your license file after you receive it from Avaya. WebLM does not
accept modified licenses.
To install the license file:
1. In your Web browser, navigate to the following URL for the WebLM:
https://<system_name>.<domain>:<webLM_port>/WebLM/LicenseServer
For example, https://testbox.xyzcorp.com:8443/WebLM/LicenseServer

Installation and Configuration March 2012 155


Chapter 6: Installing IC licenses

Note:
Note: The URL for the WebLM is case-sensitive.
If your contact center uses a proxy server or enhanced security for Internet Explorer,
include the proxy server address in the browser exception list and the trusted sites list.
Note:
Note: Accessing the URL gives the security alert or error message if you have not
generated a security certificate for the WebLM deployment. You can continue with
the Web site by ignoring the error.
2. Click License Administration.
The Logon page displays.
3. Enter the default user name and password.
The default user name is: admin and the password is: weblmadmin.
WebLM forces you to change the password immediately to help prevent unauthorized
access to your license file. For more information, see Changing the administrative
password on page 159.
4. Enter the license file path in the Enter License Path field.
If you do not know the license file path, click Browse and select the license file.
5. Click Install.
If the installation is successful, WebLM displays a confirmation page. If you installed an
incorrect license file, or WebLM could not access the location of the license file on your
network, WebLM displays an error page.
6. In the left pane, click the aic hyperlink for Avaya Interaction Center under Licensed
Products, and confirm that the number of agents and servers matches your expectations.
To install license file on Solaris:
Note:
Note: If you are running WebLM as a non-root user, you must give additional privileges
to this non-root user to install the license file.
1. Log in to the Solaris system as root.
2. Execute the following command:
usermod -K defaultpriv=basic,net_rawaccess <non-root user>.
3. Log in again to the Solaris system as non-root.
4. Start WebLM and install the license file.
To install license file on AIX:
Note:
Note: If you are running WebLM as a non-root user, you must give additional privileges
to this non-root user to install the license file.

156 Installation and Configuration March 2012


Configuring the License server

1. Log in to the AIX system as root.


2. Execute the following command:
usermod -K defaultpriv=basic,net_rawaccess <non-root user>.
3. Log in again to the AIX system as non-root.
4. Start WebLM and install the license file.

Configuring the License server


This section includes information about how to configure the License server that is automatically
installed with the primary ORB server. Use the same configuration parameters in all other
License servers in the IC system.
Do not host more than one License server on a system. If your IC system requires multiple
License servers, you must host them on different systems.
To configure the License server:
1. In IC Manager, double-click the License server from the list of servers.
2. On the General tab enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

Name License_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the For example, select Default
server from the drop-down list. from the drop-down list if the
server is in the Default domain.
Host Select the IP address of the When you select the host, IC
system from the drop-down list, or Manager fills in the fields for
type the IP address if it is not in Directory, Port, and Executable.
the list.

Installation and Configuration March 2012 157


Chapter 6: Installing IC licenses

3. Click the License Server tab and enter the information for the fields mentioned in the
following table:

Field Recommended entry Notes

Warn about Select this field.


upcoming
license expiry
Time in advance If you selected Warn about Default is 96 hours.
of expiry (hours) Upcoming License Expiry,
enter the amount of time
before the license expires
that you want to be warned.
Alarm on no Select this field.
licenses
WebLM Server Add the URL of the server The default URL is https://
URLs page for a WebLM License <system_name>.
Manager. <domain>:<webLM_port>/WebLM/
LicenseServer
Note: The URL for the
WebLM is case-sensitive. For example: https://
testbox.xyzcorp.com:8443/
WebLM/LicenseServer
Important: You must not use the
IP address of the system in the
URL.

4. Click OK.
5. Start the License Server.
Note:
Note: Start the License Server after configuring the database applications. For more
information, see Configuring databases on page 65.
6. Confirm that the Alarm Monitor at the bottom of the IC Manager window displays a
confirmation message, such as "WebLM server in the configuration is working". If you do
not see this alarm message, your license is not working correctly.

158 Installation and Configuration March 2012


Changing the administrative password

Changing the administrative password


The Web License Manager does not impose constraints on the administrative password.
However, you can use a combination of alphabetic and numerical characters.
To change the administrative password for Web License Manager:
1. In your internet browser, navigate to the URL of the server page for the WebLM.
A sample URL is https://<system_name>.<domain>:<webLM_port>/WebLM/
LicenseServer
The URL for the WebLM is case-sensitive.
2. Click the License Administration page.
The Logon page displays.
3. Enter the default user name and password.
The default user name is: admin and the password is: weblmadmin.
4. Complete the following fields under Change Password:
l Current password
l New password
l Confirm password
5. Click Submit.
The Logon page displays. You need to login again with new password.

Managing users
In Web License Manager (WebLM), you can add new users, configure existing users, and also
delete users. You can view the list of user by clicking the Manage Users link in the left pane.
To add a user
1. In the left pane of Web License Manager page, click Manage Users.
2. Click Add User.
3. In the right pane, enter the user name in the User Name field.
The user name must be unique.
4. Enter the password and in the Password and Confirm Password fields.
5. Click Add User.

Installation and Configuration March 2012 159


Chapter 6: Installing IC licenses

To delete a user
1. In the left pane of Web License Manager page, click Manage Users.
2. Click Delete User.
3. In the right pane, select the check box corresponding to the user you want to delete.
4. Click Delete.
5. Click OK to confirm deleting the selected user.
To modify a user
Note:
Note: You can modify only the password for a user.
1. In the left pane of Web License Manager page, click Manage Users.
2. Click Modify User.
3. In the right pane, select the user name from the User Name drop-down list.
4. Enter the new password for the selected user in the Password and Confirm Password
fields.
Note:
Note: You must enter a valid password to proceed further.
5. Click Change.

Viewing server properties


On the WebLM page, you can view the WebLM server properties that includes the information
about the primary host ID of the WebLM server and also the available host IDs on that server.
You can view the server properties by clicking the Server Properties link in the left pane of the
WebLM page.

Viewing information about configured licenses


The WebLM page displays the detail license information for a product. You can click the product
name link under the Licensed Products category to view the information.
The license information displays details about date and time the license file is installed, the
licensed features, and acquired licenses. You can also click the View Peak Usage link on the
page to view the peak usage of the licenses for the features of a product.
When you click the View Peak Usage link, the system displays the View Peak Usage Web
page. This page displays a table that displays the feature-wise peak usage information. The
table displays the information in the following columns:

160 Installation and Configuration March 2012


Managing users

l Feature (License Keyword): This column lists the display name of the licensed features
of the product and the keywords of each feature. These keywords are used to represent
the licensed feature in the license file.
l Currently Allocated: This column lists the number of feature licenses purchased by the
customer.
l Usage: qty/%: This column lists the number of feature licenses for each licensed feature
that is currently used by the licensed applications. The column also displays the
percentage of usage. For example, if 50 is the available feature licenses and 5 feature
licenses have been used by the applications, this column will display 5/10%.
l Peak Usage (last 7 days): qty/%: This column lists the highest number of feature
licenses for each licensed feature that has been used by the applications in the past seven
days. The column also displays the percentage of peak usage. For example, if the peak
usage in the past seven days is 25 and the feature licenses those were available during
the peak usage calculation was 50, the column displays 25/50%.
l Peak Usage (last 30 days): qty/%: This column lists the highest number of feature
licenses for each licensed feature that has been used by the applications in the past 30
days. The column also displays the percentage of peak usage. For example, if the peak
usage in the past 30 days is 50 and the feature licenses those were available during the
peak usage calculation was 50, the column displays 50/100%.
l Time of Query: This column lists the date and time when the last usage query for the
WebLM server was executed. If the status of the last usage query was Failed, this column
also displays the date and time of the usage query that was last successful.
l Status: This column lists the success or failure of the last usage query executed for the
WebLM server.
Note:
Note: The Status column of the WebLM server remains empty if the server has not
been queried even once for feature license usage.

Installation and Configuration March 2012 161


Chapter 6: Installing IC licenses

162 Installation and Configuration March 2012


Chapter 7: Configuring Telephony

The Avaya Computer Telephony for IC (Telephony) is part of the voice channel of Avaya
Interaction Center (IC).
You can use the information provided in this chapter to set up a simple Telephony environment
with one Telephony server and one PBX or ACD. IC also supports a complex Telephony
environment that can include multiple Telephony servers with multiple PBXs or ACDs and works
independently or together as an integrated environment. You can also configure an IVR.
To configure Telephony, perform the steps in the following topics:
1. Before you configure Telephony on page 164.
2. Configuring the ACD name parameter on page 164.
3. Creating the Telephony server on page 165.
4. Creating a voice queue on page 174.
5. Creating the Telephony Queue Statistics server on page 178.
6. Starting the Telephony servers on page 181.
7. Configuring a Workflow server for Telephony on page 182.
8. Building and loading workflow for Telephony on page 185.
9. Creating routing hints for the Incoming Call workflow on page 187.
Your IC system can also include the following optional configurations:
l Multi-site heterogeneous switches, as described in Avaya IC Telephony Connectors
Programmer Guide.
l Return on No Answer (RONA), as described in Avaya IC Telephony Connectors
Programmer Guide.
l Connections to an IVR and VP, as described in the IC Integration with VP/IR Guide.
l Connection to Siebel, as described in the Siebel Integration Guide.

Installation and Configuration March 2012 163


Chapter 7: Configuring Telephony

Before you configure Telephony


Before you configure Telephony and related components, make sure that you:
1. Install and configure all prerequisite software and hardware. The prerequisites can include
one or more of the following:
l Database
l Telephony switch, equipment, and software
l IVR (optional)
For more information about the prerequisites and supported platforms for Telephony, see
Avaya IC Installation Planning and Prerequisites.
2. Copy the IC server files to the target systems, as described in Installing IC server and
administration components on page 28.
3. Configure a secondary server environment, as described in Configuring the ORB server
environment on page 34.
4. Perform all the steps to configure the IC core servers, databases, and related components,
as described in Configuring core servers on page 108.

Configuring the ACD name parameter


You must configure an ACD name parameter for each ACD in your IC system. You can include
identifying information, such as department or site in the ACD name.
To configure the ACD name parameter
1. In IC Manager, click the Configuration tab.
2. In the left pane, select Telephony > ACD Name from the list of tables.
3. On the toolbar, click New.
4. In the ACD Name field, type the name for the ACD.
Use alphanumeric characters without spaces and special characters.
5. Click Ok.
6. Refresh the Directory server:
a. Select Manager > Refresh.
b. Click Ok.
If you do not receive a Success message, perform the steps in Troubleshooting the refresh
in IC Manager on page 456.

164 Installation and Configuration March 2012


Creating the Telephony server

Creating the Telephony server


The Telephony server (TS) is the connector server for the voice channel. The Telephony server
interfaces with a switch (PBX), monitors phone calls, and controls telephony routing. This server
uses the EDU server to record information on telephone calls. The Telephony server is specific
to the switch you are using.
This section describes how to set up a Telephony server for a single site that does not receive
more than 10,000 voice contacts per hour. For more information about the Telephony server,
see Avaya IC Telephony Connectors Programmer Guide.
For information about how to configure the VDN, CDN, or CCT on each link of the switch to
communicate with the Telephony server, see Avaya IC Installation Planning and Prerequisites.
To create a Telephony server
1. In IC Manager, select Server > New.
2. From the list of servers, select TS.
3. Click Ok.
4. On the General tab enter the information for the fields mentioned in the following table.

Field Recommended entry Notes

Name TS_<domain>_<switch> Include the name of the domain


and the name of the switch in
the server name to identify the
server.
Domain Select the IC domain for the server For example, select Voice1
from the drop-down list. from the drop-down list if the
server is in the Voice domain.
Host Select the IP address of the When you select the host, IC
system from the drop-down list, or Manager fills in the fields for
enter the IP address if it is not in Directory, Port, and Executable.
the list.

5. Click Ok.

Installation and Configuration March 2012 165


Chapter 7: Configuring Telephony

6. Configure the telephony switches mentioned in the following table to complete the
Telephony server configuration.

Telephony switch Location of step

Avaya Communication Manager Configuring the Telephony server for Avaya


(Avaya Communication Manager) Communication Manager on page 166

Aspect Configuring the Telephony server for


Aspect on page 168
Cisco Unified Contact Center Configuring the Telephony server for Cisco
Unified Contact Center on page 170
SIP Configuring Telephony Server for SIP on
page 172

Configuring the Telephony server for Avaya Communication


Manager
For information about the interface between Avaya products and the IC Telephony server, see
Avaya IC Telephony Connectors Programmer Guide.

Tip:
Tip: This section includes only the basic required properties. You can also configure
advanced properties or properties on the Configuration tab. For example, you
can add a parameter to handle blocked ANIs. For more information, see
Interaction Center Administration Guide and Avaya IC Telephony Connectors
Programmer Guide.
To configure the Telephony Server for Avaya Communication Manager
1. In IC Manager, double-click the Telephony Server (TS) from the list of servers.
2. Click the TS tab and enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

ACD Name Select the name of the ACD The name of the ACD that this
assigned to the Avaya switch. TS is serving from a pick list of
names assigned to the ACD
during system configuration.
ACD Type Select Avaya The type of ACD with which the
TS will communicate.

166 Installation and Configuration March 2012


Creating the Telephony server

Field Recommended entry Notes

ACD Model Select Definity The model of the ACD that


corresponds to the selected
ACD Type.
ACD Protocol Select asai The protocol to be used
between the TS and the ACD.
If your system includes a
Legacy TS with switch with
Avaya DEFINITY software, see
IC/OA Software Upgrade and
Data Migration.
Site Select the site of your TS. Select the site that this server is
associated with. The TS uses
this information to retrieve the
queues for internal monitoring.
ACD Link Enter the IP address or the The device through which the
host name (if the host name TS communicates with the
can be resolved) of AES. ACD.
Maximum length is 32.
Signal Number Specify a signal number The signal extension number of
when configuring multiple the ASAI line associated with
Avaya users on a single each TS.
system. The signal number is
There is no default value in mandatory, if it is not specified,
the TS, but IC Manager sets the TS will not be able to
this value to 1. establish the link between
Maximum length is 16. users.

Call Control Check to enable call control If checked, enables the TS to


on every call. monitor calls, not stations, on
the system.

3. Click Ok.

Installation and Configuration March 2012 167


Chapter 7: Configuring Telephony

Configuring the Telephony server for Aspect


For information about the interface between the Aspect CallCenter switch and the IC TS, see
Avaya IC Telephony Connectors Programmer Guide.

Tip:
Tip: This section includes only the basic required properties. You can also configure
advanced properties or properties on the Configuration tab. For example, you
can add a parameter to handle Aspect data variables. For more information, see
Interaction Center Administration Guide and Avaya IC Telephony Connectors
Programmer Guide.
To configure the Telephony Server for Aspect
1. In IC Manager, double-click the Telephony Server (TS) from the list of servers.
2. Click the TS tab and enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

ACD Name Select the name of the ACD The name of the ACD that this
assigned to the Aspect TS is serving from a pick list of
switch. names assigned to the ACD
during system configuration.
ACD Type Select Aspect The type of ACD with which the
TS will communicate.
ACD Model Select Aspect9 Aspect9 applies to all the
supported versions of the
Aspect ACD.
ACD Protocol Displays AspectCMI after you The protocol to be used
select Aspect9 as ACD between the TS and the ACD.
Model Avaya IC automatically selects
AspectCMI when ACD Type of
Aspect is selected.
Site Select the site of your TS. Select the site that this server is
associated with. The TS uses
this information to retrieve the
queues for internal monitoring.
Aspect Contact Enter the IP address or the
Server Host host name (if the host name
can be resolved) of the
system that hosts the Aspect
Contact server.

168 Installation and Configuration March 2012


Creating the Telephony server

Field Recommended entry Notes

Data Interlink Enter the Data Interlink The Data Interlink number from
Number number. the Aspect ACD the TS uses to
communicate with the ACD.
Aspect Header Enter the link definition on the If this field is empty, the server
Aspect switch. uses the system name of the
ACD.
Device Enter the TCP/IP port where Default is 7,046.
the TS needs to create a For a list of default port
connection. numbers for components in the
IC suite, see the Avaya IC
Installation Planning and
Prerequisites.
Monitored Agent Enter the number assigned to Default is 1.
Group the agent group to monitor. Do not complete this field if the
TS is monitoring all the agent
groups on Avaya IC.
Monitored Trunk Enter the number assigned to Default is 1.
Group the trunk group to monitor. Do not complete this field if the
TS is monitoring all the trunk
groups on Avaya IC.
Monitor All Agent Check this box if you want Default is unchecked.
Groups the TS to monitor all agent This overrides the entry in the
groups. Monitored Agent Group field.
Monitored Super Enter the number assigned to Default is 1.
Agent Group the super agent group to Leave this field blank if you do
monitor. not want the TS to monitor the
super agent group.
Monitor All Trunk Check this field if you want Default is unchecked.
Groups the TS to monitor all trunk This overrides the entry in the
groups. Monitored Trunk Group field.
Blind Transfer Enter the Call Control Table
CCT number used to perform blind
transfers.
Make Call CCT Enter the Call Control Table
number used to make calls
within the Aspect switch.
External Calls Enter the Call Control Table
CCT number used to make calls
external to the Aspect switch.

Installation and Configuration March 2012 169


Chapter 7: Configuring Telephony

Field Recommended entry Notes

Route CCT Enter the Call Control Table


number used to route calls
external to the Aspect switch.
Transfer CCT Enter the Call Control Table
number used during call
transfers.
Transfer Init CCT Enter the Call Control Table
number used during transfer
init operations.
Predictive CCT Enter the Call Control Table
number used during
predictive operations.

3. Click Ok.

Configuring the Telephony server for Cisco Unified Contact


Center
For information about the interface between Cisco Unified Contact Center and the IC TS, see
Avaya IC Telephony Connectors Programmer Guide.

Tip:
Tip: This section includes only the basic required properties. You can also configure
advanced properties or properties on the Configuration tab. For more
information, see Interaction Center Administration Guide and Avaya IC Telephony
Connectors Programmer Guide.
To configure the Telephony server for Cisco Unified Contact Center
1. In IC Manager, double-click the Telephony Server (TS) from the list of servers.
2. Click the TS tab and enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

ACD Name Select the ACD name, assigned The name of the ACD (switch) that
to the switch. this TS is serving from a pick list of
names assigned to the ACD during
system configuration.
ACD Type Select Cisco The type of ACD with which the TS
will communicate.

170 Installation and Configuration March 2012


Configuring the Telephony server for Cisco Unified Contact Center

Field Recommended entry Notes

ACD Model Select ICM The model of the ACD that


corresponds to the selected ACD
Type.
ACD Protocol Select CTIOS The protocol used by Cisco UCC.
Site Select the site of your TS. The site that this TS is associated
with. The TS uses this information to
retrieve the queues for internal
monitoring.
Primary Host A / B Enter the IP address or the host Specifies the primary hostname
name (if the host name can be where the Cisco CTI OS Server
resolved) of the system which resides. The hostname is used to
hosts the CTIOS service. establish a TCP/IP connection.
Primary Port A Enter the TCP/IP port where the Specifies the primary port number to
TS needs to create a which the socket connection needs to
connection. be made.
Secondary Host A Enter the IP address of the Specifies the secondary hostname
system which hosts the CTI OS where the Cisco CTI OS Server
service. resides. The hostname is used to
establish a TCP/IP connection.
Secondary Port A Enter the TCP/IP port where the Specifies the secondary port number
TS needs to create a to which the socket connection needs
connection. to be made.
Peripheral ID Enter the Peripheral gateway ID The numerical PBX peripheral ID.
of CTIOS.
Enable Route Point Route Point option is required if A check box that specifies if
application gateway is Application gateway should be
configured. Default is checked initialized.
Application Enter Application gateway port Specifies the port number for the
Gateway Port number. It is required if Route application gateway to listen on. The
Point option is selected. port number is required only if the
enable_route_point option is true
otherwise this text box should not be
visible.
Dials by Equipment Select this check box. Default is Specifies that dials by equipment
checked. needs to be selected.

3. Click Ok.

Installation and Configuration March 2012 171


Chapter 7: Configuring Telephony

Configuring Telephony Server for SIP


This section describes the required and optional parameters that must be set to configure the
SipTS in IC Manager.
To configure the SipTS in IC Manager
1. In IC Manager, click the Server tab.
2. On the toolbar, click Create Server.
3. From the list of servers, select the TS server type.
4. Configure the following parameters at the appropriate tabs and click Ok.

172 Installation and Configuration March 2012


Configuring Telephony Server for SIP

General tab
The settings on this tab pertain to the Communication Manager switches supported in IC 7.3:.

Field Recommended entry Notes

Name TS_SIP The name assigned to the TS.


Domain Select the SIP (IC) domain The server is assigned to the SIP
from the drop-down list. (IC) voice domain.
Host Select the IP address of the After selecting the Host, IC Manager
system from the drop-down fills in the fields for Directory, Port,
list. and Executable.
Enter the IP address if it is
not in the list.
Executable Path and file name of the Verify this field is pointing to the new
sipsrv.exe file. SipTS executable.

TS tab
The settings on this tab pertain to Communication Manager switches supported in IC 7.3:

Field Recommended entry Notes

ACD Name Select the name of the ACD The name of the ACD (switch) that this
assigned to the switch. TS is serving from a pick list of names
assigned to the ACD during system
configuration.
ACD Type Select SIP The type of ACD with which the TS will
communicate.
SBC Type Select CM The model of the ACD that corresponds
to the selected ACD Type.
ACD Protocol Select SIP The protocol used by the Application
Link Server to communicate with the
TS and the switch.
Site Select the site of your TS. The site that this TS is associated with.
The TS uses this information to retrieve
the queues for internal monitoring.
SIP B2B Device User name of single B2BUA This is mandatory property.
within the SipTS. Note: One SIP TS can have only one
For example, 62011. B2BUA.
SIP B2B Pass- Password for the B2BUA.
word

Installation and Configuration March 2012 173


Chapter 7: Configuring Telephony

Field Recommended entry Notes

SIP Domain The IP address or FQDN of the This is mandatory property.


SIP Registrar.
SIP Fail Device The route point or phone num- This is mandatory property.
ber, for example, 47000. It cannot be the park device with wait
treatment style 1.
SIP Outbound The IP address or FQDN of the This is mandatory property. The
Proxy SIP Proxy. address must be a valid SIP URI and
starts with sip, for example
sip:135.8.52.125.
SIP Protection The SIP domain name This is advanced and optional property.
Domain Its required format is: sip:avaya.com
The property is used for Digest Authen-
tication.
SIP RoutePoint The common password for all route
Password points configured in any TSA.

Advocate tab
The settings on this tab pertain to the Communication switches supported in IC 7.3:

Field Recommended entry Notes

Enable Advocate Select to enable Business Checking this parameter displays the
Advocate. other parameters listed in this table.
Default is unchecked.
Default RONA No Selection
Destination
Optional Backup Link No Selection
for Advocate

Creating a voice queue


The sample Incoming Call workflow uses the DefaultVoiceQueue@DefaultTenant voice queue.
Create this queue and additional queues, including a queue for each possible route (transfer)
point where the Incoming Call workflow can route a voice contact.

174 Installation and Configuration March 2012


Creating a voice queue

IC uses voice queues for the following:

To gather statistics information: The TSQueueStatistics server monitors the queues and
maintains statistics in the ADU server. These statistics can then be processed by, for example,
OA. For more information, see Creating the Telephony Queue Statistics server on page 178.

To provide a literal translation for a switch device: With this literal translation, you can
reference a destination in the switch. For example, you can reference VDN 1234 as
queue_sales. IC displays queue_sales as a destination in the Unified Agent Directory.

To provide support for multi-site heterogeneous switches: IC uses the information you
enter in the fields on the Voice tab of the queue to support multi-site heterogeneous switches.
For more information, see Avaya IC Telephony Connectors Programmer Guide.

To integrate with routing hints: You add the ID of the voice queue to the RoutingHint table
when you configure the routing hints used by the Incoming Call workflow. For more information,
see Creating routing hints for the Incoming Call workflow on page 187.
The following procedure explains how to create a simple voice queue. For more information,
including queues for transfers and multi-site heterogeneous switches, see Interaction Center
Administration Guide and Avaya IC Telephony Connectors Programmer Guide.
To create a simple voice queue
1. In IC Manager, click the Device tab.
2. Select Device > New Device.
3. In the New Device dialog box, select Voice Queue. Click OK.
4. In the Device Editor (Voice) dialog box:
a. Click the General tab and enter the information for the fields mentioned in the
following table:

Field Recommended Description


entry

Id The device number The ID is the VDN or vector identifier that


known to the PBX (or your PBX or ACD uses for the queue.
ACD). The ID must be a numeric value.
Site Select the site of your
Telephony server.
ACD Name Select the name of This is the ACD Name that you confirmed
the ACD. in Configuring the ACD name
parameter on page 164,

Installation and Configuration March 2012 175


Chapter 7: Configuring Telephony

Field Recommended Description


entry

Name Type a name for the For the default voice queue, type
voice queue. DefaultVoiceQueue
@DefaultTenant.
Queue names can have up to 256
characters, including special characters
and spaces. Queue names cannot:
l Start with a digit, such as zero (0)

l Start with an asterisk "*" or a pound


sign "#"
l Contain "@" (except default queue)

The Unified Agent Directory displays this


name to agents.
Media Voice Automatically set by IC Manager. You
cannot change this field.
Priority Assign a priority to the For example, type 1.
queue.
Service Level Type the number of The service level defines the time within
hours, minutes, and which all voice contacts in the queue must
seconds in the format be answered. Type the time in the format
HH:MM:SS HH:MM:SS.
Minimum 1 Type the minimum number of agents who
agents must be active to use the queue.
Addressable Check this box. Determines whether the queue is
displayed in the Unified Agent Directory.

176 Installation and Configuration March 2012


Creating a voice queue

b. Click the Voice tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry Description

Enable EDU Default is unchecked. If selected, the first Telephony server


Tracking in the TS Set monitors this queue
internally.
Select this option only under one of
the following conditions:
l The switch and CTI link cannot
make a call-to-data association.
l The switch supports queue
monitoring.
l The environment is configured to
ensure that new contacts are
pre-processed by one Telephony
server, where all the queues
reside, but all agents are handled
by another Telephony server.
(Usually the pre-process has to
do with call routing and queue
monitoring.)
Note: In addition to selecting this
check box, make sure that the
associated Telephony server is the
first one in the TS Set list.
Wait Treatment Leave this field blank. The numeric value associated with
Style the wait treatment configuration on
the switch. For more information,
contact your switch administrator.
The field 'Wait Treatment Style' is not
present in the Voice tab, while
creating devices.
TS Set Select the Ellipsis (…) Defines the Telephony servers that
button and in the dialog can be used to deliver voice contacts
box: to this queue, and the order that the
l Select New.
Multi-Site Heterogeneous Switch
(MSHS) mechanism follows when
l Select the attempting to deliver contacts to
Telephony server specific queues. In order to do this,
that handles voice the MSHS uses the ADU for its
contacts for this central data store.
queue from the
drop-down list. The TS Set can only include
Telephony servers that handle
l After you have contacts from the switch where the
added all of the queue resides
Telephony servers,
click Ok. Note: Queue names are kept in
cache for 24 hours.

Installation and Configuration March 2012 177


Chapter 7: Configuring Telephony

5. Click Ok.

Creating the Telephony Queue Statistics server


The Telephony Queue Statistics server (TSQS) monitors the voice channel and maintains
queue statistics in the ADU Server. These statistics include contact count and age of oldest
contact.
Note:
Note: If Business Advocate handles all routing for voice contacts, you do not need a
TSQS server.
The IC installation program does not automatically add this server.
To create the TSQS
1. In IC Manager, select Server > New.
2. From the list of servers, select TsQueueStatistics and click OK.
3. On the General tab enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

Name TsQueueStatistics_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the server For example, select Voice1
from the drop-down list. from the drop-down list if the
server is in the Voice domain.
Host Select the IP address of the When you select the host, IC
system from the drop-down list, or Manager fills in the fields for
enter the IP address if it is not in Directory, Port, and Executable.
the list.

4. Configure the telephony switches mentioned in the following table to complete the TSQS
server configuration.

Telephony switch Location of step

Avaya Communication Manager Configuring the TSQS server for Avaya


Communication Manager on page 179
Aspect Configuring the TSQS server for Aspect on
page 179
Cisco Unified Contact Center Configuring the TSQS server for Cisco
Unified Contact Center on page 180

178 Installation and Configuration March 2012


Creating the Telephony Queue Statistics server

Configuring the TSQS server for Avaya Communication Manager

Tip:
Tip: This section includes only the basic required properties. For information about the
advanced properties, see Interaction Center Administration Guide.
To configure the TSQS for Avaya Avaya Communication Manager
1. In IC Manager, double-click the TS Queue Statistics (TSQS) server from the list of servers.
2. Click the TSQS tab and enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

ACD Name Select an ACD Name. The name of the ACD (switch) that
this TSQS is serving. Provides a
pick list of name(s) assigned to the
switch during system
configuration.
Each TSQS on the system must
have a unique ACD Name.
Site Select the site where the The site used by your TS
TSQS is located. configured for the Avaya switch.
ACD Type Select Avaya. The ACD Type option used by
your TS configured for the Avaya
switch.
ACD Model Displays Definity after you The ACD Model option used by
select Avaya as ACD Type. your TS configured for the Avaya
switch.
ACD Protocol Select asai. The ACD Protocol option used by
your TS configured for Avaya
switch.

3. Click Ok.

Configuring the TSQS server for Aspect

Tip:
Tip: This section includes only the basic required properties. For information about the
advanced properties, see Interaction Center Administration Guide.

Installation and Configuration March 2012 179


Chapter 7: Configuring Telephony

To configure the TSQS for Aspect:


1. In IC Manager, double-click the TS Queue Statistics (TSQS) server from the list of servers.
2. Click the TSQS tab and enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

ACD Name Select an ACD Name The name of the ACD (switch) that
this TSQS is serving. Provides a
pick list of name(s) assigned to the
switch during system
configuration.
Each TSQS on the system must
have a unique ACD Name.
Site Select the site where the The Site used by your TS
TSQS is located. configured for the Aspect switch
ACD Type Select Aspect. The ACD Type option used by the
TS configured for the Aspect
switch.
ACD Model Select Aspect9. Aspect9 applies to all the
supported versions of the Aspect
ACD.
ACD Protocol Displays AspectCMI after Select the ACD Protocol option
you select Aspect 9 as the used by your Telephony server
ACD Model. configured for the Aspect switch.
Switch Name Enter the IP address or the This is different from the IP
host name of the link that address used by the switch.
connects the switch to the
TSQS.
Switch Port Enter the port number used Default is 8000.
by the switch.

3. Click Ok.

Configuring the TSQS server for Cisco Unified Contact Center

Tip:
Tip: This section includes only the basic required properties. For information about the
advanced properties, see Interaction Center Administration Guide.
To configure the TSQS for Cisco Unified Contact Center:
1. In IC Manager, double-click the TS Queue Statistics (TSQS) server from the list of servers.

180 Installation and Configuration March 2012


Starting the Telephony servers

2. Click the TSQS tab and enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

ACD Name Select the ACD name, assigned The name of the ACD (switch) that
to the switch. this TSQS is serving. from the pick list
of the names assigned to the switch
during system configuration.
Each TSQS on the system must have
a unique ACD Name.
Site Select the site where the TSQS The Site used by your TS configured
is located. for the Cisco switch.
ACD Type Select Cisco The option used by the TS configured
for the Cisco switch.
ACD Model ICM after you select Cisco as ICM applies to all the supported
ACD Type. versions of the Cisco Unified Contact
Center.
ACD Protocol Select CTIOS The ACD Protocol option used the
Telephony server configured for the
Cisco switch.
DB Server Name Enter the IP address or the host Cisco AWDB database server host
name of the Distributor Admin name.
Workstation Database Server
(AWDB).
DB Name Enter the Distributor Admin Cisco AWDB database name.
Workstation Database Name.
DB Login Enter the Distributor Admin Cisco AWDB database username.
Workstation Database Login ID.
DB Password Enter the Database login Cisco AWDB database password.
Password for the Distributor
Admin Workstation.

3. Click Ok.

Starting the Telephony servers


! Important:
Important: Create the voice queues before you start the Telephony server and the TSQS
server.

Installation and Configuration March 2012 181


Chapter 7: Configuring Telephony

To start Telephony servers


1. Start the Telephony server:
a. In IC Manager, select and right-click the Telephony server.
b. Select Start.
After the Alarm Monitor displays a message confirming that the server has started
correctly, continue with the next step.
2. Start the TSQS server:
a. In IC Manager, select and right-click the TSQS server.
b. Select Start.
After the Alarm Monitor displays a message confirming that the server has started
correctly, continue with the next step.
3. Set your Telephony server to start automatically
a. In IC Manager, double-click the Telephony server from the list of servers.
b. Click the General tab.
c. Select the Auto Start check box.
d. Click Ok.
4. Set your TSQS server to start automatically
a. In IC Manager, double-click the TSQS server from the list of servers.
b. Click the General tab.
c. Select the Auto Start check box.
d. Click Ok.

Configuring a Workflow server for Telephony


To create and configure a Workflow server for Telephony, perform the steps in the following
topics:
1. Creating a Workflow server for Telephony on page 183
2. Configuring the voice channel for the Workflow server on page 184
If the IC system includes multiple Workflow servers, perform these steps on each Workflow
server that processes voice contacts.

182 Installation and Configuration March 2012


Configuring a Workflow server for Telephony

Creating a Workflow server for Telephony


These instructions only provide information about those parameters you need to set when you
create a Workflow server to handle voice contacts. For more information about other
parameters in the Workflow server, see Configuring multiple Workflow servers on page 119 and
Interaction Center Administration Guide.
To create a Workflow server for Telephony
1. In IC Manager, select Server > New.
2. From the list of servers, select Workflow.
3. Click Ok.
4. Click the General tab, and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Workflow_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the For example, select Voice1 to
server from the drop-down list. use the pre-configured domain
for Telephony.
Host Select the IP address of the When you select the host, IC
system from the drop-down list, or Manager fills in the fields for
type the IP address if it is not in Directory, Port, and Executable.
the list.

5. Click the Workflow tab.


6. From the IC Data Source drop-down list, select the Interaction Center data source.
The default name for this data source is interaction_center. This is the data source that you
created in Generating the Interaction Center application on page 93.
7. Select Synchronous Startup Flows.
8. If the following row does not exist, add it to the Synchronous Startup Flows:
a. Select New.
b. In the new row, type web_routing.update_qw_cache
c. Click Ok.
9. Continue with Configuring the voice channel for the Workflow server on page 184.

Installation and Configuration March 2012 183


Chapter 7: Configuring Telephony

Configuring the voice channel for the Workflow server


To configure the voice channel for the Workflow server:
1. In the Server Editor for the Workflow server, click the Channels tab.
2. On the toolbar, click New Channel.
3. In the Channel Editor dialog box, enter the information for the fields mentioned in the
following table.

Field Recommended entry Notes

Global Do not check this field. Do not check this field to create a
create a channel for a specific server
or media, such as Telephony.
By Server l Do not check this field if If you check this field, and you need
you want this channel to this Workflow server to communicate
handle events from all with more than one server, you must
servers of the type that create another channel for that
you select from the server.
Service drop-down list.
Warning: If you check this field
l Check this field if you and the Telephony server is
want this channel to named "TS", the Workflow server
handle events from only will not be able to communicate
one specific server that with the Telephony server.
you select from the
Service drop-down list.
Channel Range No entry necessary. Completed by IC Manager
Service Select TS or a specific Whether you can select a server or a
Telephony server from the type of server, depends up whether
drop-down list. or not you checked the By Server
field.
Criteria Type the criteria you want the For example, you can enter a criteria
workflow to use for the event. for the workflow to route calls that
arrive at a routing point.
For a detailed description of the
criteria for each server and server
type, see the description of the
Assign method in the Programmer
Guide for that server. For example,
to see criteria for the Telephony
server, see Avaya IC Telephony
Connectors Programmer Guide.

4. Click Ok.
5. Select the channel that you have created.

184 Installation and Configuration March 2012


Building and loading workflow for Telephony

6. On the toolbar, click New Association.


7. In the Channel Association dialog box, enter the information for the fields mentioned in
the following table.

Field Recommended entry

Channel Range Completed by IC Manager


Service Interface Completed by IC Manager
Event TS.IncomingCall
Note: This field is case-sensitive.
Flow Type <workflow_project>.<routing_workflow>
For example, if you use the sample Incoming Call workflow,
type ts.incomingcall
Note: This field is case-sensitive.

8. Click OK.
9. Click OK.
10. On the Server tab of IC Manager, select the Workflow server that handles voice contacts.
11. Right-click the Workflow server and select Start.

Building and loading workflow for Telephony


You can use the sample workflows to configure and test your Telephony servers. When you
move into production, modify the properties of the sample workflows to meet your system needs
and configuration. For more information about the sample workflows and ways to customize
them, see Avaya IC Media Workflow Reference.
For each workflow project, perform the steps in the following topics:
1. Building the Incoming Call workflow on page 186.
2. Loading workflows in the Workflow server on page 186.

Installation and Configuration March 2012 185


Chapter 7: Configuring Telephony

Building the Incoming Call workflow


You do not need to configure any blocks to use the sample Incoming Call flow.
To build the Incoming Call workflow
1. In Workflow Designer, select File > Open Project and open the TS project.
You can find the TS project in the following directory: IC_INSTALL_DIR\IC73\design\
IC\Flows\Avaya\TS\TS.prj
2. Double-click incomingcall.qfd in the Project pane.
3. Select Project > Settings.
4. Click the Database tab and enter the values for the following fields:
l IC Data Source: Interaction Center Data Source name.
l Login ID: Valid IC Administrator account
The default account is Admin.
l Password: Password for the account
5. Click Ok.
6. Select Build > Build Flowset.
Workflow Designer verifies and compiles the flows. All error messages, including the block
name, script name, and offending line, are displayed in the Output bar.
7. Select File > Exit to exit Workflow Designer.

Loading workflows in the Workflow server


When you build a flowset, Workflow Designer does not automatically load and run the
workflows in the Workflow server. You can reload workflows without restarting the Workflow
server.

Tip:
Tip: Test the workflows and confirm that they work correctly. If the Workflow server is
not running the new workflows, stop and restart the server.
To reload workflows in the Workflow server
1. In IC Manager, click the Servers tab and double-click the Workflow server.
2. In the Workflow server settings dialog box, click the Workflow tab.
3. Select Reload Flows.

186 Installation and Configuration March 2012


Creating routing hints for the Incoming Call workflow

4. In the Reload Flows dialog box:


a. Select Force Immediate Reload.
b. Click Ok to reload all currently loaded workflows even if the versions are same.
5. Click Ok.

Creating routing hints for the Incoming Call workflow


The Add Routing Hints (DNIS) block in the Incoming Call workflow uses the routing hints in the
RoutingHint table of the Directory server to route incoming voice contacts. The sample
Incoming Call workflow requires at least one routing hint for the main incoming DNIS number.
Assign this routing hint to a voice queue that you created in Creating a voice queue on
page 174.
You can create routing hints for one or more additional DNIS numbers, if required by your
contact center.

! Important:
Important: Routing hints must be in lower case. Do not use mixed upper and lower case in
your routing hints. If the routing hint is not in lower case, the workflow cannot
locate the routing hint, and IC cannot correctly route the contact.
Each row in the routing hint table contains the following:
l A routing hint
l The name of the voice queues where contacts that match the routing hint should be routed
For more information about how workflows use routing hints, see Avaya IC Media Workflow
Reference.
To create routing hints:
1. In IC Manager, click the Configuration tab.
2. In the left pane, select Tables > Workflow > RoutingHint.
3. Click New.

Installation and Configuration March 2012 187


Chapter 7: Configuring Telephony

4. In the right pane, enter the information for the fields mentioned in the following table:

Parameter Recommended entry Description

Routing Hint Type a routing hint. For the sample Incoming Call workflow,
create a routing hint with the DNIS for the
incoming calls. For example, if the DNIS
is 21000, type 21000 in this field.
The routing hint must be a single word in
all lower case or a series of numbers.
Do not use special characters.
Voice Queue ID Type the name of a voice queue. You must not use the
DefaultVoiceQueue@DefaultTenant for
routing hints. For information on how to
create a voice queue, see Creating a
voice queue on page 174.
Category/Qualifier Leave this field blank. Business Advocate uses this field.
Tenant Leave this field blank. Telephony does not use tenancy.

5. Click Ok.
6. Select Manager > Refresh.

188 Installation and Configuration March 2012


Chapter 8: Configuring Web Management

Web Management is a Web-based marketing, sales, and service application that personalizes
and manages Web transactions for Avaya Interaction Center. Configure Web Management if
your IC system includes Web Management or Email Management.
This section includes the following topics that describe Web Management and the steps that
you must perform to complete the configuration of Web Management:
1. Web Management support for media channels on page 190.
2. Before you configure Web Management on page 190.
3. Configuring servers for Web Management on page 191.
4. Configuring Web Management services on page 201.
5. Integrating Web Management Administration on page 218.
6. Configuring a Workflow server for Web Management on page 220.
7. Using workflows for Web Management on page 223.
8. Configuring routing hints for the Qualify Chat workflow on page 225.
9. Configuring the ICM server on page 228.
10. Configuring the Central Internet Routing service on page 230.
11. Configuring the Website on page 231.
12. Configuring Avaya Full Text Search Engine on page 235.
13. Configuring Web Scheduled Callback on page 245.
14. Refreshing IC Manager on page 281.
This section includes the following topics about optional Web Management configurations:
l Configuring SSL security for Web servers (optional) on page 267.
l Setting up a separate administration Website (optional) on page 272.
l Setting up a separate customer Website (optional) on page 274.
l Deploying multiple ICM servers (optional) on page 275.
For information on how to set up RONA for Web Management, see Interaction Center
Administration Guide guide.

Installation and Configuration March 2012 189


Chapter 8: Configuring Web Management

Web Management support for media channels


The following table shows the integrated functionality that Web Management provides and the
support that the functionality provides for the chat channel and the email channel.

Feature or component Chat channel Email channel

Customer management 9 9
Self-service to provide suggested responses for agents - 9
Chat escalation 9 8
Chat typing status 9 8
Web scheduled calls 9 8
Email escalation 8 9
Survey 9 8
WebACD server administration 9 9
Web page multi-tenancy and multi-tenancy 9 9
administration
DataWake and DataWake administration 9 9
Chat server and client components 9 8

Before you configure Web Management


Before you configure Web Management, ensure that you:
1. Install and configure all prerequisite software and hardware, including a Web server.
For information on prerequisites required for each computer, see Avaya IC Installation
Planning and Prerequisites.
2. Copy the IC server files to the target computer, as described in Installing IC server and
administration components on page 28.
3. Configure a secondary server environment, as described in Configuring the ORB server
environment on page 34.
4. Perform all the steps to configure the IC core servers, databases, and related components,
as described in Configuring core servers on page 108.

190 Installation and Configuration March 2012


Configuring servers for Web Management

Configuring servers for Web Management


You must add and configure Web Management servers to use Web Management and Email
Management. These instructions include only the properties required to get the servers up and
running. For information about other server properties, see Interaction Center Administration
Guide.
This section describes the Web Management servers and how to configure them.
Note:
Note: Add and configure the servers in the order in which they are presented in the
following topics. IC systems that include the email channel, but not the chat
channel, do not require the Attribute server.
1. Creating the WebACD server on page 191.
2. Creating the Attribute server on page 195.
3. Creating the ComHub server on page 197.
4. Creating the Paging server on page 199.
5. Starting the Web Management servers on page 201.

Creating the WebACD server


The WebACD server works as a call distributor for chat and email contacts. This server assigns
tasks to agents and tracks different states of agent interactions. This server uses the Attribute
server, Paging server, IC Email server, and ComHub server to complete support operations
such as managing agent states and administering agent and contact interactions. The WebACD
server is also known as the Web Agent Automatic Call Distributor server.
The IC installation program does not automatically add the WebACD server. Web Management
and Email Management require this server.
In the Avaya IC 7.3 release, you can configure two WebACD servers within the WebACD
cluster, called WACD_Cluster. However, only one WebACD is supported for each computer for
each domain.
In case of two WebACD servers deployment, you have to Configure the ComHub server and
Paging server for both the Web domain configured with WebACD server. For example: If Web
and Web2 are two domains where you have configured WebACD1 server and WebACD2
server respectively. Then, you have to configure the ComHub and Paging servers in both Web
and Web2 domain.

Tip:
Tip: On your development system, or if you encounter issues with the WebACD
server, set the WACD trace levels on the Debug tab to 10,000 or 100,000.

Installation and Configuration March 2012 191


Chapter 8: Configuring Web Management

To create the WebACD server


1. In IC Manager, select Server > New.
2. In the right pane, select WACD from the list of servers.
3. Click Ok.
4. Click the General tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name WebACD_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the server For example, select Web from
from the drop-down list. the drop-down list.
Host Enter or select the IP address from When you select the host, IC
the drop-down list. Manager fills in corresponding
Directory, Port, and Executable.

5. Click the WACD tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Host Name Enter the name of the system For example, enter TESTBOX.
that hosts the WebACD server.
Domain Enter the domain of the system For example, enter xyzcorp.com.
that hosts the WebACD server.
Service Port 4010 If you must change this port, see
Avaya IC Installation and
Configuration for a list of the
default port numbers used by the
other Avaya IC servers. Port
conflicts can cause serious
problems within the Avaya IC
system.
IC Data Source Select the Interaction Center If you used the default name,
Data Source. select interaction_center.

192 Installation and Configuration March 2012


Configuring servers for Web Management

Field Recommended entry Notes

WACD Enter the name and domain of For example, enter


Webserver the computer that hosts the TEXTBOX.xyzcorp.com.
Web Administration pages. IC does not support website
redundancy. Therefore, WACD
Webserver value should be same
as the 'ChatLoginServer' value in
the 'System/Configuration'
properties.
Port Enter the port that the IC Default port is 80 unless you plan
Webserver uses for connections to configure SSL for your website.
with Web applications. If you must change this port, see
Avaya IC Installation and
Configuration for a list of the
default port numbers used by the
other Avaya IC servers. Port
conflicts can cause serious
problems within the Avaya IC
system.
Protocol Select the protocol that you use Select http unless you plan to
to connect to the Website. configure SSL for your Web site.
For more information on SSL, see
Avaya IC Installation and
Configuration.
Comhub Host Enter the fully-qualified domain For example, enter
Name name of the system that hosts TESTBOX.xyzcorp.com.
the ComHub server.
Comhub Port Enter the service port for the Default service port is 4001.
Comhub server. If you must change this port, see
Avaya IC Installation and
Configuration for a list of the
default port numbers used by the
other Avaya IC servers. Port
conflicts can cause serious
problems within the Avaya IC
system.
Website Context Enter the name of the Web The default website context is
application used for Web website.
Management.

Installation and Configuration March 2012 193


Chapter 8: Configuring Web Management

Field Recommended entry Notes

Agent Timeout 100 If the WebACD assigns a contact


(secs) to an agent who has turned on the
"Wait for agent confirmation before
accepting a contact" option in
Avaya Agent, then this value
specifies the number of seconds
that the WebACD server will wait
for confirmation from that agent
before it reassigns the contact to
another available agent.
For details about setting this
option, see the Avaya Agent User
Guide.
Max Display No recommended entry Enter the number of currently
Tasks active tasks to display per request
in the
WebACD administration pages.
Task Wrap No recommended entry The WebACD server automatically
Timeout (secs) wraps and completes a task after
an customer or agent has timed
out. For example, if the Avaya
Agent shuts down and the user is
forced to end the consultation, the
WebACD server waits until the
amount of time specified in the
wrap-up timeout parameter has
passed, then wraps and
completes the task.
Interval Between No recommended entry Enter the period of time that the
Cleanup (mins) WebACD should wait between
cleaning up threads from timed out
and abandoned chat tasks.
Max Allowed No recommended entry Enter the maximum time that a
Queue Time chat task can stay in a queue
(mins) before it is considered to be dead
or abandoned.

194 Installation and Configuration March 2012


Configuring servers for Web Management

Field Recommended entry Notes

Summary No recommended entry Enter the period of time that the


Interval (mins) WebACD should wait between
creating summary records. This
interval must be an even divisor of
60 (for example, you can use 4, 5,
6, 10, 12, or 15, but you cannot
use 8 or 9.)
If you set the interval to 5 minutes,
then the WebACD will write
summaries at 12:00, 12:05, 12:10,
etc.
Requalify No recommended entry Enable this option if you want the
Contacts WebACD server to re-run the
Qualify workflow on unassigned
tasks.
Default Email No recommended entry This is applicable if you want to
Cluster configure WebACD server for
email management.

6. Click Ok.

! CAUTION:
CAUTION: Do not start the WebACD server till it is added to the WACD_Cluster.

Creating the Attribute server


The Attribute server acts as a communications bridge between the ICM server and the
WebACD server for chats. The Attribute server provides:
l Tracking of user web page browsing sessions for DataWake.
l Web site property event notifications between the Web site and the ICM server.
If your IC system includes DataWake, or you are concerned with performance issues on the
Web site, you can host a second Attribute server on the Web site computer in the DMZ. If your
IC system includes this deployment, configure the secondary ORB server on the computer to
start automatically.
The IC installation program does not automatically add the Attribute server. Web Management
requires the Attribute server.
To create the Attribute server:
1. In IC Manager, select Server > New.
2. From the list of servers, select Attribute.

Installation and Configuration March 2012 195


Chapter 8: Configuring Web Management

3. Click Ok.
4. Click the General tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Attribute_<domain> Include the domain in the server


name to identify the server in
the list of servers.
Domain Select the IC domain for the server For example, select Web from
from the drop-down list. the drop-down list if the server
is in the Web domain.
Host Select the IP address of the When you select the host, IC
system from the drop-down list, or Manager fills in the fields for
enter the IP address if it is not in Directory, Port, and Executable.
the list.

5. Click the Attribute tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry

Port If you must change the default, see Changing the service port
for the Attribute server on page 492. Port conflicts can cause
serious problems within the IC system.
Enable DataWake Check this field if:
Recording l The IC system includes DataWake

l You want this Attribute server to track the Web pages


browsed by a Website customer.
Enable ICM Bridge Check this field.
IC Login By default, this field uses the icmbridge account that is
provided with IC.
If you have not already done so, change the default password
for this account.
Important: Do not use the Administrative account for IC
Manager or any account for which the password may
change.

196 Installation and Configuration March 2012


Configuring servers for Web Management

Field Recommended entry

IC Password Type the password for the account in the IC Login field.
ICM Servers l Click the Ellipsis (…) button.
l In the ICM Servers dialog box:
- Click New.
- Select Enabled.
- Type the name and domain of the computer that hosts the
ICM server. For example, TESTBOX.xyzcorp.com.
- Accept the default port number or change to an available
port.
- Click Ok.

6. Click the Configuration tab.


7. Click New on the toolbar.
8. Enter wacd_cluster_name in Name and WACD_Cluster in Value.
9. Click Ok.

Creating the ComHub server


The ComHub server provides a communications hub for the Web Management and Email
Management servers. This server also assists in passing information from a web-based
interface to the WebACD server, and helps the WebACD server to respond to agent requests,
such as logon or logoff.
The IC installation program does not automatically add the ComHub server. Web Management
and Email Management requires this server.
In case of two WebACD servers deployment, you have to configure the ComHub server for both
the Web domain having WebACD server configured. For example: If Web and Web2 are two
domains where you have configured WebACD1 server and WebACD2 server respectively.
Then, you have to configure the ComHub server in both Web and Web2 domain.
To create the ComHub server
1. In IC Manager, select Server > New.
2. From the list of servers, select ComHub.
3. Click Ok.

Installation and Configuration March 2012 197


Chapter 8: Configuring Web Management

4. Click the General tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Comhub_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the For example, select Web from the
server from the drop-down drop-down list if the server is in the
list. Web domain.
Host Select the IP address of the When you select the host, IC
system from the drop-down Manager fills in the fields for
list, or enter the IP address if Directory, Port, and Executable.
it is not in the list.

5. Click the ComHub tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Host Name Enter the fully-qualified For example, enter


domain name of the system TESTBOX.xyzcorp.com.
that hosts the ComHub
server.
Service Port Accept the default port of If you must change the default, see
4001 or enter a new port. Changing the service port for the
ComHub server on page 492. Port
conflicts can cause serious problems
within the IC system.
IC Data Source Select the Interaction Center If you used the default name, select
Data Source. interaction_center.
Threads Accept the default or enter a The default entry is 10.
number of threads. The number of threads that can be
constructed to handle
communication tasks.

6. Click Ok.

198 Installation and Configuration March 2012


Configuring servers for Web Management

Creating the Paging server


The Paging server serves as a communications bridge between Avaya Agent and the ComHub
server. This server brokers messages to ensure that they are sent to correct agents and to the
WebACD server through ComHub server.

! Important:
Important: When you create IC accounts for agents who handle chat contacts, ensure that
the domain for those agents fails over to the domain that includes the Paging
server.
The IC installation program does not automatically add the Paging server. Web Management
and Email Management require this server.
In case of two WebACD servers deployment, you have to configure the Paging server for both
the Web domain having WebACD server configured. For example: If Web and Web2 are two
domains where you have configured WebACD1 server and WebACD2 server respectively.
Then, you have to configure the Paging server in both Web and Web2 domain.
To create the Paging server
1. In IC Manager, select Server > New.
2. From the list of servers, select Paging.
3. Click Ok.
4. Click the General tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Paging_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the server For example, select Web from
from the drop-down list. the drop-down list if the server
is in the Web domain.
Host Select the IP address of the When you select the host, IC
system from the drop-down list, or Manager fills in the fields for
enter the IP address if it is not in Directory, Port, and Executable.
the list.

Installation and Configuration March 2012 199


Chapter 8: Configuring Web Management

5. Click the Paging tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Host Name Enter the name of the system For example, enter TESTBOX.
that hosts the Paging server.
Important: The Avaya IC agent
desktop application uses this host
name without the "Domain" name
to connect to the Paging server.
Configure the agent system to use
the host name without the domain
name suffix to communicate with the
system that hosts the Paging server.
Domain Enter the domain of the For example, enter xyzcorp.com.
system that hosts the Paging
server. Important: The Avaya IC agent
desktop application does not use
this Domain field to connect to the
Paging server. For more
information, see the Notes for
Host Name above.
Service Port 4200 If you must change the default, see
Changing the service port for the
Paging server on page 492. Port
conflicts can cause serious problems
within the IC system.
ComHub Host Enter the fully-qualified For example, enter
Name domain name of the TESTBOX.xyzcorp.com.
computer that hosts the
ComHub server of the same
Avaya IC domain.

6. If you changed the default service port of 4001 for the Comhub server, perform the
following steps:
a. Right-click on a blank space of the Paging tab.
b. Select the box next to Show Advanced Properties.
c. In the Comhub Port field, type the service port for the Comhub server.
7. Click Ok.

200 Installation and Configuration March 2012


Configuring Web Management services

Starting the Web Management servers


Before you configure your media channels, start the IC servers, including the Web Management
servers. When you start the Attribute server, the WebACD server starts automatically and starts
the next paired WebACD server from the WACD_Cluster.
To start the Web Management servers
1. In IC Manager, select the server.
2. Right-click the server and select Start.
For more information about the correct order for starting and stopping Web Management and
other IC servers, see Starting and stopping IC servers on page 131.

Setting startup options for servers in IC Manager


Set the following Web Management servers to autostart:
l Attribute server
l ComHub server
l Paging server
l Workflow server that processes chat contacts
To set startup options for servers in IC Manager
1. In IC Manager, double-click the server in the Server tab.
2. Click the General tab.
3. Select the Auto Start box.

Configuring Web Management services


This section describes how to install and configure Web Management services for each
operating system that IC supports. This section includes the following topics:
l Where to configure Web Management services on page 202.
l Hosting multiple Web applications on one computer on page 202.
l Setting memory allocation for Web Management services on page 202.
l Configuring Web Management services on Windows on page 203.
l Configuring Web Management services on Solaris on page 207.
l Configuring Web Management services on AIX on page 213.

Installation and Configuration March 2012 201


Chapter 8: Configuring Web Management

Where to configure Web Management services


Configure Web Management services on the following:
l Computers that host Web Management Web sites
l Computers that host the WebACD servers and Attribute servers to configure database
access for:
- Suggested Response feature of the WebACD server
- DataWake recording feature of the Attribute server

Hosting multiple Web applications on one computer


If the IC system includes more than one Web application on the same computer as the WebLM,
you must configure all of the Web applications on the target computer at the same time.

! Important:
Important: If you do not configure all of the Web applications simultaneously, leave the
options for all Web applications on the target computer selected when you re-run
the Configuration Tool to create new Web applications. If you do not leave the
options for the previously created Web applications selected, the Configuration
Tool may delete those Web applications.

Setting memory allocation for Web Management services


The Web tab also includes advanced properties for the Java Virtual Machine. Only configure the
advanced properties if you expect a high volume of contacts on the Web site. For more
information, see Configuration Tool advanced properties on page 499.
The advanced properties use the following format:
-<initial_Java_heap> -<maximum_Java_heap>

202 Installation and Configuration March 2012


Configuring Web Management services

If you expect a high volume of chat contacts, increase the default settings for the advanced
properties. For example, you can use the advanced properties to increase the memory
allocations for the Web site JVM and ICM JVM should be adjusted upward. For high volumes,
configure each of these properties to:

Website JVM Options For Windows:


--JvmMs 128 --JvmMx 512
For Solaris:
-Xms128m -Xmx512m
For AIX:
-Xms128m -Xmx512m
ICM JVM Options All Platforms:
-Xms128m -Xmx512m

Configuring Web Management services on Windows


Use these instructions if you plan to host Web Management services on a Windows computer.
You do not need to stop the IIS Web server on Windows computers.
To configure Web Management services to run on a Windows computer
1. To start the Configuration Tool, select Start > Programs > Avaya Interaction Center 7.3
> Configuration Tool.
If the Configuration Tool is already open, close and re-open it to ensure that the
Configuration Tool includes all system changes, such as new servers.
2. Log in with your IC Manager login ID and password.
3. Click the Web tab.
4. Enter the information for the general fields mentioned in the following table.

Field Description Sample entry

Tomcat Base Port The port used to configure the following ports: Default:
l Tomcat HTTP ports for Web applications 9600
l Tomcat AJP (Web server connector) ports

IIS Website The name of the IIS Web server that the Web Default Web Site
application will use.
Tip: For a localized version of IIS, type the
localized name for the IIS Web server.

Installation and Configuration March 2012 203


Chapter 8: Configuring Web Management

Field Description Sample entry

Web Server Host The name of the system that hosts the Web server. testbox
Do not include the DNS domain.
DNS Domain The network (DNS) domain of the system that xyzcorp.com
hosts your Web server. Do not enter an IC domain.
Note: Verify the default DNS domain carefully to
ensure that it is correct.
Web Server Port The port that your Web server uses for Default:
communication. Make sure that the port matches 80
the protocol used by your Web server for
communication. The default ports are:
l HTTP port is 80.

l HTTPS port is 443.

Do not change the default port unless you assign a


different port to the Web server.
IC Test Optional. Checkmark in box
IC Test is a Web application that you can use to
test your Tomcat configuration.
If you install multiple versions of Tomcat, the
Configuration Tool creates an IC Test application
on each version of Tomcat. The Configuration Tool
also creates a separate Tomcat server to host IC
Test.
To access IC Test, use the Tomcat HTTP port in
the URL. For example, type:
http://<server>.<domain>.com:9600/
ictest
Note: The port number is not required if you install
a single version of Tomcat, or access IC Test from
the separate Tomcat server for IC Test.

204 Installation and Configuration March 2012


Configuring Web Management services

5. Enter the information for the Web Management fields mentioned in the following table.

Field Description Sample entry

Configure Web Select this box if you want to configure Web Checkmark in box
Management Management services on the target computer.
After you select this box, the Configuration Tool
automatically:
l Displays the other Web Management fields

l Select the following boxes:

- Website
- ICM
- CIRS
- Attribute - DataWake recording (PDM)
Website Creates the Web site Web application and Checkmark in box
performs other tasks that are required to
configure a Web Management Web site on the
target computer.
After you select this box, the Configuration Tool
displays the following required fields for the Web
site:
l Website Virtual Directory Name

l WebACD

l Attribute Server

Website Virtual The name of the virtual directory for the Web site. website
Directory Name
WebACD The WebACD server in your IC system. WebACD_web
You must create the WebACD server before the
Configuration Tool can include the server in the
drop-down list. If the list does not include the
server, close the Configuration Tool and create
the server. For more information, see Creating
the WebACD server on page 191.
Attribute Server The Attribute server that the DataWake plug-in Attribute_web
uses.
You must create the Attribute server before the
Configuration Tool can include the server in the
drop-down list. If the list does not include the
server, close the Configuration Tool and create
the server. For more information, see Creating
the Attribute server on page 195.

Installation and Configuration March 2012 205


Chapter 8: Configuring Web Management

Field Description Sample entry

ICM Service Configures the ICM server and related Checkmark in box
components on a target computer.
For more information, see Configuring the ICM
server on page 228.
CIRS Service Configures the CIRS server and related Checkmark in box
components on a target computer.
For more information, see Configuring the Central
Internet Routing service on page 230.
Important: Only configure a CIRS server if
your IC system includes more than one ICM
server.
Attribute - Configures the DataWake recording feature of Checkmark in box
DataWake the Attribute server.
recording (PDM)
IC Login Use the website account that you imported into website
the database with the seed data.
If you have not already done so, change the
default password for this account. For more
information, see Interaction Center Administration
Guide.
Note: Do not use the Administrator account for
IC Manager or any other account for which the
password may change.
IC Password The password used by the IC Login. website
IC Data Source The Interaction Center data source that you interaction_center
create with the Interaction Center application for
the CallCenterQ database. For more information,
see Generating the Interaction Center
application on page 93.
Repository Data The Repository data source that you create with repository
Source the repository application for the IC Repository
database. For more information, see Generating
the IC Repository application on page 84.
Database Login Type a DBA login ID for the database server. SQL Server: sa

Oracle: sys
Database The password for the DBA login ID. admin
Password

206 Installation and Configuration March 2012


Configuring Web Management services

Field Description Sample entry

Oracle Home Oracle databases only. SQL Server: leave empty


The home directory of the Oracle client on the
system that hosts the Web Management servers. Oracle: C:\app\
Administrator\
product\11.2.0\
client_1

6. Click Apply Settings.


7. Click OK in the Success dialog box.
8. Click Exit.
9. To complete the configuration, perform the following steps to ensure that all Web
Management services start properly:
a. Open the Windows Services control panel.
b. Start Avaya IC Web Management Service 7.3, as described in Starting and stopping IC
services on page 138.

Configuring Web Management services on Solaris


Use these instructions if you plan to host Web Management services on a computer with Solaris
operating system.

! Important:
Important: To configure Web Management services on Solaris, log in as a user with write
permissions on the Web server directories and the IC installation directories. The
root user usually has these write permissions.
To configure Web Management services to run on a Solaris computer
1. Stop the Oracle iPlanet server that hosts the Web site application, as described in Starting
and stopping Oracle iPlanet Web server on page 140.
2. If the Configuration Tool is already open, close it to ensure that the Configuration Tool
includes all system changes, such as new servers.
3. Start the Configuration Tool:
a. Navigate to IC_INSTALL_DIR/IC73/bin
b. Run ./configure
4. Log in with your IC Manager login ID and password.
5. Click the Web tab.

Installation and Configuration March 2012 207


Chapter 8: Configuring Web Management

6. Enter the information for the general fields mentioned in the following table.

Field Description Sample entry

Tomcat Base Port The port used to configure the following ports: Default: 9600
l Tomcat HTTP ports for Web applications

l Tomcat AJP (Web server connector) ports

Web Server Home The installation path for the iPlanet Web Server /opt/oracle/
that hosts the Web application. websever7.0

Web Server Name The root name of the server as found in the testbox.xyzcorp.co
iPlanet Server home directory. m
Note: Do not include https- in the Web server
name.
Web Server Host The name of the system that hosts the Web testbox
server.
Do not include the DNS domain.
DNS Domain The network (DNS) domain of the system that xyzcorp.com
hosts your Web server. Do not enter an IC
domain.
Note: Verify the default DNS domain carefully
to ensure that it is correct.
Web Server Port The port that your Web server uses for Default: 80
communication. Make sure that the port matches
the protocol used by your Web server for
communication. The default ports are:
l HTTP port is 80.

l HTTPS port is 443.

Do not change the default port unless you assign


a different port to the Web server.
Deploy iPlanet If this box is checked, the config tool will pull and Check this box if you
Configuration deploy the configuration changes of server would like the config
instance to the config store. tool to pull and
deploy
configuration.
iPlanet Webserver iPlanet configuration used for website
Config configuration.
iPlanet Webserver Node is a network resource, such as a server or a Hostname
Node host on which Admin server is installed
iPlanet Webserver Admin login given at the time of iplanet Default is "admin"
Admin Login installation.

208 Installation and Configuration March 2012


Configuring Web Management services

Field Description Sample entry

iPlanet Webserver Admin password given at the time of iplanet


Admin Password installation.
IC Test Optional. Checkmark in box
IC Test is a Web application that you can use to
test your Tomcat configuration.
If you install multiple versions of Tomcat, the
Configuration Tool creates an IC Test application
on each version of Tomcat. The Configuration
Tool also creates a separate Tomcat server to
host IC Test.
To access IC Test, use the Tomcat HTTP port in
the URL. For example, type:
http://<server>.<domain>.com:9600/ictest
Note: The port number is not required if you
install a single version of Tomcat, or access IC
Test from the separate Tomcat server for IC Test.

Note:
Note: You can pull the configuration changes manually to the config store using the
following steps:
From Command Line:
a. Start the Web Server 7.0 Administration Server. See the Administrator's Guide.
b. For pulling the changes back to the Administration Server repository, execute the
following command.
wadm> pull-config --user=admin --config=CONFIG_NAME
From Administrator Console:
a. Start the Administrator Console (for example, https:// support.xyzcorp.com:8989/)
where 8989 is the default port on which administrative server is running.
b. On the admin console, select the Configuration and virtual server on which the
website is deployed.
c. Select Edit Virtual server.
d. On the right top corner, a link with message "Instance Configuration Modified"
would be displayed. click on the link and choose 'pull and deploy configuration'
and click on the Ok button.

Installation and Configuration March 2012 209


Chapter 8: Configuring Web Management

7. Enter the information for the Web Management fields mentioned in the following table.

Field Description Sample entry

Configure Web Select this box if you want to configure Checkmark in box
Management Web Management services on a target
computer.
After you select this box, the Configuration
Tool automatically:
l Displays the other Web Management
fields
l Select the following boxes:

- Website
- ICM
- CIRS
- Attribute - DataWake recording
(PDM)
Website Creates the Web site Web application and Checkmark in box
performs other tasks that are required to
configure a Web Management Web site on
a target computer.
After you select this box, the Configuration
Tool displays the following required fields
for the Web site:
l Web site Virtual Directory Name

l WebACD

l Attribute Server

Website Virtual The name of the virtual directory for the website
Directory Name Web site.
WebACD The WebACD server in your IC system. WebACD_web
You must create the WebACD server
before the Configuration Tool can include
the server in the drop-down list. If the list
does not include the server, close the
Configuration Tool and create the server.
For more information, see Creating the
WebACD server on page 191.

210 Installation and Configuration March 2012


Configuring Web Management services

Field Description Sample entry

Attribute Server The Attribute server that the DataWake Attribute_web


plug-in uses.
You must create the Attribute server before
the Configuration Tool can include the
server in the drop-down list. If the list does
not include the server, close the
Configuration Tool and create the server.
For more information, see Creating the
Attribute server on page 195.
ICM Service Configures the ICM server and related Checkmark in box
components on a target computer.
For more information, see Configuring the
ICM server on page 228.
CIRS Service Configures the CIRS server and related Checkmark in box
components on a target computer.
For more information, see Configuring the
Central Internet Routing service on
page 230.
Important: Only configure a CIRS
server if your IC system includes more
than one ICM server.
Attribute - Configures the DataWake recording Checkmark in box
DataWake feature of the Attribute server.
recording (PDM)
IC Login Use the website account that you imported website
into the database with the seed data.
If you have not already done so, change
the default password for this account. For
more information, see Interaction Center
Administration Guide.
Note: Do not use the Administrator
account for IC Manager or any other
account for which the password may
change.
IC Password The password used by the IC Login. website
IC Data Source The Interaction Center data source that interaction_center
you create with the Interaction Center
application for the CallCenterQ database.
For more information, see Generating the
Interaction Center application on page 93.

Installation and Configuration March 2012 211


Chapter 8: Configuring Web Management

Field Description Sample entry

Repository Data The Repository data source that you repository


Source create with the repository application for
the IC Repository database. For more
information, see Generating the Interaction
Center application on page 93.
Database Login Type a DBA login ID for the database Oracle: sys
server.
Note: Do not use the DBA login for a
database client on a DB2 database.
Database The password for the DBA login ID. admin
Password
Database Host The host name of the computer that hosts testbox.xyzcorp.com
your database server.
Oracle SID The Oracle SID of your database. icutf8db
Note: The Oracle SID field is
case-sensitive.

8. Click Apply Settings.


9. Click Ok in the Success dialog box.
10. Click Exit.
11. To complete the configuration, perform the following steps to ensure that all Web
Management services start properly:
a. In the iPlanet Server installation directory:
l Open the admin-server directory.
l If the directory includes a file called start-ICEnv.backup, execute the following
command to rename the file:
mv start-ICEnv.backup oldstart-ICEnv
b. Start the Oracle iPlanet server that hosts the Web site application, as described in
Starting and stopping Oracle iPlanet Web server on page 140.
c. Navigate to the IC_INSTALL_DIR/IC73/bin directory and use the following script
to start Tomcat:
nohup ./ictomcat.sh start website

! Important:
Important: For Solaris only, the Configuration Tool changes the ownership of the
implementation file (vesp.imp) and the interface file (vespidl.pk) to root. If you do
not want to run IC as root, you must change the ownership of these files as
described in Changing ownership for IC on Solaris only on page 39.

212 Installation and Configuration March 2012


Configuring Web Management services

Configuring Web Management services on AIX


Use these instructions if you plan to host Web Management services on an AIX system.

! Important:
Important: To configure Web Management services on AIX, log in as a user with write
permissions on the Web server directories and the IC installation directories. The
root user usually has these write permissions.
To configure Web Management services to run on an AIX system:
1. Stop the IBM HTTP Server that hosts the Web site application, as described in Starting
and stopping IBM http Web server on page 143.
2. If the Configuration Tool is already open, close it to ensure that the Configuration Tool
includes all system changes, such as new servers.
3. Start the Configuration Tool:
a. Navigate to IC_INSTALL_DIR/IC73/bin
b. Run ./configure
4. Log in with your IC Manager login ID and password.
5. Click the Web tab.
6. Enter the information for the general fields mentioned in the following table.

Field Description Sample entry

Tomcat Base Port The port used to configure the following Default:
ports: 9600
l Tomcat HTTP ports for Web
applications
l Tomcat AJP (Web server connector)
ports
Web Server Home The installation path for the IBM HTTP /usr/HTTPServer
server instance that hosts the Web
application.
Web Server Host The name of the system that hosts the Web testbox
server.
Do not include the DNS domain.
DNS Domain The network (DNS) domain of the computer xyzcorp.com
that hosts your Web server. Do not enter an
IC domain.
Note: Verify the default DNS domain
carefully to ensure that it is correct.

Installation and Configuration March 2012 213


Chapter 8: Configuring Web Management

Field Description Sample entry

Web Server Port The port that your Web server uses for Default:
communication. Make sure that the port 80
matches the protocol used by your Web
server for communication. The default ports
are:
l HTTP port is 80.

l HTTPS port is 443.

Do not change the default port unless you


assign a different port to the Web server.
IC Test Optional. Checkmark in box
IC Test is a Web application that you can
use to test your Tomcat configuration.
If you install multiple versions of Tomcat,
the Configuration Tool creates an IC Test
application on each version of Tomcat. The
Configuration Tool also creates a separate
Tomcat server to host IC Test.
To access IC Test, use the Tomcat HTTP
port in the URL. For example, type:
http://
<server>.<domain>.com:9600/
ictest
Note: The port number is not required if
you install a single version of Tomcat, or
access IC Test from the separate Tomcat
server for IC Test.

214 Installation and Configuration March 2012


Configuring Web Management services

7. Enter the information for the Web Management fields mentioned in the following table.

Field Description Sample entry

Configure Web Select this box if you want to configure Checkmark in box
Management Web Management services on a target
computer.
After you select this box, the
Configuration Tool automatically:
l Displays the other Web Management
fields
l Select the following boxes:

- Website
- ICM
- CIRS
- Attribute - DataWake recording
(PDM)
Website Creates the Web site Web application and Checkmark in box
performs other tasks that are required to
configure a Web Management Website on
a target computer.
After you select this box, the
Configuration Tool displays the following
required fields for the Website:
l Website Virtual Directory Name

l WebACD

l Attribute Server

Website Virtual The name of the virtual directory for the website
Directory Name Website.
WebACD The WebACD server in your IC system. WebACD_web
You must create the WebACD server
before the Configuration Tool can include
the server in the drop-down list. If the list
does not include the server, close the
Configuration Tool and create the server.
For more information, see Creating the
WebACD server on page 191.

Installation and Configuration March 2012 215


Chapter 8: Configuring Web Management

Field Description Sample entry

Attribute Server The Attribute server that the DataWake Attribute_web


plug-in uses.
You must create the Attribute server
before the Configuration Tool can include
the server in the drop-down list. If the list
does not include the server, close the
Configuration Tool and create the server.
For more information, see Creating the
Attribute server on page 195.
ICM Service Configures the ICM server and related Checkmark in box
components on a target computer.
For more information, see Configuring the
ICM server on page 228.
CIRS Service Configures the CIRS server and related Checkmark in box
components on a target computer.
For more information, see Configuring the
Central Internet Routing service on
page 230.
Important: Only configure a CIRS
server if your IC system includes more
than one ICM server.
Attribute - Configures the DataWake recording Checkmark in box
DataWake feature of the Attribute server.
recording (PDM)
IC Login Use the website account that you website
imported into the database with the seed
data.
If you have not already done so, change
the default password for this account. For
more information, see Interaction Center
Administration Guide.
Note: Do not use the Administrator
account for IC Manager or any other
account for which the password may
change.
IC Password The password used by the IC Login. website
IC Data Source The Interaction Center data source that interaction_center
you create with the Interaction Center
application for the CallCenterQ database.
For more information, see Generating the
Interaction Center application on page 93.

216 Installation and Configuration March 2012


Configuring Web Management services

Field Description Sample entry

Repository Data The Repository data source that you repository


Source create with the repository application for
the IC Repository database. For more
information, see Generating the IC
Repository application on page 84.
Database Login Type a DBA login ID for the database DB2: db2inst1
server.
Note: Do not use the DBA login for a
database client on a DB2 database.
Database The password for the DBA login ID. admin
Password
Database Host The host name of the system that hosts testbox.xyzcorp.com
your database server.
DB2 Port The port that the target system uses to Default:
communicate with the DB2 database. 50,000

8. Click Apply Settings.


9. Click Ok in the Success dialog box.
10. Click Exit.
11. To complete the configuration, perform the following steps to ensure that all Web
Management services start properly:
a. Start the IBM HTTP Server that hosts the Web site application, as described in Starting
and stopping IBM http Web server on page 143.
b. Navigate to the IC_INSTALL_DIR/IC73/bin directory.
c. Use the following script to start Tomcat:
nohup ./ictomcat.sh start website

! Important:
Important: For AIX only, the Configuration Tool changes the ownership of the implementation
file (vesp.imp) and the interface file (vespidl.pk) to root. If you do not want to run
IC as root, you must change the ownership of these files as described in
Changing ownership for IC on AIX only on page 41.

Installation and Configuration March 2012 217


Chapter 8: Configuring Web Management

Integrating Web Management Administration


Web Management Administration is a set of Web pages that you use to administer and
configure Web Management and Email Management. You open Web Management
Administration from IC Manager. Before you use Web Management Administration, you must
integrate it with IC Manager.
Note:
Note: Complete only those properties listed in this section to integrate Web
Management administration. You do not need to complete the other properties
available in the System/Configuration list.
This section includes the following topics:
l Integrating Web Management Administration with IC Manager on page 218
l Setting the ServerName property - AIX only on page 219

Integrating Web Management Administration with IC Manager


To integrate Web Management Administration with IC Manager:
1. In IC Manager, select Tools > Groups.
2. Click the Properties tab.
3. In the left pane, select the IC node.
4. In the Sections list, select System/Configuration.
5. From the list of properties, double-click the Value column next to ChatLoginServer and
enter the information for the following fields:
a. In the Property Value field, type the fully-qualified domain name of a computer that
hosts the Tomcat server for the Web Management Administration Web site. For
example, type support.xyzcorp.com.
b. Click Ok.
6. From the list of properties, double-click the Value column next to ChatLoginServerWebsite
and enter the information for the following fields:
a. Type the name of the Tomcat web application for the Web Management Administration
Web site.
This is the name that you specified when you configured the website Tomcat
application in Configuring Web Management services on page 201. The Web
Management Administration Website must be on a computer that you specified for the
ChatLoginServer property.
b. Click Ok.

218 Installation and Configuration March 2012


Integrating Web Management Administration

7. If you serve your Web Management Administration pages from a secure web server, you
must also modify the properties shown in the following table:

Property Recommended entry Notes

ChatLoginServerProtocol Type the protocol that For secure server protocol,


your Web server uses. type https.
For non-secure server
protocol, type http.
ChatLoginServerPort Type the following Do not change the default
ports: port.
l HTTP - 80

l HTTPS - 443

8. Click Ok.
9. Exit and restart IC Manager.

Setting the ServerName property - AIX only


The default installation of the IBM http server does not include the fully qualified domain name
for the ServerName property in the httpd.conf file. If this property is incorrect, the Web
Management Administration pages can loop indefinitely on the opening page.
To set the ServerName property:
1. In a text editor, open the .../HTTPServer/conf/httpd.conf file.
2. Search for the ServerName entry and ensure that the value includes the fully qualified
domain name of the server.
3. Save the file.
4. Restart the IBM http server, as described in Starting and stopping IBM http Web server on
page 143.

Installation and Configuration March 2012 219


Chapter 8: Configuring Web Management

Configuring a Workflow server for Web Management


To configure the Workflow server for Web Management, perform the steps in the following
topics:
1. Creating a Workflow server for Web Management on page 220.
2. Creating the chat channel for the Workflow server on page 221.
If your IC system includes multiple Workflow servers, perform these steps on each Workflow
server that processes chat contacts.

Creating a Workflow server for Web Management


These instructions provide information only about those parameters you need to set when you
create a Workflow server to handle chat contacts. If you have configured two WebACD servers,
create two Workflow servers for Web Management. For example, if Web and Web2 are two
domains where you have configured WebACD1 server and WebACD2 server respectively. Then,
you must configure WebManagement Workflow servers in both Web and Web2 domain.
For more information about other parameters in the Workflow server, see Configuring multiple
Workflow servers on page 119 and Interaction Center Administration Guide.

! CAUTION:
CAUTION: If you do not configure the Workflow server with synchronous startup flows, the
Qualify Chat workflow cannot resolve the pkey of the queue where a contact is to
be routed. If this occurs, IC cannot route chat contacts.
To create a Workflow server for Web Management
1. In IC Manager, select Server > New.
2. From the list of servers, select Workflow.
3. Click Ok.
4. Click the General tab, and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

Name Workflow_<domain> Include the domain in the server


name to identify the server.

220 Installation and Configuration March 2012


Configuring a Workflow server for Web Management

Field Recommended entry Notes

Domain Select the IC domain for the For example, you can select
server from the drop-down list. Web or Web2 to use the
preconfigured domain for Web
Management.
Host Select the IP address of the When you select the host, IC
system from the drop-down list, or Manager fills in the fields for
type the IP address if it is not in Directory, Port, and Executable.
the list.

5. Click the Workflow tab.


6. From the IC Data Source drop-down list, select the Interaction Center data source.
The default name for this data source is interaction_center. This is the data source that you
created in Generating the Interaction Center application on page 93.
7. Select Synchronous Startup Flows.
8. If the following rows do not exist, add them to the Synchronous Startup Flows:
a. Click New.
b. In the new row, type web_routing.update_qw_cache
c. Click OK.
9. Continue with Creating the chat channel for the Workflow server on page 221.

Creating the chat channel for the Workflow server


To create the chat channel for the Workflow server
1. In the Server Editor for the Workflow server, click the Channels tab.
2. Click the Channels tab.
3. Select New Channel.
4. In the Channel Editor dialog box:

Installation and Configuration March 2012 221


Chapter 8: Configuring Web Management

a. Enter the information for the fields mentioned in the following table.

Field Recommended entry Notes

Global Do not check this field. Do not check this field to create a
create a channel for a specific server
or media, such as Chat.
By Server l Do not check this field if If you check this field, and you need
you want this channel to this Workflow server to communicate
handle events from all with more than one server, you must
servers of the type that create another channel for that
you select from the server.
Service drop-down list.
Warning: If you check this field
l Check this field if you and the WebACD server is named
want this channel to "WACD", the Workflow server will
handle events from only not be able to communicate with
one specific server that the WebACD server.
you select from the
Service drop-down list.
Channel Range No entry necessary. Completed by IC Manager
Service Select WACD or the Whether you can select a server or a
WebACD server from the type of server, depends up whether
drop-down list. or not you checked the By Server
field.
Criteria Type media=chat

b. Click OK.
5. Select the channel that you created in the step above.
6. Click New Association.
7. In the Channel Association dialog box, enter the information for the fields mentioned in
the following table and click Ok.

Field Recommended entry

Channel Range Completed by IC Manager


Service Range Completed by IC Manager
Event WACD.QualifyChat
Note: This field is case-sensitive.
Flow <flow_project>.<flow_name>
For example, to use the sample workflow, type
wacd.qualifychat

222 Installation and Configuration March 2012


Using workflows for Web Management

8. Click OK.
9. In the Server tab of IC Manager, select the Workflow server that handles chat contacts.
10. Right-click the Workflow server and select Start.

Using workflows for Web Management


You can use the sample workflows to configure and test your Web Management servers. When
you move into production, modify the sample workflows to meet your system needs and
configuration. For more information, see Avaya IC Media Workflow Reference.
Note:
Note: If you add a queue to route chat contacts, you must re-run the update_qw_cache
workflow in the Web_Routing project. If you do not want to stop and start the
Workflow server that processes chat contacts, select Run Flows on the General
tab of the Workflow server.
This section includes the following topics:
l Workflows required by Web Management on page 223.
l Reloading the customer management workflows on page 224.

Workflows required by Web Management


Web Management requires the following sample and system workflows:
l Qualify Chat workflow in the WACD project
l All workflows in the WebRouting project
l All workflows in the WebCenter project
The IC seed data includes compiled sample workflows for these projects. When you created the
CCQ database, you imported the compiled workflows with the seed data and stored them in the
database.
For a complete list of the workflows in these projects, including the directories where IC installs
the workflows, see Avaya IC Workflow Designer User Guide.

! Important:
Important: Make sure that no workflows use a formatted telephone number to look up
customer records. For example, confirm that your Qualify Chat workflow does not
use a formatted telephone number in the Customer Lookup block.

Installation and Configuration March 2012 223


Chapter 8: Configuring Web Management

Reloading the customer management workflows


The customer management workflows in the WebCenter project require file-based Avaya IC
Scripts. By default, the include property contains the names of the required file-based IC
Scripts.
Before you compile the workflows in the WebCenter project, add the following Avaya IC Script
directory to the project:
IC_INSTALL_DIR\IC73\design\IC\Flows\Avaya\WebCenter
To add the Avaya IC Script directory
1. With the project open in Workflow Designer, select Project > Settings.
2. In the Directories tab of the Project Settings dialog box, select New Folder.
3. In the Open dialog box:
a. Navigate to the following IC Script folder:
IC_INSTALL_DIR\IC73\design\IC\Flows\Avaya\WebCenter
b. Click Ok to add the Avaya IC Script folder to the Directories tab.
4. If you have not already done so, in the Project Settings dialog box:
a. Click the Database tab.
b. Verify that the IC Data Source field includes the name of the Interaction Center data
source.
c. In the Login Id field, enter an administrative account for IC.
d. In the Password field, enter the password for the administrative account.
5. In the Project Settings dialog box, click Ok.
You can now compile and load the customer management workflows.

224 Installation and Configuration March 2012


Configuring routing hints for the Qualify Chat workflow

Configuring routing hints for the Qualify Chat workflow


The Fetch Routing Hints (chat) block in the Qualify Chat workflow uses the routing hints in the
RoutingHint table of the Directory server to route incoming chat contacts. The following table
shows the routing hints used in the sample Qualify Chat workflow.

Category Sample routing hint values

language This category requires ISO-639-1 values,


such as:
l en

l sp

l fr

l de

l zh

intent l sales
l support

To route chat contacts with the sample Qualify chat workflow, create these hints, then assign
them to the default chat queue.

! Important:
Important: Routing hints must be in lower case. Do not use mixed upper and lower case in
your routing hints. If the routing hint is not in all lower case, the workflow cannot
locate the routing hint, and Avaya IC cannot correctly route the contact.
To configure routing hints, perform the steps in the following topics:
1. Creating routing hints on page 225.
2. Associating routing hints with Web Self-Service documents on page 227.

Creating routing hints


Use the Configuration tab of IC Manager to create routing hints and add them to the RoutingHint
table. The Qualify Chat workflow uses hints from the RoutingHint table to route incoming chat
contacts.
Each row in the routing hint table contains the following:
l A routing hint
l The IDs of the queues where contacts that match the routing hint should be routed

Installation and Configuration March 2012 225


Chapter 8: Configuring Web Management

Tip:
Tip: The default chat queue is DefaultChatQueue@DefaultTenant. You can create
and use additional chat queues for routing chat contacts. For more information,
see Interaction Center Administration Guide.
To create routing hints
1. In IC Manager, click the Configuration tab.
2. In the left pane, select Tables > Workflow > RoutingHint.
3. Click New.
4. In the right pane, enter the information for the fields mentioned in the following table.

Parameter Recommended entry Description

Routing Hint Type a routing hint. For the sample Qualify Chat workflow,
enter a value for the language or intent
category.
For language, type a value such as:
- en
- sp
- fr
- de
- zh
For intent, type a value such as:
- sales
- support
The routing hint must be a text string in all
lower case. The text string cannot contain
any special characters.
Chat Queue ID Type DefaultChatQueue@DefaultTenant is the
DefaultChatQueue@DefaultT default chat queue. For more information
enant. about chat queues, see Interaction Center
Administration Guide.
Category/Qualifier Leave this field blank. Used only for routing hints for chat
contacts in Business Advocate.
Tenant Select DefaultTenant from the Select the tenant used by the queue.
queue from the drop-down list. For the DefaultChatQueue, select
DefaultTenant to ensure that the routing
hint uses the correct queue.

5. Click Ok.
Repeat Steps 3 through 6 to create the second routing hint.

226 Installation and Configuration March 2012


Configuring routing hints for the Qualify Chat workflow

6. Select Manager > Refresh.

Associating routing hints with Web Self-Service documents


After you add the routing hints to the Directory server tables, you can associate the routing hints
with documents in the Web Self-Service database.
When a customer requests a chat contact with an agent, Web Management records the last
document that the customer viewed on the Web site. If that document has an associated routing
hint, the Qualify Chat workflow uses that routing hint to determine the correct queue for the chat
contact.
You need to create at least one document for that database to fully test the Qualify Chat
workflow. For more information about the Web Self-Service database, see Interaction Center
Administration Guide.
To associate routing hints with Web Self-Service documents
1. In IC Manager, select Services > Web Response Unit.
2. In the left pane, select Web Self-Service Console.
3. On the Web Self-Service Console page:
a. Select a tenant from the drop-down list.
b. In the left pane, select Manage FAQ.
4. On the Manage FAQ page:
a. Select the document in the list of documents.
b. Click Update.
5. In the document, scroll down to the Routing Attributes section.
6. Select one routing hint from the Routing Hint drop-down lists.
7. Click Update.

Installation and Configuration March 2012 227


Chapter 8: Configuring Web Management

Configuring the ICM server


The ICM server is a service that hosts text conference for Web Management. The ICM server
does not run in IC Manager. For information about how to stop and restart the ICM server, see
Starting and stopping IC services on page 138.

! Important:
Important: The steps in Configuring the ICM server are optional. Do not perform these steps
if the ICM server requires only the default functionality. For example, perform
these steps if you want to increase the logging level from the default logging level
of "1".
Do not enter a value or change the default values in the fields available through Advanced
Properties unless a property needs to be explicitly changed from the default value calculated
by the ICM server during its initialization. Most IC systems do not require setting any of the
advanced properties. For more information about the advanced properties, see Interaction
Center Administration Guide.
To configure the ICM Server
1. In IC Manager, click the Configuration tab.
2. From the Tables list in left pane, select Chat > ICM.
3. Click New.
4. In the right pane, type a name for the ICM server in the Global ICM Name field.
If your Avaya IC system includes multiple ICM servers, type the name that allows you to
easily identify the ICM server. For example, for an ICM server on the TESTBOX computer,
type icm_TESTBOX.

! Important:
Important: The ICM server name is case-sensitive.
The ICM server uses the global name to determine which ICM record to read for
configuration. The global name in this field must match the dsObject parameter in the
following file on the system that hosts the ICM server:
IC_INSTALL_DIR/IC73/etc/systemParms.txt

228 Installation and Configuration March 2012


Configuring the ICM server

5. In the right pane, review the fields as shown in the following table.
Note:
Note: Do not enter a value or change a default value in these fields unless a property
needs to be explicitly changed from the default value calculated by the ICM
server during initialization. Most IC systems do not require changing any of these
fields.

Parameter Description

ICM Active External clients use this parameter to determine which


ICMs to use.
Enable Emoticons Select this check box to enable emoticons in the Chat
application. With chat message, you can send emoticons to
the client. For more information, see Avaya Agent Web
Client Online Help.
ICM Server Name The fully-qualified domain name of the system that hosts
this ICM server.
SMTP Host The fully-qualified domain name of the system that hosts
the SMTP server. For example, SMTPSVR.xyzcorp.com.
Chat Transcript The directory where IC stores the chat transcripts. The
Directory default directory is IC_INSTALL_DIR\IC73\comp\icm\
transcript
Style Sheet Directory The directory where IC stores the style sheets used to
format emails that include chat transcripts.
If you use the default installation directory, IC Manager
automatically enters the following directory:
../comp/icm/transcriptxsl
CIRS Host The name of the system that hosts the CIRS server used
for load balancing.
ICM Property A number from 0 to 4 that represents the debug level for
Management Debug ICM components. Level 0 provides no debugging
Level information in the logs, and level 4 provides full debugging
information.
ICM Toolkit Debug A number from 0 to 4 that represents the debug level for
Level ICM toolkit components. Level 0 provides no debugging
information in the logs, and level 4 provides full debugging
information.
ICM Debug Level A number from 0 to 4 that represents the debug level for the
ICM server. Level 0 provides no debugging information in
the logs, and level 4 provides full debugging information.

6. Click Ok.

Installation and Configuration March 2012 229


Chapter 8: Configuring Web Management

7. Restart the ICM server.

Configuring the Central Internet Routing service


If your IC system includes multiple ICM servers, you must configure a Central Internet Routing
service (CIRS server) to balance the load between the ICM servers. Repeat the following steps
for each CIRS server in your IC system.
The CIRS server does not run in IC Manager. For information about how to stop and restart the
CIRS server, see Starting and stopping IC services on page 138.

! Important:
Important: The steps in Configuring the Central Internet Routing service are optional. Do not
perform these steps if the CIRS server requires only the default functionality. For
example, perform these steps if you want to increase the logging level from the
default logging level of "1".
Do not enter a value or change the default values in the fields available through Advanced
Properties unless a property needs to be explicitly changed from the default value calculated
by the CIRS server during its initialization. Most IC systems do not require setting any of the
advanced properties. For more information about the advanced properties, see Interaction
Center Administration Guide.
To configure the CIRS server:
1. In IC Manager, click the Configuration tab.
2. From the Tables list in left pane, select Chat > CIRS.
3. Click New.
4. In the right pane, type a name for the CIRS server in the Global CIRS Name field.
The CIRS server name is case-sensitive.
If your Avaya IC system includes multiple CIRS servers, type a name that allows you to
easily identify this CIRS server. For example, for a CIRS server on the TESTBOX
computer, type cirs_TESTBOX.
The CIRS server uses the global name to determine which CIRS record to read for
configuration. The global name in this field must match the dsObjectName parameter in
the following file on the system that hosts the CIRS server:
IC_INSTALL_DIR/IC73/etc/cirsSystemParms.txt

230 Installation and Configuration March 2012


Configuring the Website

5. In the right pane, review the fields as shown in the following table.
Note:
Note: Do not enter a value or change the default values in these fields unless a property
needs to be explicitly changed from the default value calculated by the CIRS
server during its initialization. Most IC systems do not require changing any of
these fields.

Parameter Description

CIRS Active External clients use this parameter to determine which


ICMs to use.
This box must be checked for the CIRS server to function.
IC Site Automatically lists all sites in your IC system. This field
contains the site where this CIRS server is located.

6. Click Ok.
7. Restart the CIRS server.

Configuring the Website


Before you configure the website, create the web site application in the Configuration Tool. For
more information, see Configuring Web Management services on page 201.
If you are configuring a localized version, you can specify a supported language for the Web
site. For more information, see Configuring the Website for supported languages on page 440.

! Important:
Important: The steps in Configuring the Website are optional. Do not perform these steps if
the Web site requires only the default functionality. For example, perform these
steps to create a separate administration Web site and to disable access to the
administration pages on the customer Web site.
Do not enter a value or change the default values in the fields available through Advanced
Properties unless a property needs to be explicitly changed from the default value calculated
by the Website during its initialization. Most IC systems do not require setting any of the
advanced properties. For more information about the advanced properties, see Interaction
Center Administration Guide.
Note:
Note: For handling large number of chat requests, configure the Website on a separate
system and IIS Webserver to be configured on a separate system. For more
information, see Configuring IIS server on a separate system on page 234.

Installation and Configuration March 2012 231


Chapter 8: Configuring Web Management

You can install the primary and the secondary Websites on the primary and secondary
WebACD servers. But you must follow the below mentioned rules while configuring the
Webservers, such as IIS, Oracle iPlanet, and Apache.
l Setup the Webserver either on the primary or the secondary website system. If the
Webserver is setup on both the systems, the WebAdmin plug-in on both these systems will
redirect the request to each other, which results in the WebACD page not being displayed.
In this configuration, two systems are used and the Webserver from either the primary or
secondary Website system can be used to host the Website.
l Alternatively, you can setup a third system for the Webserver and install the primary
Website and WebACD on one system and secondary Website and WebACD on the other
system.
To configure the Website
1. In IC Manager, click the Configuration tab.
2. From the Tables list in the left pane, select Website > Website Context Configuration.
3. Click New.
4. In the right pane, type a name for the Website in the Global Name field.
The Website name is case-sensitive.
Type a name that allows you to easily identify the Web site. For example, for a Web site on
the TESTBOX computer, type website_TESTBOX.
The Website uses this parameter to determine which website context record to read. This
value must match the dsObject parameter in the following file on a computer that hosts
the Web site:
IC_INSTALL_DIR\IC73\comp\website\WEB-INF\web.xml
5. In the right pane, review the fields as shown in the following table.
Note:
Note: Do not enter a value or change the default values in these fields unless a property
needs to be explicitly changed from the default value calculated by the Web site
during its initialization. Most IC systems do not require changing any of these
fields.

Parameter Description

Context Active External clients use this parameter to determine which


website context to use.
This box must be checked for the Website to function.
CIRS Name This is the CIRS server to which the ICM CIRS servlet
connects to perform load-balancing for chat contacts.

232 Installation and Configuration March 2012


Configuring the Website

Parameter Description

Website Debug Level A number from 0 to 4 that represents the debug level for the
website. Level 0 provides no debugging information in the
logs, and level 4 provides full debugging information.
Default hostname for The name of the system that hosts the Web site.
context Used by external clients to determine the location of your
customer-facing Website.
If you enter a value in this field, Web Management uses this
as the default system_name in the URL for the
customer-facing Website.
If you leave this field blank, Web Management uses the
value that you use in the URL when you access the
customer-facing website for the first time. For example, if
you use localhost in the URL the first time, the URL will be
http://localhost/website/public.
IC Site This property is not currently used.
Servlet context name The name of your Website servlet. For example, website.
This is the web application name in the Tomcat server.
Used by external clients to determine website context
name.
This value is part of the URL used to access the
customer-facing Website. For example, if you enter support
for a customer support Website, the URL will be:
http://<hostname>/support/public
Default internet Either HTTP or HTTPS protocol.
protocol Used by external clients to determine website protocol.
Default port for This is the HTTP connection port that the website uses.
context The defaults are:
l 80 for HTTP

l 443 for HTTPS

6. Click Ok.
7. Restart the Tomcat server that hosts the Website, as shown in the following table:

Operating system Step

Windows From the Services Control Panel, restart the Tomcat


server.

Installation and Configuration March 2012 233


Chapter 8: Configuring Web Management

Operating system Step

Solaris Run the following command:


nohup ./ictomcat.sh start
AIX Run the following command:
nohup ./ictomcat.sh start

Configuring IIS server on a separate system


Scenario:
System 1: One IIS
System 2: One AIC Website (tomcat)
Note:
Note: After you configure IIS as per this scenario, you must use the URL of the
System 1 for accessing the IC Web site.
For example: http://<IP address of System 1>/website/public/
account.jsp.
To configure IIS server on System 1
1. Install IIS 7.5.
2. Create a directory named IIS on the C drive.
3. From the IC_INSTALL_DIR\IC73\tomcat\modules directory on System 2, copy the
following files into the IIS directory.
l iis_redirect.dll
l iis_redirect.properties
4. Edit the iis_redirect.properties file as mentioned below:
5. Replace the directory path mentioned for log_file, worker_file,
worker_mount_file with C:\IIS. For example:
Replace:
log_file=IC_INSTALL_DIR\IC73\tomcat\logs\iis_redirect.log.
With:
log_file=C:\IIS\iis_redirect.log.
6. From the IC_INSTALL_DIR\IC73\tomcat\conf directory on System 2, copy the
following files into the IIS directory.
l workers.properties

234 Installation and Configuration March 2012


Configuring Avaya Full Text Search Engine

l uriworkermap.properties
7. Edit the workers.properties file as mentioned below:
8. Replace the localhost value of all the host properties with the IP address of System 2.
For example:
Replace:
worker.website_ajp13.host=localhost.
With:
worker.website_ajp13.host=<IP Address of System 2>.
9. Create an application directory with name aicjakarta in the location C:\IIS.
10. Restart the IIS server.
Note:
Note: To access the IC Web site pages, you must use the complete URL including the
file name. For example, http://<IP address of System 1>/website/
public/account.jsp.

Configuring Avaya Full Text Search Engine


Avaya Full Text Search Engine (Avaya FTSE) is the full text search engine for IC. Avaya FTSE
supports the Web Self-Service database, including the FAQs and Suggested Email Responses.
This section includes the following topics:
l Configuring Avaya FTSE for Windows on page 235
l Configuring for Avaya FTSE for Sun Solaris on page 237
l Configuring for Avaya FTSE for IBM AIX on page 241

Configuring Avaya FTSE for Windows


This section includes the following topics:
l Configuring full text searches for Microsoft Windows on page 236
l Updating the full text indices on Microsoft Windows on page 236

Installation and Configuration March 2012 235


Chapter 8: Configuring Web Management

Configuring full text searches for Microsoft Windows


You must configure full text searches on every system that hosts one or more of the following:
l Customer Website
l Administrative Website
l WebACD server
To configure full text searches for Microsoft Windows:
1. Restart the IC Website service, as described in Starting and stopping services on
Windows on page 139.
2. Open a DOS command prompt window.
3. In the command prompt window, navigate to the following directory: IC_INSTALL_DIR\
IC73\etc\wru_sql\
4. Run the set up command for your database:

Database Set up command

SQL Server fulcrum_setup.cmd sqlserver <ccq_database_username>


<ccq_database_password>
Oracle fulcrum_setup.cmd oracle <ccq_database_username>
<ccq_database_password>

After the set up command executes, continue with Step 5.


5. Check the IC_INSTALL_DIR\IC73\etc\wru_sql\wru_createview.err file for
errors.
If the file is not present or is empty, the set up command executed correctly. Some
messages that you might see in the error file do not indicate a problem. For more
information, see Full text search configuration error messages on page 474.
6. Check the IC_INSTALL_DIR\IC73\etc\wru_sql\fulcrum.err file for errors.
If the file is empty, the set up command executed correctly. Some messages that you
might see in the error file do not indicate a problem. For more information, see Full text
search configuration error messages on page 474. Correct these errors as indicated in the
message and as required by the database, then re-run the set up command.

Updating the full text indices on Microsoft Windows


If you host your customer Web site and WebACD server on different systems, or if your IC
configuration includes multiple Web sites, you must update the full text indices on those
systems. The update ensures that the indices on these systems include all documents that you
have added to the index.

236 Installation and Configuration March 2012


Configuring Avaya Full Text Search Engine

You can run the update command as needed or schedule them to run at regular intervals. If you
schedule an update to run at regular intervals, do not run the update more frequently than once
per hour.
You must run this update command on every system that hosts one or more of the following:
l Customer-facing Website
l WebACD server

! Important:
Important: Do not run this update command on the system that hosts the Administrative
Website. That system automatically updates its own index.
To update the full text indices:
1. Open a DOS command prompt window.
2. In the command prompt window, navigate to the following directory: IC_INSTALL_DIR\
IC73\etc\wru_sql
3. Run the following update command: fulcrum_updatendx.cmd
4. Check the IC_INSTALL_DIR\IC73\etc\wru_sql\fulcrum_updatendx.err file for
errors.
If the file is empty, the set up command executed correctly. All messages in this file
indicate errors. Correct these errors as indicated in the message and as required by the
database, then re-run the set up command.
5. Restart the IC Website service, as described in Starting and stopping services on
Windows on page 139.
After you update the full text indices, you must restart the IC Website service to ensure that
the drivers for the fulcrum search are loaded.

Configuring for Avaya FTSE for Sun Solaris


This section includes the following topics:
l Changing ownership for the full text search directory on page 238
l Configuring full text searches on Solaris on page 238
l Updating full text indices on Sun Solaris on page 240

Installation and Configuration March 2012 237


Chapter 8: Configuring Web Management

Changing ownership for the full text search directory


Only the root user has read permissions for some of the files in the following directory:
IC_INSTALL_DIR/IC73/etc/wru_sql
You must change the ownership for this directory if you plan to run the Avaya FTSE
components as a non-root user on any system that hosts a Website or the WebACD server.
To change ownership for the full text search directory:
1. Log in as root user.
2. Navigate to IC_INSTALL_DIR/IC73/etc
3. Execute the following command:
chown -R <userid> wru_sql
where <userid> represents the non-root user that you use to run the Avaya FTSE
components.

Configuring full text searches on Solaris


You must configure full text searches on every system that hosts one or more of the following:
l Customer Website
l Administrative Website
l WebACD server
To configure full text searches on Solaris:
1. If you defined the following environment variable in your shell, remove the setting for that
environment variable.

Operating system Environment variable

Solaris ORACLE_HOME

2. Navigate to the following directory: IC_INSTALL_DIR/IC73/etc/wru_sql.

238 Installation and Configuration March 2012


Configuring Avaya Full Text Search Engine

3. Run the following command to create the indices for full text searching:
./fulcrum_setup.sh <ccq_database_username> <ccq_database_password>
When this command executes, you may see the following output:

Error message Description

ERROR at line 1: You can ignore this error. It indicates that


ORA-00955: name is already used by an the view already exists.
existing object
DB21034E The command was You can ignore this error. This message
processed as an SQL statement indicates that the view already exists.
because it was not a valid Command
Line Processor command. During SQL
processing it returned: SQL0601N The
name of the object to be created is
identical to the existing name
"CCQ.WRU_VIEW" of type "VIEW".
SQLSTATE=42710
"Error : 666" This error indicates a problem in the
odbc.ini file. This error results from the
bind18 command used to create bind
packages for the ODBC drivers.
Verify that the entries in the odbc.ini file
for the ccq datasource are correct.
Incorrect values in this file typically result
from incorrect values entered in the
Configuration Tool.
Repeat the configuration of Web
Self-Service.

execsql: execute failed You may see this error message twice in
SQLSTATE: SGS00, Native error: 0, fulcrum.err. This error occurs because
the script is attempting to drop a table
error text [Hummingbird][SearchServer] that does not yet exist.
Invalid table name
You can ignore this error when you run
the fulcrum_setup command for the
first time on a system. However, if you
receive this error when you repeat the
command on a system, investigate why
the script cannot access the database to
perform the following tasks:
l unprotect table qw_wru_en

l drop table qw_wru_en

Installation and Configuration March 2012 239


Chapter 8: Configuring Web Management

4. Check the IC_INSTALL_DIR/IC73/etc/wru_sql/fulcrum.err file for errors.


If the file is not present or is empty, the set up command executed correctly. Some
messages that you might see in the error file do not indicate a problem. For more
information, see Full text search configuration error messages on page 474.
5. Verify that the command did not create a file with a DIL extension in the
IC_INSTALL_DIR/IC73/etc/wru_sql/ directory.
If such a file exists, check the contents for errors. If it contains errors, check the contents of
fulcrum_odbctrace.out to see what went wrong. If there were problems with the
database connection, confirm that the entries in the odbc.ini file are correct and that you
invoked fulcrum_setup.sh with a valid username and password.
6. If necessary, after you correct all errors, re-run the fulcrum_setup.sh command.

Updating full text indices on Sun Solaris


If you host your customer Web site and WebACD server on different systems, or if your IC
configuration includes multiple Websites, you must update the full text indices on those
systems. The update ensures that the indices on these systems include all documents that you
have added to the index.
You can run the update command as needed or schedule them to run at regular intervals. If you
schedule an update to run at regular intervals, do not run the update more frequently than once
per hour.
You must run this update command on every system that hosts one or more of the following:
l Customer-facing Website
l WebACD server

! Important:
Important: Do not run this update command on the system that hosts the Administrative
Website. That system automatically updates its own index.
To update the full text indices:
1. Navigate to the following directory: IC_INSTALL_DIR/IC73/etc/wru_sql
2. Run the following update command:
./fulcrum_updatendx.sh
3. Check the IC_INSTALL_DIR/IC73/etc/wru_sql/fulcrum_updatendx.err file for
errors.
If the file is empty, the set up command executed correctly. All messages in this file
indicate errors. Correct these errors as indicated in the message and as required by the
database, then re-run the set up command.

240 Installation and Configuration March 2012


Configuring Avaya Full Text Search Engine

4. Restart the IC Website service, as described in Starting and stopping services on


Solaris on page 139.
After you update the full text indices, you must restart the IC Website service to ensure that
the drivers for the fulcrum search are loaded.

Configuring for Avaya FTSE for IBM AIX


This section includes the following topics:
l Changing ownership for the full text search directory on page 241
l Configuring full text searches on IBM AIX on page 241
l Updating full text indices on IBM AIX on page 244

Changing ownership for the full text search directory


Only the root user has read permissions for some of the files in the following directory:
IC_INSTALL_DIR/IC73/etc/wru_sql
You must change the ownership for this directory if you plan to run the Avaya FTSE
components as a non-root user on any system that hosts a Website or the WebACD server.
To change ownership for the full text search directory:
1. Log in as root user.
2. Navigate to IC_INSTALL_DIR/IC73/etc
3. Execute the following command:
chown -R <userid> wru_sql
where <userid> represents the non-root user that you use to run the Avaya FTSE
components.

Configuring full text searches on IBM AIX


You must configure full text searches on every system that hosts one or more of the following:
l Customer Website
l Administrative Website
l WebACD server
To configure full text searches on IBM AIX:
1. If you defined the following environment variable in your shell, remove the setting for that
environment variable.

Installation and Configuration March 2012 241


Chapter 8: Configuring Web Management

Operating system Environment variable

IBM AIX DB2DIR

2. Navigate to the following directory: IC_INSTALL_DIR/IC73/etc/wru_sql.


3. Run the following command to create the indices for full text searching:
./fulcrum_setup.sh <ccq_database_username> <ccq_database_password>
When this command executes, you may see the following output:

Error message Description

ERROR at line 1: You can ignore this error. It indicates that


ORA-00955: name is already used by an the view already exists.
existing object
DB21034E The command was You can ignore this error. This message
processed as an SQL statement indicates that the view already exists.
because it was not a valid Command
Line Processor command. During SQL
processing it returned: SQL0601N The
name of the object to be created is
identical to the existing name
"CCQ.WRU_VIEW" of type "VIEW".
SQLSTATE=42710

242 Installation and Configuration March 2012


Configuring Avaya Full Text Search Engine

Error message Description

"Error : 666" This error indicates a problem in the


odbc.ini file. This error results from the
bind18 command used to create bind
packages for the ODBC drivers.
Verify that the entries in the odbc.ini file
for the ccq datasource are correct.
Incorrect values in this file typically result
from incorrect values entered in the
Configuration Tool.
Repeat the configuration of Web
Self-Service.

execsql: execute failed You may see this error message twice in
SQLSTATE: SGS00, Native error: 0, fulcrum.err. This error occurs because
the script is attempting to drop a table
error text [Hummingbird][SearchServer] that does not yet exist.
Invalid table name
You can ignore this error when you run
the fulcrum_setup command for the
first time on a system. However, if you
receive this error when you repeat the
command on a system, investigate why
the script cannot access the database to
perform the following tasks:
l unprotect table qw_wru_en

l drop table qw_wru_en

4. Check the IC_INSTALL_DIR/IC73/etc/wru_sql/fulcrum.err file for errors.


If the file is not present or is empty, the set up command executed correctly. Some
messages that you might see in the error file do not indicate a problem. For more
information, see Full text search configuration error messages on page 474.
5. Verify that the command did not create a file with a DIL extension in the
IC_INSTALL_DIR/IC73/etc/wru_sql/ directory.
If such a file exists, check the contents for errors. If it contains errors, check the contents of
fulcrum_odbctrace.out to see what went wrong. If there were problems with the
database connection, confirm that the entries in the odbc.ini file are correct and that you
invoked fulcrum_setup.sh with a valid username and password.
6. Verify that the wru_createview.sql script contains the correct values for username,
password, and database name for the DB2 database.
The Configuration Tool substitutes these values when you configure the Website Web
application. Incorrect values in this file typically result from incorrect values entered in the
Configuration Tool. If the file includes errors, re-configure the Website. For more
information, see Configuring Web Management services on page 201.
7. If necessary, after you correct all errors, re-run the fulcrum_setup.sh command.

Installation and Configuration March 2012 243


Chapter 8: Configuring Web Management

Updating full text indices on IBM AIX


If you host your customer Web site and WebACD server on different systems, or if your IC
configuration includes multiple Websites, you must update the full text indices on those
systems. The update ensures that the indices on these systems include all documents that you
have added to the index.
You can run the update command as needed or schedule them to run at regular intervals. If you
schedule an update to run at regular intervals, do not run the update more frequently than once
per hour.
You must run this update command on every system that hosts one or more of the following:
l Customer-facing Website
l WebACD server

! Important:
Important: Do not run this update command on the system that hosts the Administrative
Website. That system automatically updates its own index.
To update the full text indices:
1. Navigate to the following directory: IC_INSTALL_DIR/IC73/etc/wru_sql
2. Run the following update command:
./fulcrum_updatendx.sh
3. Check the IC_INSTALL_DIR/IC73/etc/wru_sql/fulcrum_updatendx.err file for
errors.
If the file is empty, the set up command executed correctly. All messages in this file
indicate errors. Correct these errors as indicated in the message and as required by the
database, then re-run the set up command.
4. Verify that:
l The odbc.ini file lists the IP address of the DB2 system not the hostname.
l Each IP address listed in /etc/hosts has only one entry.
5. Restart the IC Website service, as described in Starting and stopping services on AIX on
page 142.
After you update the full text indices, you must restart the IC Website service to ensure that
the drivers for the fulcrum search are loaded.

244 Installation and Configuration March 2012


Configuring Web Scheduled Callback

Configuring Web Scheduled Callback


Web Scheduled Callback uses the components of the IC chat channel to route and report on
Website customer requests for an agent callback.

Tip:
Tip: If you want an agent to handle Web Scheduled Callback contacts, you must
configure the agent to handle voice and chat contacts.
To configure Web Scheduled Callback:
1. Cautions and tips for configuring Web Scheduled Callback on page 245
2. Creating a Web Scheduled Callback server on page 246
3. Configuring the Website for Web Scheduled Callback on page 247
4. Configuring Agents for Web Schedule Callback on page 248

Cautions and tips for configuring Web Scheduled Callback


This section includes some important cautions and tips that you need to consider when you
install the software for Avaya Agent Web Client on the server.
This section includes the following topics:
l Supported agent desktop applications on page 245
l Time zone requirements for Web Scheduled Callback on page 246
l Calendar requirements for Web Scheduled Callback on page 246

Supported agent desktop applications


Avaya Agent is the only agent desktop application that supports Web Scheduled Callback. If an
IC system includes Web Scheduled Callback, that system cannot include agents who work in
Avaya Agent Web Client or a custom application developed with the Client SDK.

Installation and Configuration March 2012 245


Chapter 8: Configuring Web Management

Time zone requirements for Web Scheduled Callback


Web Scheduled Callback is a time-bound feature. For Web Scheduled Callback to work
correctly, all IC servers and the database must be in the same time zone.

! Important:
Important: If the time on the systems that host IC servers and the database is not
synchronized, a time lag may occur between the scheduled time for the callback
and the exact time that a Web Scheduled Callback request is delivered to an
agent.

Calendar requirements for Web Scheduled Callback


Web Scheduled Callback requires the Gregorian calendar. Web Scheduled Callback does not
work with any other calendar. For example, Web Scheduled Callback does not support the Thai
B. E. (Buddhist Era) calendar or date format.

Creating a Web Scheduled Callback server


The Web Scheduled Callback server retrieves the scheduled call from the database and
delivers the call to the agent as a Chat&Callback task.
To create a Web Scheduled Callback server:
1. In IC Manager, select Server > New.
2. From the list of servers, select WSCallback and click Ok.
3. On the General tab enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

Name WSCallback_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the server For example, select Website
from the drop-down list. from the drop-down list.
Host Enter or select the IP address from When you select the host, IC
the drop-down list. Manager fills in the
corresponding Directory, Port,
and Executable.

246 Installation and Configuration March 2012


Configuring Web Scheduled Callback

4. Click the WSCallback tab and enter the information for the fields mentioned in the
following table:

Field Recommended entry Notes

ICM Server Enter the name of the computer The Web Scheduled Callback
Name where the ICM server is installed. contacts are sent to the ICM
server that you specify here.
Call timeout Enter the number of seconds after Default is 120.
interval (sec) which the time out occurs if the
request is not routed to an agent.
IC Login Enter the IC Login username. Default is dcobridge1
IC Password Click the Ellipsis (…) and specify
the password for the IC Login.

5. Click Ok.

Configuring the Website for Web Scheduled Callback


You can configure the working hours of a contact center with the tenant properties for a
Website. The default values for these properties assume that the contact center opens at 09:00
and closes 18:00.
To configure the Website for Web Scheduled Callback
1. In IC Manager, select Services > MultiTenancy Administration.
2. In the Tenant Admin menu, select Tenant Properties.
3. From the Select a Tenant drop-down list select the tenant you want to customize.
4. Click Customize Tenant.
5. On the Customize Tenant page, select the language properties you want to set from the
Select Language drop-down list at the top of the page.
6. Click the Callback link.
7. Update the properties mentioned in the following table, and then click Update Data.

Property Default value Notes

callback.checkcallbacktime TRUE When set to TRUE, enables Web


Scheduled Callback.

Installation and Configuration March 2012 247


Chapter 8: Configuring Web Management

Property Default value Notes

callback.contactcenteropentime 09:00 Use a 24-hour clock and xx:xx


format only.
callback.contactcenterclosetime 18:00 Use a 24-hour clock and xx:xx
format only.

Configuring Agents for Web Schedule Callback


Agents can receive the Web Schedule Callback only if the chat and voice channels are enabled
for them.
To configure the agents for Web Schedule Callback:
1. Create a new Workgroup:
a. In IC Manager, select Tools > Groups.
b. The Group Manager window opens.
c. In the left pane, right-click the DefaultTenant and select New Workgroup.
d. In the Create New Workgroup window, enter the value for Workgroup Name and the
Description.
e. Click Ok.
f. Add all the agents who are handling the Web Schedule Callback requests to this
workgroup.
g. Click Ok.
2. Create a new Queue:
a. In IC Manager, click the Device tab.
b. In the left pane, right-click Devices and select New Device.
c. In the list of devices, select Chat Queue.
d. In Device Editor, enter the value for the fields mentioned in the following table:

Field Value

QueueID Enter the queue ID for the queue.


For example, ScheduledCallbackQueue.
Name Enter the name for the queue. You can enter the queue ID
as queue name.
Priority Enter the queue priority value as 1.

248 Installation and Configuration March 2012


Configuring Web Scheduled Callback

Field Value

Minimum Agents Enter the minimum number of agents as 1.


Workgroup Enter the queue membership. Click the Ellipses (...) button
next to the field and add the workgroup that you have
created in the first step to be a member of this queue.
Tenant The value for this field is automatically selected based on
the workgroup that you select.

e. Click Ok.
In the right pane, the queue is added in the list of devices.
3. Create Routing Hints:
a. In IC Manager, click the Configuration tab.
b. In the left pane, select Tables > WorkFlow > RoutingHint.
c. On the toolbar, click the New button.
d. Add the following two routing hints.
Note:
Note: Add routing hints for all the languages that your call center supports by using the
standard language conventions as Routing Hint names.

Routing Hint Chat Queue ID Tenant

en Enter the chat queue ID that you have created in Select the Tenant for the
the step 2. queue ID that you
For example, select.
ScheduledCallbackQueue@DefaultTenant.
pvchat Enter the chat queue ID that you have created in Select the Tenant for the
the step 2. queue ID that you
For example, select.
ScheduledCallbackQueue@DefaultTenant.

4. Build and upload the routing hints to the workflow.


a. In IC Manager, click the Servers tab.
b. In the right pane, select the WorkFlow server from the list of servers.
c. Click the WorkFlow tab.
d. Click the Run Flow button.
e. Keep the default value for flow name.
f. Click Ok.

Installation and Configuration March 2012 249


Chapter 8: Configuring Web Management

g. Click Ok.

Configuring Voice Chat


Avaya Interaction Center (Avaya IC) installations can include Voice Chat. Voice Chat is a
component of Web Management that includes the following features:
l Chat and VoIP where a voice chat contact is initiated from a chat session. The customer
uses VoIP, and the agent uses a telephone.
l Chat and Phone where a voice chat contact is initiated from a chat session. The customer
and the agent use a telephone.
VoIP Chat feature is incorporated in the HTML Chat client. This feature enables customer and
agent to communicate using a VoIP call during an HTML chat session.
To set up both types of VoIP Chat, perform the steps in the following topics:
1. Prerequisites for Voice Chat on page 250
2. Configure the Workflow server for Voice Chat on page 255
3. Build and load workflows for Voice Chat on page 257
4. Configure the Telephony server for Voice Chat on page 259
5. Configure the Voice Chat gateway on page 259
6. Configure the Voice Media Manager server on page 261
7. Configure the Voice Chat workflow table on page 262
8. Set the startup options for the VMM server on page 262
9. Configuring IC System for Voice Chat on page 263

Prerequisites for Voice Chat


Before you configure Voice Chat:
1. Install and configure the Telephony switch and other hardware, including the following:
l Install and configure a supported IP Gateway
l Create a separate route point (VDN) for Voice Chat
l Direct all calls on the Voice Chat route point (VDN) over the CTI link using the Adjunct
Route
For information about supported Telephony switches, see VoIP Configuration on
page 251. For information about your Telephony switch, see the switch documentation.

250 Installation and Configuration March 2012


Configuring Voice Chat

2. Install and configure Telephony, including an ACD. For more information, see Avaya IC
Installation and Configuration guide.
3. Install and configure Web Management. For more information, see Avaya IC Installation
and Configuration guide.
4. Confirm that the Avaya Voice Media Manager (VMM) is installed and running. The Voice
Media Manager does not run in IC Manager. On a Windows system, you can view and
start the Voice Media Manager in the Services Control Panel.
Avaya IC installs the VMM with the Avaya IC servers.

VoIP Configuration
This section explains how to configure the Avaya DEFINITY/Communication Manager switch to
enable the Voice channel to handle VoIP calls. This section contains the following
configurations:
l Define IP Codec Set on page 251
l Assign node name on page 252
l Define the IP interface on page 252
l Assign a link to the C-LAN on page 253
l Create an IP signaling group on page 253
l Create IP trunk group on page 254
l Define the class of restriction on page 254
l Create vector for route point (VDN) on page 254

Define IP Codec Set


To define the Codec Set
1. Run change ip-codec-set 1 on the command line.
The change ip codec set 1 form opens.
2. Type G.723-5.3K in the Audio Codec field.
3. Type Y in the Silence Suppression field.
4. Type 1 in the Frames Per Pkt field.
5. Type 30 in the Packet Size (ms) field.
6. Press F3 to submit this form.

Installation and Configuration March 2012 251


Chapter 8: Configuring Web Management

Assign node name


You need to add a node name for the C-LAN, TN2302 Medpro board and VMM server.
To assign the node name
1. Run change node-names ip on the command line.
The node names ip form opens.
2. Type the unique name for each C-LAN and for each TN2302 Medpro board in the Name
field.
Note:
Note: If you use CrossFire board TN2602, you may get an error message as IP Codec
mismatched. The Communication Manager must have at least one TN2302
Medpro board to work with Voice chat, as the VMM service requires the G.723-5.3
IP codec.
3. Type the unique IP address for each of the corresponding C-LAN and TN2302 Medpro
board in the IP Address field.
4. For the VMM Server, type the hostname in the Name field and IP address in the IP
Address field.
5. Press F3 to submit this form.

Define the IP interface


To define the IP interface for CLAN
1. Run change ip-interface <board location> on the command line.
The IP interface form opens.
2. Type y in the Enable Ethernet Port field.
3. Type the node name that you created for the C-LAN circuit pack in Assign node name on
page 252 in the Node Name field.
4. Type the IP address of the gateway for the ip interface for the C-LAN circuit pack in the
Gateway Address field.
5. Type 1 in the Network Region field for the C-LAN circuit pack.
6. Press F3 to submit this form.
To define the IP interface for Medpro
1. Run change ip-interface <board location> on the command line.
The IP interface form opens.
2. Type y in the Enable Ethernet Port field.
3. Type the node name that you created for the TN2302 Medpro board in Assign node
name on page 252 in the Node Name field.

252 Installation and Configuration March 2012


Configuring Voice Chat

4. Type the IP address of the gateway for the ip interface for the TN2302 Medpro board in the
Gateway Address field.
5. Type 1 in the Network Region field for the TN2302 Medpro board.
6. Press F3 to submit this form.

Assign a link to the C-LAN


You must assign a link to the C-LAN using the ethernet data module.
To assign a link to the LAN using the ethernet data module
1. Run add data-module next on the command line to open the data module form.
2. Type Ethernet in the Type field.
3. Type the port number to be used by the C-LAN circuit pack in the Port field. Ethernet
connections must be assigned to port 17 on the C-LAN circuit pack.
4. Type the link number to assign to the circuit pack in the Link field.
5. Press F3 to submit this form.

Create an IP signaling group


To create a signaling group:
1. Run add signaling-group next on the command line to open the signaling group
form for the next available signaling group.
2. Type h.323 in the Group Type field.
3. Leave the Trunk Group for Channel Selection field blank until you create a trunk group
in the next task. Once you have created the trunk group, run change signaling group
at the command line and enter the trunk group number in the Trunk Group for Channel
Selection field.
4. Type the node name that you created for the C-LAN IP interface in Assign node name on
page 252 in the Near-end Node Name field.
5. Type the port number 1720 for the C-LAN IP interface in the Near-end Listen Port field.
6. Enter the node name of the VMM server you created in Assign node name on page 252 in
the Far-end node name field and the port created in IC Manager for VMM (default 8120)
in Far-end Listen Port field.
7. Press F3 to submit this form.

Installation and Configuration March 2012 253


Chapter 8: Configuring Web Management

Create IP trunk group


To create a trunk group:
1. Run add trunk-group next on the command line.
The trunk group form opens.
2. Type isdn in the Group Type field.
3. Type IP Trunk in the Group Name field.
4. Type the trunk access code in the TAC field.
5. Type H.323 in the Carrier Medium field.
6. Type tie in the Service Type field.
7. Type auto in the Member Assignment Method field.
8. Enter the number of the signaling group from the previous task, Create an IP signaling
group on page 253 in the Signaling Group field.
9. Enter number of members in the Number of Members field for this trunk.
10. Press F3 to submit this form.

Define the class of restriction


To define the class of restriction 1:
1. Run change cor 1 at the command line to open the cor 1 form which is used by all trunk
groups.
2. Enter 0 (zero) in the FRL field.
3. Enter none in the Calling Party Restriction field.
4. Enter none in the Called Party Restriction field.
5. Press F3 to submit this form.

Create vector for route point (VDN)


To create vector for route point:
1. Run change vector <vector number> at the command line to open the CALL
VECTOR form.
The vector number is the number that you have mentioned in the VDN.
2. Create a vector layout as follows:

wait-time 2 secs hearing ringback


adjunct routing link 5
wait-time 5 secs hearing ringback
stop

254 Installation and Configuration March 2012


Configuring Voice Chat

3. Press F3 to submit this form.

Configure the Workflow server for Voice Chat


To configure the Workflow server for Voice Chat, perform the steps in the following topics:
1. Add a semaphore for the Voice Chat workflow on page 255
2. Create the Voice Chat channel for the Workflow server on page 255
3. Restart the Workflow server on page 257
Note:
Note: This section assumes that you are using an existing Workflow server to handle
Voice Chat contacts. If the Avaya IC system includes a separate Workflow server
for Voice Chat, see IC Avaya IC Installation and Configuration guide.

Add a semaphore for the Voice Chat workflow


You must add a semaphore to all Workflow servers that process voice chat contacts and are in
the Web and Website domain. The Attribute server uses the ICM account to log in to the ICM
server. You entered this account in the IC Login field of the Attribute server configuration. For
more information about the icmbridge account, see Avaya IC Installation and Configuration.
To add the semaphore for the Voice Chat workflow:
1. In IC Manager, double-click the Workflow server.
2. Click the Workflow tab.
3. Click the Ellipsis (...) button next to Semaphores.
4. In the Semaphores dialog box:
a. Click New.
b. Click in the new row and type:
ivchat.ivchat_key
c. Click OK.
5. Click OK.

Create the Voice Chat channel for the Workflow server


If your Avaya IC system includes multiple Workflow servers, perform these steps on the
Workflow server that processes voice contacts.
To create the voice chat channel for the Workflow server:
1. In IC Manager, double-click the Workflow server that processes voice contacts.

Installation and Configuration March 2012 255


Chapter 8: Configuring Web Management

2. Click the Channels tab.


3. Select New Channel.
4. In the Channel Editor dialog box, complete the fields as shown in the following table and
select OK.

Field Recommended entry Notes

Global Do not select this field. Do not select this field to


create a channel for a specific
server or media, such as Voice
Chat.
By Server l Do not select this field if If you select this field, and you
you want this channel to need this Workflow server to
handle events from all communicate with more than
servers of the type that one server, you must create
you select from the another channel for that
Service drop-down list. server.
l Select this field if you want Warning: If you check this
this channel to handle field and the Telephony server
events from only one is named "TS", the Workflow
specific server that you server will not be able to
select from the Service communicate with the
drop-down list. Telephony server.

Channel Range No entry necessary. Completed by IC Manager.


Service Select TS or a specific Whether you can select a
Telephony server from the server or a type of server,
drop-down list. depends up whether or not
you checked the By Server
field.
Criteria Type: The VDN that you have
*r<VDN_for_Voice_Chat> created as mentioned in the
Prerequisites for Voice
Chat on page 250.
For example, type:
*r57001

5. Select the channel that you created in the step above.


6. Select New Association.
7. In the Channel Association dialog box, complete the fields as shown in the following
table and select OK.

Field Recommended entry

Channel Range Completed by IC Manager.


Service Interface Completed by IC Manager.

256 Installation and Configuration March 2012


Configuring Voice Chat

Field Recommended entry

Event TS.IncomingCall
Note:
Note: This field is case-sensitive.
Flow <project_name>.<flow_name>
For example, type ts.incoming_ivchat

Restart the Workflow server


To restart the Workflow server
1. In IC Manager, select the Workflow server that handles voice contacts.
2. Right-click the Workflow server and select Stop.
3. After the Alarm Monitor at the bottom of IC Manager displays a message confirming that
the Workflow server has stopped:
a. Select the Workflow server.
b. Right-click the Workflow server.
c. Select Start.

Build and load workflows for Voice Chat


Voice Chat uses the following sample workflows:
l Incoming Voice Chat workflow in the TS project
l Voice Chat workflow in the ivchat project
l Telephony workflows, see Avaya IC Installation and Configuration
The Avaya IC seed data does not include a compiled sample Voice Chat or a compiled sample
Incoming Voice Chat workflow. You must build and load these workflows.

Installation and Configuration March 2012 257


Chapter 8: Configuring Web Management

! CAUTION:
CAUTION: By default, the Qualify Chat workflow assumes that you will create a WebVoice
workgroup that includes agents who are configured to receive contacts from the
voice and chat channels. If you do not intend to create this workgroup, you must
customize the IVChatWorkgroup and PVChatWorkgroup properties in the Set
Route Parameter blocks. The value of these properties must be the name of a
valid workgroup. The workgroup must include agents who can handle contacts
from the voice and chat channels. If you change these blocks, you must build and
load the Qualify Chat workflow.
For more information about voice chat workflows and Workflow Designer, see Avaya Workflow
Designer User Guide.
To load the Voice Chat workflows, complete the steps in the following topics:
1. Build the Incoming Voice Chat workflow on page 258
2. Build the Voice Chat workflow on page 259

Build the Incoming Voice Chat workflow


To build the Incoming Voice Chat workflow:
1. In Workflow Designer, select File > Open Project and open the TS project.
You can find the TS project in the following directory:
IC_INSTALL_DIR\IC73\design\IC\Flows\Avaya\TS\TS.prj
2. Double-click incomingivchat.qfd in the Project pane.
3. Select Project > Settings.
4. Select the Database tab and type the following values:
l Interaction Center Data Source name in the IC Data Source field.
l Valid Avaya IC Administrator account in the Login ID field.
The default account is Admin.
l Password for the account in the Password field.
5. Click OK.
6. Select Build > Build Flowset.
Workflow Designer verifies and compiles the flows. All error messages, including the block
name, script name, and offending line, are displayed in the Output bar.
7. Select File > Exit to exit Workflow Designer.

258 Installation and Configuration March 2012


Configuring Voice Chat

Build the Voice Chat workflow


To build the voice chat workflow:
1. In Workflow Designer, open the Voice Chat workflow located in the following directory:
IC_INSTALL_DIR\IC73\design\IC\flows\Avaya\ivchat\ivchat.qfd
2. Select Project > Settings.
3. Select the Database tab and type the following values:
l Interaction Center Data Source name in the IC Data Source field.
l Valid Avaya IC Administrator account in the Login ID field.
l Password for the account in the Password field.
4. Click OK.
5. Select Build > Build Flowset.
Workflow Designer verifies and compiles the flows. All error messages, including the block
name, script name, and offending line, are displayed in the Output bar.

Configure the Telephony server for Voice Chat


You must configure the Telephony server to ensure that the agent is not placed in a Busy state
and can receive a voice chat contact.
To configure the Telephony server for Voice Chat:
1. In IC Manager, double-click the Telephony server.
2. Click the TS tab.
3. Right-click in the background and select the check box adjacent to Show Advanced
Properties.
4. Select the Dial By Equipment check box.
You might need to scroll down to see the Dial By Equipment check box.
5. Click OK.

Configure the Voice Chat gateway


You must configure one Voice Chat gateway for each CLAN card. Repeat the following steps for
each gateway.
To configure the Voice Chat gateway:
1. In IC Manager, click the Configuration tab.

Installation and Configuration March 2012 259


Chapter 8: Configuring Web Management

2. From the Tables list in left pane, select Voice Chat > IPGateway.
3. Click New.
4. In the right pane, enter the value for the fields mentioned in the following table:

Field Recommended entry Description

Name Type a unique name for the For example, type the node name
gateway. of the CLAN card.
IP Address Type the IP Address of the
CLAN card.
Port Type the near end listening
port of the CLAN card.
Default: 1720
ACD Name Select the name of the ACD Select the same ACD that you
from the drop-down list. configured for the Telephony
server.
Site Select the site from the For example, select
drop-down list. DefaultSite.
RoutePoint Type the VDN that you set
up in the switch to receive
voice chat calls.
Capacity Type the number of calls Check your switch documentation
which this gateway can for more information.
handle.
Active Select this check box if you Gateways should always be active
want voice chat to be able unless there is a problem with the
to use the gateway. gateway, or you must perform
maintenance on the system.
If there is a problem with a gateway,
clear this check box immediately to
ensure the gateway cannot be used
for subsequent calls.
Before you bring the system that
hosts the gateway down for
maintenance, make the gateway
inactive so that it will not be used
for subsequent calls. You can bring
the system down as soon as there
are no more calls on the gateway.

5. Click OK.

260 Installation and Configuration March 2012


Configuring Voice Chat

Configure the Voice Media Manager server


Avaya IC installs the Voice Media Manager (VMM) server when you install Avaya IC servers on
a system. You can configure and run more than one VMM server in an Avaya IC system.
Avaya IC uses a round robin algorithm to select a VMM server from an available list of VMMs to
handle a voice chat.
To configure the VMM Server:
1. In IC Manager, click the Configuration tab.
2. From the Tables list in left pane, select Voice Chat > VMM.
3. Click New.
4. In the right pane, enter the value for the fields mentioned in the following table:

Field Recommended entry Description

Name Type the name of the For example, if host the VMM server on
system that hosts the VMM testbox.xyzcorp.com, type "testbox" as
server. the name of that VMM server.
IP Address Type the IP Address of the
system that hosts the VMM
server.
Port Default 8120.
Site Select the site from the For example, select DefaultSite.
drop-down list.
Active Select this check box. A VMM server should always be active
unless there is a problem with the VMM
server, or you must perform maintenance
on the system.
If there is a problem with a VMM server,
clear this check box immediately to
ensure the VMM server cannot be used
for subsequent calls.
Before you bring the system that hosts the
VMM server down for maintenance, make
the VMM server inactive so that it will not
be used for subsequent calls. You can
bring the system down as soon as there
are no more calls on the VMM server.

5. Click OK.

Installation and Configuration March 2012 261


Chapter 8: Configuring Web Management

Configure the Voice Chat workflow table


To configure the Voice Chat workflow table:
1. In IC Manager, click the Configuration tab.
2. From the Tables list in left pane, select Workflow > VoiceChat.
3. Click New.
4. In the right pane, enter the value for the fields mentioned in the following table:

Parameter Recommended entry Description

Name Type the name of the IV For example, type ivchat.


chat workflow.
Timeout (sec) Type the number of This entry represents how many
seconds that the workflow seconds a gateway should have to
should wait before it times respond to a MakeCall request.
out.

5. Click OK.

Set the startup options for the VMM server


The VMM setup script configures the VMM to start automatically.
If you host your Avaya IC servers on Solaris, you must run the VMM setup script to start and
configure the Voice Media Manager (VMM) for Voice Chat.

! Important:
Important: You must perform this step only if you host your Avaya IC servers on Solaris.
You must set the VMM server to autostart, as described in the following topics:
l Set the startup options for the VMM server on Windows on page 262
l Set the startup options for the VMM server on Solaris on page 263

Set the startup options for the VMM server on Windows


To set startup options for the VMM server on Windows:
1. In the Services control panel, right-click the Avaya Voice Media Manager and select
Properties.
2. Select Automatic from the Startup Type drop-down list.

262 Installation and Configuration March 2012


Configuring Voice Chat

3. Click OK.

Set the startup options for the VMM server on Solaris


To configure the VMM server to start automatically on Solaris:
1. Navigate to the following directory:
IC_INSTALL_DIR/IC73/bin
2. At the command line, type:
./vmm_setup start
3. Press Enter.
To stop the VMM server on Solaris:
1. Navigate to the following directory:
IC_INSTALL_DIR/IC73/bin
2. At the command line, type:
./vmm_setup stop
3. Press Enter.

Configuring IC System for Voice Chat


To enable the VoIP feature to function properly, you need to configure your IC system. Before
performing the steps given below, you need to carry out all of the installation instructions
described in Configuring Voice Chat on page 250.
Note:
Note: VoIP Chat is supported on Windows and Solaris only.

Configuring IIS server for Windows 2008 R2 server


Perform the following steps on the system where the ICM server is installed:
Note:
Note: By default, security settings on Windows 2008 R2 Server allow access only to
files with certain predefined extensions, such as .html, .xml, .jpg, and so on. To
allow client applications to download .ini files, you need to configure your system
using the IIS Manager as given below.
1. Stop the Tomcat server, the ICM server, and Website, if already running.

Installation and Configuration March 2012 263


Chapter 8: Configuring Web Management

2. Delete all the files and subdirectories in the following directory:


.../IC73/tomcat/work/Catalina/localhost/website/org/apache/jsp/
public_
Sometimes, no files or directories are present in the public_ directory. In such a
scenario, proceed to the next step.
3. Start the IIS Admin tool by following the steps given below:
a. Open the IIS manager
b. Select the website which hosts the IC website (e.g., default Web Site).
c. On the home page, double-click on Mime Types section
d. Click Add in the Actions pane.
e. In the MIME Type dialog box,
l Type .ini in the Associated extension text box.
l Type Text/Plain in the Content type (MIME) text box.
f. Click OK in the MIME Type dialog box.
g. Click OK.
h. Click Apply and then click OK.
4. Start the Tomcat server, the ICM server, and Website.

Configuring IIS server for Windows 2008 R2 server


To configure IIS7.x in Windows 2008 R2 server, invoke Server manager -> Roles -> Web Server
(IIS) -> Internet Information Services (IIS) Manager.
To add a plugin to IIS7.x using the IIS manager:
1. Allow the plugin to run on the server:
a. Click on the server node, and double-click ISAPI and CGI restrictions node on the
home page.
b. Click Add in the Actions pane.
c. Add the full path to the plugin, and enter a description for the same.
d. Select Allow extension path to execute option.
2. Add the plugin as an ISAPI filter on the website:
a. Click on the website where Avaya IC website is deployed (e.g., Default Web Site).
b. In the home page of the website, double-click on the ISAPI filters node.

264 Installation and Configuration March 2012


Configuring IIS server for Windows 2008 R2 server

c. Click Add in the Actions pane.


d. Give a name to the filter, and add the complete path to the plugin. This path is the
same as that entered in the previous step (Allowing plugin to run on the server).
3. Add Handler Mapping for the plugin on the website:
a. Click on the website where Avaya IC website is deployed (for example, Default Web
Site).
b. In the home page of the website, double-click on the Handler Mappings node.
c. Click Add Script Map in the Actions pane.
d. In the Request path text box, enter the file name of the plugin (for example,
isapi_redirect.dll).
e. Enter the complete path in the Executable text box. This is the same as the path given
in the previous 2d step.
f. Give a name for the script mapping.
g. Click Request Restrictions.
1. In the Mapping tab, select the invoke handler option.
2. Select the File or folder option.
3. In the Verbs tab, select the All verbs option.
4. In the Access tab, select the Script option.
4. Add read permissions to the folder where the plugin is installed:
a. The website runs under a certain Application Pool in IIS. The identity which the
Application Pool runs requires that it have read permission to all folders where plugins
defined for the website are installed. Unless this is done, the website may not get
access to the plugins and they may fail to load.
b. To determine the application pool under which the website runs, click on the website,
and select Advanced Settings in the Actions panel. The Application Pool used for the
website can be read/set from the dialog thus shown. Take a note of the application
pool used.
c. To determine the Identity used by the application pool, click on the Application Pool
node. Select the application pool noted in the previous step, and select Advanced
Settings from the Action panel. The Identity of the Application Pool can be read/set
using this dialog box. The value in the "Identity" property can either be an account
name (for example, LocalService, NetworkService, and so on) or can be set as
"ApplicationPoolIdentity". In case it is an account name, then the specified account
needs to have read access to the folder(s) where the plugin(s) are installed. In case
the Identity is set as "ApplicationPoolIdentity", then the account "IIS AppPool\
<application pool name>" is used; where <application pool name> is the name of the
application pool (e.g., DefaultAppPool). Whenever an application pool is created, a
user with the given format is created, and is used as the default identity for the pool.
These users are not visible under Local Users of the computer.

Installation and Configuration March 2012 265


Chapter 8: Configuring Web Management

d. Once the Application pool identity account is determined, allow read permissions to
this account on the folder(s) where the plugin(s) are installed.
5. Add read/write permissions to folders where plugins write logs:
a. Some plugins may write logs, and the application pool identity account should have
read/write access to these folders. If this is not the case, then the plugins may not be
able to write logs for troubleshooting.
b. Once the Application pool identity account is determined (see previous step), allow
read/write permissions to this account on the folder(s) where the plugin(s) writes logs.
6. Enabling 32-bit applications for the Application pool:
a. As IC plugins are 32 bit applications, the Application Pool under which the website
runs must be setup to run 32-bit applications, else the plugin(s) will not load, and an
error will be displayed in the browser when navigating the website.
b. Click on the Application Pools node. Select the application pool which services the
website which hosts the IC website (e.g., DefaultAppPool). Click on "Advanced
settings" in the Actions pane. This will bring up a dialog box. In the General section,
set the "Enable 32-bit Applications" property to true. Click OK.
Note:
Note: In the above steps, it is easier to manage the system if the same name/
description is given when creating the ISAPI/CGI restrictions rule, creating the
ISAPI filter, and creating the Handler Mappings.

Configuring Website for Voice Chat


1. Launch the Web browser and navigate to the Website Admin Pages.
2. Navigate to the IC Website Multi-tenant Administration page and select Tenant
Properties.
3. Click Customize.
4. Select Chat Properties.
5. Modify the following chat properties:
VoIP Chat requires the size of the command frame to be changed to 120 so that the VoIP
applet can be placed in the command frame
l Change the chat.htmlclient.command.framesize property value from the default
size of 55 to 120. This modification is required to fit the VoIP chat applet in the
command frame.
l Change the chat.phrases.IccCommon.launchvoip property value to Agent has
initiated Voice Chat....
6. Click Update Data to save the changes.

266 Installation and Configuration March 2012


Configuring SSL security for Web servers (optional)

Configuring SSL security for Web servers (optional)


You can configure Web Management and Email Management to work with Secure Sockets
Layer (SSL) to provide secure Internet sessions. SSL is optional.
SSL connections require additional work for the Web servers, because they encrypt and decrypt
all communications. Therefore, if your system includes SSL, install an ICM server on a system
dedicated to text conference. If desired, this ICM server can be a second ICM server. To install
an additional ICM server, see Deploying multiple ICM servers (optional) on page 275.
If all tenants will be using SSL, you can host all Web Management servers on one system, but
should still host the ICM server on a dedicated system.
To configure SSL, perform the steps in the following topics:
1. Prerequisites for configuring SSL on page 267.
2. Modifying the Website configuration on page 268.
3. Configuring the WebACD server on page 268.
4. Editing the configuration file on page 269.
5. Modifying the SSL properties on page 269.
6. Configuring SSL for specific tenants on page 270.
7. Modifying tenant properties for SSL on page 270.

Prerequisites for configuring SSL


Before you configure Web Management or Email Management to use SSL, you must complete
the following steps:
l Install and properly configure SSL. This step requires you to:
a. Generate SSL authentication keys and a certificate request.
b. Submit the certificate request to a certifying authority such as VeriSign, Thawte, or
GTE CyberTrust.
c. Import the signed certificate and configure the Web server to use the signed certificate
returned by the certifying authority.
l If your Avaya IC system includes a second Web Management server for SSL, configure
SSL on the secure server and the system that hosts the ComHub server.
l Install, configure, and test one of the following on the secure server system:
- A full set of Web Management servers or Email Management servers
- An additional ICM server

Installation and Configuration March 2012 267


Chapter 8: Configuring Web Management

Modifying the Website configuration


You must modify the configuration of the website to use SSL values.
To modify the website configuration:
1. In IC Manager, select the Configuration tab.
2. From the Tables list in left pane, select Website > Website Context Configuration.
3. In the right pane, select the entry for the website and select Edit.
4. Update the values as shown in the following table:

Property Recommended entry

Default internet protocol Select https from the drop-down list


Default port for context Type 443.

5. Click Ok.
6. Select Manager > Refresh.

Configuring the WebACD server


To configure the WebACD server:
1. In IC Manager, double-click the WebACD server in the lists of servers.
2. Click the WACD tab.
3. In the WACD Webserver field, update the values as shown in the following table:

Property Recommended entry

Default port for context Type 443.


Default internet protocol Select https from the drop-down list

4. Click OK.

268 Installation and Configuration March 2012


Configuring SSL security for Web servers (optional)

Editing the configuration file


To edit the configuration file:
1. In Notepad or another text editor, open webadmin.cfg.
2. Change the value of the attribute serverPort to 443.
3. Add the new attribute-value pair shown in the following table:

Attribute Value

protocol https://

4. Save and close the file.

Modifying the SSL properties


To modify the SSL properties:
1. In IC Manager, select Tools > Groups.
2. Select the Properties tab.
3. Select IC in the left pane of the Group Manager.
4. Select System/Configuration in the Sections list.
5. Select the following properties.
6. Select Edit and set values for the properties, as shown in the following table:

Property Recommended entry

ChatLoginServerProtocol Type https.


ChatLoginServerPort Type 443.

7. Click Ok.

Installation and Configuration March 2012 269


Chapter 8: Configuring Web Management

Configuring SSL for specific tenants


The values that you set in the previous steps become the default values for all tenants. All
tenants are not configured for SSL by default. You can override this default behavior by setting
a tenant specific property.
To set the website.pages.public property:
1. In IC Manager, select Services > MultiTenancy Administration.
2. Select Tenant Properties in the Tenant Admin menu.
3. Select the tenant you want to customize from the Select a Tenant drop-down list.
4. Select Customize Tenant.
5. In the Customize Tenant page, select the language properties you want to set from the
Select Language drop-down list at the top of the page.
6. Select the website properties.
7. Change the website.pages.public property to an absolute URL with the protocol
specified as http for non SSL and https for SSL.
For example, type https://mysystem.company.com/website/public.
8. Select Update Data at the bottom of the page.

Modifying tenant properties for SSL


You must modify some tenant properties for SSL to function properly in your Website.

Tip:
Tip: This section describes the tenant properties that you typically need to modify.
Some properties may not be required for all IC systems.
To modify the tenant properties for SSL:
1. In IC Manager, select Services > MultiTenancy Administration.
2. Select Tenant Properties in the Tenant Admin menu.
3. Select the tenant you want to customize from the Select a Tenant drop-down list.
4. Select Customize Tenant.
5. In the Customize Tenant page, select the language properties you want to set from the
Select Language drop-down list at the top of the page.
6. If the customer Website uses SSL, do the following:
a. Click the wru link.

270 Installation and Configuration March 2012


Configuring SSL security for Web servers (optional)

b. Update the properties in the following table.


In the recommended entries, server is the fully-qualified domain name of the system
that hosts the customer Website.

Property Recommended entry

wru.stylesheets.display https://server/website/public/xsl/displayxsl
wru.stylesheets.displayparts https://server/website/public/xsl/displaypartsxsl
wru.stylesheets.grouping https://server/website/public/xsl/groupingxsl
wru.stylesheets.search https://server/website/public/xsl/search.xsl

c. Select Update Data.


7. If the administration Website uses SSL, do the following:
a. Scroll to the top of the page and click the wruadmin link.
b. Update the properties in the following table.
In the recommended entries, server is the fully-qualified domain name of the system
that hosts the administration Website.

Property Recommended entry

wruadmin.stylesheets. https://server/website/admin/wru/xsl/edit.xsl
approve
wruadmin.stylesheets. https://server/website/admin/wru/xsl/
approvelist approvelist.xsl
wruadmin.stylesheets. https://server/website/website/admin/wru/xsl/
display display.xsl
wruadmin.stylesheets. https://server/website/admin/wru/xsl/
displayparts displayparts.xsl
wruadmin.stylesheets.edit https://server/website/admin/wru/xsl/edit.xsl
wruadmin.stylesheets. https://server/website/admin/wru/xsl/
grouping grouping.xsl
wruadmin.stylesheets. https://server/website/admin/wru/xsl/search.xsl
search
wruadmin.stylesheets. https://server/website/admin/wru/xsl/edit.xsl
submit

c. Select Update Data.

Installation and Configuration March 2012 271


Chapter 8: Configuring Web Management

Setting up a separate administration Website (optional)


You can configure a web server to serve as an administration website only. The administration
Website will not contain any accessible external or customer-facing content, and the chat
functions will be disabled.
These instructions assume that you have already configured Web Management.
Note:
Note: If your IC system includes multiple Attribute servers, all Websites and ICM
servers must use the same Attribute server, so that their Tenant customization
properties remain synchronized.
To set up a separate administration website, complete the steps in the following topics:
1. Creating the Web application for the administration website on page 272.
2. Configuring an administration Website on page 272.
3. Integrating the administration Website on page 273.

Creating the Web application for the administration website


Create the Web application for the administration website, as described in Configuring Web
Management services on page 201.

Configuring an administration Website


Create a separate entry for the administration Website in IC Manager.
To configure the administration website
1. In IC Manager, click the Configuration tab.
2. From the Tables list in left pane, select Website > Website Context Configuration.
3. Click New.
4. Right-click in the right pane, and check the box next to Show Advanced Properties.

272 Installation and Configuration March 2012


Setting up a separate administration Website (optional)

5. Complete the fields in the right pane, as shown in the following table:

Field Recommended entry

Global Name Type a name for the website.


For example, type AdminWebsite.
Note: The Global Name is case-sensitive.
The Global Name must match the dsObject parameter
in the following file on the system that hosts the
administration Website: IC_INSTALL_DIR\IC73\
comp\website\WEB-INF\web.xml
Context Active Check this box.
Admin Pages Active Check this box.
Public Pages Active Do not check this box.

For more information about these fields, see Configuring the Website on page 231
6. Click Ok.
7. Select Manager > Refresh.
8. Restart the Tomcat server that hosts the Administration website.

Integrating the administration Website


To integrate the administration website:
1. In IC Manager, select Tools > Groups.
2. Select the Properties tab.
3. Select IC in the left pane of the Group Manager.
4. Select System/Configuration in the Sections list.
5. Select the following properties:
a. Select Edit.

Installation and Configuration March 2012 273


Chapter 8: Configuring Web Management

b. Set values for the properties, as shown in the following table:

Property Recommended entry

ChatLoginServer Type the fully-qualified domain name of the


system that hosts the administration website.
ChatLoginServerWebsite Type the servlet context name that you gave to
this website in Configuring an administration
Website on page 272.

Note:
Note: If the columns in the right pane are Name, Entity, Value, and Over-ridable, select
the - (minus) button on the toolbar to view and edit these properties.
6. Click Ok.

Setting up a separate customer Website (optional)


You can configure a web server to serve as a customer Website only. The customer Website will
not contain any accessible administration functions. These instructions assume that you have
already configured Web Management.
Note:
Note: If the IC system includes multiple Attribute servers, all Websites and ICM servers
must use the same Attribute server, so that their Tenant customization properties
remain synchronized.
To set up a separate customer Website, complete the steps in the following topics:
1. Creating the Web application for the customer Website on page 274.
2. Configuring the customer Website on page 274.

Creating the Web application for the customer Website


Create the Web application for the customer website, as described in Configuring Web
Management services on page 201.

Configuring the customer Website


Create a separate entry for the customer website in IC Manager.

274 Installation and Configuration March 2012


Deploying multiple ICM servers (optional)

To configure the customer Website:


1. In IC Manager, select the Configuration tab.
2. From the Tables list in left pane, select Website > Website Context Configuration.
3. Select New.
4. Right-click in the right pane, and check the box next to Show Advanced Properties.
5. Complete the fields in the right pane, as shown in the following table:

Field Recommended entry

Global Name Type a name for the Website, for example,


type CustomerWebsite.
Context Active Check this box.
Admin Pages Active Do not check this box.
Public Pages Active Check this box.

For more information about these fields, see Configuring the Website on page 231
6. Click Ok.
7. Select Manager > Refresh.
8. Restart the Tomcat server that hosts the customer website.

Deploying multiple ICM servers (optional)


The ICM server hosts the Web Management conferences between agents and customers. You
can deploy additional ICM servers, for one or both of the following reasons:
l To increase the capacity or load sharing of chat functionality.
l To use a secure server for chat escalations from one site but not another.

Tip:
Tip: The procedures in this section describe how to deploy one additional ICM server.
To deploy more than one additional ICM servers, follow these instructions for
each additional ICM server.
This section includes the following topics:
l Deployment guidelines for an additional ICM server on page 276.
l Before you configure an additional ICM server on page 276.

Installation and Configuration March 2012 275


Chapter 8: Configuring Web Management

l Configuring an additional ICM server with a CIRS server on page 277.


l Configuring an independent additional ICM server on page 280.
l Adding ICM servers to the ICM Bridge on page 281.

Deployment guidelines for an additional ICM server


The following guidelines describe the two ways that you can deploy an ICM server:

Deploying an additional ICM server with a CIRS server: With a CIRS server for load
balancing. In this configuration, user enter the Web site on the primary system and are
redirected to an ICM server on a different system based on the load. For more information, see
Configuring an additional ICM server with a CIRS server on page 277.

Deploying an additional ICM server without a CIRS server: Without a CIRS server. In this
configuration, each combination of ICM server and Web site is independent. For more
information, see Configuring an independent additional ICM server.

Tip:
Tip: If you’re setting up a secure ICM server, follow the instructions in the section
Configuring SSL security for Web servers (optional) on page 267, as well as the
instructions below.

Before you configure an additional ICM server


This section includes information that you need to know and steps you must perform before you
configure an additional ICM server.
This section includes the following topics:
l Location of an additional ICM server on page 276.
l Installing the ICM server software on page 277.
l Setting the startup options for the secondary ORB server on page 277.

Location of an additional ICM server


Deploy an additional ICM server on a dedicated system for scalability. Do not install the
additional ICM server on the system that hosts your database software.

276 Installation and Configuration March 2012


Deploying multiple ICM servers (optional)

Installing and configure prerequisites


Install and configure all prerequisites for a Website system, including a database client. For
more information, see Avaya IC Installation Planning and Prerequisites.

Installing the ICM server software


The software for the ICM server is included in the IC installer for IC servers. To install the ICM
server software, follow the instructions in Installing IC server and administration components on
page 28.

Setting the startup options for the secondary ORB server


If you do not plan to host other IC servers on the same system as the additional ICM server,
then the secondary ORB server does not need to be started. Set the startup options on the
secondary ORB server to Manual.
If the system also hosts an IC server, such as an Attribute server, the secondary ORB server
must be started. Set the startup options for the secondary ORB server to Automatic.
For more information on how to set the startup options, see Starting and stopping the ORB
server on page 134.

Configuring an additional ICM server with a CIRS server


To configure an additional ICM server to work with a CIRS server and the Web site, you must
designate one system that hosts an ICM server and Website combination as the primary ICM
server system.
Note:
Note: You must create a Web site on the secondary system, where you are configuring
another ICM server with the CIRS server.
After you determine which system will be the primary ICM server system, perform the steps in
the following topics:
1. Configuring the primary ICM server on page 278.
2. Configuring the additional ICM server on page 278.
3. Configuring the CIRS server on page 279.
4. Configuring the CIRS servlet for Website on page 280.
5. Adding ICM servers to the ICM Bridge on page 281.

Installation and Configuration March 2012 277


Chapter 8: Configuring Web Management

Configuring the primary ICM server


These instructions assume that you have already installed and configured the primary ICM
server and the CIRS server.
To configure the primary ICM server:
1. In IC Manager, select the Configuration tab.
2. From the Tables list in left pane, select Chat > ICM.
3. Select the ICM table with the same name as the dsObjectName in IC_INSTALL_DIR/
IC73/etc/SystemParms.txt
If the table does not exist, create a new table. For more information, see Configuring the
ICM server on page 228.
4. Update the fields in the right pane shown in the following table:

Property Recommended entry

Global ICM Name Type the value of dsObjectName.


ICM Server Name Type the fully-qualified domain name of the system
that hosts the primary ICM server.
CIRS Host Type the hostname of the system that hosts the
primary ICM server.
CIRS Port Type the port for the CIRS server.

For information on all other fields, see Configuring the ICM server on page 228.
5. Click Ok.
6. Restart the ICM server
7. Start the CIRS server.
8. Add the ICM server to the ICM Bridge. For more information, see Adding ICM servers to
the ICM Bridge on page 281.

Configuring the additional ICM server


To configure the additional ICM Server:
1. In IC Manager, select the Configuration tab.
2. From the Tables list in left pane, select Chat > ICM.
3. Select New.

278 Installation and Configuration March 2012


Deploying multiple ICM servers (optional)

4. Update the following fields in the right pane shown in the following table:

Property Recommended entry

Global ICM Name Type a name for the additional ICM server.
For example, type icm2.
ICM Server Name Type the fully-qualified domain name of the system
that hosts the additional ICM server.
CIRS Host Type the hostname of the system that hosts the
primary ICM server.
CIRS Port Type the port for the CIRS server.

For information on all other fields, see Configuring the ICM server on page 228.
5. Click Ok.
6. Restart the ICM server
7. Start the CIRS server.
8. Add the ICM server to the ICM Bridge. For more information, see Adding ICM servers to
the ICM Bridge on page 281.

Configuring the CIRS server


To configure the CIRS server:
1. In IC Manager, select the Configuration tab.
2. From the Tables list in left pane, select Chat > CIRS.
3. Select the CIRS table with the same name as the dsObjectName in IC_INSTALL_DIR/
IC73/etc/cirsParms.txt
If the table does not exist, create a new table. For more information, see Configuring the
Central Internet Routing service on page 230.
4. In the Global CIRS Name field in the right pane, type the value of dsObjectName in
IC_INSTALL_DIR/IC73/etc/cirsParms.txt
For information on all other fields, see Configuring the Central Internet Routing service on
page 230.
5. Select the CIRS Active check box.
This check box must be checked for the CIRS server to function.
6. Click OK.
7. Start the CIRS server.

Installation and Configuration March 2012 279


Chapter 8: Configuring Web Management

Configuring the CIRS servlet for Website


For more information about Website applications, see Configuring the Website on page 231.
To configure the CIRS servlet for website:
1. In IC Manager, select the Configuration tab.
2. From the Tables list in left pane, select Website > Website Context Configuration.
3. Create or update the websitecontext record for each Web Management application that
chat users must access.
a. On the toolbar, click to create a new record.
b. Right-click and select the Show Advanced Properties check box.
c. Complete the fields as shown in the following table:

Property Recommended entry

Global Name Type the value of dsObjectName in


IC_INSTALL_DIR/IC73/comp/website/
WEB-INF/web.xml.

For information on all other fields, see Configuring the Central Internet Routing service on
page 230.
4. Click Ok.
5. Restart each server that hosts a Website application.
6. Start the ICM server.

Configuring an independent additional ICM server


After you designate one system as the primary ICM server system, perform the steps in the
following topics:
1. Configuring an additional ICM server on page 280.
2. Adding ICM servers to the ICM Bridge on page 281.

Configuring an additional ICM server


To configure an independent additional ICM server:
1. In IC Manager, select the Configuration tab.
2. From the Tables list in left pane, select Chat > ICM.
3. Select New.

280 Installation and Configuration March 2012


Refreshing IC Manager

4. Type a name for the additional ICM server in the Global ICM Name field.
For information on all other fields, see Configuring the ICM server on page 228.
5. Click Ok.
6. Restart the ICM server
7. Add the ICM server to the ICM Bridge. For more information, see Adding ICM servers to
the ICM Bridge on page 281.

Adding ICM servers to the ICM Bridge


You add ICM servers to the ICM bridge in the Attribute server configuration. For more
information, see Creating the WebACD server on page 191.
To add an additional ICM server to the ICM Bridge:
1. In IC Manager, double-click the Attribute server in the list of servers.
2. Click the Attribute tab.
3. Click the Ellipsis (…) next to the ICM Servers field.
4. In the ICM Servers dialog box:
a. Click New.
b. Select Enabled.
c. In the Host field, type the name and domain of the system that hosts the ICM server.
For example, type TESTBOX.xyzcorp.com.
d. Accept the default port number (8103) or change to an available port.
e. Click Ok.
Repeat these steps for each ICM server in your Avaya IC system.
5. Click Ok.
6. Restart the Attribute server.

Refreshing IC Manager
After you complete your Web Management configuration, refresh IC Manager and verify that the
configuration information is present.
To refresh IC Manager
1. In IC Manager, select Manager > Refresh.

Installation and Configuration March 2012 281


Chapter 8: Configuring Web Management

2. In the Success message, click Ok.


If you do not see a Success message, see Troubleshooting the refresh in IC Manager on
page 456.
3. If required, verify that the information on the Configuration tab is correct.

282 Installation and Configuration March 2012


Chapter 9: Configuring Email Management

Email Management is part of the email channel for IC.


To configure Email Management, perform the steps in the following topics:
1. Before you configure Email Management on page 284.
2. Configuring an IC Poller Server on page 284
3. Configuring an IC Email server on page 286.
4. Configuring Email Template Administration on page 289.
5. Configuring a Workflow server for Email Management on page 297.
6. Using workflows for Email Management on page 303.
7. Creating routing hints for email workflows on page 305.
8. Configuring the WebACD server for Email Management on page 307.
9. Integrating Email Template Administration on page 308.
10. Configuring email accounts on page 309.
11. Creating an email status on page 320.
12. Configuring Avaya Content Analyzer (optional) on page 321.
Your IC system can also include optional Email Management features, such an approval
process or email message loop detection. For more information on how to configure these
features, see Interaction Center Administration Guide.

Tip:
Tip: For information on how to set up RONA for Email Management, see Interaction
Center Administration Guide.

Installation and Configuration March 2012 283


Chapter 9: Configuring Email Management

Before you configure Email Management


Before you configure Email Management, you must:
1. Verify that all required third party software, including SMTP servers, POP3 servers, IMAP4
servers and email accounts are installed and configured and accessible through the
network. For more information, see Avaya IC Installation Planning and Prerequisites.
2. Copy the IC server files to the target computers, as described in Installing IC server and
administration components on page 28.
3. Configure a secondary server environment, as described in Configuring the ORB server
environment on page 34.
4. Perform all the steps to configure the IC servers, databases, and related components,
described in Configuring core servers on page 108.
5. Configure Web Management, as set out in Configuring Web Management on page 189.

Configuring an IC Poller Server


The Poller server interacts with POP3, and IMAP4 servers, polls e-mails from the exchange
server that you have configured, and store them in a database.
This section includes the following topics:
l Guidelines for IC Poller Server on page 284
l Creating the IC Poller Server on page 284

Guidelines for IC Poller Server


Ensure that the failover strategy for your IC domains includes the following:
l A domain should contain only one Poller server.

Creating the IC Poller Server


The IC installation program does not automatically add the Poller server. Email Management
requires this server for polling the mails from the exchange server.

284 Installation and Configuration March 2012


Configuring an IC Poller Server

To create the IC Poller Server


1. In the IC Manager, select Server > New.
2. From the list of server types, select Poller and click Ok.
3. On the General tab, enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

Name Poller_<domain> To identify the server, include


the domain in the server name.
Domain IC. For example, select Poller
from the drop-down list if the
server is in the Poller domain.
Host IP address of the Poller server When you select the host, IC
Manager fills the fields for
Directory, Port, and Executable.

4. Click the Poller tab and enter the information for the fields mentioned in the following
table.

Field Recommended entry Notes

IC Data Source Interaction Center Data The default data source name is:
Source. interaction_center.
Maximum 240 Determines the maximum number of
Messages email contacts retrieved from a POP3
Retrieved per or IMAP4 server over a single
POP3 Cycle connection.
POP3 Cycle Wait 240 Specifies the default number of
Time (sec) seconds that the server waits between
checking for new contacts on a POP3
server. You can override this property
per mail account.
This duration is the interval between
the closing of a session and opening a
new session with POP3/ IMAP4 email
server for the same email account.

5. Click Ok.
6. Add the poller server into the poller cluster.
7. Start the IC Poller Server:
a. On the Server tab, select the IC Poller Server.
b. Right-click the IC Poller Server and select Start.

Installation and Configuration March 2012 285


Chapter 9: Configuring Email Management

For more information about the correct order for starting and stopping IC servers, see Starting
and stopping IC servers on page 131.

Configuring an IC Email server


The IC Email server interacts with Poller and SMTP servers for polling and forwarding of emails
into the IC system from customer to agent. Through workflows, the IC Email server also handles
the filtering of spam, the delivery of automatic replies, and the management of traffic flow to
external agents and approval agents.
This section includes the following topics:
l Guidelines for an IC Email server on page 286.
l Creating the IC Email server on page 286.

Guidelines for an IC Email server


Ensure the following:
l A domain should contain only one IC Email server.

Creating the IC Email server


The IC installation program does not automatically add the IC Email server. Email Management
requires this server.
To create the IC Email server
1. In the IC Manager, select Server > New.
2. From the list of server types, select Email and click Ok.
3. On the General tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry Notes

Name Email_<domain> To identify the server, include


the domain in the server name.

286 Installation and Configuration March 2012


Configuring an IC Email server

Field Recommended entry Notes

Domain IC. For example, select Email from


the drop-down list if the server
is in the Email domain.
Host IP address of the Email server When you select the host, IC
Manager fills in the fields for
Directory, Port, and Executable.

Installation and Configuration March 2012 287


Chapter 9: Configuring Email Management

4. Click the ICEMail tab and enter the information in the following fields.

Field Recommended entry Notes

IC Data Source Interaction Center Data If you used the default name, select
Source. interaction_center.
Template Admin Accept the default or Specifies the port on which the built-in
Port change if required. HTTP server will listen.
If you must change this port, see Avaya
IC Installation Planning and
Prerequisites for a list of the default port
numbers used by the other Avaya IC
servers. Port conflicts can cause serious
problems within the Avaya IC system.
If more than one IC Email server is
configured on the same host computer,
ensure that the port number is different
for each IC Email server.
Run Analyze Check this field. Check this field if you want:
Flow l The IC Email server to invoke an
email analysis workflow to assist in
the routing of incoming email
contacts.
l To use Analyze with Keywords or
Content Analyzer to process
incoming email.
You must also complete all steps to
configure Email workflows to use email
analysis. For details, see Using
workflows for Email Management on
page 303 and the Avaya IC Media
Workflow Reference.

288 Installation and Configuration March 2012


Configuring Email Template Administration

Field Recommended entry Notes

Run Outbound For the initial installation of Select this field if you want to:
Email Flow IC, clear this field. l Have IC analyze outbound email.

l Have a supervisor approve outbound


email.
l Use Analyze with Keywords or
Content Analyzer to process
outbound email.
You must also complete all steps to
configure Email workflows to use email
analysis.
AgentPort Accept the default or All IC Agents communicates with the IC
change if required. Email server on this port.
If more than one IC Email server is
configured on the same host computer,
ensure that the port number is different
for each IC Email server.

Even if you check the fields in the ICEmail tab, email analysis will not work if you do not
perform the steps in the following topics:
l Configuring a Workflow server for Email Management on page 297
l Using workflows for Email Management on page 303
l Creating routing hints for email workflows on page 305
5. Click Ok.
6. Add Email server to the IC Email Cluster.
7. Start the IC Email server:
a. On the Server tab, select the IC Email server.
b. Right-click the IC Email server and select Start.
For more information about the correct order for starting and stopping IC servers, see Starting
and stopping IC servers on page 131.

Configuring Email Template Administration


Email Template Administration requires a Web application. You can configure Email Template
Administration on the Web tab of the IC Configuration Tool.
This section describes how to install and configure Email Template Administration for each
operating system that IC supports. This section includes the following topics:

Installation and Configuration March 2012 289


Chapter 9: Configuring Email Management

l Where to configure Email Template Administration on page 290.


l Hosting multiple Web applications on one computer on page 290.
l Advanced properties for Email Template Administration on page 290.
l Configuring Email Template Administration on Windows on page 291.
l Configuring Email Template Administration on Solaris on page 293.
l Configuring Email Template Administration on AIX on page 295.

! Important:
Important: The Configuration Tool overwrites all manual edits that you make to an IC
configuration file.

Where to configure Email Template Administration


Configure Email Template Administration on a computer that hosts the templates for Email
Management and the Web pages for Email Template Administration.

Hosting multiple Web applications on one computer


If the IC system includes more than one Web application on the same computer as WebLM,
configure all the Web applications on the target computer at the same time.

! Important:
Important: If you do not configure all of the Web applications simultaneously, keep the
options for all Web applications on the target computer selected when you re-run
the Configuration Tool to create new Web applications. If you keep the options for
previously created Web applications unselected, the Configuration Tool may
delete those Web applications.

Advanced properties for Email Template Administration


The Web tab also includes advanced properties for the Java Virtual Machine.
If you expect a high volume of access to Email Template Administration, you can configure only
the advanced properties. For more information, see Configuration Tool advanced properties on
page 499.

290 Installation and Configuration March 2012


Configuring Email Template Administration

Configuring Email Template Administration on Windows


If you plan to host Email Template Administration on a Windows computer, use the following
instructions.
Note:
Note: You do not need to stop the IIS Web server on Windows computers.
To configure Email Template Administration to run on a Windows computer
1. Start the Configuration Tool by selecting Start > Programs > Avaya Interaction Center
7.3 > Configuration Tool.
Note:
Note: If the Configuration Tool is already open, close and re-open it to ensure that the
Configuration Tool includes all system changes, such as new servers.
2. Log in to the Configuration Tool using your IC Manager login ID and password.
3. On the Web tab, enter the information for the fields mentioned in the following table:

Field Description Sample entry

Tomcat Base Port The port used to configure the following ports: Default: 9600
l Tomcat HTTP ports for Web applications

l Tomcat AJP (Web server connector) ports

IIS Website The name of the IIS Web server that the Web Default Web Site
application will use.
Tip: For a localized version of IIS, type the
localized name for the IIS Web server.
Web Server Host The name of the computer that hosts the Web testbox
server.
Do not include the DNS domain.
DNS Domain The network (DNS) domain of the computer that xyzcorp.com
hosts your Web server. Do not enter an IC domain.
Note: Verify the default DNS domain and ensure
that it is correct.

Installation and Configuration March 2012 291


Chapter 9: Configuring Email Management

Field Description Sample entry

Web Server Port The port that your Web server uses for Default: 80
communication. Make sure that the port matches the
protocol used by your Web server for
communication. The default ports are:
l HTTP port is 80.

l HTTPS port is 443.

Do not change the default port unless you assign a


different port to the Web server.
IC Test Optional. Checkmark in box
IC Test is a Web application that you can use to test
your Tomcat configuration.
If you install multiple versions of Tomcat, the
Configuration Tool creates an IC Test application for
each version of Tomcat. The Configuration Tool also
creates a separate Tomcat server to host IC Test.
To access IC Test, use the Tomcat HTTP port in the
URL. For example, type:
http://<server>.<domain>.com:9600/
ictest
Note: The port number is not required if you
install a single version of Tomcat, or access IC
Test from the separate Tomcat server for IC Test.

4. Select the Configure Email Template Administration check box.


5. Click Apply Settings.
6. Click Ok on the Success dialog box.
7. Click Exit.
To ensure that Email Template Administration services started properly
1. Open the Windows Services control panel.
2. Start IC Email Template Management Service 7.3.
For more information about how to start and stop Web application services, see Starting
and stopping IC services on page 138.

292 Installation and Configuration March 2012


Configuring Email Template Administration

Configuring Email Template Administration on Solaris


Use these instructions if you plan to host Email Template Administration on a Solaris computer.

! Important:
Important: To configure Email Template Administration on Solaris, you must log in as a user
with write permissions on the Web server directories and the IC installation
directories. The root user usually has these write permissions.
To configure Email Template Administration to run on a Solaris computer:
1. Stop the Oracle iPlanet server that hosts the Website application. For information, refer
Starting and stopping Oracle iPlanet Web server on page 140.
2. If the Configuration Tool is already open, close it to ensure that the Configuration Tool
includes all system changes, such as new servers.
3. Start the Configuration Tool:
a. Navigate to IC_INSTALL_DIR/IC73/bin
b. Run ./configure
4. Log in to the Configuration Tool using your IC Manager login ID and password.
5. On the Web tab, enter the information for the fields mentioned in the following table:

Field Description Sample entry

Tomcat Base Port The port used to configure the following ports: Default: 9600
l Tomcat HTTP ports for Web applications

l Tomcat AJP (Web server connector) ports

Web Server The installation path for the Oracle iPlanet Server /opt/oracle/
Home that hosts the Web application. webserver7
Web Server The root name of the server as found in the Oracle testbox.xyzcorp.co
Name iPlanet Server home directory. m
Note: Do not include https- in the Web server
name.
Web Server Host The name of the computer that hosts the Web testbox
server.
Do not include the DNS domain.
DNS Domain The network (DNS) domain of the computer that xyzcorp.com
hosts your Web server. Do not enter an IC domain.
Note: Ensure that the default DNS domain is
correct.

Installation and Configuration March 2012 293


Chapter 9: Configuring Email Management

Field Description Sample entry

Web Server Port The port that your Web server uses for Default: 80
communication. Make sure that the port matches
the protocol used by your Web server for
communication. The default ports are:
l HTTP port is 80.

l HTTPS port is 443.

Do not change the default port unless you assign a


different port to the Web server.
IC Test Optional. Checkmark in box
IC Test is a Web application that you can use to
test your Tomcat configuration.
If you install multiple versions of Tomcat, the
Configuration Tool creates an IC Test application
on each version of Tomcat. The Configuration Tool
also creates a separate Tomcat server to host IC
Test.
To access IC Test, use the Tomcat HTTP port in the
URL. For example, type:
http://<server>.<domain>.com:9600/
ictest
Note: The port number is not required if you install
a single version of Tomcat, or access IC Test from
the separate Tomcat server for IC Test.

6. Select the Configure Email Template Administration check box.


7. Click Apply Settings.
8. Click Ok on the Success dialog box.
9. Click Exit.
To ensure that Email Template Administration services started properly
1. In the Oracle iPlanet Server installation directory:
a. Open the Open the admin-server directory.
b. If the directory includes a file called start-ICEnv.backup, execute the following
command to rename the file:
mv start-ICEnv.backup oldstart-ICEnv
2. Start the Oracle iPlanet server that hosts the Website application. For information, refer
Starting and stopping Oracle iPlanet Web server on page 140.
3. Navigate to the IC_INSTALL_DIR/IC73/bin directory.
4. Use the following script to start Tomcat
nohup ./ictomcat.sh start rlmanager

294 Installation and Configuration March 2012


Configuring Email Template Administration

! Important:
Important: For Solaris only, the Configuration Tool changes the ownership of the
implementation file (vesp.imp) and the interface file (vespidl.pk) to root. If you do
not want to run IC as root, you must change the ownership of these files as
described in Changing ownership for IC on Solaris only on page 39.

Configuring Email Template Administration on AIX


Use these instructions if you plan to host Email Template Administration on an AIX computer.

! Important:
Important: To configure Email Template Administration on AIX, you must log in as a user with
write permissions on the Web server directories and the IC installation directories.
The root user usually has these write permissions.
To configure Email Template Administration to run on an AIX computer
1. Stop the IBM HTTP Server that hosts the Website application with the stop script
packaged with the Web server: ./httpserver.sh stop
2. Start the Configuration Tool:
a. Navigate to IC_INSTALL_DIR/IC73/bin
b. Run ./configure
If the Configuration Tool is already open, close and re-open it to ensure that the
Configuration Tool includes all system changes, such as new servers.
3. Log in to the Configuration Tool using your IC Manager login ID and password.
4. On the Web tab, enter the information for the fields mentioned in the following table:

Field Description Sample entry

Tomcat Base Port The port used to configure the following ports: Default: 9600
l Tomcat HTTP ports for Web applications

l Tomcat AJP (Web server connector) ports

Web Server The installation path for the IBM HTTP server /usr/HTTPServer
Home instance that hosts the Web application.
Web Server Host The name of the system that hosts the Web server. testbox
Do not include the DNS domain.

Installation and Configuration March 2012 295


Chapter 9: Configuring Email Management

Field Description Sample entry

DNS Domain The network (DNS) domain of the computer that xyzcorp.com
hosts your Web server. Do not enter an IC domain.
Note: Verify the default DNS domain carefully to
ensure that it is correct.
Web Server Port The port that your Web server uses for Default:
communication. Make sure that the port matches 80
the protocol used by your Web server for
communication. The default ports are:
l HTTP port is 80.

l HTTPS port is 443.

Do not change the default port unless you assign a


different port to the Web server.
IC Test Optional. Checkmark in box
IC Test is a Web application that you can use to
test your Tomcat configuration.
If you install multiple versions of Tomcat, the
Configuration Tool creates an IC Test application
on each version of Tomcat. The Configuration Tool
also creates a separate Tomcat server to host IC
Test.
To access IC Test, use the Tomcat HTTP port in
the URL. For example, type:
http://<server>.<domain>.com:9600/
ictest
Note: The port number is not required if you
install a single version of Tomcat, or access IC
Test from the separate Tomcat server for IC
Test.

5. Select the Configure Email Template Administration check box.


6. Click Apply Settings.
7. Click OK on the Success dialog box.
8. Click Exit.
To ensure that Email Template Administration services started properly
1. Start the IBM HTTP Server that hosts the Website application, as described in Starting and
stopping IBM http Web server on page 143.
2. Navigate to the IC_INSTALL_DIR/IC73/bin directory.
3. Use the following script to start Tomcat:
nohup ./ictomcat.sh start rlmanager

296 Installation and Configuration March 2012


Configuring a Workflow server for Email Management

! Important:
Important: For AIX only, the Configuration Tool changes the ownership of the implementation
file (vesp.imp) and the interface file (vespidl.pk) to root. If you do not want to run
IC as root, you must change the ownership of these files as described in
Changing ownership for IC on AIX only on page 41.

Configuring a Workflow server for Email Management


To configure the Workflow server for Email Management, perform the steps in the following
topics:
1. Creating a Workflow server for Email Management on page 297.
2. Creating email channels for the Workflow server on page 298.
3. Starting the Workflow server on page 303.
If your IC system includes multiple Workflow servers, perform these steps on each Workflow
server that handles pre-qualification for email contacts and routes email contacts.

Creating a Workflow server for Email Management


These instructions only provide information about those parameters you need to set when you
create a Workflow server to handle email contacts. For more information about other
parameters in the Workflow server, see Configuring multiple Workflow servers on page 119 and
Interaction Center Administration Guide.

! CAUTION:
CAUTION: If you do not configure the Workflow server with synchronous startup flows, the
Qualify Email workflow cannot resolve the pkey of the queue where a contact is to
be routed. If this occurs, IC cannot route email contacts.
To create a Workflow server for Email Management
1. In IC Manager, select Server > New.
2. From the list of server types, select Workflow.
3. Click Ok.

Installation and Configuration March 2012 297


Chapter 9: Configuring Email Management

4. On the General tab, and enter the information for the fields mentioned in the following
table:

Field Recommended entry Notes

Name Workflow_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the For example, select Email to
server from the drop-down list. use the pre-configured domain
for Email Management.
Host Select the IP address of the When you select the host, IC
system from the drop-down list, or Manager fills in the fields for
type the IP address if it is not in Directory, Port, and Executable.
the list.

5. Click the Workflow tab.


6. From the IC Data Source drop-down list, select the Interaction Center data source.
The default name for this data source is interaction_center. This is the data source
that you created in Generating the Interaction Center application on page 93.
7. Select Synchronous Startup Flows.
8. If the following rows do not exist, add them to the Synchronous Startup Flows:
a. Click New.
b. In the new row, type web_routing.update_qw_cache
c. Click Ok.
9. Continue creating email channels for workflow servers as mentioned in Creating email
channels for the Workflow server on page 298.

Creating email channels for the Workflow server


You must add email channels and associations with the workflows for each channel. You create
separate channels for email qualification and for email analysis. Use different Workflow servers
to handle each task and create these channels in the appropriate Workflow.

! Important:
Important: In case you have configured two WebACD servers then deploy 2 Email
Management Workflow servers in those domains. For example, if Web and Web2
are two domains where you have configured WebACD1 server and WebACD2
server respectively, you must configure Email Management Workflow servers in
both Web and Web2 domain.

298 Installation and Configuration March 2012


Configuring a Workflow server for Email Management

This section includes the following topics:


l Creating the email channel for email qualification on page 299.
l Creating the email channel for email analysis on page 300.

Creating the email channel for email qualification


Perform these steps in each Workflow server that will run the Qualify Email workflow.
To create an email channel for a Workflow server that qualifies emails:
1. In the Server Editor for the Workflow server, click the Channels tab.
2. Click New Channel on the toolbar.
3. In the Channel Editor dialog box, enter the information for the fields mentioned in the
following table:

Field Recommended entry Notes

Global Do not select this field. Do not select this field to create a
channel for a specific server or
media, such as Email.
By Server l Do not select this field if If you select this field, and you need
you want the channel to this Workflow server to communicate
handle events from all with more than one server, you must
servers of the type that create another channel for that
you select from the server.
Service drop-down list.
Warning: If you select this field
l Select this field if you and the WebACD server is named
want the channel to "WACD", the Workflow server
handle events only from a cannot communicate with the
specific server that you WebACD server.
select from the Service
drop-down list.
Channel Range No entry necessary. Completed by IC Manager
Service Select WACD or the Whether you can select a server or a
WebACD server from the type of server, depends up whether
drop-down list. or not you have selected the By
Server field.
Criteria Type media=email

4. Click Ok in the Channel Editor dialog box.


5. Select the channel that you created in the step above.
6. Click the New Association button on the toolbar.

Installation and Configuration March 2012 299


Chapter 9: Configuring Email Management

7. In the Channel Association dialog box, enter the information for the fields mentioned in
the following table:

Field Recommended entry

Channel Range Completed by IC Manager


Service Interface Completed by IC Manager
Event WACD.QualifyEmail
Note: This field is case-sensitive and must follow the
format <flow_project>.<flow_name>
Flow <flow_project>.<flow_name>
For example, type wacd.qualifyemail

8. Click Ok in the Channel Association dialog box.


9. Perform one of the following steps:
l Click Ok in the Server Editor to complete the Workflow server configuration.
l If the Workflow server also runs email analysis workflows, continue with Creating the
email channel for email analysis on page 300.

Creating the email channel for email analysis


Perform these steps in each Workflow server that will run the email analysis workflow.
To create an email channel for a Workflow server that analyzes emails:
1. In the Server Editor for the Workflow server, click the Channels tab.
2. Click the New Channel button on the toolbar.

300 Installation and Configuration March 2012


Configuring a Workflow server for Email Management

3. In the Channel Editor dialog box, enter the information for the fields mentioned in the
following table:

Field Recommended entry Notes

Global Do not check this field. Do not check this field to create a
create a channel for a specific server
or media, such as Email.
By Server l Do not check this field if If you check this field, and you need
you want this channel to this Workflow server to communicate
handle events from all with more than one server, you must
servers of the type that create another channel for that
you select from the server.
Service drop-down list.
Warning: If you check this field
l Check this field if you want and the WebACD server is named
this channel to handle "WACD", the Workflow server will
events from only one not be able to communicate with
specific server that you the WebACD server.
select from the Service
drop-down list.
Channel Range No entry necessary. Completed by IC Manager
Service Select ICEMail from the Whether you can select a server or a
drop-down list. type of server, depends up whether
or not you checked the By Server
field.
Criteria Type *.

4. Click Ok in the Channel Editor dialog box.


5. Select the channel that you created in the step above.
6. Click the New Association button on the toolbar.

Installation and Configuration March 2012 301


Chapter 9: Configuring Email Management

7. In the Channel Association dialog box, enter the information for the fields mentioned in
the following table to create an inbound and an outbound association for the email
channel.

Channel or Field Recommended entry


Association

Association 1 Channel Range Completed by IC Manager


Service Interface Completed by IC Manager
Event ICEmail.Analyze
Note: This field is case-sensitive and
must follow the format
<flow_project>.<flow_name>
Flow <flow_project>.<flow_name>
For example, enter one of the following:
l icemail.analyzenoca if your
system does not include Content
Analyzer
l icemail.analyzeca if your
system includes Content Analyzer
Association 2 Channel Range Completed by IC Manager
Service Interface Completed by IC Manager
Event ICEmail.OutboundEmail
Note: This field is case-sensitive and
must follow the format
<flow_project>.<flow_name>
Flow <flow_project>.<flow_name>
For example, enter one of the following:
l icemail.outboundnoca if your
system does not include Content
Analyzer
l icemail.outboundca if your
system includes Content Analyzer

8. Click Ok in the Channel Association dialog box.


9. Click Ok in the Server Editor to complete the Workflow server configuration.

302 Installation and Configuration March 2012


Using workflows for Email Management

Starting the Workflow server


To start the Workflow server:
1. In IC Manager, right-click the Workflow server that handles email contacts and select
Start.

Using workflows for Email Management


You can use the sample workflows to configure and test your Email Management servers. IC
seed data includes compiled sample workflows. When you import seed data into the CCQ
database, you are storing the compiled workflows in the database.
Note:
Note: ICEmail flows, such as analyzenoca, analyzeca, outboundca, and
outboundnoca are not seeded for fresh IC 7.3 install. Therefore, you must
manually built these flows in Workflow Designer and upload these flows to the
database.
Email Management uses the following sample workflows:
l An incoming and outbound Email Analysis workflows from the ICEmail project
l The Qualify Email workflow in the WACD project
l All Web Management workflows, see Using workflows for Web Management on page 223
Before your IC system moves into production, you can modify the properties of the sample
workflows to meet the requirements of your contact center. For example, you can route an
outbound email to an approval queue or to an approving agent. For more information, see
Avaya IC Media Workflow Reference.

Configuring Outbound Email Analysis workflows


The ICEmail project contains two sample Outbound Email Analysis flows. The sample
Outbound with Keywords workflow (outboundnoca) performs analysis on outbound email in IC
systems that do not include Content Analyzer. The sample Outbound with Content Analyzer
workflow (outboundca) performs analysis on outbound email in IC systems with Content
Analyzer.
The sample Outbound Email Analysis flows depend on settings in the following:
l Outbound settings in the IC Email server
l Email channel in the Workflow server

Installation and Configuration March 2012 303


Chapter 9: Configuring Email Management

l Group properties in IC Manager


l Blocks in the Qualify Email workflow
l Blocks in the Outbound Email Analysis workflow
You must know the configuration of your production environment before you can configure the
Outbound Email Analysis flows to work in your IC system. Therefore, until you have tested your
Email Management system and know the configuration of your production environment, you
should not run any Outbound Email Analysis flows. For more information on this setting, see
Creating the IC Email server on page 286.
If you want to run an Outbound Email Analysis workflow in your Email Management system, you
must configure and test your system carefully.
To configure Outbound Email Analysis:
1. In Workflow Designer, open the appropriate Outbound Email Analysis workflow in the
ICEmail project, as shown in the following table:

Workflow IC system configuration

outboundca IC systems with Content Analyzer.


outboundnoca IC systems without Content Analyzer.

2. Double-click the GetAgentQuota block and in the Property Sheet:


a. Click the Basic tab.
b. Set the value of DefaultQuotaValue to 0 (zero).
If you set the default value to 0 (zero), outbound email contacts are not reviewed.
3. Save and recompile the workflow.
4. In IC Manager, set the group properties for agents
a. Select Tools > Groups > Properties to open the Group Properties dialog box:
b. Select Email/Agent and set the value of the ReviewQuota property.
If you set the default value to 0 (zero), outbound email contacts are not reviewed.
c. Apply and save the changes.
For more detailed instructions, see Setting global properties for all agents on page 338.
5. In IC Manager, if you configured any agents not to cascade their properties from the global
properties, set the value of ReviewQuota to 0 (zero) for those agents also. For more
detailed instructions, see Setting properties for individual agents and workgroups on
page 338.

304 Installation and Configuration March 2012


Creating routing hints for email workflows

Creating routing hints for email workflows


The sample email workflows contain blocks that use routing hints from the RoutingHint table in
the Directory server to analyze and route email contacts. These blocks include:
l Fetch Routing Hints (email) block in the Qualify Email workflow
l Set Routing Hint blocks in each of the Email Analysis workflows

! Important:
Important: Routing hints must be in lower case. Do not use mixed upper and lower case in
your routing hints. If the routing hint is not in all lower case, the workflow cannot
locate the routing hint, and Avaya IC cannot correctly route the contact.
For more information about the sample email workflows and how the workflows use routing
hints, see Avaya IC Media Workflow Reference.
The email workflows use hints from the RoutingHint table to route email contacts.
Each row in the routing hint table contains the following:
l A routing hint
l The IDs of the queues where contacts that match the routing hint should be routed

Tip:
Tip: The default email queue is DefaultEmailQueue@DefaultTenant. You can create
and use additional email queues for routing email contacts. For more information,
see Interaction Center Administration Guide.
The routing hints that you need to create for the sample email workflows depend upon your IC
system. The following table describes the routing hints required by the different sample email
workflows.

IC deployment Email workflow Routing hints

Email contact routing wacd.qualifyemail If deployment includes email analysis, no


additional hints required.
If no email analysis, create a routing hint
for the To address of email. For example,
[email protected]

Installation and Configuration March 2012 305


Chapter 9: Configuring Email Management

IC deployment Email workflow Routing hints

Email Analysis with icemail.analyzenoca Create a routing hint with a value such as:
Keywords l sales

l support

l printers

icemail.outboundnoca Create a routing hint with a value of:


l approvalrequired

Email Analysis with icemail.analyzeca Create a routing hint with a value such as:
Content Analyzer l home computing

l desktop

Also, create routing hints for language with


an ISO-639-1 value such as:
l en

l sp

l fr

l de

l zh

icemail.outboundca Create a routing hint with a value of:


l approvalrequired

l suspectcontent

To create routing hints


1. In IC Manager, click the Configuration tab.
2. In the left pane, select Tables > Workflow > RoutingHint.
3. Click the New button on the toolbar.
4. In the right pane, enter the information for the fields mentioned in the following table:

Parameter Recommended entry Description

Routing Hint Type a routing hint. Type the name of a routing hint required
by a sample email workflow.
The routing hint must be a single word in
all lower case, and cannot contain any
special characters.
Email Queue ID Type DefaultEmailQueue@ DefaultEmailQueue@DefaultTenant is the
DefaultTenant. default email queue. For more information
about email queues, see Interaction
Center Administration Guide.

306 Installation and Configuration March 2012


Configuring the WebACD server for Email Management

Parameter Recommended entry Description

Category/Qualifier Leave this field blank.


Tenant Select DefaultTenant from the Select the tenant used by the queue.
queue from the drop-down list. For the DefaultEmailQueue, select
DefaultTenant to ensure that the routing
hint uses the correct queue.

5. Click Ok.
6. Click Apply.
Repeat Steps 3 through 6 to create all required routing hints.
7. Select Manager > Refresh.

Configuring the WebACD server for Email Management


Configuration of the default email cluster is required for agents to communicate to IC Email
server.

! Important:
Important: Ensure that the email servers in the default email cluster are always running.
To configure the default email cluster in the WebACD server
1. In IC Manager, double-click the WACD server in the lists of server types.
2. Click the WACD tab.
3. In the Default Email Cluster, drop-down list, select the email cluster that you want to use
for configuring WebACD.
Note:
Note: You must configure the email cluster before you configure the WebACD server for
email management.
4. Click Ok.
Note:
Note: In case of two WebACD servers, you must configure the default email cluster on
both the WebACD servers.

Installation and Configuration March 2012 307


Chapter 9: Configuring Email Management

Integrating Email Template Administration


Perform these steps to launch the Email Template Administration Tool from IC Manager.

Tip:
Tip: You need to complete only those properties listed in this section to integrate
Email Management administration.
To configure Email Template Administration:
1. In IC Manager, select Tools > Groups.
2. Click the Properties tab.
3. In the left pane, select IC.
4. In the Sections list, select System/Configuration.
5. Select the following properties:
a. Click Edit.
b. Set values for the properties, as shown in the following table:

Property Recommended entry

EmailLoginServer Type the fully-qualified domain name of the server that


hosts the Email Template Administration pages. For
example, type ICEmail.xyzcorp.com.
EmailLoginServerPort Type one of the following ports for the IC Email server
web port:
l HTTP - 80

l HTTPS - 443

Do not change the default port.


EmailLoginServerWebsite Type rlmanager as the name of the Response Library
Manager web application.
The Configuration Tool defined this application name
when you configured Email Template Administration.
EmailServer Type the fully-qualified domain name of the system
that hosts the IC Email server.
EmailServerPort Type the IC Email server HTTP port. For example, the
default is 19114.

If one of these properties is not available, select Property Insert and select the property
name from the drop-down menu.

308 Installation and Configuration March 2012


Configuring email accounts

Tip:
Tip: If the columns in the right pane are Name, Entity, Value, and Overridable, select
the - (minus) button on the toolbar to view and edit these properties.
6. Click Apply.
7. Click Ok.

Configuring email accounts


You must configure Email Management to use your mail accounts to:
l Retrieve inbound email from customers
l Send outbound agent replies
The following table describes the email accounts that must exist before you configure Email
Management to use email accounts.

Required email accounts Description

Email Management mail accounts These accounts must exist as mailboxes on the POP3
or IMAP4 server.
Note the login ID and password. IC Manager can only
link to an existing mailbox. IC Manager cannot create
mailboxes on a POP3 or IMAP4 server.
At least one email account for the Web Management uses customer email accounts to
Customer account for inbound send email from the Customer Web site to your
customer messages contact center. Use this email address for mailto: links
on your web site and wherever you plan to make email
addresses available to customers.

Installation and Configuration March 2012 309


Chapter 9: Configuring Email Management

Required email accounts Description

Bounced email account Email Management uses this account as the


destination address for emails sent by the IC Email
server that the SMTP server bounces or rejects. All
filtered spam and other junk emails also get forwarded
to this bounced email.
You include this account in your IC Email server
configuration.
Disabled accounts (optional) You can set up Disabled accounts to test or
troubleshoot the following servers:
l Web Management servers

l IC Email server

l Tomcat server where you install the website


application
Email Management does not retrieve messages for
disabled accounts.

Email Management can manage mailboxes in any number of domains as long as it has the
necessary information to log onto the POP3 or IMAP4 server.

Tip:
Tip: The IC Poller Server generates the "to address" for an incoming email from the
Name and Domain fields on the General tab of the Email Account
Configuration window. As a result, the logon account does not need to match
the first part of the email address, and the "to address" is independent of the
logon account used to poll the POP3 or IMAP4 server.
To add a POP3/IMAP4 email account to Email Management:
1. In IC Manager, select Services > Email Accounts.
2. In the Email Accounts dialog box, click New.

310 Installation and Configuration March 2012


Configuring email accounts

3. In the New Email Account property sheet, enter the information for the fields mentioned
in the following table.

Tab Field Description

General tab Display Name The name that the e-mail client application displays
for the configured e-mail address.
For example, if [email protected] is an actual
e-mail address and Support Test is the display name
for that e-mail address, the e-mail client application at
the customer end shows the display name in the
From address of the e-mail that they receive from
agents.
Name Type the mailbox name exactly as it is configured in
your POP3 or IMAP4 server. For example, type
agent.
Domain Type the mailbox domain exactly as it is configured in
your POP3 or IMAP4 server. For example, type
xyzcorp.com.
Tenant Select the tenant from the drop-down list to associate
with this email account.
Return address Select the address that appears in the From field in
an email response sent to the customer from this
account. By default, IC Manager automatically
completes this field with name@domain.
Bounce Email Type the email address to which the bounced email
Address are sent.
Owner Name Select the poller cluster for which the email account is
configured.
Disable Select the check box to temporarily disable the email
Account account.

Installation and Configuration March 2012 311


Chapter 9: Configuring Email Management

Tab Field Description

Outgoing Email Outgoing Email Type the network address for the SMTP email server
Server tab Server (SMTP) you would like to use here.
Outgoing Email Type the port number for the SMTP server.
Server (SMTP)
Port
Test Click this button to test the email account for the
outgoing mail server.
If you want to send a sample email as well as test the
connection, select the Send a test message using
this account check box. IC Manager creates an
email with:
l A dummy address in the From field

l The selected email account in the To field

l The current timestamp in the Subject field.

l The phrase "Test mail message" in the Body


field.
If you want to change any of the default
information, you can change the value in the
appropriate field.
l Click Test, to send that email to the SMTP server.
You can use this option to generate multiple test
emails and compare the timestamp in their
subject lines.
Incoming Email Email Account Select POP3 or IMAP4 from the drop-down list. In IC
Server tab Type 7.3, you can also use IMAP4 protocol for receiving
the emails. In IMAP4, all the mails remains on the
mail server.
If you select IMAP4, the Mail Folder Name field
becomes visible. In this field, you have to enter the
exact name of the folder from which you want fetch
the emails. For example:
l To access the nested folder
support_requests, which is inside the
INBOX/Support folder, you must enter INBOX/
Support/support_requests.
l To access the root folder INBOX or New
Requests, you must enter INBOX or New
Requests.

312 Installation and Configuration March 2012


Configuring email accounts

Tab Field Description

Incoming Email Type the network address of the POP3 or IMAP4


Server server where the email accounts are configured, the
logon account, and password in the appropriate field.
Note: If any of these settings are incorrect, Email
Management will not be able to connect to the
POP3 or IMAP4 email server.
Note: For email accounts with TLS enabled, the
incoming server name should be Fully Qualified
Domain Name (FQDN). For example,
hostname.domainname.
Incoming Email Type the port number for receiving mails from POP3
Server Port and IMAP4 server.
By default, the port number for POP3 sever is 110
(995 if TLS is enabled) and IMAP4 server is 143 (993
if TLS is enabled).
Logon account Enter the name of the email account.
You do not need to enter the domain.
Password / Enter the password for the email account in both of
Confirm these fields.
Use TLS Select this field to enable the TLS (Transport Layer
Security) for the mails that are fetched from this email
account. For more information, see Configuring the
email accounts for SSL on page 316. If you select
this option, the IMAP4/ POP3 works on the SSL port,
which is 993/ 995.
Use Secure Select this check box to secure the username and
Authentication password over the network. Secure Password
Authentication is a challenge-response protocol used
by the Windows security subsystem to prevent
passwords from being sent through the network in
plain text. Your POP3 or IMAP4 server must support
Secure Password Authentication to use this option.
Authentication Select NTLM or MD5 as authentication types for this
Type email account. For more information, see Configuring
the email accounts for SSL on page 316.
Test Click the button to test the email account for incoming
mail server.

Installation and Configuration March 2012 313


Chapter 9: Configuring Email Management

Tab Field Description

Templates tab — The Templates tab allows you to specify the


following templates:
l Header: The template specifies the text to be
inserted at the top of any email that you are
sending to a customer.
l Footer: The template specifies the text to be
appended to the end of any email that you are
sending to a customer.
l New Message: The template specifies the text to
be automatically sent to a customer when a new
email is received from the customer.
l Follow Up: The template specifies the basic
acknowledgement message to be sent when a
customer replies to a message sent from IC or a
follow up email is received from the customer.
l Bounce Mail: The template specifies the text
that will be sent automatically in response to
message that has been rejected.
You can create these templates in Email Template
Administration. For more information, see
Configuring Email Template Administration on
page 289
Filter tab Filter Type Select the type of filter to be enabled for this email
account.
Note: At a time, only one filter is active.
Accept From Click the button to enter email addresses. Email
management rejects mails that comes from an email
address that is not in the Accept From list.
The field is enabled only if you select the filter type as
VALID_EMAIL_LIST.
Reject From Click the button to enter email addresses. Email
management rejects mails that comes from any email
address mentioned in the Reject From list.
The field is enabled only if you select the filter type as
INVALID_EMAIL_LIST.

314 Installation and Configuration March 2012


Configuring email accounts

Tab Field Description

Miscellaneous tab Override global Select this box if you want this account to check for
email checking new messages either more or less frequently than
scheduler the global setting that was specified for the IC Poller
Server.
New email Specifies the number of seconds that the email
check server waits for checking new contacts on a POP3 or
frequency (sec) IMAP4 server.
This duration is an interval between closing of a
session and opening a new session with POP3/
IMAP4 email server for same email account.
You must check Override global email checking
scheduler to use this field.
Duplicate Select the check box to enable the checking of
Message duplicate message received by an agent.
Checking Selecting this options ensures that duplicate
messages are not received. The option does not
check outbound email contacts.
An incoming email contact is considered to be a
duplicate if all of the following parts of the contact are
identical to those in a previous contact:
l From address

l To address

l Subject

l Body

Loop Detection Select the check box to enable the loop detection.
Loop Detection Loop detection is based on "sender", "from address",
Type "reply to address" or "both".
Loop Detection Click the button to select the template for the loop
Template detection type selected above.
Blank Template Select this check box to set the Blank Email template.
Detection
Blank Email The templates specifies the text that will be
automatically sent to a customer when a blank email
(for example, an email with no body text) is received
from a customer.
You must select the Blank Template Detection
check box.
Loop Detection The maximum number of automated responses that
Count you want the customer to receive in a 24-hour period.
Note: Email Management will not automatically
respond to messages that exceed this count.

Installation and Configuration March 2012 315


Chapter 9: Configuring Email Management

4. Click Ok.
For more information about how to create IC email accounts, see Interaction Center
Administration Guide.

Configuring the email accounts for SSL


Currently IC allows you to configure all the POP3 email accounts either with Windows NT Lan
Manager (NTLM) or Message-Digest algorithm 5 (MD5) security authentication types. These
authentication methods allows only the password to be secured over the network. In IC 7.3
release, you can now configure all your POP3 and IMAP4 email accounts with the SSL security.
To enable SSL for email accounts you require:
l Server Certificate: This needs to be generated using a certificate request to certificate
authority for the exchange server and will be added to the exchange server.
l Root Certificate: This can downloaded from the certificate authority such as VeriSign or
Thawte
The SSL security in IC requires that you configure a Server side certificate on the exchange
server and Root certificates on the local computers of agents.
The Server side certificate works only if you enable the secure channel with 128-bit encryption
on the exchange server.
The Root certificate should be in the .PEM format and the certificate file name is in the host
name.domain name format. The host name is the name of the computer where the mail
server is configured and the domain name is the name of the domain in which the mail server
resides. The Root certificate with a different format must be converted to .PEM format.

! Important:
Important: Do not change the certificate format by manually changing the extension. You
must use the OpenSSL utility for converting the format of the certificate.
Note:
Note: Before configuring an email account with the SSL security, you have to ensure
that your mail servers are configured with the required server certificates received
from a certified authority, such as VeriSign or Thawte.
You can enable the SSL security for any email account by selecting an option in the email
account configuration. For more information, see the table in the Configuring email accounts on
page 309.

316 Installation and Configuration March 2012


Configuring email accounts

Creating certificate request for POP3 or IMAP4 server for SSL


In IC, selecting the TLS option to enable the SSL security requires a certificate to be created
and installed on the exchange server. This section explains the procedure to create a certificate
for POP3 or IMAP4
To create certificate for POP3 or IMAP4
1. From the Windows Start menu, select Programs > Microsoft Exchange > System
Manager.
2. In the left pane, expand the Servers node.
3. Select a mail exchange server.
4. For the selected server, select Protocols > POP3.
5. Right-click the Default option and select Properties.
6. On the Default POP3 Virtual Server Properties window, click the Access tab.
7. In the Secure Communication section, click Certificate.
8. By keeping the default options selected click Next on the following pages:
1. Server Certificate
2. Delayed or Immediate Request
3. Name and Security Settings
9. Click Next.
10. On the Your Site’s Common Name page, enter the complete server name including the
domain as common name. For example, puicdev111.pop.ic.com.
Note:
Note: The common name you entered here is used for naming the Root Certificate.
11. Click Next.
12. Click Next.
13. Enter the certificate file name and click Next.
Note:
Note: Follow the same procedure for creating certificate request for IMAP4.

Creating Certificates using Microsoft CA


After you create a request for creating certificate, you need to create a certificate and get it
downloaded on the server. This section explains the procedure for doing this.
To create a certificate
1. On the exchange server, open the Internet Explorer.
2. In the address bar, type: http://localhost/certsrv.

Installation and Configuration March 2012 317


Chapter 9: Configuring Email Management

3. Click the Request a certificate link.


4. Click the advanced certificate request link.
5. Click the Submit a certificate request by using a base-64-encoded CMC or PKCS #10
file, or submit a renewal request by using a base-64-encoded PKCS #7 file link.
6. On the Submit a Certificate Request or Renewal Request page, paste the contents of
the certificate text file that you have created while creating certificate request. For more
information, see Creating certificate request for POP3 or IMAP4 server for SSL on
page 317.
7. In the Certificate Template drop-down list, select Web Server as the certificate template.
8. Click Submit.
9. On the Certificate Issued page, select Base 64 encoded option.
10. Click the Download certificate link.
11. Save the certificate.
The certificate will be in the .CER format. You need to convert this certificate in the .PEM
format. For more information, see Converting root certificate from .CER format to .PEM
format on page 320.
Note:
Note: For Certificate Authority other than Microsoft CA, you must send the request to
the respective Certificate Authority.

Adding Certificate to POP3 or IMAP4 Server


After you create and download the certificate, you need to add the certificate to a proper
location on the POP3 or IMAP4 server. This section explains the procedure for doing this.
To add certificate to POP3 or IMAP4 server
1. From the Windows Start menu, select Programs > Microsoft Exchange > System
Manager.
2. In the left pane, expand the Servers node.
3. Select a mail exchange server.
4. For the selected server, select Protocols > POP3.
5. Right-click the Default option and select Properties.
6. On the Default POP3 Virtual Server Properties window, click the Access tab.
7. In the Secure Communication section, click Certificate.
8. On the Pending Certificate Request page, click Next.
9. Select the certificate file converted into the .PEM format.
10. Click Next to add a certificate.

318 Installation and Configuration March 2012


Configuring email accounts

Activating TLS settings on POP3 or IMAP4 server


To activate TLS to POP3 or IMAP4 server
1. From the Windows Start menu, select Programs > Microsoft Exchange > System
Manager.
2. In the left pane, expand the Servers node.
3. Select a mail exchange server.
4. For the selected server, select Protocols > POP3.
5. Right-click the Default option and select Properties.
6. On the Default POP3 Virtual Server Properties window, click the Access tab.
7. In the Secure Communication section, click Communication.
8. On the Security dialog box, select Require secure channel and Require 128-bit
encryption.
9. Click OK.

Downloading Root Certificate from the Microsoft CA


To download a root certificate
1. On a local computer, open the Internet Explorer.
2. In the address bar, type: http://localhost/certsrv/.
3. In Encoding method, select Base 64.
4. Click the Download CA Certificate link.
Note:
Note: The certificate will be in the .CER format. Change the .CER file name to your
site’s Common Name, which was used while Creating certificate request for
POP3 or IMAP4 server for SSL on page 317. For Certificate Authority other than
Microsoft CA, you must obtain the Root Certificate from respective Certificate
Authority.
You need to convert this certificate in the .PEM format. For more information, see Converting
root certificate from .CER format to .PEM format on page 320.

! Important:
Important: After you convert the certificate to .PEM format, you must copy the Root
certificate to the IC_INSTALL_DIR\IC73\etc directory of the local computer
where Poller server is running.

Installation and Configuration March 2012 319


Chapter 9: Configuring Email Management

Converting root certificate from .CER format to .PEM format


You must convert the Root certificate to .PEM format
To convert certificate format
1. Run the Command Prompt.
2. Type the following command:
openssl x509 -in <certificatename.cer> -out
<certificatenewname.pem> -outform PEM
The certificatenewname must be in the form: host name.domain name.

Creating an email status


An agent can select an email status from a scrollable list in Avaya Web Agent. The agent
selects a status to resolve an email contact. You can use Mail Template Administration from IC
Manager to create the different types of email status that appear in the list.

! Important:
Important: You must create at least one email status of Dismiss and select the Messages
set to this status should be treated as answered check box for that status.
Email Management requires this Dismiss status when tasks are cancelled in IC
Web site Administration Tool. If you do not create a Dismiss status, and a task is
cancelled from IC Website Administration Tool, the IC Email server server
generates an alarm.
For more information on how to create an email status, see Interaction Center Administration
Guide.
To create an email status
1. In IC Manager, select Services > Mail Template Administration.
If prompted, log in to Email Template Administration with the same login ID and password
that you used for IC Manager.
2. Click New.
3. Select New Status.
4. In the New Status Properties dialog box, complete the following fields:
a. Type a name for the status in the Name field.
This text is displayed on the list of statuses available to agents in Avaya Agent.

320 Installation and Configuration March 2012


Configuring Avaya Content Analyzer (optional)

b. Check the boxes shown in the following table, if desired:

Check box Recommended entry

Messages set to this status Check this box if the status indicates a
should be treated as resolution of the issue that requires no
answered further action by the agent.
Send template for this status Check this box if you want to send an
auto-response message to the user when
an agent assigns this status to a
message. Choose a template to send. If
you do not know the location of the
template, select Browse and navigate to
the desired template.

5. Click Ok to close the Status Properties dialog box.

Configuring Avaya Content Analyzer (optional)


The IC server installation automatically installs Content Analyzer files on the server system. For
more information, see Installing IC server and administration components on page 28.
Before you can configure and use Content Analyzer, you must create and configure the Content
Analyzer servers.
To configure Content Analyzer, perform the steps in the following topics:
1. Creating the Administrative Content Analyzer server on page 321.
2. Creating the Operations Content Analyzer server on page 323.
3. Adding a Knowledge Base on page 324.
For more detailed information about Content Analyzer, see:
l Avaya IC Workflow Designer User Guide for an overview of Content Analyzer and
information about how to customize workflows for Content Analyzer
l Interaction Center Administration Guide to administer Content Analyzer, including how to
set up and maintain Knowledge Bases and how to train Content Analyzer

Creating the Administrative Content Analyzer server


For more information about the Administrative Content Analyzer server, see Interaction Center
Administration Guide.

Installation and Configuration March 2012 321


Chapter 9: Configuring Email Management

To create the Administrative Content Analyzer server:


1. In IC Manager, select Server > New.
2. From the list of servers, select CAAdmin and click Ok.
3. On the General tab enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

Name CAADmin_<domain> Include the domain in the server name


to identify the server.
Domain Select the IC domain for the This server should be in the same
server from the drop-down domain as the IC Email server.
list. For example, select Email from the
drop-down list if the server is in the
Email domain.
Host Select the IP address of the When you select the host, IC Manager
system from the drop-down fills in the fields for Directory, Port, and
list, or enter the IP address if Executable.
it is not in the list.

4. Click the CAAdmin tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry Notes

IC Data Select the Interaction Select the default name:


Source Center Data Source. interaction_center.
Path to Enter the location of the Windows:
NLP Data NLP data. IC_INSTALL_DIR\IC73\oem\banter\
nlpdata
Solaris:
IC_INSTALL_DIR/IC73/oem/banter/
NLPData/
AIX:
IC_INSTALL_DIR/IC73/oem/banter/
NLPData/

5. Click Ok.
6. Start the Administrative Content Analyzer server.

322 Installation and Configuration March 2012


Configuring Avaya Content Analyzer (optional)

Creating the Operations Content Analyzer server


For more information about the Operations Content Analyzer server, see Interaction Center
Administration Guide.
Note:
Note: Do not start the Operations Content Analyzer server. You must configure at least
one trained and validated Knowledge Base before you start this server.
To create the Operations Content Analyzer server:
1. In IC Manager, select Server > New.
2. From the list of servers, select CAServer and click Ok.
3. On the General tab enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

Name OperationCA_<domain> Include the domain in the server


name to identify the server.
Domain Select the IC domain for the This server should be in the same
server from the drop-down domain as the IC Email server.
list. For example, select Email from the
drop-down list if the server is in the
Email domain.
Host Select the IP address of the When you select the host, IC
system from the drop-down Manager fills in the fields for
list, or enter the IP address if Directory, Port, and Executable.
it is not in the list.

Installation and Configuration March 2012 323


Chapter 9: Configuring Email Management

4. Click the CA Server tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry Notes

IC Data Select the Interaction Select the default name:


Source Center Data Source. interaction_center.
Path to Enter the location of the Windows:
NLP Data NLP data. IC_INSTALL_DIR\IC73\oem\banter\
nlpdata
Solaris:
IC_INSTALL_DIR/IC73/oem/banter/
NLPData/
AIX:
IC_INSTALL_DIR/IC73/oem/banter/
NLPData/
Knowledge Select the Knowledge Click the button to display the Knowledge
Base Base associated with Base dialog box. For more information, see
this server. Adding a Knowledge Base on page 324.

5. Click OK.

Adding a Knowledge Base


Before you add a Knowledge Base to your Operations Content Analyzer server, perform the
following steps in the Content Analyzer Administration tab:
1. Create the Knowledge Base.
2. Train the Knowledge Base.
3. Validate the Knowledge Base.
4. Save the trained and validated Knowledge Base.
For detailed information on how to perform these steps, see Interaction Center Administration
Guide.
You need the following information about the Knowledge Bases before you add them to the
Operations Content Analyzer server:
l Name
l Knowledge Base file location
l Threshold
l Language codes

324 Installation and Configuration March 2012


Configuring Avaya Content Analyzer (optional)

In IC Manager, the information for all the saved Knowledge Bases is available. You can find this
information in the KB Management pane of the Content Analysis window.
To add a Knowledge Base to the Operations Content Analyzer server
1. In IC Manager, select Server >New.
2. In the list of servers, double-click the operational CAServer.
3. In the Server Editor dialog box, click the CAServer tab.
4. Click the Ellipsis (…) button next to Knowledge Base.
5. In the Knowledge Base dialog box:
a. Click New.
b. Type the name of the Knowledge Base in the Name column.
This name must be the same as the name of the Knowledge Base in the KB Name
column of the KB Management pane in the Content Analysis window.
c. Type the directory path to the Knowledge Base in the KB File Location column.
This path must be the same as the path in the File Path column of the KB
Management pane in the Content Analysis window.
If the Administrative Content Analyzer server and the Operations Content Analyzer
server are hosted on the same physical system, this path must match the File Path
column of the KB Management pane in the Content Analysis window.
If the Administrative Content Analyzer server and the Operations Content Analyzer
server are hosted on different physical systems, make sure that this file path accesses
the same Knowledge Base as the one pointed to by the File Path column of the KB
Management pane in the Content Analysis window.
d. Type a threshold in the Threshold column, if required.
You can leave this column blank or type the same threshold that you specified when
you validated the Knowledge Base.
e. Click the Ellipsis (…) button in the Languages column.
6. In the Languages dialog box:
a. Click New.
b. Type a language code.
Repeat Steps a and b for each language code you want to add. All available language
codes are in the Languages column of the KB Management pane in the Content
Analysis window. The language codes are listed in a single string, separated by
semicolons.
c. Click Ok.
7. Click Ok in the Knowledge Base dialog box.
8. Click Ok in the CAServer tab.

Installation and Configuration March 2012 325


Chapter 9: Configuring Email Management

326 Installation and Configuration March 2012


Chapter 10: Configuring agent accounts

You must create and configure IC accounts for all agents who will use Avaya Agent, Avaya
Agent Web Client, or a custom application developed using Client SDK.
After you create the agent accounts, you also need to configure the:
l Unified Agent Directory for agents who work with Avaya Agent
l Address Book for agents who work with Avaya Agent Web Client
l Address Book agents who work with custom applications created using Client SDK
The Unified Agent Directory and the Address Book allow agents to interact with other agents in
the IC system.

Tip:
Tip: This section includes basic information about how to create test agents for a
development IC system. A customized system or a production system may
require that you configure additional properties. For more information about agent
properties that you can configure for agent accounts, see Interaction Center
Administration Guide.
This section includes the following topics:
1. Required permissions for agents on page 328
2. Cautions and tips for creating agent accounts on page 329
3. Creating an agent account on page 331
4. Setting agent properties on page 337
5. Configuring agents for Avaya Agent on page 339
6. Configuring agents for Avaya Agent Web Client on page 343
7. Creating agents for a Client SDK custom application on page 345
8. Configuring a Workflow server for transfers and conferences on page 347

Installation and Configuration March 2012 327


Chapter 10: Configuring agent accounts

Required permissions for agents


Agents can run IC agent desktop applications on their desktops with limited permissions over
certain directories. Agents do not require administrator privileges.
Note:
Note: If two different versions of Agent co-exist (for example, IC Agent 7.1 and IC Agent
7.3) on the same system, Agents should have the privilege of reading from and
writing into Windows Registry. Agents should also have the privilege of running
regedit.exe in silent mode.
The following table describes the permissions and allowable restrictions on IC directories for
agent desktop applications.

Directory Required permissions Allowable restrictions

IC_INSTALL_DIR\IC73\bin Modify permissions Delete


(includes Read, Write, Execute)
IC_INSTALL_DIR\IC73\etc Modify permissions
(includes Read, Write, Delete,
Execute)
IC_INSTALL_DIR\IC73\apps Modify permissions
(includes Read, Write, Delete,
Execute)
IC_INSTALL_DIR\IC73\logs Modify permissions
(includes Read, Write, Delete,
Execute)

Note:
Note: In Windows 7, before running the qui.exe, ensure that the Run as
Administrator option under compatibility mode for the qui.exe is unchecked.

328 Installation and Configuration March 2012


Cautions and tips for creating agent accounts

Cautions and tips for creating agent accounts


You must create an account in IC Manager for each agent, supervisor, and other employees
who need to use IC. Each user account requires that you configure permissions, media
channels, and other requirements.
This section contains information about creating agent and other user accounts for testing,
including the minimal permissions and configuration settings. For more information, see
Interaction Center Administration Guide.
This section also includes some important cautions and tips that you need to consider when you
create agents for your IC system. For more information, see Interaction Center Administration
Guide.
This section includes the following topics:
l Agent domains on page 329.
l Agent workgroups and tenants on page 329.
l Agent login IDs on page 330.
l Agent password requirements on page 330.

Agent domains
All IC agent accounts must belong to a User domain. You must create all User domains before
you create your agents. If you have created agents first, you must assign all agents to the
Default domain, and then create the User domains and reassign the agents.
If your User domain does not include a secondary ORB server, the domain must failover to a
domain that includes an ORB server, such as the Default domain.

Agent workgroups and tenants


Organize your agent population into sets of tenants and workgroups that mirror the organization
of your contact center.
A tenant is a set of workgroups that fulfill a particular business function. You can use tenants to
define the security and administrative boundaries around data, queues, and content resources.
A workgroup is a set of agents or queues that form a logical grouping. A workgroup can only
belong to one tenant. However, you can share agents across tenants by assigning them to
multiple workgroups. To use workgroups, create workgroups and tenants before you create
agents.

Installation and Configuration March 2012 329


Chapter 10: Configuring agent accounts

Tenants, workgroups, and agents inherit properties from parent to child entities. By default, if
you assign a property value to a tenant, the workgroups in that tenant inherit that property value
from the tenant, and the agents in the workgroups inherit the property value from the
workgroups. When you assign agents to workgroups, and workgroups to tenants, you can
specify the order of inheritance. The inheritance order controls which property value IC
Manager uses for an agent if an entity inherits multiple values for the same property.

Agent login IDs


Each agent must have a unique login ID.
If an agent or supervisor needs to monitor multiple IC devices, the agent or supervisor must
have a unique IC login ID for each device.
IC does not support simultaneous logins with the same login ID.

! Important:
Important: Simultaneous logins with the same login ID can cause serious issues with the
performance of IC.
IC does not support:
l Two agents logging in with the same login ID.
l One agent simultaneously logging in to more than one computer with the same login ID.
l One agent simultaneously logging in to more than one IC desktop application with the
same login ID.

Agent password requirements


To prevent unauthorized access to IC, agents are assigned passwords that are required when
they log into IC.

Tip:
Tip: Password requirements (such as the required length and duration) are controlled
by the properties in the Agent/Security section. For more information, see
Interaction Center Administration Guide.

330 Installation and Configuration March 2012


Creating an agent account

Creating an agent account


You must create at least one agent account to test the IC system and make sure that all
features and media channels function correctly. When you create your production system, you
must create an IC agent account for each agent who will work with an IC agent application.

Tip:
Tip: Create at least one agent in each User domain. Configure these agents to handle
all applicable media channels.
The procedures in this section contain information on how to set basic properties for agent
accounts, so you can test your system. If you want to set additional properties for your test
agents, see Interaction Center Administration Guide.
To create an agent, perform the tasks in the following topics:
1. Creating an agent account on page 331.
2. Configuring an agent for media channels on page 335.
After you create an agent account, you must configure the agent properties, as described in
Setting agent properties on page 337.

Creating an agent account


This procedure assumes that you will create the agent account in the Default tenant.
To create an agent account
1. In IC Manager, click the Agent tab.
2. In the left pane, expand the DefaultTenant node and select a tenant in that.
If you want to create an agent account in a different tenant, select that tanent node in the
left pane.
3. Select Agent > New.
4. Click the General tab and enter the information for the fields mentioned in the following
table:

Field Description

First Name Required field


Type agent’s first name.
Last Name Required field
Type agent’s last name.

Installation and Configuration March 2012 331


Chapter 10: Configuring agent accounts

Field Description

Preferred Name Required field


Type agent’s preferred name.
Employee ID Type the agent’s company employee ID (if available).
Domain Required field
Select domain for the agent from the list.
Note: If the agent will handle chat contacts, the agent
domain must failover to the domain that includes the
Paging server.
Site Select a site from the drop-down list.
Note: IC uses the Site to compile statistics for groups,
agents, or queues.

5. In the System Information group of the General tab, enter the information for the fields
mentioned in the following table:

Field Description

Login ID Required field


Type a login ID that the agent uses for all IC applications.
Each agent account must have a separate and unique
login ID. For more information, see Agent login IDs on
page 330.
Options 1. Click the Ellipsis (…) button next to Options.
2. Select the User Addressable check box to make the
agents visible for transfers.
3. Click OK.

332 Installation and Configuration March 2012


Creating an agent account

Field Description

Task Load Required field


Set this field to less than or equal to 6 concurrent tasks.
Use the arrow keys to set the maximum number of
contacts that an agent can handle concurrently. These
contacts can come from any of the media channels used
by the agent.
For example, if you plan to configure the test agent to
use Email and Voice media channels, and to set the task
load on Email to 2 and the task load on Voice to 1, set
this Task Load property to 3.
Task Ceiling Required field.
The Task Ceiling is an upper limit on the Task Load.
Use the arrow keys to set the limit of the task load across
all of the media channels. The task load must be less
than or equal to the task ceiling.
Note: The Task Load can vary according to your
system conditions, such as number of tasks, agents,
or time of day.

6. In the Membership Information group of the General tab, enter the information for the
fields mentioned in the following table:

Field Recommended entry

Domain Required field


Select your User domain from the drop-down list.
Workgroup 1. Click the Ellipsis (…) button next to Workgroup.
2. Expand the DefaultTenant node in the Workgroups list.
3. Select the Default workgroup.
4. Click >> to add the agent to the Default workgroup.
5. Click OK.
Note: Agents can belong to more than one workgroup.
Agents who work with chat contacts or email contacts must
have the Default workgroup as their primary workgroup.
Site Select a site from the drop-down list.
Note: IC uses the Site to compile statistics for groups or
agents or queues.

Installation and Configuration March 2012 333


Chapter 10: Configuring agent accounts

Tip:
Tip: If you want this agent to be a Supervisor who can monitor chats between other
agents and customers, configure this agent as the Supervisor for the Workgroup.
7. Click the Email tab in the center of the General tab, and enter the information for the fields
mentioned in the following table:

Field Recommended entry

Primary Type the email address assigned to the agent by the contact
center. This address is configured at the mail server.
If you specify that the agent is user addressable on the System
tab, IC lists this email address for the agent in the Agent
Directory.
Internal Type the email address assigned to the agent for internal email
messages only. This address is not intended to be used outside
of the contact center.
Personal Type the email address assigned to the agent for personal,
non-business communication from the agent.
Mobile Device Type the email address assigned to the agent for use with their
mobile device.

8. Click Ok.
9. Click the Security tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry

Password Type the password that the agent uses to log in to IC


applications.
For example, type agent1.
Confirm Type the password a second time to confirm.
Roles Select one or more check boxes to select the agent’s security
level.

10. Click OK.

334 Installation and Configuration March 2012


Creating an agent account

Configuring an agent for media channels


When you set Task Load and Task Ceiling for the media channels, ensure that:
l The total of all Task Load values does not exceed the Task Load that you set for the agent
on the General tab.
l The total of all Task Ceiling values does not exceed the Task Ceiling set on the General
tab.

! Important:
Important: If you want an agent to handle Web Scheduled Callback contacts, you must
configure the agent to handle voice and chat contacts.
This section includes the following topics:
l Configuring an agent to handle chat contacts on page 335.
l Configuring an agent to handle email contacts on page 336.
l Configuring an agent to handle voice contacts on page 336.

Configuring an agent to handle chat contacts


If you want the agent to receive and handle Web Scheduled Callback contacts, you must also
configure the agent to handle voice contacts.

Tip:
Tip: This step continues from the previous step and assumes that the agent account
remains open in IC Manager.
To configure an agent to handle chat contacts
1. In IC Manager, click the Channels tab.
2. From the Channel drop-down list, select Chat.
3. Enter the information for the fields mentioned in the following table:

Field Recommended entry

Disable Chat Channel Clear this check box.


Task Load Set the maximum number of chat contacts an agent
can handle at one time.
Task Ceiling Set the maximum value for the chat Task Load.

4. Click Apply.

Installation and Configuration March 2012 335


Chapter 10: Configuring agent accounts

Configuring an agent to handle email contacts

Tip:
Tip: This step continues from the previous step and assumes that the agent account
remains open in IC Manager.
To configure an agent to receive handle email contacts
1. In IC Manager, click the Channels tab.
2. From the Channel drop-down list, select Email.
3. Enter the information for the fields mentioned in the following table:

Field Recommended entry

Disable Email Channel Clear this check box.


Show Full Headers Select this check box if you want the agent to see the
full header of each email contact.
From Address Type the email address that you want recipients to
see in emails from this agent.
Task Load Set the maximum number of email contacts an agent
can handle at one time.
Task Ceiling Set the maximum value for the email Task Load.

4. Configure the primary email address for the agent, as described in Creating an agent
account on page 331.
5. Click Apply.

Configuring an agent to handle voice contacts


If you want the agent to receive and handle Web Scheduled Callback contacts, you must also
configure the agent to handle chat contacts.

Tip:
Tip: This step continues from the previous step and assumes that the agent account
remains open in IC Manager.
To configure an agent to handle voice contacts
1. In IC Manager, click the Channels tab.
2. From the Channel drop-down list, select Voice.

336 Installation and Configuration March 2012


Setting agent properties

3. Enter the information for the fields mentioned in the following table:

Field Recommended entry

Disable Voice Channel Clear this check box.


Phone ID Type the logical extension number for the agent’s
phone. For example, type 34181.
Password Type the password for agent login to the ACD.
Phone Type Type the type of phone that the agent uses.
The switch requirement for agent login determines
the phone type. Some supported switches support
both phone types. Other supported switches only
support one phone type.
l Type EAS if the configuration controls the queue
structure. You can only type EAS for Avaya
DEFINITY/Communication Manager, or Aspect.
l Type ACD if the switch requires a queue. You can
type ACD for all supported switches.
Equipment Type the physical extension number for the agent’s
phone.
For example, type 24181.
Queue Type the default voice queue for this agent.
Task Load Set the maximum number of voice contacts an agent
can handle at one time.
Task Ceiling Set the maximum value for the voice Task Load.

4. Click Apply.

Setting agent properties


By default, IC provides default values for most agent properties. You can use these default
values to ensure that the agent applications function correctly.
As you customize the IC system, you may need to configure different values for these agent
properties. For example, you need to configure different values for the agent properties if you
want the agent desktop applications to include wrapup functionality. For information about the
agent properties or how to enable other features, see Interaction Center Administration Guide.
This section includes the following topics that describe how to set properties for agents:
l Setting global properties for all agents on page 338.

Installation and Configuration March 2012 337


Chapter 10: Configuring agent accounts

l Setting properties for individual agents and workgroups on page 338.

Setting global properties for all agents


The procedures in this topic assume that the property already exists in the property section. If a
property does not exist, click Add Property and select that property from the Assign Property
dialog box. For more information on adding properties to a property section, see Interaction
Center Administration Guide.
To set global properties that affect all agents in IC
1. In IC Manager, select Tools > Groups.
2. Click the Properties tab.
3. In the left pane, select the IC node.
4. In the Sections list, select the property section that includes the property you want to set.
5. In the right pane, double-click the property that you want to set.
6. In the Edit Property dialog box:
a. In the Property drop-down list, verify that the correct property is selected.
b. In the Property Value field, set the value for the property.
c. Clear the Descendants May Override check box.
d. Click OK.
7. Click Apply.
8. Click OK.

Setting properties for individual agents and workgroups


The procedures in this topic assume that the property already exists in the property section. If a
property does not exist, click Add Property and select that property from the Assign Property
dialog box. For more information on adding properties to a property section, see Interaction
Center Administration Guide.
To set properties for individual agents and workgroups:
1. In IC Manager, click the Agent tab.
2. Select the desired agent or workgroup:
l To select a workgroup, navigate to and select the desired workgroup in the left pane.
l To select an agent, navigate to the workgroup that includes the agent in the left pane,
then double-click the agent in the list of agents.

338 Installation and Configuration March 2012


Configuring agents for Avaya Agent

3. Click the Properties tab.


4. In the Sections list, select the desired property section.
5. In the right pane, double-click the property that you want to set.
6. In the Edit Property dialog box:
a. If necessary, select the property name from the Property Name drop-down list.
b. In the Property Value field, set the value for the property.
c. Clear the Descendants May Override check box.
d. Click OK.
7. Click Apply.
8. Click OK.

Configuring agents for Avaya Agent


For agents who will work in Avaya Agent, these agent properties ensure that Avaya Agent and
the Unified Agent Directory include the functions required by the agent. For example, you
specify which Avaya Agent layout the agent will use.
For information about properties that configure additional features available for agents who
work with Avaya Agent, including wrapup, see Interaction Center Administration Guide.
This section includes the following topics:
l Setting agent properties for Avaya Agent on page 340.
l Configuring agents for the Unified Agent Directory on page 341.

Installation and Configuration March 2012 339


Chapter 10: Configuring agent accounts

Setting agent properties for Avaya Agent


The agent properties that you must set for Avaya Agent include the Avaya Agent layout that an
agent will use and the home directory for agents who handle chat contacts and email contacts.
You can change some or all of these default values to ensure that the functionality available to
your agents matches the configuration of your Avaya IC system. Before you move to a
production environment, review these properties to determine whether you need to change any
of the default values. For more information about the additional agent properties, see Interaction
Center Administration Guide.

Configuring the agent layout property


By default the agent layout property is configured for the out-of-the-box, English Avaya Agent
layout. If the IC system includes a custom or non-English Avaya Agent layout, you must
configure the Agent/Desktop/Layout property for that layout.

Configuring the home directory property


The home directory property is always configured from the perspective of Avaya Agent. The
syntax that you use to configure the home directory property depends upon how the computer
that hosts Avaya Agent will access the directory. Since Avaya Agent is only supported on
Windows, the syntax for the home directory must be in a format that Windows can use to
access another network system.

! Important:
Important: Even if the home directory uses the same shared directory as the working
directory, you may need to use a different syntax for the home directory property.
For more information about the home directory property, including recommended deployments
of the home directory for Avaya Agent and the working directory of Avaya Agent Web Client,
see Interaction Center Administration Guide.
To configure the home directory:
1. If it does not already exist, create the shared directory for the home directory on a network
computer.
2. Ensure that all agent workstations that host Avaya Agent:
l Can access the shared directory for the home directory through either a mapped drive
or UNC notation in Windows Explorer.
l Have the required Read, Write, and Execute permissions for that directory

340 Installation and Configuration March 2012


Configuring agents for Avaya Agent

3. Configure the Agent/Desktop/WAC.HomeDir as described in Setting agent


properties on page 337.
The following table provides examples of the syntax used to configure the home directory
property. These examples use the AgentResource directory on a computer named
resource.xyzcorp.com as the shared directory.

Avaya Agent access to shared directory Syntax for home directory

You map the Z: drive on each agent Z:\AgentResource


workstation to the shared directory folder
hosted on a Windows network computer.
Note: Do not use this syntax if the shared
directory is on a UNIX computer.
Each agent workstation uses UNC notation in \\resource.xyzcorp.com\
Windows Explorer to access the shared AgentResource
directory.
Note: You can use this syntax if the shared
directory is on a Windows or UNIX
computer.

Configuring agents for the Unified Agent Directory


The Unified Agent Directory contains resources for your contact center, including:
l Queues
l Agents
l Supervisors
l Subject Matter Experts
l Non-human resources, such as Interactive Voice Response units (IVRs)
You must configure queues and agents as Addressable if you want them to be visible in the
Unified Agent Directory. For agents, set the ShowAgentsOnStartup property to be True to
display the Directory tab in the Unified Agent Directory. Agents use the Directory tab to view
individual agents in the contact center.
Agents can filter their view of the Unified Agent Directory to see only agents or queues that
meet specified criteria. You can change this setting to force agents to view all of the agents and
queues in your contact center, if desired.
For information on how to set other properties related to the Unified Agent Directory, see
Interaction Center Administration Guide. For information on how to use the Unified Agent
Directory, see Avaya Agent User’s Guide.

Installation and Configuration March 2012 341


Chapter 10: Configuring agent accounts

Note:
Note: You do not need to perform these steps if the IC system does not include Avaya
Agent.
The following table describes the properties that you need to set for agents to display in and use
the Unified Agent Directory. All properties for the Unified Agent Directory are in the Agent/
Desktop/Directory section.

Property Recommended entry Notes

ShowAgentsOnStartup Yes Adds the Directory Tab to the


Unified Agent Directory.
ShowAgentState Yes Displays agent’s state in the
Directory tree of the Unified Agent
Directory.
ShowAllAgents Yes Shows the entire Directory tree for
agents in the Unified Agent
Directory.
SkillsSupport Yes Lets agents use skills as search
criteria in the Unified Agent
Directory.
TransferFlowName Type the name of the workflow
that retrieves the destination
from the virtual queue.
WorkflowServerName Name of the Workflow server Use the Workflow server where
that runs the workflows for the you added the semaphore in
Unified Agent Directory. Configuring a Workflow server for
transfers and conferences on
page 347.
UADStringFormat Select the desired string Determines how agents are
format. displayed in the Unified Agent
Directory. When you choose a
string format, the Unified Agent
Directory displays the following
information in IC Manager:
l Standard string format
displays the Display Name for
an agent.
l ASCII string format displays
the Full Name for an agent.
l LoginID string format displays
the Login Name for an agent.

342 Installation and Configuration March 2012


Configuring agents for Avaya Agent Web Client

Configuring agents for Avaya Agent Web Client


The only agent property that you must set for Avaya Agent Web Client is the working directory
that an agent will use. IC Manager includes additional agent properties that have default values.
You can change some or all of these default values to ensure that the functionality available to
your agents matches the configuration of your IC system.
Before you move to a production environment, review the additional properties to determine
whether you need to change any of the default values. For more information about the
additional agent properties, see Interaction Center Administration Guide.

Tip:
Tip: You must also create a separate agent account for each Java Application Bridge
that communicates with Avaya Agent Web Client. For more information, see
Configuring an agent account for the Java Application Bridge on page 388.
This section includes the following topics:
l Configuring the working directory property on page 343.
l Configuring agents for the Address Book on page 344.

Configuring the working directory property


The working directory property is always configured from the perspective of Web Client
Connector. The syntax that you use to configure the working directory property depends upon
the operating system of the computer that hosts Web Client Connector for Avaya Agent Web
Client and how that computer will access the shared directory.
Even if the working directory uses the same shared directory as the home directory, you may
need to use a different syntax to configure the working directory property.
For more information about the home directory property, including recommended deployments
of the working directory of Avaya Agent Web Client and the home directory for Avaya Agent,
see Interaction Center Administration Guide.

! CAUTION:
CAUTION: If you do not use a valid directory path when you configure the working directory,
Avaya Agent Web Client will not function properly. Avaya Agent Web Client
displays an error message on the Status Bar, and the chat and email channels
will be disabled.
To configure the working directory
1. If it does not already exist, create the shared directory for the working directory on a
network system.

Installation and Configuration March 2012 343


Chapter 10: Configuring agent accounts

2. Ensure that all computers that host Web Client Connector for Avaya Agent Web Client:
l Can access the shared directory for the working directory through one of the following
methods:
- For a Windows computer: a mapped drive or UNC notation in Windows Explorer
- For a UNIX computer, an NFS mount for the shared directory
l Have the required Read, Write, and Execute permissions for that directory
3. Configure the Agent/Desktop/WebClient.WorkingDirectory as described in
Setting agent properties on page 337.
The examples in the following table use the AgentResource directory on a computer
named resource.xyzcorp.com as the shared directory.

Web Client Connector access to shared Syntax for working directory


directory

You map the Z: drive on the Web Client Z:\AgentResource


Connector computer to the shared directory
folder hosted on a Windows network computer.
Note: Do not use this syntax if Web Client
Connector is on a UNIX computer.
The Web Client Connector computer uses \\resource.xyzcorp.com\
UNC notation in Windows Explorer to access AgentResource
the shared directory.
Note: Do not use this syntax if Web Client
Connector is on a UNIX computer.
You perform an NFS mount for the shared /opt/AgentResource
directory on the Web Client Connector
computer.
Note: Do not use this syntax if Web Client
Connector is on a Windows computer.

Configuring agents for the Address Book


You do not need to configure any agent properties for the Address Book to work in Avaya Agent
Web Client. However, if you want an agent to be visible in the Address Book, you must also
configure the agent for the Address Book.
To configure agents for the Address Book in Avaya Agent Web Client
1. Enable the User Addressable field in the System Information group of the General tab
for each agent who:
l Will work in Avaya Agent Web Client

344 Installation and Configuration March 2012


Creating agents for a Client SDK custom application

l Must be visible in the Address Book


For more information on how to enable the User Addressable field, see Options in
Creating an agent account on page 331.
2. Configure the primary email address for each agent who:
l Will need to receive emails in Avaya Agent Web Client or from agents who work in
Avaya Agent Web Client
l Must be visible in the Address Book
For more information, see Step 7 of Creating an agent account on page 331.

Creating agents for a Client SDK custom application


The only agent property that you must set for a custom application developed with the Client
SDK is the working directory that an agent will use. IC Manager includes additional agent
properties that have default values. You can change some or all of these default values to
ensure that the functionality available to your agents matches the configuration of your IC
system.
Before you move to a production environment, review the additional properties to determine
whether you need to change any of the default values. For more information about the
additional agent properties, see Interaction Center Administration Guide.

Tip:
Tip: You must also create a separate agent account for each Java Application Bridge
that communicates with the Client SDK server. For more information, see
Creating an agent account for the Java Application Bridge on page 412.
This section includes the following topics:
l Configuring the working directory property on page 343.
l Configuring agents for the Address Book on page 344.

Configuring the working directory property


The working directory property is always configured from the perspective of Tomcat. The syntax
that you use to configure the working directory property depends upon the operating system of
the system that hosts Tomcat for the Client SDK server and how that system will access the
shared directory.

Installation and Configuration March 2012 345


Chapter 10: Configuring agent accounts

Even if the working directory uses the same shared directory as the home directory, you may
need to use a different syntax to configure the working directory property.
For more information about the working directory property, including recommended
deployments, see Interaction Center Administration Guide.

! CAUTION:
CAUTION: If you do not use a valid directory path when you configure the working directory,
your custom application will not function properly. You should configure your
custom application to display an error message on the Status Bar and to disable
the chat and email channels.
To configure the working directory
1. If it does not already exist, create the shared directory for the working directory on a
network computer.
2. Ensure that all computers that host Tomcat for the Client SDK:
l Can access the shared directory for the working directory through one of the following
methods:
- For a Windows computer: a mapped drive or UNC notation in Windows Explorer
- For a UNIX computer, an NFS mount for the shared directory
l Have the required Read, Write, and Execute permissions for that directory
3. Configure the Agent/Desktop/WebClient.WorkingDirectory.
The following table provides examples of the syntax used to configure the working
directory property. These examples use the AgentResource directory on a computer
named resource.xyzcorp.com as the shared directory.

Tomcat access to shared directory Syntax for working directory

You map the Z: drive on the Tomcat system to Z:\AgentResource


the shared directory folder hosted on a
Windows network computer.
Note: Do not use this syntax if Tomcat is on
a UNIX computer.
The Tomcat computer uses UNC notation in \\resource.xyzcorp.com\
Windows Explorer to access the shared AgentResource
directory.
Note: Do not use this syntax if Tomcat is on
a UNIX computer.
You perform an NFS mount for the shared /opt/AgentResource
directory on the Tomcat computer.
Note: Do not use this syntax if Tomcat is on
a Windows computer.

346 Installation and Configuration March 2012


Configuring a Workflow server for transfers and conferences

Configuring agents for the Address Book


You do not need to configure any agent properties for the Address Book to work in your custom
application. However, if you want an agent to be visible in the Address Book of your custom
application, you must also configure that agent for the Address Book.
To configure agents for the Address Book in your custom application:
1. Enable the User Addressable field in the System Information group of the General tab
for each agent who:
l Will work in your custom application
l Must be visible in the Address Book
For more information on how to enable the User Addressable field, see Creating an agent
account on page 331.
2. Configure the primary email address for each agent who:
l Will need to receive emails in your custom application or from agents who work in your
custom application
l Must be visible in the Address Book
For more information, see Interaction Center Administration Guide.

Configuring a Workflow server for transfers and


conferences
For agents to be able to transfer or conference voice contacts and chat contacts to virtual
queues, you must configure every Workflow server in a user domain for transfers and
conferences. Without this configuration, agents will not be able to transfer contacts to queues
and may encounter problems with transfers to and conferences with agents.
All IC systems require Workflow servers in User domains to handle agent transfers and
conferences. You must perform these steps if the IC system includes Avaya Agent or Avaya
Agent Web Client.
This section includes the following topics:
l Required configuration parameters on page 348.
l Working with transfer workflows on page 348.
l Configuring a Workflow server on page 348.

Installation and Configuration March 2012 347


Chapter 10: Configuring agent accounts

Required configuration parameters


The following table describes the required configuration parameters for Workflow servers that
handle agent transfers and conferences.

Configuration parameter Value

Semaphore agentsearch.update_searchresult
Synchronous Startup Flow sys_transfer.update_vq_cache
Startup Flow sys_agentsearch.update_agentstate_cache

Working with transfer workflows


The IC seed data includes these workflows. When you created the CCQ database, you
imported the compiled workflows with the seed data and stored them in the database. However,
you must still associate these workflows with the Workflow server.

Configuring a Workflow server


If your IC system includes multiple Workflow servers, perform these steps on every Workflow
server in a user domain and every Workflow server that handles agent searches and transfers
between agents.

! Important:
Important: If you create a new virtual queue or queue for agent transfers, you must do one of
the following for every Workflow server in a user domains that runs workflows for
the Unified Agent Directory:
- Manually run the sys_transfer.update_vq_cache workflow
- Restart each Workflow server
To configure the Workflow server for agent transfers and conferences
1. In the Server tab of IC Manager, double-click a Workflow server in a user domain.
2. Click the Workflow tab.
3. Confirm that the Workflow server includes the following required semaphore:
agentsearch.update_searchresult
a. Click the Ellipsis (…) button next to Semaphores.

348 Installation and Configuration March 2012


Configuring a Workflow server for transfers and conferences

b. If the rows do not include the required semaphore:


l Click New.
l In the new row, type agentsearch.update_searchresult
l Click Ok.
4. Confirm that the Workflow server includes the required synchronous startup flows:
a. Click the Ellipsis (…) button next to Synchronous Startup Flows.
b. Verify that the rows include the following required synchronous startup flows:
l sys_transfer.update_vq_cache
l sys_transfer.transfertovq
If the rows do not include either or both of those required flows, click New and add the
missing flow.
5. Confirm that the Workflow server includes the following required startup flow:
a. Click the Ellipsis (…) button next to Startup Flows.
b. If the rows do not include the following required startup flow:
sys_agentsearch.update_agentstate_cache
l Click New.
l In the new row, type sys_agentsearch.update_agentstate_cache.
l Click Ok.
6. Click Ok.
7. Stop and restart the Workflow server.
Repeat these steps for every Workflow server in a user domain.

Installation and Configuration March 2012 349


Chapter 10: Configuring agent accounts

350 Installation and Configuration March 2012


Chapter 11: Deploying Avaya Agent

Perform the steps in the following topics to deploy Avaya Agent:


1. Required privileges for the agent installer on page 351.
2. Creating installation files for agent applications on page 351.
3. Preparing for installation by agents on page 357.
4. Configuring WebAgent on page 359
5. Configuring the Citrix integration on page 368.

! Important:
Important: Read the IC Readme file and Avaya IC Installation Planning and Prerequisites
before you install Avaya Agent.

Required privileges for the agent installer


All IC users who create agent installers and who install or configure IC components require an
Administrator login or a login with administrator privileges.

Creating installation files for agent applications


To create installation files for agent applications, perform the steps in the following topics:
1. Cautions and tips for installation files on page 352
2. Required information for the Agent Site Preparation wizard on page 354.
3. Running the Avaya Agent site preparation wizard on page 355.
4. Copying the server implementation file on page 356.

Installation and Configuration March 2012 351


Chapter 11: Deploying Avaya Agent

Cautions and tips for installation files


Before you run the Agent Site Preparation wizard, note the cautions and tips in the following
topics:
l Disabling firewalls on page 352.
l Stopping agent desktop applications on page 352.
l Installation path for agent desktop applications on page 353.
l Size of agent installer directory on page 353.
l Installer directory availability on page 353.
l Location for Avaya Agent installation on page 353.
l Size of Avaya Agent installation directory on page 353.
l Solaris system on page 353.
l AIX system on page 353

Disabling firewalls
If the system where you want to install Avaya Agent has a personal or desktop firewall, you
need to disable the firewall before you start the installation. You can re-enable the firewall after
the installation is complete.

Stopping agent desktop applications


Before you or an agent runs the Agent Installer on an agent desktop system, confirm that there
are no IC agent desktop applications or qui.exe processes running on the agent desktop
system. The Agent Installer may stop responding or pause indefinitely if an agent desktop or
qui.exe process is still running.

Configuring Internet Explorer on agent workstations


Set the following internet options in Internet Explorer for all agents who will handle chat
contacts:
l Security level: Medium if agents use Windows XP, Windows Vista, and Windows 7.
l ActiveX controls: allow to run.
l Trusted sites: add the URL of the Website server to the Trusted Sites list.

352 Installation and Configuration March 2012


Creating installation files for agent applications

Installation path for agent desktop applications


The agent installer automatically adds the following to the installation path for agent desktop
applications: \apps\<application_name>
When you specify the initial section for the installation path, do not include any duplication of the
directories. If you include a duplicate directory, the -d parameter in the shortcut cannot find the
working directory for the applications.
For example, if you specify C:\apps as the installation path for agent desktop applications, the
-d parameter cannot locate the apps directory, as it is duplicated in the installation path of C:\
apps\Avaya\IC73\apps\interaction_center

Size of agent installer directory


Select a network share with at least 110MB of available disk space for each agent installer
directory.

Installer directory availability


Make sure that the network system is online when you run the Agent Site Preparation wizard.

Location for Avaya Agent installation


Select the directory path for the Avaya Agent installation on the desk top systems.

Size of Avaya Agent installation directory


Make sure that the agent desktop systems have at least 350 MB of available disk space.
Approximately 220 MB of the required available space must be in a temp directory. The agent
installer deletes the files in the temp directory when you reboot the agent desktop system.

Solaris system
If you plan to host the agent installer on a Solaris system, you must:
1. Run the Agent Site Preparation wizard on a Windows system.
2. Transfer the files to a Samba share on the Solaris system.

AIX system
If you plan to host the agent installer on a AIX system, you must:
1. Run the Agent Site Preparation wizard on a Windows system.
2. Transfer the files to a Samba share on the AIX system.

Installation and Configuration March 2012 353


Chapter 11: Deploying Avaya Agent

Required information for the Agent Site Preparation wizard


Before you complete the required information, you must know how many different agent
configurations your contact center requires. If you must create multiple agent configurations,
you must run the Agent Site Preparation wizard for each configuration.
You must plan your agent desktop configuration before you run the Agent Site Preparation
wizard. The tables in each section provide examples of the kind of planning and information that
you must complete before you run the Agent Site Preparation wizard. You can fill out your
configuration information in these tables, or create similar tables of your own.

Path for agent installers: The path for agent installers specifies the directory path for the
folder where you place the agent installer and configuration data for each agent configuration.
The default directory is: C:\Avaya\IC73\AgentInstaller. You can copy the installation
files to another location, such as a Web server, after you create the agent installer.
By default, the Agent Site Preparation Wizard places the agent installer in a directory path that
includes IC73 to ensure that you do not overwrite an earlier version of the agent installer. The
default directory path is C:\Avaya\IC73\AgentInstaller.

Directory on agent desktop: The directory on the agent desktop specifies where the agent
installer will install Avaya Agent. Use a drive and directory that is valid on all agent desktop
systems. The agent installer will present this directory to all agents during the installation. If
desired, you can let agents override the default installation directory and select their own
installation directory.
By default, the agent installer places the agent desktop applications in a directory path that
includes IC73 to ensure that the agent applications are correctly updated.
For example, the default directory and path for installing agent desktop applications is: C:\
Avaya\IC73\.

Applications to be installed: Most Avaya Agent installations use Interaction Center as the
agent application to include in each agent configuration.

Telephony switch type: If your IC system includes Telephony, you must know the type of
telephony switch used by the agents who will use the version of Avaya Agent installed by this
agent installer.

354 Installation and Configuration March 2012


Creating installation files for agent applications

Running the Avaya Agent site preparation wizard


Repeat this entire procedure for each Avaya Agent configuration in the IC system.
To run the Avaya Agent site preparation wizard:
1. Insert IC Release 7.3 CD/DVD-ROM 4.
The IC installer starts automatically. If you disabled Autorun on the system, navigate to the
Servers directory on the CD/DVD-ROM and run setup.exe.
2. When the IC installer opens, read the entire IC license agreement carefully, then accept
the terms of the agreement. Select Next, then follow the prompts in the installer.
The IC installer exits if you do not agree to the terms of the agreement.
3. In the product installation screen, select Avaya Rich Client Preparation Wizard 7.3.
Select Next, then follow the prompts in the installer.
4. In the Avaya Agent installation folder screen:
a. Accept the default or type the path to the directory where the agent installer will install
the application files on each agent desktop.
b. Select one of the options in the following table:

Option Description

Yes, allow agents to choose Allows agents to decide where to install Avaya
an alternate folder Agent.
No, always use the Does not allow agents to decide where to install
pre-defined folder Avaya Agent.
If you select this option, Avaya Agent will always be
installed in the same folder on the agent desktop.

Note:
Note: Do not use apps in the installation path for agent desktop applications. If you do,
the -d parameter cannot locate the apps directory and start the application.
c. Click Next.
5. In the applications screen:
a. Select the following application for agents who use this configuration:
l interaction_center
If you plan to use Avaya Agent only, select interaction_center.

Installation and Configuration March 2012 355


Chapter 11: Deploying Avaya Agent

b. Select one of the options in the following table:

Option Purpose

Yes, allow Avaya Agent to To have Avaya Agent automatically


perform updates automatically check for and apply updates each
time an agent logs in.
No, updates will be done To require agents to apply updates
manually manually when you notify them that an
update is available.

c. Select Next.
6. In the telephony switch window, select the type of phone switch to use with Avaya Agent.
If this configuration does not include Telephony, select None.
7. Select Finish to complete the agent installer.

Copying the server implementation file


The agent installer requires access to the vesp.imp server implementation file from the system
that hosts the primary ORB server. You must copy this file to a location where the agent installer
has access.
To copy the server implementation file.
1. Navigate to the following directory where the vesp.imp file is located:
IC_INSTALL_DIR\IC73\etc
2. Copy the vesp.imp file to the following directory on the system that hosts the agent
installer:
IC_INSTALL_DIR\IC73\AgentInstaller\config
Note:
Note: Do not copy the vesp.imp file to the IC_INSTALL_DIR\IC73\bin directory.
The vesp.imp file cannot function properly from this directory.

356 Installation and Configuration March 2012


Preparing for installation by agents

Preparing for installation by agents


As you complete these procedures, refer to the following table for the directories and files in the
Avaya Agent installer directory.

Directory Contents

<agent_installdir>\config This directory contains the files that agents install to


update Avaya Agent.
<agent_installdir>\update This directory contains updates that you make
available to the agent applications.
<agent_installdir>\install.exe The executable that runs the installation of an agent
configuration on the agent desktop.

To prepare an agent installer for installation by agents, perform the steps in the following topics:
1. Testing the agent installer on page 357.
2. Creating installation instructions for agents on page 358.

Testing the agent installer


You must test the agent installer to make sure that:
l The agent installer works properly.
l The correct installation options are available for agents when they install the agent
configuration.
l The agents can access the agent installer through a shared network drive.
Note:
Note: Before you install IC agent applications, configure all agent workstations with
restore points. The agent installer replaces some system files during the
installation. If software conflicts arise, restore points allow easy rollback after you
uninstall IC. See the Windows documentation or third-party guides for procedures
on enabling such functionality.

Installation and Configuration March 2012 357


Chapter 11: Deploying Avaya Agent

If you placed the agent installer on a shared network drive, agents can copy the folders to their
systems, or run the agent installer across the network.
If the agents will run the agent installer across the network, they must be able to access the
shared network drive from their systems. Agents cannot use the Run dialog box on the Start
menu to run the agent installer.
To test the agent installer:
1. Close down all Windows applications.
2. Use Windows Explorer to navigate to the folder, then right-click install.exe, and select
Run as Administrator.
3. When the Avaya Agent installer opens, read the entire IC license agreement carefully, then
accept the terms of the agreement: Select Next, then follow the prompts in the installer.
The Avaya Agent installer exits if you do not agree to the terms of the agreement.
Note:
Note: The following error message can occur:
You must use "Turn Windows features on or Off" in the Control Panel to install
or configure Microsoft .Net Framework 3.0 x86.
Click Ok on the message window to proceed further.
Note:
Note: The Visual C++ Redistributable Installation dialog box appears. Click Yes to
install the Visual C++ runtime libraries. VCRedist is a Microsoft re-distributable
package ‘Visual C++ 2005 SP1(MFC security update)’ that installs Visual C++
runtime libraries required to run IC. If Visual C++ 2005 SP1 or a later is already
installed by another application, this installation can be skipped. Click No to skip
VCRedist package installation.
4. After the Avaya Agent installer completes:
a. Select Yes, restart my computer.
b. Select Finish.
After the system reboots, the installer registers all necessary DLLs and OCXs.

Creating installation instructions for agents


Follow these steps to send the URL or directory path and other instructions to all agents who
must install a specific agent configuration.
Create instructions for agents that include the following:
l Directory path to the network drive.
l Instructions to close all applications before starting the installation.

358 Installation and Configuration March 2012


Configuring WebAgent

l Any other special instructions, such as whether they can select their own installation
directory.
l The name of a person to contact if they have problems.

Configuring WebAgent
You can configure the WebAgent by specifying the values for different parameters in the
Application.properties file. You can find the Application.properties file in the
home directory that you have specified in IC Manager.
This section contains the following:
l Locating Application.properties file on page 359
l HTML Editor configuration for Rich Client on page 360
l Configure converting email message to an attachment on page 362
l Configure auto flush on page 362
l Configure number of attachments to be displayed without scrollbar on page 362
l Configure the default location for saving attachment on page 363
l Configure Default Sorting on page 364
l Configure UTF-8 Encoding on page 364
l Configure viewing E-mail templates on page 364

Locating Application.properties file


You can create the Application.properties file in the home directory and specify the location of
that file in the HomeDir property in IC Manager.
Note:
Note: You must create the Application.properties file in the home directory, if it does
not exist.
To specify the location Application.properties file in IC Manager
1. In IC Manager, select Tools > Groups.
2. In the left pane, select IC.
3. In the right pane, click the Properties tab.
4. In the Sections list, select Agent/Desktop/WAC.
5. Edit the HomeDir property to specify the home directory location.

Installation and Configuration March 2012 359


Chapter 11: Deploying Avaya Agent

HTML Editor configuration for Rich Client


When you install IC Rich Client, a new folder "..\IC73\WebAgent\editlive" is created. This folder
will contain the following xml configuration files:
l NewOutboundEmail.xml
l PreviewEmailConfig.xml
l ReplyForwardEmailConfig.xml
l ResourcesConfig.xml
The above files contain the configuration parameters to configure the text plain/Html properties
for specific functions as the name of the xml suggests.

Application.properties file: This file contains a property to Enable/Disable the editor logging
using the property email.editor.log.level. By default this property is disabled. Default value is
email.editor.log.level=false
This property can be used to debug the editor.

! Important:
Important: If the Shared Path "HomeDir" for WebAgent is configured in ICManager, using the
property "Agent/Desktop/WAC", then copy the folders lexicons, images, and
editlive under this path.
Following properties of Application.properties file are deprecated:
l email.edit.defaultNewFont
l email.edit.defaultNewFontSize
l email.edit.defaultReplyFont
l email.edit.defaultReplyFontSize
l email.HtmlNewMessage.r
l email.HtmlNewMessage.g
l email.HtmlNewMessage.b
l email.HtmlReplyMessage.r
l email.HtmlReplyMessage.g
l email.HtmlReplyMessage.b
You can configure the following HTML p-tag in the appropriate xml configuration file to change
the default style-sheet configured for email reply/replyall, forward, new outbound, and so.
For example:

360 Installation and Configuration March 2012


Configuring WebAgent

<style type="text/
css">
p{
font-family: Arial;
font-size: 12pt;
color:rgb(0,0,0)
}
body{
font-family: Arial;
}
p{
margin: 0 1
}
</style>

You can configure the default fonts for Email Reply/Forward, New Outbound Email, and Email
Resources.
The configuration xml file contains options to add/remove a toolbar button and shortcut menus.
Inserting text can be performed using <br> or <p> tags which can be configured using the
property "brOnEnter" set to true.
Font family (size, font-face) can be updated under toolbar format section. Few attributes are
disabled under section <wysiwygEditor>, like the element showTableGridlines. The property
showTableGridlines for example is used to display GRID when text, table, paragraph is
inserted in HTML Editor.

Installation and Configuration March 2012 361


Chapter 11: Deploying Avaya Agent

Configure converting email message to an attachment


You need to configure the Avaya Agent to convert large size email messages to an attachment.
With this configuration, the Avaya Agent convert a large size email message to an attachment
with file name as message.txt (for plain text message) and message.html (for html text
message).
To configure avaya agent to convert large size email messages to an attachment:
1. Replace or add the following key in the Application.properties:
email.largeemail.putasattachment=true
email.largeemail.size=<In KB>

Configure auto flush


You need to configure the Avaya Agent to flush log messages to the webagent.log file.
To configure auto flush:
1. Replace or add the following key:
application.trace.flush=true
Note:
Note: By default, Auto flush is false.

Configure number of attachments to be displayed without


scrollbar
You need to configure the number of attachments to be displayed without scrollbar in the
WebAgent.
To configure number of attachments
1. Replace or add the following key:
email.attachment.length=<number of attachments>
Note:
Note: The default number of attachments is set to 20.

362 Installation and Configuration March 2012


Configuring WebAgent

Configure the default location for saving attachment


You need to configure the Avaya Agent to change the default location for saving attachments in
the WebAgent.
To configure the attachment location:
1. Replace or add the following key:
default.attachment.location=\\\\<Location_to_store_attachments>
Note:
Note: If this location is accessible and if the specified directory does not exists, a new
directory with the name of an agent is created. Attachments are stored at the
specified location for that particular agent.
If this location is not accessible, then the attachments are stored at the following
location:
...\IC73\WebAgent\attachments
Or
\\<Shared_Root_Directory>\attachments

Installation and Configuration March 2012 363


Chapter 11: Deploying Avaya Agent

Configure Default Sorting


You need to configure the Avaya Agent to set the default sorting column for Customer History
and Tracking History.
To configure the default sorting column:
1. Replace or add the following keys:
l For Customer History:
history.customer.column.sort=<column_no>
l For Tracking History:
history.tracking.column.sort=<column_no>

Configure UTF-8 Encoding


You need to configure the Avaya Agent to detect incompatible character set encodings and use
UTF-8 character set for outbound email.
To configure UTF-8 Encoding:
1. Replace or add the following key:
email.charsetdetection.coverttoutf8=true

Configure viewing E-mail templates


You need to configure the Avaya Agent to populate the subject line and attachments of E-mail
templates:
To configure viewing E-mail templates:
1. Replace or add the following keys:
email.template.preview.level=3
email.template.use.level=3
emailresource.usage.subject.behavior=3

364 Installation and Configuration March 2012


WebAgent HTML Editor

WebAgent HTML Editor


The WebAgent HTML Editor UI and behavior can be configured using the EditLive!
configuration XMLs. These XMLs contains the configuration data which is used by Ephox
Editlive! To render the UI and respond to UI events.
Out of the box, following four configuration XMLs are provided to customize the UI and features
of WebAgent HTML editor:

NewOutboundEmail.xml: This is used for rendering the UI for new email composition in HMTL
mode.

PreviewEmailConfig.xml: This is used for previewing the email in HTML mode.

ReplyForwardEmailConfig.xml: This is used for rendering the UI for email composition in


reply/reply all/forward in HMTL mode.

ResourcesConfig.xml: this is used for rendering the UI for resource related operation e.g. edit/
preview in HMTL mode.
This section contains the following:
l Hyperlink settings in Configuration XML on page 365
l Configure Hyperlink for HTML E-mail on page 368

Hyperlink settings in Configuration XML


The Hyperlink dialog box enables you to specify the link type and target location for a hyperlink
jump to be encoded around the string or image selected in your document.
This section contains the following:
l Displaying Hyperlink Button in Toolbar on page 365
l Configuring Insert Hyperlink Dialog Box on page 366

Displaying Hyperlink Button in Toolbar


To display the hyperlink control for the HTML Editor Toolbar, following tags are used in the
configuration file:
l <toolbars>: This element contains the configuration information for the toolbars within
EditLive!. This includes the Format and the Command toolbars and the buttons and combo
boxes contained within them.
l <toolbar>: This element contains the configuration information for a toolbar for use within
EditLive!.

Installation and Configuration March 2012 365


Chapter 11: Deploying Avaya Agent

l < toolbarButton>: This element will cause a particular button to be present on the toolbar
within EditLive!.

<!-- Customize the


EditLive! toolbars -->
<toolbars>
<toolbar name="Format">
.
.
<toolbarButton name="HLink"/>
</toolbar>
</toolbars>

In the above snippet, the <toolbarButton> tag is used to insert the Hyperlink button in the HTML
'Format' toolbar.

Configuring Insert Hyperlink Dialog Box


The Hyperlink dialog box can be customized for links and email ids using following tags:
l <hyperlinks>: This element allows for the configuration of a list of hyperlinks and e-mail
addresses to be made available to the end users of EditLive! using the Insert Hyperlink
dialog.
l <hyperlinkList>: This element allows for the specification of a list of hyperlinks that the
users of EditLive! will be provided using the Insert Hyperlink dialog.
l <mailtoList>: This element allows for the specification of a list of e-mail addresses that the
end users of EditLive! will be provided using the Insert Hyperlink dialog.
l <PlacesInDocument>: This element allows the "Places in Document" panel of the Insert
Hyperlink dialog to be hidden.

Fields:

The Insert Hyperlink Dialog box contains following fields and options

Text to Display: Specifies a description for the hyperlink. This is useful when the file name or
URL is not helpful in identifying the contents of the linked file.

Screen Tip: Specifies text that appears when the user's pointer is over a hyperlink.
The Insert Hyperlink dialog box includes the following tabs under Link To:
l Existing File or Web Page on page 367
l Email Address on page 367

366 Installation and Configuration March 2012


WebAgent HTML Editor

l Places in Document on page 367

Existing File or Web Page


This tab creates a hyperlink to an existing file or web page.
The Web Links button displays default values for Web Links which can be used to hyperlink the
text from the Editor. The <hyperlinklist> tag is used to provide default values for Web Pages in
the configuration file.

Email Address
This tab specifies an email address to link to. When the hyperlink is executed, a new email is
created using the default system email program.
The Email Address button displays default values for email addresses which can be used to
hyperlink the text from the Editor. The <mailtolist> tag is used to provide default values for Web
Pages in the configuration file.

Fields

When the hyperlink is executed, a new email is created using the default system email program.

E-mail Address: Specifies an email address.

Subject: Specifies a subject for the email.

Recently Used E-mail Addresses: Lists recently used email addresses, from which you can
select one to use for the hyperlink.

Places in Document
This tab allows the "Places in Document" panel of the Insert Hyperlink dialog to be hidden. If the
<placesInDocumentList > is set to false, the "Places in Document" is not displayed in the
hyperlink dialog box. If the <placesInDocumentList > is set to true, the "Places in Document" is
displayed in the hyperlink dialog box and would contain the list of places bookmarked using the
"Bookmark" option in the current document.
To enable the "Bookmark" control of Editlive in the HTML Editor toolbar following tag can be
used in configuration file:

</toolbar>
</toolbars>
.
<toolbarButton name="HLink"/>
<toolbarButton name="Bookmark"/>
</toolbar>

Installation and Configuration March 2012 367


Chapter 11: Deploying Avaya Agent

The bookmarks from the existing document are available under "Places in Document" list.
These bookmarks can be used for creating hyperlinks.

Configure Hyperlink for HTML E-mail


The Hyperlink dialog box can be configured to display default Web Links and Email Address
which can be used for hyper linking any text inside the WebAgent HTML Editor.
Modify the Editlive! configuration files to enable default Web-Links and Email addresses:
1. Goto <AVAYA_IC73_HOME>\IC73\WebAgent\editlive directory on the system where
AARC is installed.
2. Edit the file NewOutboundEmail.xml.
3. Go to "<hyperlinks>" tag.
4. Uncomment <hyperlinkList> and <mailtoList> tags as shown in below snippet.
5. To customize the hyperlinks and email ids, provide appropriate values for "href" and
"description" attributes in <hyperlink> and <mailtolink> tags.
6. Follow the steps 1 to 5 for following files:
l <AVAYA_IC73_HOME>\IC73\WebAgent\editlive\ReplyForwardEmailConfig.xml
l <AVAYA_IC73_HOME>\IC73\WebAgent\editlive\ResourcesConfig.xml
Note:
Note: Copy the changed configuration files to the respective "WAC/HomeDir" if it is
other than the default Home Directory defined in ICManager.

Configuring the Citrix integration


The Citrix client interface with the seamless window causes issues with the login behavior and
the appearance of the IC agent desktop applications. Avaya provides two tools that prevent
these potential issues. For more information, see Avaya IC Installation Planning and
Prerequisites.
You do not need to perform additional steps if the IC uses the Citrix Web interface.
For this configuration, the Citrix integration requires some additional steps to ensure that the
agents can connect to the agent desktop applications and that the agent desktop applications
function correctly in the Citrix interface.
This section includes the following topics:
l About the Citrix integration on page 369

368 Installation and Configuration March 2012


Configuring the Citrix integration

l Installing the agent applications on the Citrix server on page 370


l Deploying Avaya Agent Rich Client on the Citrix server on page 370
l Locating the files for the tools on page 371
l Configuring the Avaya Agent INI file on page 372
l Configuring the IC Web browser tool on page 372
l Configuring the executable tool on page 375
l Sequence for using the Avaya tools for Citrix on page 379
l Creating ICA (Citrix Client) connection with Citrix server on page 379
For more detailed information about the IC tools and the Citrix integration with IC, see Avaya IC
Installation Planning and Prerequisites.

About the Citrix integration


IC supports the following methods of publishing applications in Citrix:
l Agent applications accessed as embedded applications in the Citrix Web interface.
l Agent applications accessed in a seamless window in the Citrix client interface.
This section includes the following topics:
l Limitations of Citrix integration with IC on page 369.
l Configuring Citrix integration for seamless window applications on page 369.

Limitations of Citrix integration with IC


Before you deploy your IC agent desktop applications on a Citrix server, consider the following
limitations:
l Do not host embedded applications and seamless window applications on the same Citrix
server. To use both publishing methods in an IC system, host the embedded applications
on a different Citrix server from seamless window applications.
l Do not use the Web browser tool, the Executable tool, or the Avaya Agent INI file (qui.ini)
on a Citrix server that hosts embedded applications.

Configuring Citrix integration for seamless window applications


If the IC system includes access to IC agent desktop applications through the Citrix client
interface in a seamless window, you can configure the Citrix integration in the following ways:
l Configure and run the Web browser tool to access the agent desktop applications.
l Configure and run the Executable tool to access the agent desktop applications.

Installation and Configuration March 2012 369


Chapter 11: Deploying Avaya Agent

Installing the agent applications on the Citrix server


To install the agent desktop applications on a Citrix server, follow the procedures in Testing the
agent installer on page 357. Do not perform any additional steps during the installation.
Depending upon the environment, you may need to adjust the size of the Avaya Agent
framework then re-create the agent installer. For more information on how to customize the
framework size, see Avaya Agent Integration.
Note:
Note: You cannot install the agent desktop applications in a Citrix environment if you do
not select the Citrix installation option in the Agent Site Preparation Wizard. For
more information, see Running the Avaya Agent site preparation wizard on
page 355.

Deploying Avaya Agent Rich Client on the Citrix server


To deploy the Avaya Agent Rich Client on the Citrix server:
1. Start the Citrix AppCenter Console.
2. In the left navigation pane, right-click the XenApp node under the Citrix Resources node
and select Create a new Citrix Farm.
The system creates a NewFarmCitrix node under the XenApp node.
3. In the left navigation pane, right click the Applications node under NewFarmCitrix and
select New > Publish application.
The system displays the Welcome page.
4. Click Next.
5. On the Name screen, enter the application display name and description and click Next.
The system displays the Publish Application page.
6. On the Type screen, select the Installed application option and click Next.
The system displays the Location page.
7. In the Command line field, enter the path of the qui.exe file.
After you enter the qui.exe file path in the Command line field, the system displays the
working directory of the qui.exe file in the Working directory field.

370 Installation and Configuration March 2012


Configuring the Citrix integration

8. In the Command line field, modify the path of the qui.exe file as given below If the
IC_INSTALL_DIR\IC73\ resides on a C drive:
C:\Avaya\bin\qui.exe" -d C:\Avaya\apps\interaction_center -n
interaction_center
Otherwise, select the appropriate drive and path.
9. Click Next.
10. Click Add at the bottom of the screen.
11. In the Select Servers window, select the Citrix server name and click OK.
12. On the Servers screen, click Next.
13. On the Users screen, select Allow only configured users option.
14. Click Add to add the configured users.
15. In the Select Users or Groups window, select the user name and click Add.
16. Click OK after you add all the required users.
17. On the Users screen, click Next.
18. On the Shortcut presentation screen, select the appropriate options and click Next.
19. On the Publish immediately screen, select the Configure advanced application
settings now option and click Next.
20. On the Access control screen, select the appropriate option for the connection and click
Next.
21. On the Content Redirection screen, click Next.
22. On the Limits screen, select the Limit instances allowed to run in server farm option
and enter the appropriate value in the Maximum instances field.
Note:
Note: If you want only one instance of application for each user, select the Allow only
one instance of application for each user check box.
23. Click Next.
24. On the Clients options screen, click Next.
25. On the Appearance screen, select appropriate Session window size and Colors.
26. Click Finish.

Locating the files for the tools


The files for the tools are in the following directory on the IC Windows CD/DVD-ROM 1:
<CD/DVD-ROM_drive>\Utils\Citrix

Installation and Configuration March 2012 371


Chapter 11: Deploying Avaya Agent

Configuring the Avaya Agent INI file


If the IC system includes agents accessing the Citrix client interface with the seamless window,
you must configure the Avaya Agent INI file on each of the Citrix server system that hosts IC
agent desktop applications.

! CAUTION:
CAUTION: Do not create or configure the Avaya Agent INI file on any system except a Citrix
server that an agent will access through the Citrix client interface with the
seamless window. The parameter needed for the seamless window can cause
undesirable formatting and sizing of the Avaya Agent in other deployments.
To configure the Avaya Agent INI file:
1. In Notepad or another text editor, open a new document.
2. Type the following information into the document:
[QConsole]
ResizeDesktop=FALSE

3. Save the file with the following name: qui.ini


4. Install the file in the Windows installation directory on each Citrix server that hosts IC agent
desktop applications.
For example, the Windows installation directory is typically either C:\Winnt or C:\
Windows.

Configuring the IC Web browser tool


To use the IC Web browser tool to access the agent desktop applications on the Citrix server:
1. Configure the IC Web browser tool.
2. Copy the files to the system that hosts the Web server used by IC.
This section includes the following topics:
l Components of the Web browser tool on page 373
l Installing the Web browser tool on page 373
l Updating the HTML page for the Web browser tool on page 374.
l Accessing more than one Citrix server on page 375.

372 Installation and Configuration March 2012


Configuring the Citrix integration

Components of the Web browser tool


The IC Web browser tool includes the files listed in the following table.

File Description

ActiveX control SetupLocalDesktopForAgentViaCitrixCtr.CAB


Digitally signed ActiveX control with unique class ID
HTML access page BasicStartAgent.htm
l Specifies the URL for the applications on the Citrix server.

l Determines the text that the agent sees on the links. You can
customize this text.

Installing the Web browser tool


To install the Web browser tool:
1. For Avaya IC systems that use Microsoft IIS as the Web server, when you set up and test
the Web browser tool, configure a virtual directory in IIS for the Web browser tool.
2. Copy the following files to the system that hosts the Web server used by the IC system:
l SetupLocalDesktopForAgentViaCitrixCtr.CAB
l BasicStartAgent.htm
For example, if the IC system uses the Microsoft IIS as the Web server, copy the files to
the system that hosts that Web server.

Installation and Configuration March 2012 373


Chapter 11: Deploying Avaya Agent

Updating the HTML page for the Web browser tool


The following table describes the parameters you can configure and add to the HTML page.
The only required parameter is CitrixClientURL.

! CAUTION:
CAUTION: Do not delete or change the javascript or other code in the HTML page.

Property Description

CitrixClientURL Specifies the location of the startup link for the IC


agent desktop applications on the Citrix server. The
value for the property must be a valid URL.
For example: CitrixClientURL="http://
server_name.com/ICAgent/
ICAgentAppMode.ica"
<A href="javascript: Specifies the text on the link that the agent clicks to
Main.SetDesktopForICAgent() access the agent desktop applications on the Citrix
"> Start Avaya Agent</A> server.
<A href="javascript: Specifies the text on the link that the agent clicks to
Main.ResetDesktop();window. close the interface with the agent desktop applications
close()">EXIT</A> on the Citrix server.
<A href="javascript: Specifies the text on the link that the agent clicks to
Main.ForcedResetDesktop()"> force a reset of the interface with the agent desktop
Force Reset</A> applications on the Citrix server in the event of a
failure.
DontStartMultipleInstancesOf Determines how the tool acts when an agents logs in
Agent to and exits from the tool.
This property is optional. You can add it to the HTML
page, if desired. For more information, see
DontStartMultipleInstancesOfAgent on page 377.

In addition to the parameters in the above table, you can also customize the HTML page as
follows:
l Add a corporate logo, a graphic for the background, or otherwise customize the
appearance of the HTML page.
l Add one or more of the properties in the Application or Desktop sections of the INI file for
the executable tool, as described in Updating the INI file for the IC executable tool on
page 376.
Note:
Note: You cannot add properties from the GUI section of the INI file for the executable
tool.

374 Installation and Configuration March 2012


Configuring the Citrix integration

Accessing more than one Citrix server


If the agents need to access the agent desktop applications on more than one Citrix server:
1. For each Citrix server that hosts agent desktop applications, configure the files for a Web
browser tool.
2. Install the following files in the same folder on the system that hosts the Web server:
l One copy of the ActiveX control:
SetupLocalDesktopForAgentViaCitrixCtr.CAB
l For each Citrix server that the agents need to access, one copy of
BasicStartAgent.htm
3. Create a desktop icon or an Internet Explorer Favorites menu for each Web browser tool.

Configuring the executable tool


To use the IC executable tool to access the agent desktop applications on the Citrix server:
1. Configure the IC executable tool.
2. Copy the files to either the agent workstations or to a network share that can be accessed
by all agents.
This section includes the following topics:
l Components of the executable tool on page 376
l Installing the executable tool on page 376
l Updating the INI file for the IC executable tool on page 376
l Accessing more than one Citrix server on page 378

Installation and Configuration March 2012 375


Chapter 11: Deploying Avaya Agent

Components of the executable tool


The IC executable tool includes the files listed in the following table.

File Description

Executable file SetupLocalDesktopForAgentViaCitrix.exe


Launches the dialog box used by agents to access the Citrix server that
hosts the agent desktop applications.
INI file AgentDesktopCtr.ini
After you update this file:
l Specifies the directory path to the agent desktop applications on the
Citrix server.
l Determines the text on the buttons in the dialog box. You can
customize this text to suit the needs of the contact center and to match
the corporate style.

Installing the executable tool


You can install the executable in either of the following locations:
l On a network share that is accessible to all agents who need to use the executable tool.
l Every agent workstation used by an agent who needs to use the executable tool.
To install the executable tool, copy the following files to the desired location:
l SetupLocalDesktopForAgentViaCitrix.exe
l AgentDesktopCtr.ini

Updating the INI file for the IC executable tool


The following table describes the parameters that you can configure and update in the
AgentDesktopCtr.ini file. The only required parameter is the directory path for the agent
desktop applications on the Citrix server.

Section Property Description

APPLICATION CitrixClientURL Specifies the location of the startup link for the IC
agent desktop applications on the Citrix server. The
value for the property must be a valid URL.
For example: CitrixClientURL="http://
server_name.com/ICAgent/
ICAgentAppMode.ica"

376 Installation and Configuration March 2012


Configuring the Citrix integration

Section Property Description

APPLICATION DontStartMultipleInstances Determines how the tool acts when an agents logs in
OfAgent to and exits from the tool.
Default setting is TRUE.
When this property is set to TRUE, if an agent logs
out of Avaya Agent without exiting from the tool, the
agent cannot use the tool to log back in to Avaya
Agent. Instead, the agent sees an error which states
that Avaya Agent is already running.
The agent must follow the correct sequence of steps
if you use this setting. For more information, see
Sequence for using the Avaya tools for Citrix on
page 379.
When this property is set to FALSE, if an agent logs
out of Avaya Agent without exiting from the tool, the
agent can use the tool to log back in to Avaya Agent.
The tools will allow the agent to start a "new" instance
of Avaya Agent.
APPLICATION AgentAlreadyRunningMsg Specifies the message displayed to the agent if an
interface is already open and you set
DontStartMultipleInstancesOfAgent is set to TRUE.
For example, AgentAlreadyRunningMsg=The
Avaya agent was already started
DESKTOP ClientBarHeight Controls the desktop area reserved for the bottom of
the Avaya Agent framework. The default value is 125
pixels.
For example, ClientBarHight= 151

DESKTOP ClientBarWidth Controls the desktop area reserved for the left side
bar of the Avaya Agent framework. The default value
is 200 pixels.
For example, ClientBarWidth=201

Installation and Configuration March 2012 377


Chapter 11: Deploying Avaya Agent

Section Property Description

GUI Caption properties The following caption properties allow you to specify
the text for the dialog box:
l WindowCaption="Avaya Agent Desktop
Control (customize me)"
l StopButtonCaption="Exit Avaya Agent
(customize me)"
l StartButtonCaption="Start Avaya
Agent (customize me)"
l ResetButtonCaption="Reset Desktop
(customize me)"
l ApplicationFrameCaption="Application
Controls (customize me)"
l ResetFrameCaption="Emergency Control
(customize me)"
GUI MinimizeWindowOnLanch Automatically minimizes the interface after the agent
edAppStart accesses the agent desktop applications on the Citrix
server.
For example,
MinimizeWindowOnLanchedAppStart=TRUE
GUI MaximizeWindowOnLanch Automatically maximizes the interface after the
edAppExit agents starts the agent desktop applications on the
Citrix server. Only set this property to TRUE if you
also set AutoResetOnExit to TRUE.
For example,
MaximizeWindowOnLanchedAppExit=TRUE
GUI DisableStartButtonAfterFir Automatically disables the Start button on the dialog
stClick box after the agent starts the agent desktop
applications on the Citrix server.
For example,
DisableStartButtonAfterFirstClick=FALSE
GUI AskForExitConformation Ensures that the interface asks the agent to confirm
before exiting the interface to the Citrix server.
Set this property to FALSE if you experience
problems with minimizing or maximizing Avaya
Agent.
For example, AskForExitConformation=FALSE

Accessing more than one Citrix server


If an agent needs to access the agent desktop applications on more than one Citrix server:
1. For each Citrix server that hosts agent desktop applications, configure the files for a
executable tool.

378 Installation and Configuration March 2012


Configuring the Citrix integration

2. Install a executable tool for each Citrix server in separate folders on the agent workstation.
3. Create a desktop icon or Start menu item for each executable tool.

Sequence for using the Avaya tools for Citrix


Agents must use the following sequence when they use either the Web browser tool or the
Executable tool. If an agent does not follow this sequence, Avaya Agent and other agent
desktop applications may no longer size properly in the Citrix interface.
The proper sequence for using the Avaya tools for Citrix is:
1. Agent starts the Avaya tool:
l For Web browser tool, agent clicks the Start link.
l For the Executable tool, agent selects Start.
Avaya Agent on the Citrix server starts.
2. Agent logs in to Avaya Agent through Citrix.
3. Agent handles contacts and performs required tasks in Avaya Agent.
4. Agent logs out from Avaya Agent through Citrix.
5. Agent exits the Avaya tool:
l For Web browser tool, agent clicks the Exit link.
l For Executable tool, agent selects Exit.
6. On the Citrix AppCenter console, verify that the Rich Client application is successfully
added under the Citrix applications node.
You can change the published application setting from the Citrix AppCenter console.
7. Modify the Avaya Agent INI file:
a. Update the Citrix server’s qui.ini file with the following two lines:
[QConsole]
ResizeDesktop=FALSE
b. Save the qui.ini file.

Creating ICA (Citrix Client) connection with Citrix server


To create an ICA (Citrix Client) connection with Citrix server:
There are two ways to install Citrix client. They are:
l Method A: Using Citrix Program Neighbourhood on page 380

Installation and Configuration March 2012 379


Chapter 11: Deploying Avaya Agent

l Method B: Using Citrix ICA Quick Launch Tool on page 381

Method A: Using Citrix Program Neighbourhood


1. Install Citrix Program Neighborhood on the Windows XP/Windows 7 system.
2. On the Citrix client system, open Citrix Program Neighborhood.
3. Add a new ICA connection.
4. Select Local Area Network and click Next.
The system displays the Add New ICA Connection window.
5. Enter the description for the new ICA connection.
6. Select the network protocol.
7. Select the Published Application option and click the drop-down list to select the
published application that you want to connect.
Note:
Note: If you select the Server option, the system remotely connects with the Citrix
server using Remote Desktop Connection (RDC).
8. Click Server Location.
The system displays the Locate Server or Published Application window.
9. Click Add to add the Citrix server name in the Address List field.
10. Click OK.
11. On the Add New ICA Connection page, click Next.
12. Select published view option and click Next.
13. Select the appropriate option.
14. Select the encryption level and click Next (Use default).
15. Enter the login credential of the Citrix server.
Note:
Note: You must have the access permission of the published application from the Citrix
XenApp.
16. Select the display options and click Next.
17. Click Finish.
18. In the Citrix Program Neighborhood window, ensure that the Citrix Client connection is
successfully added.
19. Double-click the added Citrix Client connection.
It will start session from the server side, and you can then access the published
applications.

380 Installation and Configuration March 2012


Configuring the Citrix integration

Method B: Using Citrix ICA Quick Launch Tool


1. Install the Citrix ICA Client and Citrix QuickLaunch Tool on Windows XP or Windows 7
system.
2. Open the Citrix QuickLaunch Tool from Citrix client system.
3. In the Citrix QuickLaunch Tool window, click Options>>.
4. Under Please specify the server or farm information field, add the XenApp Server
address and XML Service Port number. This is the port number that was specified while
configuring PNAgent.
5. Under Select the type of ICA connection field, select to a Published App option and
select the Published application from the list.
6. Under ICA Options field, in the Encryption Level field, select the required encryption
level.
7. Under Credentials field, provide the login credentials of the Citrix XenApp server.
Note:
Note: The login credential used to login to Citrix XenApp server must have permission
of published application from Citrix presentation server.
8. Click Write ICA File and provide the path to save the ICA file.
9. Double-click the saved ICA file or click Connect in the Citrix QuickLaunch Tool window
to start Avaya agent.

Installation and Configuration March 2012 381


Chapter 11: Deploying Avaya Agent

382 Installation and Configuration March 2012


Chapter 12: Installing Avaya Agent Web
Client

Avaya Agent Web Client is a Web based component of Avaya Interaction Center (IC)
application. Using Avaya Agent Web Client, you can contact customer on the Web. You can
chat with customer, collaborate the chat session with multiple agents, or even involve additional
people referred by the customer.
Installation of Avaya Agent Web Client includes installation of WebClient and installation of
Web Client Connector.
WebClient installation generates a web-application WAR file that contains all the required
WebClient components, JAR files, and so on. You must install WebClient only on Windows
computer.
After you generate the web-application war file, it needs to be deployed on Web Client
Connector computer. You can install Web Client Connector on all the Avaya supported
platforms.
When you install Avaya Agent Web Client in a contact center:
l Do not install Avaya Agent Web Client on an agent workstation.

! Important:
Important: Read the IC Readme file and Avaya IC Installation Planning and Prerequisites
before you install and deploy Avaya Agent Web Client.
For information about how to customize Avaya Agent Web Client, see Avaya Agent Web Client
Customization.
This section include the following topics:
1. Prerequisites for Avaya Agent Web Client on page 384.
2. Installing the Avaya Agent Web Client on page 386
3. Creating the application WAR file on page 387
4. Setting up the Java Application Bridge on page 388
5. Installing the Avaya Agent Web Client Connector on page 397.
6. Re-installing Avaya Agent Web Client on page 398.
7. Modifying the web.xml file on page 398

Installation and Configuration March 2012 383


Chapter 12: Installing Avaya Agent Web Client

Prerequisites for Avaya Agent Web Client


This section includes information that you need to know and steps you must perform before you
install and deploy Avaya Agent Web Client. Ensure that you have completed the prerequisites
described in the following topics.
l IC components on page 384
l Agent workstations on page 384
l JRE version on page 385.
l Required administrator privileges on page 385.
l Working directory property on page 386

IC components
For IC components, ensure that you have completed the following tasks:
l Install and configure all IC prerequisites, as described in Avaya IC Installation Planning
and Prerequisites.
l Install and configure Avaya IC, including all media channels.
l Configure agents for Avaya Agent Web Client, as described in Configuring the working
directory property on page 343.

Agent workstations
Install and configure the following prerequisites on all agent workstations that will be used to
access Avaya Agent Web Client:
l Install Internet Explorer version 7 with the Sun Java Plug-in version 1.6.0_10 enabled. By
default, Microsoft Internet Explorer uses the Microsoft Java Plug-in.
l Configure the internet options of Internet Explorer as follows:
- Security level: Medium if agents uses Windows Server 2008 R2.
- ActiveX controls: allow to run.
Add the URL of the Avaya Agent Web Client system to the Trusted Sites list.
- Proxy server settings: Add the fully qualified domain name of the contact center to the
proxy Exceptions field. For example, you can enter *.company_name.com or
*.*.company_name.com. You can add multiple names. Check the documentation
for your operating system for details.

384 Installation and Configuration March 2012


Prerequisites for Avaya Agent Web Client

- Pop-up blockers: disable or configure to allow pop-ups on the Avaya Agent Web Client
URL.

JRE version
Avaya Agent Web Client requires the following versions of JRE:
Web Client Connector computers: The installer for Web Client Connector automatically
installs the required version of JRE. The JRE version installed by this installer remains
independent of the JRE version you already have on a computer.

Avaya Agent Web Client on agent desktop computers: Requires at least JRE version
1.6.0_10. Avaya Agent Web Client automatically installs the required version if JRE is not
installed. If an older version of JRE is already installed, you must upgrade JRE to the latest
version.

Required administrator privileges


The installer for Avaya Agent Web Client requires the same administrator privileges as the
installers for the IC servers and the IC Design & Administration Tools. For more information, see
Required administrator privileges on page 23.

! Important:
Important: You can install Avaya Agent Web Client as root or as a user with the same
privileges as root. If you install as root, do not run Avaya Agent Web Client as the
root user.
For more information on ownership on Solaris, see Changing ownership for Avaya
Agent Web Client on Solaris only on page 402.
For more information on ownership on AIX, see Changing ownership for Avaya Agent
Web Client on AIX only on page 402.

Installation and Configuration March 2012 385


Chapter 12: Installing Avaya Agent Web Client

Working directory property


The working directory holds Avaya Agent Web Client agent settings for agents, agent
resources, and global resources. Avaya Agent Web Client uses agent file persistence to save
settings for each agent.

! CAUTION:
CAUTION: If you do not use a valid directory path when you configure the working directory,
Avaya Agent Web Client will not function properly. Avaya Agent Web Client
displays an error message on the Status Bar, and the chat and email channels
will be disabled.
For more information about the working directory and recommended settings for that directory,
see Configuring the working directory property on page 343.

Installing the Avaya Agent Web Client


Avaya Interaction Center, Release 7.3 provides the icclientsuite installer that you can run
to install Avaya Agent Web Client. You can download the icclientsuite installer using the
install.htm file and other required files provided in Avaya Interaction Center, Release 7.3.

To download the installer


1. Double click the install.html file.
The Internet Explorer window opens with Welcome page and a button for downloading the
installer.
2. Click the Download Installer for Windows button.
The File Download dialog box opens with options for running or saving the installer.
3. Click Run to run the installer from the server.
OR
4. Click Save to first save the installer on your local computer and then run it.

To install Avaya Agent Web Client on Windows computers


1. Go to the location where you have downloaded the iclientsuite installer, the
install.exe file.
2. Double click the install.exe file.
The InstallAnywhere launch the icclientsuite installer with Introduction page.

386 Installation and Configuration March 2012


Creating the application WAR file

3. Click Next to continue.


The License Agreement page displays.
Note:
Note: Read the license information carefully.
4. Select I accept the terms of the License Agreement to accept the license and click Next
to continue.
The Component Selection page displays.
5. Select AAWC and click Next.
The Choose Install Folder page displays.
6. Enter or choose the location where you want to install the Avaya Agent Web Client.
Note:
Note: Keep the default location for installing Web Client.
7. Click Next.
The Pre-Installation Summary page is displayed. You can see the summary of the
options that you have selected in the earlier steps. This page also displays the available
space and the space that is required for installing the Web Client.
Note:
Note: Check the summary carefully. If you want to change any information, click the
Previous button to go to the previous page.
8. Click Install.
The Avaya Agent Web Client installation starts. After the Web Client is installed
successfully, the Install Complete page is displayed. The page displays the folder location
where the Web Client is installed successfully.
9. Click Done.

Creating the application WAR file


To Create WAR file
1. Go to the location where you have installed the Avaya Agent Web Client.
Note:
Note: The default location is IC_INSTALL_DIR\IC73\Avaya IC Client Suite
7.3

Installation and Configuration March 2012 387


Chapter 12: Installing Avaya Agent Web Client

2. Double click the wargenerater.bat file.


The Command Prompt console opens. After completing the process, the
webclient.war file is created in the folder where Avaya Agent Web Client is installed.
Note:
Note: If you are migrating from Avaya IC 7.1 to Avaya IC 7.3, first you need to manually
merge all your customization scripts, JSP scripts, and properties and then
generate the war file.

Setting up the Java Application Bridge


The Application server for Avaya Agent Web Client uses the Java Application Bridge to
communicate with the IC servers and databases.
This section includes the following topics:
l Configuring an agent account for the Java Application Bridge on page 388
l Creating a Java Application Bridge on page 390.
l Setting up UNC to UNIX mapping on Solaris only on page 392
l Setting up UNC to UNIX mapping on AIX only on page 394

Configuring an agent account for the Java Application Bridge


The Java Application Bridge requires a non-human agent account for IC. This account is the
DCO Bridge account.
The IC seed data includes one non-human agent account for the DCO Bridge. You can use this
account for the first Java Application Bridge in the IC system.
You must create a unique non-human agent account for each additional Java Application Bridge
in the IC system. Name each account dcobridgeN. The agent name can also include the name
of the system that hosts the Java Application Bridge.

Tip:
Tip: The following instructions describe how to create additional non-human agent
accounts for the Java Application Bridge. If you use the account in the IC seed
data, you should double-click that agent account and complete Step 5 below.
To configure an agent account for the Java Application Bridge:
1. In IC Manager, click the Agent tab.

388 Installation and Configuration March 2012


Setting up the Java Application Bridge

2. In the left pane, expand the DefaultTenant node.


If you want to create this agent account in a different tenant, expand that node in the left
pane instead of DefaultTenant.
3. Select Agent > New.
4. On the General tab enter the information for the fields mentioned in the following table:

Field Recommended entry

First Name dcobridgeN (for example, dcobridge2)


Last Name dcobridgeN (for example, dcobridge2)
Preferred Name dcobridgeN (for example, dcobridge2)
Employee ID dcobridgeN (for example, dcobridge2)
Login ID dcobridgeN (for example, dcobridge2)
Domain The same user domain as the Java Application Bridge
that will use this agent account. For example, User1.
Task Load 0
Task Ceiling 0
Site DefaultSite

5. Click the Security tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry

Password Enter a password for this account.


Tip: Change the password for the pre-defined Java
Application Bridge account.
Confirm Re-enter the password for this account.
Force password Clear this field.
change on login Do not check this field for non-human IC users
Disable login Do not check this field.
Role Check the Agent role.
Note: Do not check any of the other roles.

6. Click Ok.

Installation and Configuration March 2012 389


Chapter 12: Installing Avaya Agent Web Client

Creating a Java Application Bridge


The Java Application Bridge is not a true IC server. The Java Application Bridge impersonates
each agent who logs in to the Avaya Agent Web Client. When the Java Application Bridge
makes a request for an agent, the Java Application Bridge mirrors the domain structure of the
agent.
You must create a Java application bridge for each Avaya Agent Web Client application.
To configure a Java application bridge
1. In IC Manager, click the Server tab.
2. Select Server > New.
3. From the list of servers, select JavaAppBridge.
4. Click Ok.
5. On the General tab enter the information for the fields mentioned in the following table:

Field Recommended entry Notes

Name Enter a name for the Java Include the name of the computer
Application Bridge. that hosts the Web Client Connector
application server to identify the
location of the JavaAppBridge.
Domain Select an IC User domain for For example, select User1 from the
the Java Application Bridge drop-down list.
from the drop-down list. Assign the Java Application Bridge to
the same User domain as the
majority of the agents who use
Avaya Agent Web Client.
If the IC system includes Avaya
Agent Web Client at different sites,
use the User domain that contains
the majority of agents at that site.
If the IC system includes agents in
multiple domains, you do not need a
Java Application Bridge in each User
domain.
Ensure that the domain with the Java
Application Bridge fails over to the
following domains:
l Itself

l The Default domain

l All domains with an ADU server

390 Installation and Configuration March 2012


Setting up the Java Application Bridge

Field Recommended entry Notes

Host Enter the IP address of the


computer that hosts Web
Connector.
Port Enter a port assignment for You can use any available port in the
the Java Application Bridge. 9000 range for the Java Application
Bridge. If you do not host other IC
servers on the same computer as
Web Client Connector, use port
9002.
Directory Enter the path to the etc For example enter:
directory for Avaya Agent IC_INSTALL_DIR\IC73\etc
Web Client.
where IC_INSTALL_DIR is the path
to this directory on the Web
Connector computer. For example, if
you used the default, the path would
be:
C:\Avaya\IC73\etc
Executable Enter jabsrv Leave the default entry.
Tip: This entry exists because this
is a required field in IC Manager.
No separate executable exists.

6. Record the Name value for the Java Application Bridge.


7. Click the JavaAppBridge tab and enter the information for the fields mentioned in the
following table:

Field Recommended entry Notes

IC User Enter the name of the agent Use the agent account that you
account for this Java created in Configuring an agent
Application Bridge server. account for the Java Application
Bridge on page 388.
For example, enter dcobridge1.
IC Password Enter the password
associated with the agent
account.

8. Click Ok.
Do not start the Java Application Bridge.
You can start the Java Application Bridge:
l On Windows: By running the aawcclient.bat script

Installation and Configuration March 2012 391


Chapter 12: Installing Avaya Agent Web Client

l On Solaris: By running aawcclient.sh script


l On AIX: By running aawcclient.sh script

Setting up UNC to UNIX mapping on Solaris only


The UNC to UNIX Path Mapping field of the Java Application Bridge maps the UNC address of
a network folder which holds files that agents can attach to resources with the UNIX path that
Web Client Connector uses to access the folder.

Tip:
Tip: You do not need to map the working directory for the Web Client Connector
computer. However, you can map this directory if required.
This section includes the following topics:
l Prerequisites for UNC to UNIX path mapping on page 392.
l Requirements for entries in the UNC to UNIX Path Mapping field on page 392.
l Accessing multiple folders on one computer on page 393.
l Examples of entries in the UNC to UNIX Path Mapping field on page 393.
l Configuring UNC to UNIX Path Mapping on page 394.

Prerequisites for UNC to UNIX path mapping


You must perform the following steps before you configure UNC to UNIX path mapping:
1. Install Samba (or an equivalent product) on the UNIX system that hosts the attachments
directory to make the folders and files accessible from a Windows system.
2. Configure the UNIX shares for Samba (or an equivalent product) as follows:
a. Ensure that the name of each share is the same as the UNIX folder that it shares.
b. Ensure that all agents have Read permissions for the share. You can give the agents
additional permissions for the share, if desired.
c. Ensure that the UNIX user under which Avaya Agent Web Client runs has the same
permissions for the UNIX directory as agents have for that directory’s share.

Requirements for entries in the UNC to UNIX Path Mapping field


Follow these requirements when you enter information in the UNC to UNIX Path Mapping field:
l You can only create one entry for each computer. The Java Application Bridge only
considers the first entry for a given computer in the table. All subsequent entries are
ignored.

392 Installation and Configuration March 2012


Setting up the Java Application Bridge

l You can only use the format \\system_name in the UNC System Name column.
l You can only use valid UNIX paths in the UNIX Path column.

Accessing multiple folders on one computer


You cannot add multiple entries for a computer in the UNC to UNIX Path Mapping field. If you
want to store files for attachments in multiple folders on the same computer:
1. Organize the folders so that they are all subfolders of a single folder. For example, create
an attachments folder with subfolders titled printers, ink, and cables.
2. Use Samba (or an equivalent product to configure the UNIX shares named printers, ink,
and cables for the subfolders of the attachments folder.
3. Give agents Read permissions, at a minimum, for the shares.
4. In the UNC System Name column, enter the name of the system where the attachments
folder is located. For example, \\sunbox1.
5. In the UNIX Path column, enter the UNIX path for the attachments directory. For
example, /opt/attachments.

Examples of entries in the UNC to UNIX Path Mapping field


The following table shows a series of entries in the UNC to UNIX Path Mapping field, including
both valid and invalid entries.

UNC to UNIX Path Mapping entry


Description
UNC System Name UNIX Path

\\sunbox1 /opt/data/attachments A valid entry in both columns.


\\sunbox2\ /opt/data/attachments An invalid entry in the UNC System Name
column. The Java Application Bridge cannot
accept an entry that ends with a backslash.
\\sunbox1 /opt/data Entry will be ignored as there is already an
entry for this UNC system name.
\\sunbox3 / A valid entry in both columns. The UNIX
Path entry points to the root directory on the
system.
\\sunbox4 An invalid entry in the UNIX Path column.
For root directory, enter /, as shown in the
above entry.

Installation and Configuration March 2012 393


Chapter 12: Installing Avaya Agent Web Client

Configuring UNC to UNIX Path Mapping


The UNC to UNIX Path Mapping field of the Java Application Bridge maps the UNC address of
a network folder which holds files that agents can attach to resources with the UNIX path that
Web Client Connector uses to access the folder.
Alarms are generated and added to the logs if an error is detected. For more information, see
Troubleshooting the Java Application Bridge on page 484.
To configure UNC to UNIX Path Mapping for Web Client Connector on Solaris:
1. If necessary, double-click the Java Application Bridge in the Server tab of IC Manager.
2. Click the JavaAppBridge tab.
3. Click the Ellipsis (…) button next to the UNC to UNIX Path Mapping field.
4. In the UNC to UNIX Path Mapping dialog box:
a. Click New.
b. In the UNC System Name column, enter the name of the system that hosts the
attachments folder in UNC format. For example, enter \\testbox
c. In the UNIX Path column, enter the path that the Web Client Connector computer uses
to access the attachments folder. For example, enter /opt/data/attachments
d. After you create entries for each attachments folder, click Ok.
e. Click Ok to close the Server Editor.
f. Restart the Avaya Agent Web Client application server in the Web Client Connector
computer.

Setting up UNC to UNIX mapping on AIX only


The UNC to UNIX Path Mapping field of the Java Application Bridge maps the UNC address of
a network folder which holds files that agents can attach to resources with the UNIX path that
Web Client Connector uses to access the folder.

Tip:
Tip: You do not need to map the working directory for the Web Client Connector
computer. However, you can map this directory if required.
This section includes the following topics:
l Prerequisites for UNC to UNIX path mapping on page 395.
l Requirements for entries in the UNC to UNIX Path Mapping field on page 395
l Accessing multiple folders on one computer on page 395
l Examples of entries in the UNC to UNIX Path Mapping field on page 396

394 Installation and Configuration March 2012


Setting up the Java Application Bridge

l Configuring UNC to UNIX Path Mapping on page 396.

Prerequisites for UNC to UNIX path mapping


You must perform the following steps before you configure UNC to UNIX path mapping:
1. Install Samba (or an equivalent product) on the UNIX system that hosts the attachments
directory to make the folders and files accessible from a Windows system.
2. Configure the UNIX shares for Samba (or an equivalent product) as follows:
a. Ensure that the name of each share is the same as the UNIX folder that it shares.
b. Ensure that all agents have Read permissions for the share. You can give the agents
additional permissions for the share, if desired.
c. Ensure that the UNIX user under which Avaya Agent Web Client runs has the same
permissions for the UNIX directory as agents have for that directory’s share.

Requirements for entries in the UNC to UNIX Path Mapping field


Follow these requirements when you enter information in the UNC to UNIX Path Mapping field:
l You can only create one entry for each computer. The Java Application Bridge only
considers the first entry for a given computer in the table. All subsequent entries are
ignored.
l You can only use the format \\system_name in the UNC System Name column.
l You can only use valid UNIX paths in the UNIX Path column.

Accessing multiple folders on one computer


You cannot add multiple entries for a computer in the UNC to UNIX Path Mapping field. If you
want to store files for attachments in multiple folders on the same computer:
1. Organize the folders so that they are all subfolders of a single folder. For example, create
an attachments folder with subfolders titled printers, ink, and cables.
2. Use Samba (or an equivalent product to configure the UNIX shares named printers, ink,
and cables for the subfolders of the attachments folder.
3. Give agents Read permissions, at a minimum, for the shares.
4. In the UNC System Name column, enter the name of the system where the attachments
folder is located. For example, \\sunbox1.
5. In the UNIX Path column, enter the UNIX path for the attachments directory. For
example, /opt/attachments.

Installation and Configuration March 2012 395


Chapter 12: Installing Avaya Agent Web Client

Examples of entries in the UNC to UNIX Path Mapping field


The following table shows a series of entries in the UNC to UNIX Path Mapping field, including
both valid and invalid entries.

UNC to UNIX Path Mapping entry


Description
UNC System Name UNIX Path

\\sunbox1 /opt/data/attachments A valid entry in both columns.


\\sunbox2\ /opt/data/attachments An invalid entry in the UNC System Name
column. The Java Application Bridge cannot
accept an entry that ends with a backslash.
\\sunbox1 /opt/data Entry will be ignored as there is already an
entry for this UNC system name.
\\sunbox3 / A valid entry in both columns. The UNIX
Path entry points to the root directory on the
system.
\\sunbox4 An invalid entry in the UNIX Path column.
For root directory, enter /, as shown in the
above entry.

Configuring UNC to UNIX Path Mapping


The UNC to UNIX Path Mapping field of the Java Application Bridge maps the UNC address of
a network folder which holds files that agents can attach to resources with the UNIX path that
Web Client Connector uses to access the folder.
Alarms are generated and added to the logs if an error is detected. For more information, see
Troubleshooting the Java Application Bridge on page 484.
To configure UNC to UNIX Path Mapping for Web Client Connector on AIX:
1. If necessary, double-click the Java Application Bridge in the Server tab of IC Manager.
2. Click the JavaAppBridge tab.
3. Click the Ellipsis (…) button next to the UNC to UNIX Path Mapping field.
4. In the UNC to UNIX Path Mapping dialog box:
a. Click New.
b. In the UNC System Name column, enter the name of the system that hosts the
attachments folder in UNC format. For example, enter \\testbox
c. In the UNIX Path column, enter the path that the Web Client Connector computer uses
to access the attachments folder. For example, enter /opt/data/attachments

396 Installation and Configuration March 2012


Installing the Avaya Agent Web Client Connector

d. After you create entries for each attachments folder, click Ok.
e. Click Ok to close the Server Editor.
f. Restart the Avaya Agent Web Client application server in the Web Client Connector
computer.

Installing the Avaya Agent Web Client Connector


Avaya Interaction Center, Release 7.3 provides the icserversuite installer that you can run
to install Web Client Connector. You can download the icserversuite installer using the
install.htm file and other required files provided in Avaya Interaction Center, Release 7.3.

To install Web Client Connector


1. Go to the location where you have downloaded the install.exe file.
2. Double click the install.exe file.
The InstallAnywhere launch the icserversuite installer with Introduction page.
3. Click Next to continue.
The License Agreement page displays.
Note:
Note: Note: Read the license information carefully.
4. Select I accept the terms of the License Agreement to accept the license and click Next
to continue.
The Component Selection page displays.
5. Click WebConnector and click Next.
The Choose Install Folder page displays.
6. Enter or select the location where you want to install the Web Client Connector.
Note:
Note: Keep the default location for installing Web Client Connector.
7. Click Next.
8. The Choose Shortcut Folder page is displayed.
9. Select any one location where you want to create a shortcut for running the Web Client.
Note:
Note: For some of the options, you can select the Create Icons for All Users check
box to create the shortcuts for all the users.

Installation and Configuration March 2012 397


Chapter 12: Installing Avaya Agent Web Client

10. Click Next.


The Pre-Installation Summary page is displayed. You can see the summary of the
options that you have selected in the earlier steps. This page also displays the available
space and the space that is required for installing the Web Client.
Note:
Note: Check the summary carefully. If you want to change any information, click the
Previous button to go to the previous page.
11. Click Install.
The Web Connector installation starts. After the Web Connector is installed successfully,
the Install Complete page is displayed. The page displays the folder location where the
Web Connector is installed successfully.
12. Select Run Configuration tool. For more information, see Run the configuration tool on
page 401.
13. Click Next.
14. Select Client mode.
15. Click Next.
16. Click Done.
After successful installation of Web Client on the Windows platform, you can configure the
Avaya Agent Web Client. For more information, see Configuring Avaya Agent Web
Client on page 399.

Re-installing Avaya Agent Web Client


If you need to re-install the Avaya Agent Web Client software, you must remove the existing
Avaya Agent Web Client software first. For more information, see Uninstalling Avaya Agent
Web Client on page 498.

Modifying the web.xml file


Do not modify the web.xml file for filter mapping for the Login Filter section. Modifying the filter
mapping for the Login Filter makes agents unable to log in to Avaya Agent Web Client.

398 Installation and Configuration March 2012


Chapter 13: Configuring and Deploying
Avaya Agent Web Client

Avaya Agent Web Client is a Web based component of Avaya Interaction Center (IC)
application. After you successfully install the Avaya Agent Web Client, you must configure and
deploy it on a system where Web Client Connector is installed. This chapter explains all the
procedures that helps you configure and deploy Avaya Agent Web Client.

! Important:
Important: Read the IC Readme file and Avaya IC Installation Planning and Prerequisites
before you install and deploy Avaya Agent Web Client.
For information about how to customize Avaya Agent Web Client, see Avaya Agent Web Client
Customization.
This section includes the following topics:
1. Before you configure and deploy Avaya Agent Web Client on page 399.
2. Configuring Avaya Agent Web Client on page 399
3. Verifying the deployment of AAWC on page 406
4. Redeploying the application WAR file (optional) on page 407

Before you configure and deploy Avaya Agent Web Client


Before you start configuring and deploying the Avaya Agent Web Client, ensure that you have
successfully created the application war file. For more information, see Creating the application
WAR file on page 387.
This section explains about the basic and advance options available for configuring Avaya
Agent Web Client.

Configuring Avaya Agent Web Client


l Basic Configuration on page 400
l Advance Configuration on page 404

Installation and Configuration March 2012 399


Chapter 13: Configuring and Deploying Avaya Agent Web Client

Basic Configuration
This section includes the following topics:
l Deploying the application WAR file on page 400
l Run the configuration tool on page 401
l Changing ownership for Avaya Agent Web Client on Solaris only on page 402
l Changing ownership for Avaya Agent Web Client on AIX only on page 402
l Starting and stopping Avaya Agent Web Client on page 402
l Setting the options in Internet Explorer 8.0 on page 403
l Testing Avaya Agent Web Client on page 404

Deploying the application WAR file


To deploy the application WAR file
1. Copy the webclient.war file, which is generated during the installation of AAWC
installation. For more information, see Creating the application WAR file on page 387.
2. Paste the webclient.war file in the IC_INSTALL_DIR/IC73/tomcat/Avaya/war
directory, on the Web Client Connector computer.
3. From the webconnector computer, run the Configuration Tool as mentioned in the below
table:

Operating system Procedure

Windows Select Start > Programs > Avaya Interaction Center 7.3 >
Configuration Tool.
Solaris 1. Navigate to IC_INSTALL_DIR/IC73/bin
2. Run ./configure
AIX 1. Navigate to IC_INSTALL_DIR/IC73/bin
2. Run ./configure

4. Enter the user name and password for administrator.


5. Click Ok.
6. Click the Web Client tab and specify the Web Client URL: http://
<IP_of_computer_on_which_WebConnector_is_installed>

400 Installation and Configuration March 2012


Basic Configuration

7. Specify the Java Application Bridge Name. For information, see Creating a Java
Application Bridge on page 390.
8. Click Apply Settings.
The message box is displayed with a message that the settings are applied successfully.
9. Click Ok.
10. Click Exit.

Run the configuration tool

! Important:
Important: Before running the configuration tool, ensure that you have added the FQDN of
all the IC systems to host file of each IC system.
To run the configuration tool
1. Start the Configuration Tool:

Operating system Procedure

Windows Select Start > Programs > Avaya Interaction Center 7.3
> Configuration Tool.
Solaris 1. Navigate to IC_INSTALL_DIR/IC73/bin
2. Run ./configure
AIX 1. Navigate to IC_INSTALL_DIR/IC73/bin
2. Run ./configure

2. On the Initial Configuration page of the Configuration Tool, select Client as the
configuration mode.
3. Enter the primary host name.
Note:
Note: Ensure that the computer that you have specified as primary host is reachable
from the computer on which you are running Configuration Tool. If required, you
must add the FQDN of a computer specified as primary host to the host file.
4. Keeping the default settings for other options, click Apply Settings.
The vesp.imp file is copied on a Web Client Connector Computer.

Installation and Configuration March 2012 401


Chapter 13: Configuring and Deploying Avaya Agent Web Client

Changing ownership for Avaya Agent Web Client on Solaris only


If you installed Avaya Agent Web Client as the root user, change ownership for Avaya Agent
Web Client to run under a non-root user.

! Important:
Important: Users must avoid running IC software as the root user wherever possible for
security reasons. Create a user for the IC system before you perform these steps.
For more information, see Avaya IC Installation Planning and Prerequisites.

Changing ownership for Avaya Agent Web Client on AIX only


If you installed Avaya Agent Web Client as the root user, change ownership for Avaya Agent
Web Client to run under a non-root user.

! Important:
Important: Users must avoid running IC software as the root user wherever possible for
security reasons. Create a user for the IC system before you perform these steps.
For more information, see Avaya IC Installation Planning and Prerequisites.

Starting and stopping Avaya Agent Web Client


In the Avaya Interaction Center, Release 7.3, you can start and stop the Avaya Agent Web
Client component by handling the javaw process.
To start or stop the javaw process
1. Open the command prompt by selecting Start > Run.
2. Change the directory to: IC_INSTALL_DIR\IC73\bin.
3. Execute the following command:

Operating system Procedure

Windows To start: aawcclient.bat start


To stop: aawcclient.bat stop
Solaris To start: ./aawcclient.sh start
To stop: ./aawcclient.sh stop
AIX To start: ./aawcclient.sh start
To stop: ./aawcclient.sh stop

402 Installation and Configuration March 2012


Basic Configuration

Setting the options in Internet Explorer 8.0


This section provides the information about setting options in Internet Explorer 8 before running
Avaya Agent Web Client.
Note:
Note: Do not access another website in new tab of the same Internet Explorer 8.0
instance from which you accessed Avaya Agent Web Client login page.
To set the options in Internet Explorer 8.0:
1. Install the Microsoft security patch KB978207, which is a cumulative security update for
Internet Explorer 8, on a system from where you want to access Avaya Agent Web Client.
You need to install this security patch if this security patch is not already installed on the
system.
2. From the system, uninstall Avaya WindowManager Control if it is already installed.
a. Open the Internet Explorer 8.0 browser.
b. From the main menu, select Tools > Internet Options.
c. On the General tab, click Settings in the Browsing History area.
d. Click View Objects to view if Avaya WindowManager Control is already installed.
e. Right-click Avaya WindowManager Control if present, and select Remove.
The system uninstalls Avaya WindowManager Control.
3. Set the Internet Explorer 8.0 so that Avaya Agent Web Client works correctly.
a. From the main menu of Internet Explorer 8.0, select Tools > Internet Options.
b. Click the Advanced tab.
c. In the Browsing section, clear the Enable automatic crash recovery and Enable
third-party browser extensions check boxes.
d. Click the General tab.
e. In the Tabs area, click Settings.
f. In the Tabbed Browsing Settings dialog box
1. Clear the Enable Tabbed Browsing check box.
OR
2. Select the Enable Tabbed Browsing check box and in the When pop-up is
encountered area, select the Always open pop-ups in a new window option.
g. Click OK.
h. In the Internet Options dialog box, click OK.
4. Restart the Internet Explorer 8.0 browser.

Installation and Configuration March 2012 403


Chapter 13: Configuring and Deploying Avaya Agent Web Client

5. Access Avaya Agent Web Client.


6. Select install if the system displays a prompt for installing the avayaicagent.cab file.
7. After the avayaicagent.cab file is installed, close Internet Explorer 8.0.

Testing Avaya Agent Web Client


Note:
Note: For information about Avaya Agent Web Client log files and troubleshooting
issues, see Interaction Center Administration Guide.
To test Avaya Agent Web Client
1. In a Web browser, navigate to the following URL:
http://WEB_CONNECTOR_SERVER_NAME:9080/avaya/agent/login.jsp
where WEB_CONNECTOR_SERVER_NAME is the fully qualified domain name of the
computer that hosts Web Connector.
Note:
Note: Ensure that the Web Client Connector server is reachable from the workstation of
an agent.
2. Log in to Avaya Agent Web Client with the login ID and password of an agent in the IC
system.

Advance Configuration
This section includes the following topics:
l Starting the HTTP server on page 404
l Configuring SSL security for Avaya Agent Web Client (optional) on page 406

Starting the HTTP server


Note:
Note: You must start Avaya Agent Web Client before you perform the steps in this
section. For more information, see Starting and stopping Avaya Agent Web
Client on page 402.
This section includes the following topics:
l Starting the HTTP server on Windows on page 405.

404 Installation and Configuration March 2012


Advance Configuration

l Starting the HTTP server on Oracle iPlanet on page 405.


l Starting the HTTP server on AIX on page 406.

Starting the HTTP server on Windows


For the HTTP server to run correctly on a Windows computer, you must stop the service for
Internet Information Services.
To start the HTTP server on a Windows computer:
1. On a computer that hosts the HTTP server, open the Windows Services panel.
2. For the World Wide Web Publishing Service:
a. Set the startup type to Manual.
b. Stop the service.
3. For the IIS Administrative Service:
a. Set the startup type to Manual.
b. Stop the service.
4. Start the service for HTTP Server.

Starting the HTTP server on Oracle iPlanet


For the HTTP server to run correctly on a Solaris system, you must stop the processes for the
Oracle iPlanet HTTP server.
To start the HTTP server on a Solaris system:
1. On a computer that hosts the HTTP server, stop the following processes for the Oracle
iPlanet HTTP server:
l httpd
l webservd
2. Navigate to the IC_INSTALL_DIR/IC73/bin directory.
3. Enter the following command to start HTTP Server:
./httpserver.sh start

Installation and Configuration March 2012 405


Chapter 13: Configuring and Deploying Avaya Agent Web Client

Starting the HTTP server on AIX


To start the HTTP server on an AIX system:
1. On a computer that hosts the HTTP server, navigate to the IC_INSTALL_DIR/IC73/bin
directory.
2. Enter the following command to start HTTP Server:
./httpserver.sh start

Configuring SSL security for Avaya Agent Web Client (optional)


You can configure Avaya Agent Web Client to work with Secure Sockets Layer (SSL) to provide
secure Internet sessions. SSL is optional.
To configure SSL security for Avaya Agent Web Client:
1. Open the server.webclient.xml.template file in a text editor.
You can find the file at the location: IC_INSTALL_DIR\IC73\bin\config\template.
2. In the file, comment the default HTTP connector and remove the commented HTTPS
connector.
3. Configure the following attributes as mentioned:
l sslProtocol="TLS"
l keystoreFile="<location-to-key-file>"
l keystorePass="<password-for-keystore>"
For the guidelines about installing and configuring SSL on Tomcat, you can access the
following link: http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html.
4. Open the aawcclient.bat.template file, located in IC_INSTALL_DIR\IC73\bin\
config\template, in a text editor and change the default port from 9080 to the SSL
port that you have configured in the Step 3.
5. Run the config tool.

Verifying the deployment of AAWC


To verify the successful deployment of AAWC
1. Verify that aawcclient.bat or aawcclient.sh, located in the IC_INSTALL_DIR\
IC73\bin folder, is updated with the changes you have provided in the config tool.

406 Installation and Configuration March 2012


Redeploying the application WAR file (optional)

2. Check whether JavaAppBridge server status is showing Up.


3. Check the IC_INSTALL_DIR\IC73\tomcat\webapps\Avaya directory for the agent
folder that contains subfolder and files.
4. Check whether Windows Task Manager is showing the javaw process running.
5. Check whether Alarm Monitor has generated an information alarm The application
started successfully.

Redeploying the application WAR file (optional)


You can update or customize Web Client and redeploy the application WAR file without
uninstalling all Avaya Agent Web Client components. Run the following procedure on the Web
Client Connector computer to redeploy the application WAR file:
1. Stop the Avaya Agent Web Client if it is running. For more information, see Starting and
stopping Avaya Agent Web Client on page 402.
2. Back up the existing webclient.war file.
3. Delete the Avaya folder from the Tomcat/Webapps directory.
4. Generate a new war file as described in Creating the application WAR file on page 387.
5. Copy the new generated war file from the Avaya Agent Web Client computer to the
Tomcat/avaya/war directory of the Web Client Connector computer.

Installation and Configuration March 2012 407


Chapter 13: Configuring and Deploying Avaya Agent Web Client

408 Installation and Configuration March 2012


Chapter 14: Deploying Client SDK
components

This section includes the following topics:


1. Before you deploy Client SDK components on page 409
2. Installing the Client SDK components on page 410
3. Configuring a secondary ORB server environment on page 410
4. Client SDK files on page 411
5. Setting up the Java Application Bridge on page 411
6. Configuring Client SDK services on page 415
7. Starting and stopping the Client SDK server on page 416
8. Running a sample client on page 417
9. Optional advanced configuration for the Client SDK server on page 420

! Important:
Important: Read the IC Readme and Avaya IC Installation Planning and Prerequisites before
you deploy the Client SDK.

Before you deploy Client SDK components


Before you deploy Client SDK server or design components:
l Install the required third-party software, as described in Avaya IC Installation Planning and
Prerequisites.
l Install and configure all IC prerequisites, as described in Avaya IC Installation Planning
and Prerequisites.
l Install and configure Avaya IC, including all media channels and Avaya FTSE.
l Create and configure agent accounts for agents who are using custom applications
developed with the Client SDK, as described in Configuring agent accounts on page 327.

Installation and Configuration March 2012 409


Chapter 14: Deploying Client SDK components

Installing the Client SDK components


Install the Client SDK server and design components, as described in Installing IC server and
administration components on page 28.

Tip:
Tip: You must install the Client SDK server components on a dedicated computer.
The following table lists the Client SDK components installed with each operating system.

Operating system Deployment

Windows Installs the following components:


l Client SDK server components

l Java and .NET design components

Solaris Installs the following components:


l Client SDK server components

l Java design components

To get the .NET design components, you must install the Client
SDK on a Windows system.
AIX Installs the following components:
l Client SDK server components

l Java design components

To get the .NET design components, you must install the Client
SDK on a Windows system.

Configuring a secondary ORB server environment


The Client SDK server requires a secondary ORB server. Configure a secondary server
environment, as described in Configuring a secondary ORB server environment on page 37.

410 Installation and Configuration March 2012


Client SDK files

Client SDK files


The following table describes the contents of the SDK directories created when you install the
Client SDK components.

Directory Contents

sdk/server Client SDK server files, including the WAR file for Tomcat
sdk/design All design files for the Client SDK in the following directories:
l dotnet

l java

The following diagrams in PDF format:


l Object model

l State models for all stateful Client SDK objects

sdk/design/dotnet/lib C# client libraries for the Client SDK client


sdk/design/dotnet/sample Source code and binaries for the .NET sample client
sdk/design/dotnet/doc Client API reference documentation for the .NET API
sdk/design/java/lib Java client libraries for the Client SDK client
sdk/design/java/sample Source code and binaries for the Java sample client
sdk/design/java/doc Client API reference documentation for the Java API.

Setting up the Java Application Bridge


The Client SDK server uses the Java Application Bridge to communicate with the IC servers
and databases.
This section includes the following topics:
1. Creating an agent account for the Java Application Bridge on page 412.
2. Creating a Java Application Bridge on page 413.

Installation and Configuration March 2012 411


Chapter 14: Deploying Client SDK components

Creating an agent account for the Java Application Bridge


The Java Application Bridge requires a non-human agent account for IC. You use this agent
account when you configure Tomcat for the Client SDK server. This account is the DCO Bridge
account.
The IC seed data includes one non-human agent account for the DCO Bridge. You can use this
account for the first Java Application Bridge in the IC system.
You must create a unique non-human agent account for each additional Java Application Bridge
in the IC system. You must name each account dcobridgeN. The agent name can also include
the name of the computer that hosts the Java Application Bridge.

Tip:
Tip: The following instructions describe how to create additional non-human agent
accounts for the Java Application Bridge. If you use the account in the IC seed
data, double-click that agent account and complete Step 5 below.
To create an agent account for the Java Application Bridge:
1. In IC Manager, click the Agent tab.
2. In the left pane, expand the DefaultTenant node.
If you want to create the agent account in a different tenant, expand that node in the left
pane instead of DefaultTenant.
3. Select Agent > New.
4. Click the General tab and enter the information for the fields mentioned in the following
fields:

Field Recommended entry

First Name dcobridgeN (for example, dcobridge2)


Last Name dcobridgeN (for example, dcobridge2)
Preferred Name dcobridgeN (for example, dcobridge2)
Employee ID dcobridgeN (for example, dcobridge2)
Login ID dcobridgeN (for example, dcobridge2)
Domain The same user domain as the Java Application Bridge
that will use this agent account. For example, User1.
Task Load 0
Task Ceiling 0
Site DefaultSite

412 Installation and Configuration March 2012


Setting up the Java Application Bridge

5. Click the Security tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry

Password Enter a password for this account.


Tip: Change the password for the pre-defined Java
Application Bridge account.
Confirm Re-enter the password for this account.
Force password Clear this field.
change on login Do not select this field for non-human IC users
Disable login Do not select this field.
Role Select the Agent role.
Note: Do not select any of the other roles.

6. Click OK.

Creating a Java Application Bridge


You must create a Java Application Bridge on the Client SDK server computer. The Java
Application Bridge is not a true IC server. The Java Application Bridge impersonates each agent
who logs in to the Client SDK. When the Java Application Bridge makes a request for an agent,
the Java Application Bridge mirrors the domain structure of the agent.
To create a Java application bridge
1. In IC Manager, click the Server tab.
2. Select Server > New.
3. From the list of servers, select JavaAppBridge.
4. Click Ok.
5. Click the General tab and enter the information for fields mentioned in the following table.

Field Recommended entry Notes

Name Enter a name for the Java Include the name of the computer
Application Bridge. that hosts the Tomcat application
server to identify the location of the
JavaAppBridge.

Installation and Configuration March 2012 413


Chapter 14: Deploying Client SDK components

Field Recommended entry Notes

Domain Select an IC User domain for For example, select User1 from the
the Java Application Bridge drop-down list.
from the drop-down list. Assign the Java Application Bridge to
the same User domain as most
Client SDK application users. You do
not need a Java Application Bridge in
each User domain.
Ensure that the domain with the Java
Application Bridge fails over to the
following domains:
l Itself

l Default domain

l All domains with an ADU server

Host Enter the IP address of the


system that hosts the Client
SDK server.
Port Enter a port assignment for You can use any available port in the
the Java Application Bridge. 9000 range for the Java Application
Bridge. Use port 9002.
Directory Enter the path to the etc For example, enter:
directory for the Client SDK IC_INSTALL_DIR\IC73\etc
server.
where IC_INSTALL_DIR is the path
to this directory on the Client SDK
server computer. For example, if you
used the default, the path is:
C:\Avaya\IC73\etc
Executable Enter jabsrv. Leave the default entry.
Tip: This entry exists because
Executable is a required field in IC
Manager. No separate executable
exists for the Java Application
Bridge.

414 Installation and Configuration March 2012


Configuring Client SDK services

6. Record the Name value for the Java Application Bridge. You need this name in
Configuring Client SDK services on page 415.
7. Click the JavaAppBridge tab and enter the information for the fields mentioned in the
following table.

Field Recommended entry Notes

IC User Enter the name of the agent Use the account that you
account for this Java created in Creating an agent
Application Bridge server. account for the Java Application
Bridge on page 412.
For example, enter dcobridge1.
IC Password Enter the password
associated with the agent
account.

8. Click OK.

! Important:
Important: Do not start the Java Application Bridge in IC Manager. When you start the Client
SDK server in Tomcat, that server starts the Java Application Bridge.

Configuring Client SDK services


Configure Client SDK services on all computers that host Client SDK server or design
components.
To configure Client SDK services
1. Start the Configuration Tool:

Operating system Procedure

Windows Select Start > Programs > Avaya Interaction Center 7.3
> Configuration Tool.
Solaris 1. Navigate to IC_INSTALL_DIR/IC73/bin
2. Run ./configure
AIX 1. Navigate to IC_INSTALL_DIR/IC73/bin
2. Run ./configure

2. Log in with your IC Manager login ID and password.

Installation and Configuration March 2012 415


Chapter 14: Deploying Client SDK components

3. Click the SDK Server tab.


4. In the SDK Server System field, type the fully-qualified domain name of the computer that
hosts the Client SDK server.
5. In the JavaAppBridge Name field, type the name of the Java Application Bridge that this
Client SDK server will use.
6. Click Apply Settings.
7. Click Exit.

Starting and stopping the Client SDK server


This section includes the following topics:
l Starting and stopping the Client SDK server on Windows on page 416
l Starting and stopping the Client SDK server on Solaris on page 417
l Starting and stopping the Client SDK server on AIX on page 417

Starting and stopping the Client SDK server on Windows


To start, stop and configure the Client SDK server on Windows:
1. In the Services control panel, right-click on the Avaya IC 7.3 SDK Service.
2. From the right-click menu, select one of the options in the following table:

Task Options

Start Client SDK server Select Start.


Stop Client SDK server Select Stop.
Set startup options 1. Select Properties.
2. Select Automatic from the Startup Type
drop-down list.
3. Click OK.

416 Installation and Configuration March 2012


Running a sample client

Starting and stopping the Client SDK server on Solaris


Execute all Client SDK server commands from the IC_INSTALL_DIR/IC73/bin directory.
For the Client SDK server to be able to log in, the IC servers must be started first.

Starting the Client SDK server: To start the Client SDK server, execute the following
command:
nohup ./ictomcat.sh start SDK

Stopping the Client SDK server: To stop the Client SDK server, execute the following
command where -force is an optional parameter that terminates the server processes:
nohup ./ictomcat.sh stop SDK -force

Starting and stopping the Client SDK server on AIX


Execute all Client SDK server commands from the IC_INSTALL_DIR/IC73/bin directory.
For the Client SDK server to be able to log in, the IC servers must be started first.

Starting the Client SDK server: To start the Client SDK server, execute the following
command:
nohup ./ictomcat.sh start SDK

Stopping the Client SDK server: To stop the Client SDK server, execute the following
command where -force is an optional parameter that terminates the server processes:
nohup ./ictomcat.sh stop SDK -force

Running a sample client


Perform these procedures on the development system where you installed the Client SDK
components. For more information about the Client SDK sample clients, see Avaya IC Client
SDK Programmer Guide.
This section includes the following topics:
l Running the .NET sample client on Windows on page 418
l Running the Java sample client on Windows on page 418
l Running the Java sample client on Solaris on page 418
l Running the Java sample client on AIX on page 419

Installation and Configuration March 2012 417


Chapter 14: Deploying Client SDK components

Running the .NET sample client on Windows


To run the .NET sample client on a Windows computer:
1. select Start > Programs > Avaya Interaction Center 7.3 > Run .Net Sample Client.
2. In the dialog box, enter:
l URL for the Client SDK server
The URL must use the format: http://<SDK_Server_System_Name>:<Port>/
<Application_context>. For example, with the default configuration, the URL
could be http://testbox.xyzcorp.com:9700/icsdk
l IC agent account
l Password for the IC agent account
3. Click Ok.

Running the Java sample client on Windows


To run the Java sample client on a Windows computer
1. Select Start > Programs > Avaya Interaction Center 7.3 > Run Java Sample Client.
2. In the dialog box, enter:
l URL for the Client SDK server
The URL must use the format: http://<SDK_Server_System_Name>:<Port>/
<Application_context>. For example, with the default configuration, the URL
could be http://testbox.xyzcorp.com:9700/icsdk
l IC agent account
l Password for the IC agent account
3. Click Ok.

Running the Java sample client on Solaris


To run the Java sample client on the Solaris system:
1. Navigate to the following folder:
IC_INSTALL_DIR\IC73\sdk\design\java\sample\bin
2. Execute the following command: ./runclient.sh
3. In the dialog box, enter:

418 Installation and Configuration March 2012


Running a sample client

l URL for the Client SDK server


The URL must use the format: http://<SDK_Server_System_Name>:<Port>/
<Application_context>. For example, with the default configuration, the URL
could be http://testbox.xyzcorp.com:9700/icsdk
l IC agent account
l Password for the IC agent account
4. Click Ok.

Running the Java sample client on AIX


To run the Java sample client on the AIX system:
1. Navigate to the following folder:
IC_INSTALL_DIR\IC73\sdk\design\java\sample\bin
2. Execute the following command: ./runclient.sh
3. In the dialog box, enter:
l URL for the Client SDK server
The URL must use the format: http://<SDK_Server_System_Name>:<Port>/
<Application_context>. For example, with the default configuration, the URL
could be http://testbox.xyzcorp.com:9700/icsdk
l IC agent account
l Password for the IC agent account
4. Click Ok.

Installation and Configuration March 2012 419


Chapter 14: Deploying Client SDK components

Optional advanced configuration for the Client SDK server


This section includes the following topics:
l Configuring the log4j files for the Client SDK server (optional) on page 420
l Changing default port range (optional) on page 421
l Enabling the Client SDK server for SSL on page 421

Configuring the log4j files for the Client SDK server (optional)
To configure the log4j files for the Client SDK server:
1. In a text editor, open the following file:
IC_INSTALL_DIR\IC73\tomcat\bin\icsdk.bat
2. Navigate to the section between MODIFICATION SECTION BEGIN and MODIFICATION
SECTION END.
3. Update the following parameters in this section:

Parameter Notes

LOG4J_CONFIGURATION Enter the full path and file name for the Log4j
XML file.
LOG4J_DEBUG Set the Log level as follows:
l true to enable logging

l false to disable logging

JAVA_SECURITY_AUTH_LOGIN_ Enter the full path to the directory that contains


CONFIG the cup.security file.
For example: AVAYA_IC73_HOME\SDK\
cup.security

4. Save the icsdk.bat file.

420 Installation and Configuration March 2012


Optional advanced configuration for the Client SDK server

Changing default port range (optional)


By default, the Client SDK server accepts connections from a client in a port range between
8000 and 9000. If a client is outside the firewall, you must open up ports in this range.
You can change the port range in the web.xml file.
To change the default port range
1. Open web.xml in a text editor.
You can find the web.xml file in the IC_INSTALL_DIR\IC73\sdk\server\icsdk\
WEB-INF folder.
2. Search for the messaging.listener.port.range entry.
This entry does not exist out-of-the-box.
3. If the entry does not exist, add the messaging.listener.port.range entry to the
web.xml file.
4. Set the value of messaging.listener.port.range entry to the desired port range, as
follows:
<a>-<b>
where the value of a is greater than the value of b, and where a and b are unsigned
integers which represent a valid port range. For example, a valid value is 9050-8050.
5. Save the file.
6. Restart the Tomcat server, as described in Starting and stopping the Client SDK server on
Windows on page 416.

Enabling the Client SDK server for SSL


To enable the Client SDK server for SSL:
1. Set up Tomcat, as described in http://tomcat.apache.org/tomcat-5.5-doc/ssl-howto.html.
If these links become inaccessible, go to http://tomcat.apache.org and search for SSL
Configuration for more information.
2. If your Tomcat configuration includes the SSL connector, you can update the appropriate
server configuration file:
a. In a text editor, such as Notepad, open one of the following server configuration files:
l IC_INSTALL_DIR\IC73\tomcat\conf\server.icsdk.xml
b. In the file, comment the default HTTP connector and remove the commented HTTPS
connector.

Installation and Configuration March 2012 421


Chapter 14: Deploying Client SDK components

c. Search for the XML tag with the following attribute:


sslProtocol="TLS"
d. Substitute the appropriate values for the following attributes of that tag:
l keystoreFile
l keystorePass
e. Save the server configuration file.

422 Installation and Configuration March 2012


Chapter 15: Deploying Web Services

This section includes the following topics:


l Before you deploy Web Services components on page 423
l Installing the Web Services components on page 424
l Configuring a secondary ORB server environment on page 424
l Web Services files on page 424
l Setting up the Web Services Bridge on page 424
l Configuring Web Services on page 429
l Starting and stopping the Web Services server on page 430

! Important:
Important: Read the IC Readme and Avaya IC Installation Planning and Prerequisites before
you deploy Web Services.

Before you deploy Web Services components


Before you deploy Web Services components:
l Install the required third-party software, as described in Avaya IC Installation Planning and
Prerequisites.
l Install and configure all IC prerequisites, as described in Avaya IC Installation Planning
and Prerequisites.
l Install and configure Avaya IC, including all media channels and Avaya FTSE.
l Create and configure agent accounts for agents who will use Web Services, as described
in Configuring agent accounts on page 327.

Installation and Configuration March 2012 423


Chapter 15: Deploying Web Services

Installing the Web Services components


Install the Web Services components, as described in Installing IC server and administration
components on page 28.

Configuring a secondary ORB server environment


The Web Services server requires a secondary ORB server. Configure a secondary server
environment, as described in Configuring a secondary ORB server environment on page 37.

Web Services files


The following table describes the contents of the SDK directories created when you install the
Web Services components.

Directory Contents

sdk/WebServices Web Services server files, including the WAR file for Tomcat
sdk/webservices/sample Sample Web Services client files

Setting up the Web Services Bridge


The Web Services server uses the Web Services Bridge to communicate with the IC servers
and databases.
This section includes the following topics:
1. Creating an agent account for the Web Services Bridge on page 425.
2. Creating a Web Services Bridge on page 426.

424 Installation and Configuration March 2012


Setting up the Web Services Bridge

Creating an agent account for the Web Services Bridge


The Web Services Bridge requires a non-human agent account for IC. You use this agent
account when you configure Tomcat for the Web Services server. This account is a DCO Bridge
account.
You must create a unique non-human agent account for each Web Services Bridge in the IC
system. Name each account dcobridgeN. The agent name can also include the name of the
system that hosts the Web Services Bridge.
To create an agent account for the Web Services Bridge:
1. In IC Manager, click the Agent tab.
2. In the left pane, expand the DefaultTenant node.
If you want to create this agent account in a different tenant, expand that node in the left
pane instead of DefaultTenant.
3. Select Agent > New.
4. Click the General tab and enter the information for the fields mentioned in the following
fields:

Field Recommended entry

First Name dcobridgeN (for example, dcobridge2)


Last Name dcobridgeN (for example, dcobridge2)
Preferred Name dcobridgeN (for example, dcobridge2)
Employee ID dcobridgeN (for example, dcobridge2)
Login ID dcobridgeN (for example, dcobridge2)
Domain The same user domain as the Web Services Bridge
that will use this agent account. For example, User1.
Task Load 0
Task Ceiling 0
Site DefaultSite

Installation and Configuration March 2012 425


Chapter 15: Deploying Web Services

5. Click the Security tab and enter the information for the fields mentioned in the following
table:

Field Recommended entry

Password Enter a password for this account.


Confirm Re-enter the password for this account.
Force password Clear this field.
change on login Do not select this field for non-human IC users
Disable login Do not select this field.
Role Select the Agent role.
Note: Do not select any of the other roles.

6. Click OK.

Creating a Web Services Bridge


You must create a Web Services Bridge on the Web Services server system. The Web Services
Bridge is not a true IC server.
To create a Web Services Bridge
1. In IC Manager, click the Server tab.
2. Select Server > New.
3. From the list of servers, select WebServices.
4. Click Ok.
5. Select the General tab and complete the fields shown in the following table.

Field Recommended entry Notes

Name Enter a name for the Web Include the name of the system that
Services Bridge. hosts the Tomcat application server
to identify the location of the Web
Services Bridge.

426 Installation and Configuration March 2012


Setting up the Web Services Bridge

Field Recommended entry Notes

Domain Select an IC User domain for For example, select User1 from the
the Web Services Bridge drop-down list.
from the drop-down list. Ensure that the domain with the Web
Services Bridge fails over to the
following domains:
l Itself

l Default domain

l All domains with an ADU server

Host Enter the IP address of the


system that hosts the Web
Services server.
Port Enter a port assignment for You can use any available port in the
the Web Services Bridge. 9000 range for the Web Services
Bridge. Use port 9003.
Directory Enter the path to the etc For example, enter:
directory for the Web IC_INSTALL_DIR\IC73\etc
Services server.
where IC_INSTALL_DIR is the path
to this directory on the Web Services
server system. For example, if you
used the default, the path is:
C:\Avaya\IC73\etc
Executable Enter wssrv. Leave the default entry.
Tip: This entry exists because
Executable is a required field in IC
Manager. No separate executable
exists for the Web Services
Bridge.

Installation and Configuration March 2012 427


Chapter 15: Deploying Web Services

6. Record the Name value for the Web Services Bridge. You will need this name in
Configuring Web Services on page 429.
7. Select the WebServices tab and complete the fields shown in the following table.

Field Recommended entry Notes

IC User Enter the name of the agent Use the account that you
account for this Web Services created in Creating an agent
Bridge. account for the Web Services
Bridge on page 425.
For example, enter dcobridge1.
IC Password Enter the password
associated with the agent
account.
Enable SSL If 'Enable SSL for DS l Response time for
for DS Authentication' configuration DS.Authenticate over
Authentication parameter is checked, SSL will be slower
DS.Authenticate request will
be sent over SSL by compared to the
WebServices to DS in SSL response time of
encrypted format. It will DS.Authenticate over
support authentication for VESP because of SSL
both LDAP and non-LDAP overhead of handshake,
users. encryption/decryption
If 'Enable SSL for DS etc.
Authentication' configuration
parameter is unchecked, l If 'Enable SSL for DS
DS.Authenticate request will Authentication'
be sent over VESP by configuration parameter
WebServices to DS. The
password will be in MD5 is unchecked,
encrypted format and rest of DS.Authenticate request
the request parameter will be for LDAP enabled users
in plain text format in this will fail. To authenticate
case. It will support LDAP enabled users,
authentication for ONLY DS.Authenticate MUST
non-LDAP users and
authentication for LDAP be sent over SSL by
users will fail. checking 'Enable SSL for
DS Authentication'
configuration parameter.
Skip ADU Checking this option, will
Events for prevent the Webservice server
WebServices from receiving the ADU events.
User By Default, the option is
unchecked and the server will
receive ADU events.

8. Click Ok.

428 Installation and Configuration March 2012


Configuring Web Services

! Important:
Important: Do not start the Web Services Bridge in IC Manager. When you start the Web
Services server in Tomcat, that server starts the Web Services Bridge.

Configuring Web Services


Configure Web Services on all systems that host Web Services components.
To configure Web Services:
1. In a text editor, open the following file:
l Windows: IC_INSTALL_DIR\IC73\tomcat/bin/icwebservices.bat
l Solaris: IC_INSTALL_DIR/IC73/tomcat/bin/icwebservices.sh
l AIX: IC_INSTALL_DIR/IC73/tomcat/bin/icwebservices.sh
2. Navigate to the section between MODIFICATION SECTION BEGIN and MODIFICATION
SECTION END.
3. Update the following parameters in this section to match your development environment:

Parameter Notes

AVAYA_IC_WEBCLIENT_URL Enter the correct protocol, host name, and port


for the system that hosts IC Web Services:
http://<ws_System>:[<ws_port>]
For example, if you install Web Services on
icwsbox.customuser.com, enter:
http://icwsbox.customuser.com:9800/
AVAYA_IC_VESP_ Enter the name of the Web Services Bridge
JAVAAPPBRIDGE_NAME hosted on the system.
Note: This value is case sensitive.

4. Save the file.


5. Execute the following command on the command prompt to create Windows service:
IC_INSTALL_DIR\IC73\tomcat\bin\icwebservices.bat install
<ServiceId> <Service Name or Description> server.icwebservices.xml
Note:
Note: You need to execute the above command only on Windows platform. You do not
need to create this service for Solaris AIX.

Installation and Configuration March 2012 429


Chapter 15: Deploying Web Services

Starting and stopping the Web Services server


This section includes the following topics:
l Starting and stopping the Web Services server on Windows on page 430
l Starting and stopping the Web Services server on Solaris on page 430
l Starting and stopping the Web Services server on AIX on page 431

Starting and stopping the Web Services server on Windows


To start, stop and configure the Web Services server on Windows:
1. In the Services control panel, right-click the IC 7.3 Web Services.
2. From the right-click menu, select one of the options in the following table:

Task Options

Start Web Services Select Start.


Stop Web Services Select Stop.
Set startup options 1. Select Properties.
2. Select Automatic from the Startup Type drop-down
list.
3. Click Ok.

Starting and stopping the Web Services server on Solaris


Execute all Web Services server commands from the IC_INSTALL_DIR/IC73/bin directory.
For the Web Services server to be able to log in, the IC servers must start first.

Starting the Web Services server: To start the Web Services server, execute the following
command:
nohup ./ictomcat.sh start webservices

Stopping the Web Services server: To stop the Web Services server, execute the following
command where -force is an optional parameter that terminates the server processes:
nohup ./ictomcat.sh stop webservices -force

430 Installation and Configuration March 2012


Starting and stopping the Web Services server

Starting and stopping the Web Services server on AIX


Execute all Web Services server commands from the IC_INSTALL_DIR/IC73/bin directory.
For the Web Services server to be able to log in, the IC servers must start first.

Starting the Web Services server: To start the Web Services server, execute the following
command:
nohup ./ictomcat.sh start webservices

Stopping the Web Services server: To stop the Web Services server, execute the following
command where -force is an optional parameter that terminates the server processes:
nohup ./ictomcat.sh stop webservices -force

Enabling the Web Services server for SSL


To enable the Web Services server for SSL:
1. Set up Tomcat, as described in http://tomcat.apache.org/tomcat-5.5-doc/ssl-howto.html.
If these links become inaccessible, go to http://tomcat.apache.org and search for SSL
Configuration for more information.
2. If your Tomcat configuration includes the SSL connector, you can update the appropriate
server configuration file:
a. In a text editor, such as Notepad, open one of the following server configuration files:
l IC_INSTALL_DIR\IC73\tomcat\conf\server.icwebservices.xml
b. Search for the XML tag with the following attribute:
sslProtocol="TLS"
c. Substitute the appropriate values for the following attributes of that tag:
l keystoreFile
l keystorePass
d. Save the server configuration file.

Installation and Configuration March 2012 431


Chapter 15: Deploying Web Services

432 Installation and Configuration March 2012


Appendix A: Configuring a localized
version

To configure a localized version of IC, perform the steps in the following topics during the
installation:
l About localized versions of IC on page 434.
l About the NLS Lang setting for Oracle on page 434.
l Enabling Database Designer for localization on page 436.
l Configuring Avaya Agent for a supported language on page 438.
l Configuring IC for multiple languages on page 439.
l Importing localized seed data on page 440.
l Configuring the Website for supported languages on page 440.
l Setting language properties for agents on page 441.
l Localizing string table messages on page 443.
l Configuring a Notification server for alternate email encodings on page 444.
l Configuring an HTTP Connector server for Traditional Chinese on page 445.
l Configuring an HTTP Connector server for Russian on page 445.
l Configuring the Customer HTML Chat Client for Japanese IMEs (optional) on page 446.

Installation and Configuration March 2012 433


Appendix A: Configuring a localized version

About localized versions of IC


The localized version of an IC release allows IC agent desktop applications to run in the
supported languages for that release.
Typically, the localized version is delivered thirty days after the English release. However, for
some releases, the localized version is delivered with the English release.
Where necessary, the topics in this section provide instructions for both types of delivery.
The following are known limitations of localization in IC:

Menu items may not be localized: Some menu items in Avaya IC applications are not
completely localized. These items display in English. For example, you may see English text in
some secondary built in forms and menu items, and on OK and Cancel buttons on some dialog
boxes.

Accelerator keys do not work in Russian: Accelerator keys do not work for Web Agent in
Russian. Ensure agents who work with Web Agent in Russian are aware that accelerator keys
will not work.
For a list of the languages supported for a specific release, see Avaya IC Installation Planning
and Prerequisites.

About the NLS Lang setting for Oracle


If your IC system includes an Oracle database, you must specify the NLS Lang property on the
Initial Configuration tab of the Configuration Tool when you configure a primary or secondary
server environment. The Configuration Tool automatically adjusts these settings when you
provide the NLS_LANG parameter in the Initial Configuration tab.
Note:
Note: The NLS Lang setting must match the value used to create the Oracle database.
This value must include UTF8, because IC requires a UTF8 database.
This section includes the following topics:
l About the NLS Lang property on page 435.
l Where Oracle specifies the NLS Lang property on page 435.
l Cautions for the NLS Lang property on page 435.
l NLS Lang settings for supported languages on page 435.
For more information, see the Oracle documentation.

434 Installation and Configuration March 2012


About the NLS Lang setting for Oracle

About the NLS Lang property


Oracle uses National Language Support (NLS LANG) values to set up language-specific
databases. The character set part of the NLS_LANG parameter specifies the character set used
by the Data server.

Where Oracle specifies the NLS Lang property


On Solaris, NLS_LANG is specified as an environment variable.
On Windows, NLS_LANG is set in the registry under the following:
HKEY_LOCAL_MACHINE > SOFTWARE > ORACLE > HOMEn

Cautions for the NLS Lang property


Do not use abbreviations in the NLS LANG parameter. For example, do not use "US" to
designate American English. You must use AMERICAN_AMERICA.UTF8.
The character set in the NLS LANG parameter must match the character set of your Oracle
database. If these character sets are different, strange character conversions and string
truncations may result.

NLS Lang settings for supported languages


The following table includes the NLS Lang settings for the languages supported in this IC
release.

Language NLS Lang Setting

English AMERICAN_AMERICA.UTF8
Spanish SPANISH_SPAIN.UTF8
German GERMAN_GERMANY.UTF8
French FRENCH_FRANCE.UTF8
Italian ITALIAN_ITALY.UTF8
Portuguese BRAZILIAN PORTUGUESE_BRAZIL.UTF8
Simplified Chinese SIMPLIFIED CHINESE_CHINA.UTF8

Installation and Configuration March 2012 435


Appendix A: Configuring a localized version

Language NLS Lang Setting

Korean KOREAN_KOREA.UTF8
Japanese JAPANESE_JAPAN.UTF8
Thai THAI_THAILAND.UTF8
Traditional Chinese TRADITIONAL CHINESE_TAIWAN.UTF8
Russian RUSSIAN_CIS.UTF8

Enabling Database Designer for localization


To use Database Designer with languages other than English, you must add a Localization
section to the Database Designer INI file (qdesigner.ini). This section identifies the character
encoding that you are using for translations in your locale.
When you open an ADL file for localization, your Database Designer INI file must contain a
Localization section with character encoding that matches the language in the localized design.
The Localization section includes the following:
l ISO-639-1 (alpha 2) two letter language abbreviations
l Character encoding used in the output generated by Database Designer
The two letter language abbreviation also identifies the language in all language-specific files.

! Important:
Important: You must host Database Designer on a system with an operating system that
supports the target encoding. For example, you can use a localized version of
Windows, or set the default system locale to the correct region in the Regional
Options section of the Windows Control Panel.
To enable localization in Database Designer:
1. With Database Designer closed, open the Database Designer INI file (qdesigner.ini) in
Notepad or another text editor.
The Database Designer INI file is installed in the Windows directory. For example, in the
systems using Windows, the Windows directory is typically C:\Windows.

436 Installation and Configuration March 2012


Enabling Database Designer for localization

2. Add a Localization section at the end of the INI file, including values for TargetLanguage
and TargetEncoding fields to match the desired locale using the information in the
following table:

Language Language Code Localization Section Update

English en [Localization]
;English
TargetLanguage=en
TargetEncoding=windows-1252
Spanish es [Localization]
;Spanish
TargetLanguage=es
TargetEncoding=windows-1252
German de [Localization]
;German
TargetLanguage=de
TargetEncoding=windows-1252
French fr [Localization]
;French
TargetLanguage=fr
TargetEncoding=windows-1252
Italian it [Localization]
;Italian
TargetLanguage=it
TargetEncoding=windows-1252
Portuguese pt [Localization]
;Portuguese
TargetLanguage=pt
TargetEncoding=windows-1252
Simplified Chinese zh [Localization]
;Simplified Chinese
TargetLanguage=zh
TargetEncoding=gb2312
Korean ko [Localization]
;Korean
TargetLanguage=ko
TargetEncoding=korean

Installation and Configuration March 2012 437


Appendix A: Configuring a localized version

Language Language Code Localization Section Update

Japanese ja [Localization]
;Japanese
TargetLanguage=ja
TargetEncoding=shift_jis
Thai th [Localization]
;Thai
TargetLanguage=th
TargetEncoding=windows-874
Traditional Chinese zt [Localization]
;Traditional Chinese
TargetLanguage=zt
TargetEncoding=Big5
Russian ru [Localization]
;Russian
TargetLanguage=ru
TargetEncoding=windows-1251

3. Save the INI file.


4. Close the text editor.

Configuring Avaya Agent for a supported language


You do not need to perform these steps for Avaya Agent Web Client. Only perform these steps
for Avaya Agent.
To configure Avaya Agent for a supported non-English language:
1. When you generate your Interaction Center data source (as discussed in Generating the
Interaction Center application on page 93):
a. Check the Avaya Agent Layout box and select an Avaya Agent Layout for the
appropriate language.
b. Check the EDU Layout box and select an EDU Layout for the appropriate language.
If you do not know the directory path, select the Ellipsis (…) button and navigate to
the directory.
2. To create and run the Agent Installer, follow the instructions in Creating installation files for
agent applications on page 351.

438 Installation and Configuration March 2012


Configuring IC for multiple languages

Configuring IC for multiple languages


If your IC system requires that Avaya Agent or Avaya Agent Web Client run in multiple
languages, you must store the messages for each language in the database. Perform these
steps after you generate the Interaction Center data source for the first language.
To configure Avaya Agent for multiple languages:
1. Close Database Designer if you have it open.
2. Update the [Localization] section of the Database Designer INI file for the language.
For more information, see Enabling Database Designer for localization on page 436.
3. In Database Designer, open the CCQ ADL file.
4. Select File > Generate Windows Application.
5. In the Generate Windows Application dialog box:
a. Check the Messages box only.
b. Check the Avaya Agent Layout box and select an Avaya Agent Layout for the
appropriate language.
c. Check the EDU Layout box and select an EDU Layout for the appropriate language.
To find the path, select the Ellipsis (…) button and navigate to the directory.
d. Select interaction_center from the Name list.
e. Type the path for the directory where you want Database Designer to store the
application files.
For example, type AVAYA_IC73_HOME\apps.
To find the path, select the Ellipsis (…) button and navigate to the directory.
f. From the DB Connection Set drop-down list, select defaultDBConnectionSet.
g. If the fields in the following table do not have entries, re-enter your IC Manager
account and password.

Field Recommended entry

Login Id Type your IC Manager login ID.


Note: Do not use your DBA login ID and password.
Password Type your password.

h. Click Ok.
Repeat these steps for each additional language.

Installation and Configuration March 2012 439


Appendix A: Configuring a localized version

Importing localized seed data


The localized seed data allows your IC system to have localized interfaces for the Website. You
perform these steps on the system that hosts Database Designer.
To install the localized seed data:
1. In Notepad or another text editor, open the following file: IC_INSTALL_DIR\IC73\
design\CallCenterQ\data\L10N\seed_L10N.cfg.
2. Verify that the DestinationPasswd field has the correct password for the Admin account.
3. Save the seed_L10N.cfg file.
4. Open a command window.
5. Navigate to IC_INSTALL_DIR\IC73\design\CallCenterQ\data\L10N.
6. Run the following file to import the localized seed data: import_seed_L10N.bat

Configuring the Website for supported languages


To configure your Website for supported languages:
1. In IC Manager, select Services > MultiTenancy Administration.
2. Select Define Languages from the Tenants Admin menu.
3. In the Properties box:
a. Select a language code.
For both Simplified Chinese and Traditional Chinese, select zh.
b. Assign a country/region code:
l For Traditional Chinese, select TW.
l For all other supported languages, leave the country/region code blank.
c. Type a default description.
d. Type a default display name.
e. Select Add Language.
If IC cannot find a property for a supported language, IC will use the default language.
English is always the default language for the default tenant.

440 Installation and Configuration March 2012


Setting language properties for agents

Setting language properties for agents


When you configure the language for an agent, you specify the language that the agent desktop
applications use. You must set this property for all agents who work with an agent desktop
language other than English.
Note:
Note: Web Agent obtains the language setting from Avaya Agent. You do not need to
configure the language for Web Agent separately.
To configure the agent language property for agents:
1. In IC Manager, select Tools > Groups.
2. Select the Properties tab.
3. Select the IC node in the left pane.
4. In the Sections list, select Agent.
5. Double-click the UILanguage property.
6. In the Edit Property UILanguage dialog box:
a. From the Property Value drop-down list, select one of the values in the following
table:

Value Language

de German
en English
es Spanish
fr French
it Italian
ja Japanese
ko Korean
pt Portuguese
ru Russian
th Thai

Installation and Configuration March 2012 441


Appendix A: Configuring a localized version

Value Language

zh Simplified Chinese
zt Traditional Chinese
Note: zt is a non-standard two letter language
code that certain components of IC use
differentiate between Traditional Chinese and
Simplified Chinese.

b. Click Ok.
7. For languages that have regional variations of a particular language, such as Simplified
Chinese and Traditional Chinese:
a. Double-click the UICountryOrRegion property.
b. From the Property Value drop-down list, select one of the values in the following
table.

Value Language

CN China (Simplified Chinese)


TW Taiwan (Traditional Chinese)

Setting the UICountryOrRegion property also allows for regional differences in the
date and time formats. For more information about how to customize Avaya Agent
Web Client for regional differences, see Avaya Agent Web Client Customization.
c. Click Ok.
8. Click Ok.

442 Installation and Configuration March 2012


Localizing string table messages

Localizing string table messages


You can use the Localization node in Database Designer to localize messages in the string
table. For more information, see IC Database Designer Application Reference.
This section includes the following topics:
l Translating string table messages on page 443.
l Deleting string table messages on page 443.

Translating string table messages


To translate string table messages:
1. Under the Localization placeholder, select String Table in the tree view.
The String Table Properties tab opens and displays all available string table messages.
2. In the String Table Properties tab, select the message to be translated.
3. Select the message text in the String Text column.
4. Delete the message text and type in the translation.
5. Select File > Save to save the ADL file with the localized string table entries and generate
the ALM file.

Deleting string table messages


If you delete a string table message that is connected to a form, the Avaya Business Application
will not be able to display the message to the user.
To delete a string table message.
1. In the String Table Properties tab, select the message to be deleted.
2. Select Delete.

Installation and Configuration March 2012 443


Appendix A: Configuring a localized version

Configuring a Notification server for alternate email


encodings
The Notification server uses a default Microsoft Windows codepage value for the outgoing email
charset. You can override this value on the Configuration tab of the Notification server in IC
Manager.
For example, if you want to use an alternate email encoding for a supported languages, such as
iso-2022-jp instead of Windows-932 (Shift-JIS) for Japanese, you need to configure the
Notification server to accept the alternate email encoding.
To configure a Notification server for alternate email encodings:
1. In IC Manager, double-click the HTTP Connector server in the lists of servers.
2. Select the Configuration tab.
3. Select New.
4. In the CTI Type Editor dialog box:
a. Complete the fields as shown in the following table:

Field Recommended entry

CTI Type Couple


Name charset
This field is case-sensitive.
Value EmailCharset
where EmailCharset is the character set for the alternate email
encoding. For example, type iso-2022-jp for Japanese.

b. Click Ok.
5. Click Ok.
6. Stop and restart the Notification server.

444 Installation and Configuration March 2012


Configuring an HTTP Connector server for Traditional Chinese

Configuring an HTTP Connector server for Traditional


Chinese
To configure an HTTP Connector server for Traditional Chinese:
1. In IC Manager, double-click the HTTP Connector server in the lists of servers.
2. Select the Configuration tab.
3. Select New.
4. In the CTI Type Editor dialog box:
a. Complete the fields as shown in the following table:

Field Recommended entry

CTI Type Couple


Name charsetmap
This field is case-sensitive.
Value Big5:Big5

b. Click Ok.
5. Click Ok.
6. Stop and restart the HTTP Connector server.

Configuring an HTTP Connector server for Russian


To configure an HTTP Connector Server for Russian:
1. In IC Manager, double-click the HTTP Connector server in the lists of servers.
2. Select the Configuration tab.
3. Select New.

Installation and Configuration March 2012 445


Appendix A: Configuring a localized version

4. In the CTI Type Editor dialog box:


a. Complete the fields as shown in the following table:

Field Recommended entry

CTI Type Couple


Name charsetmap
This field is case-sensitive.
Value windows-1251:cp1251

b. Click Ok.
5. Click Ok.
6. Stop and restart the HTTP Connector server.

Configuring the Customer HTML Chat Client for Japanese


IMEs (optional)
Some Japanese Input Method Editors (IMEs) use the Enter key to select characters. If a
Website customer uses one of these IMEs, the Customer HTML Chat Client may respond to the
Enter key and send the message prematurely. You can configure the Customer HTML Chat
Client not to automatically send a message when a customer presses the Enter key.
If you disable Send on Enter, the Website customer must select Send in the Customer HTML
Chat Client to send a chat message to an agent.
To configure the Customer HTML Chat Client for Japanese IMEs:
1. In IC Manager, select Services > MultiTenancy Administration.
2. Select Tenant Properties in the Tenant Admin menu.
3. Select the tenant you want to customize from the Select a Tenant drop-down list.
4. Select Customize Tenant.
5. In the Customize Tenant page:
a. Select Japanese from the Select Language drop-down list at the top of the page.
b. Select chat.
c. Scroll down to the chat.htmlclient.entry.sendonenter property.
d. Change the value of this property to 0.
e. Select Update Data at the bottom of the page.

446 Installation and Configuration March 2012


Appendix B: Troubleshooting

This section includes the following troubleshooting topics:


l Troubleshooting installation and configuration on page 447
l Troubleshooting the Configuration Tool on page 450
l Troubleshooting the IC servers on page 451
l Troubleshooting the refresh in IC Manager on page 456
l Troubleshooting Web Management on page 457
l Troubleshooting Avaya FTSE on page 474
l Troubleshooting Avaya Agent and Web Agent issues on page 477
l Troubleshooting Avaya Agent Web Client on page 482
l Changing default service ports on page 490
l Troubleshooting Windows configuration on page 493
l Troubleshooting IIS applications on page 493
l Uninstalling IC on page 494
Additional troubleshooting information is available in the following documentation:
l IC Readme and Readme Addendum
l Alarm Monitor online help in IC Manager
l Documentation for each IC component
If you encounter an issue not in the documentation, contact Avaya Technical Support.

! Important:
Important: Always consult the log files for information that can assist you in troubleshooting
the problem. Always backup and retain the relevant log files until you have
resolved the problem.

Troubleshooting installation and configuration


This section includes the following problems that can occur during IC installation and
configuration:
l IC installer does not display or stops abruptly on Solaris on page 448

Installation and Configuration March 2012 447


Appendix B: Troubleshooting

l IC requests time-out without completing on page 448


l libftet.so file is missing on Solaris on page 449
l Cannot start a service for a Web application with httpserver.sh on page 449
l Agent installer does not open on Windows 2000 Professional on page 449
l Uninstallation of IC on Unix platform in silent mode on page 449

IC installer does not display or stops abruptly on Solaris


Problem: The IC installation on Solaris does not display anything on the monitor or stops
abruptly.

Solution: Verify that the DISPLAY property is set and the following temporary folder has
sufficient space:
l Solaris: /var/tmp

IC installer does not display or stops abruptly on AIX


Problem: The IC installation on AIX does not display anything on the monitor or stops abruptly.

Solution: Verify that the DISPLAY property is set and the following temporary folder has
sufficient space:
l AIX: /tmp

IC requests time-out without completing


Problem: IC requests time-out without completing. For example, the ORB server or Avaya IC
ORB Service 7.3 do not start automatically on a Windows computer. If you change the system
clock in large increments (over 2-3 seconds per minute) when IC is running, IC requests may
fail with "Time-out" error.

Solution: Do not change the system clock in large increments when IC is running. Potential
solutions are as follows:
l Use a time synchronization utility. Some commercial time synchronization products may
provide gradual clock corrections over time. For more information, see Avaya IC
Installation Planning and Prerequisites.
l For the Tardis time synchronization utility, verify the configuration. Tardis may make large
time changes at unpredictable times that causes service requests to time out. To avoid this
time-out problem, set the time adjustment increments in milliseconds, as follows:
- For Maximum correction allowed, set in a range from a minimum of 50 milliseconds
to a maximum of 500 milliseconds

448 Installation and Configuration March 2012


Troubleshooting installation and configuration

- For How often the time is set, set to Every Minute


For information, see Avaya IC Installation Planning and Prerequisites and the Tardis online
help.

libftet.so file is missing on Solaris


Problem: On Solaris, IC displays an error message about missing the libftet.so file when
starting a Tomcat application.

Solution: Re-install IC server components on the Tomcat system, including Avaya FTSE as
described in Installing IC server and administration components on page 28.

Cannot start a service for a Web application with httpserver.sh


Problem: Cannot start a service for a Web application with the httpserver.sh start script.
This problem typically occurs because the .../HTTPServer/conf.httpd.conf file
includes multiple instances of ictomcat.cfg.

Solution: Do the following:


1. In a text editor, open the .../HTTPServer/conf.httpd.conf file and remove the
multiple entries for ictomcat.cfg.
2. Restart the IBM HTTP server, as described in Starting and stopping IBM http Web
server on page 143.

Agent installer does not open on Windows 2000 Professional


Problem: Agent installer does not open on Windows 2000 Professional and Java process
hangs. This problem is seen typically when you access the system through pcAnywhere. Avaya
Agent includes a Java 1.4.2 supported user interface. pcAnywhere has a known issue with Java
1.4.2 user interfaces on Windows 2000 operating systems.

Solution: To run the agent installer:


1. Uninstall pcAnywhere.
2. Install and use a different remote control software for the agent desktop system.

Uninstallation of IC on Unix platform in silent mode


When uninstalling IC on Unix platform in silent mode, an error message "Bad string" is
displayed followed by "Installation Complete" message. The application is successfully
uninstalled even after this message. You can ignore the two messages during uninstallation.

Installation and Configuration March 2012 449


Appendix B: Troubleshooting

Troubleshooting the Configuration Tool


This section includes the following problems that can occur when you use the Configuration
Tool:
l Cannot access the Initial Configuration tab again to update values on page 450
l Apply Settings is not enabled in the Configuration Tool on page 450
l Configuration Tool fails to load vesp.imp on page 450
l Configuration Tool does not install ISAPI extensions in IIS properly on page 451

Cannot access the Initial Configuration tab again to update values


Problem: Cannot access the Initial Configuration tab again to update or change the values
chosen to configure the server or client environment.

Solution: To access the Initial Configuration tab after you have configured the server or client
environment on a system:
1. Rename the vesp.imp file in IC_INSTALL_DIR\IC73\etc to vesp_old.imp.
2. Start the Configuration Tool.

Apply Settings is not enabled in the Configuration Tool


Problem: After you make a change to a field in the Configuration Tool, Apply Settings is not
enabled.

Solution: If Apply Settings is still not enabled, close and reopen the Configuration Tool.

Configuration Tool fails to load vesp.imp


Problem: When configuring a secondary ORB server environment, the Configuration Tool
displays the following message: Failed to load vesp.imp.

Solution: Do the following, then rerun the Configuration Tool:


1. Backup the following logs:
l General.log
l General_Admin.log
l Admin.log
2. Verify the following values in the Initial Configuration tab.
l IC Login and Password must be valid.

450 Installation and Configuration March 2012


Troubleshooting the IC servers

l ORB port must match the port of the ORB server on the primary system.
3. Make sure you can "ping" the primary hostname.
4. Make sure that you started the Configuration Tool from the Start menu or from within the
working directory of IC_INSTALL_DIR\IC73\bin.
5. If none of the above solutions work:
a. Navigate to IC_INSTALL_DIR\IC73\bin and execute configure -d
b. Backup the following logs again: General.log, General_Admin.log, and Admin.log.
c. Contact Avaya Technical Support and provide both versions of the logs that you
backed up.

Configuration Tool does not install ISAPI extensions in IIS properly


Problem: After configuring the IC Website, the Configuration Tool did not install the ISAPI
extensions in Microsoft IIS properly.

Solution: Review the events in the Windows Event Viewer:


1. Look for recent Application events with WSH as the resource.
2. Look for the following events, which show where the ISAPI installation script began and
ended:
l ConfigTool install IIS components - started...
l ConfigTool install IIS components - finished.
3. Review all events that occurred between these two events to identify the problems that
caused the ISAPI extension installation to fail.

Troubleshooting the IC servers


This section includes the following topics:
l Troubleshooting server communication issues on page 452
l Troubleshooting the Data server on page 453
l Troubleshooting the Workflow server on page 455
l Troubleshooting the Attribute server on page 456

Installation and Configuration March 2012 451


Appendix B: Troubleshooting

Troubleshooting server communication issues


This section includes the following problem that can occur with server communications:
l IC servers on the same system cannot communicate when disconnected from network on
page 452

IC servers on the same system cannot communicate when disconnected


from network
Problem: If a system that hosts IC servers is disconnected from the network, the servers on
that system may not be able to communicate with each other. This problem may cause agents
who are currently logged into the system to not recover properly from the network failure when
the network connection on the IC server system is reestablished.
This problem occurs if a network cable is unplugged from a system that hosts IC servers. All
servers that use the IP Address to locate another server will not be able to communicate with
those servers, even if those servers are on the same box.
This problem may exist on all supported operating systems. For a discussion of the issue on
Windows, see the following Microsoft article:
http://support.microsoft.com/default.aspx?scid=KB;en-us;q239924

Solution: The following possible solutions exist for this problem:


l For Windows, see the workaround in the Microsoft article.
l For all supported operating systems, consider the following solution:
a. Connect the IC server systems to a network hub, as follows:
IC servers -------> Hub -------------> Rest of the network
b. If the Avaya IC Server system needs to be disconnected from the rest of the network,
do the following:
IC servers --------> Hub -----X------> Rest of the network
Do not do the following:
IC servers ---X---> Hub ------------> Rest of the network

452 Installation and Configuration March 2012


Troubleshooting the IC servers

Troubleshooting the Data server


This section includes the following problems that can occur when you configure a Data server:
l Error message: Cannot find implementation on page 453
l Error message: ld.so.1: IC_INSTALL_DIR\IC73\ qorasrv: fatal: libclntsh.so.8.0: open
failed: No such file or directory on page 453
l Data server fails for an IC system that includes an Oracle database on page 454
l Error message: SQL1220 when issuing db2start or SQL1084 when trying to connect to a
database when running the 32-bit DB2 version 8.2 on AIX 6.1 with the Olson timezone
format on page 454
l DB2 SQL1131N DARI error occurs for IBM DB 9.5 on AIX 6.1 on page 454

Error message: Cannot find implementation


Problem: IC Manager displays the following error message: Cannot find implementation. This
problem typically occurs if IC Manager has not updated one of the following servers with the
Data server configuration:
l ORB server
l Directory server

Solution: Do the following:


1. Update the ORB server:
a. Right-click on the ORB server.
b. Select Update.
c. Start the Data server.
2. If you continue to get the same message:
a. Stop and start the Directory server.
b. Start the Data server.

Error message: ld.so.1: IC_INSTALL_DIR\IC73\ qorasrv: fatal:


libclntsh.so.8.0: open failed: No such file or directory
Problem: ORACLE_HOME is set to the wrong value.

Solution: Use the Configuration Tool to set ORACLE_HOME to the correct value.

Installation and Configuration March 2012 453


Appendix B: Troubleshooting

Data server fails for an IC system that includes an Oracle database


Problem: The Data server fails for an Avaya IC system that includes an Oracle database, and
the log file for the Data server includes the following error: OCI Error: ORA-04031

Solution: Increase the value for the shared pool size. The shared pool size is a configuration
parameter for the Oracle database.

Error message: SQL1220 when issuing db2start or SQL1084 when trying to


connect to a database when running the 32-bit DB2 version 8.2 on AIX 6.1
with the Olson timezone format
Problem: Running a 32-bit DB2 Version 8.2 server on AIX 6.1 encounters errors when using an
Olson timezone format (TZ=US/pacific).
In this configuration, AIX's ICU (International Unicode) component memory maps files conflict
with DB2's use of shared memory.
Prior to the 32-bit DB2 Version 8.2 FP16, the SQL1220 error message arrives on db2start.
On 32-bit DB2 version 8.2 FP16 or higher, due to unrelated changes, an error occurs later when
attempting the first connection to or activation of a database, at which point SQL1084 will be
received.

Solution: To resolve the error, switch to a POSIX timezone format. For example, TZ=EST5. An
alternative solution on FP16 or later is to enable Extended Shared Memory setting (EXTSHM)
on AIX.

Recommendation: Due to this error, set the system timezone format (TZ) of the server running
the DB2 server using the POSIX format as described above.

DB2 SQL1131N DARI error occurs for IBM DB 9.5 on AIX 6.1
Problem: While configuring the DB2 database, updating the agent records or email accounts,
the Alarm Monitor displays the SQL1131N DARI (Stored Procedure) process has been
terminated abnormally. SQLSTATE=38503 error message. Intermittently, you can observe
this error while doing other operations.

Solution: In order to resolve the error, you must run the following commands on the DB2 CLI
prompt.
1. db2 update dbm cfg using keepfenced no
2. db2stop force
3. db2start

454 Installation and Configuration March 2012


Troubleshooting the IC servers

Running these commands sets the KEEPFENCED parameter value to NO for the entire DB
database. Setting this parameter might impact the performance. To improve the performance,
you must turn the logging off by removing or commenting the logging related information in the
db2cli.ini file. The db2cli.ini files looks as shown below:

[tstcli1x]
uid=userid
pwd=password
autocommit=0
TableType="'TABLE','VIEW','SYSTEM TABLE'"

[tstcli2x]
; Assuming dbalias2 is a database in DB2 for MVS.
SchemaList="'OWNER1','OWNER2',CURRENT SQLID"

[MyVeryLongDBALIASName]
dbalias=dbalias3
SysSchema=MYSCHEMA

You can observe that the [Common] section, which contains logging information is not available
in the file. You can also comment the logging options available in the [Common] section.
After settings these parameters, follow the steps mentioned in the Avaya IC Installation
Planning and Prerequisites to configure the DB database.

Troubleshooting the Workflow server


This section includes the following problems that can occur when you configure a Workflow
server:

Workflow server cannot assign to an IC server


Problem: The Workflow server is unable to assign to another IC server. For example, the
Workflow server cannot assign to an ADU server. This problem typically occurs because:
l The channel configuration of the Workflow server is set to "Server type".
l The name of the other IC server is identical to the server type.

Solution: To enable the Workflow server to assign to the other IC server:


1. Rename the other server, following the Server naming guidelines on page 109.
2. Restart the Workflow server.
3. Verify that the Workflow server can assign to the other server.

Installation and Configuration March 2012 455


Appendix B: Troubleshooting

Troubleshooting the Attribute server


This section includes the problems that can occur with Attribute server.

Attribute server is unable to bind the port and raises an error message
Problem: Intermittently the Attribute Server raises unable to bind the port error message and
does not start.

Solution: The error can occur due to the port 2300 being used by another process or
application.
Perform the following steps to resolve this problem:
1. In IC Manager, stop the Attribute server. For more information, Starting and stopping
servers in IC Manager on page 136
2. In the list of servers, double-click the Attribute server to edit the configuration.
3. Click the Attribute tab.
4. In the Port field, change value from 2300 to a new value, such as 2325 or 2350.
5. Click Ok to save changes.
6. Start the Attribute server.

Troubleshooting the refresh in IC Manager

Tip:
Tip: Attempt to refresh IC Manager after each step.
If you do not receive a Success message after you refresh IC Manager:
1. Stop and then restart the Directory server.
2. If you still do not receive a Success message, stop and then restart the Data server.
3. If you still do not receive a Success message, check the connections to the database.
4. If you still do not receive a Success message, exit IC Manager, then log back in.

456 Installation and Configuration March 2012


Troubleshooting Web Management

Troubleshooting Web Management


This section includes the following topics:
l Troubleshooting the ICM server on page 457
l Troubleshooting Website pages on page 461
l Troubleshooting Web Management integration on page 466
l Troubleshooting DataWake on page 470
l Web Management configuration files on page 471
l ICM server configuration files on page 471
l Web Management log files on page 472
l ICM server log files on page 472
l Web Scheduled Callback log files on page 473

Troubleshooting the ICM server


This section includes the following problems that can occur with the ICM server:
l Chat failure - login connections on page 457
l Chat failure - no resources on page 458
l Chat failure - system out of service on page 459
l Transcript failure - transcript not sent on page 460
l ICM server cannot bind to ports on page 460
l Customer chat reports busy lines when ICM server running on page 461.

Chat failure - login connections


Problem: Login connection errors prevent a chat from occurring. This problem can display
several symptoms, including:
l ICM server is running but cannot log into IC core servers.
l The icmlog.txt file may include the following repeated message:
initToolkit@IcmParmMgr - Error: Toolkit Login Failed
l ICM server may have an invalid login in the systemParms.txt file.
l The IC environment may not be properly configured.

Installation and Configuration March 2012 457


Appendix B: Troubleshooting

Solution: Do the following:


1. Verify that AVAYA_IC_HOME system variable is set to IC_INSTALL_DIR\IC73\.
2. Verify that the IC core servers are up and running.
3. Verify that the vesp.imp configuration file is up-to-date in the IC_INSTALL_DIR\IC73\
etc directory.
4. If necessary, re-run the Configuration Tool on the system that hosts the ICM server,
making sure that the IC Login and IC Password fields contain valid information.
5. Restart the ICM server, as described in Starting and stopping IC services on page 138.

Chat failure - connection issues


Problem: Connection errors prevent a chat from occurring. This problem can display several
symptoms, including:
l ICM server is running, but unable to bind to its service ports (9501-9520). Another server is
using these ports.
l ICM server or another java process may have been started while another ICM server was
running (either as a Windows service or Java application).

Solution: To resolve this problem:


1. Stop all instances of the ICM service or icm java application (javaw.exe).
Be careful terminating the ICM java applications. You must determine which javaw.exe
process represents the ICM.
2. Reconfigure the ICM ports as described in Changing the default ICM service ports on
page 490.
3. Restart the ICM server, as described in Starting and stopping IC services on page 138.

Chat failure - no resources


Problem: The ICM server is running but cannot read the configuration data from database due
to PDM initialization failure or PDM query error. The PDM file may not be properly configured,
the database login credentials may be incorrect, The database client software may be
improperly configured, or the Data server or Database server may be down.
This problem can display several symptoms, including:
l The Chat application displays an establishing connection message then hangs.
l The Chat application displays an establishing connection message, then displays "Missing
Phrase" repeatedly.
l Error messages in the <icm_name>_website.log file indicate a problem with the PDM.

458 Installation and Configuration March 2012


Troubleshooting Web Management

Solution: To resolve this problem:


1. Verify that the Data server is running.
2. Verify that the Database server is running, as shown in the following table:

Database Verification steps

SQL Server Verify that:


l SQL Server DSNs are configured correctly.

l Database application is running.

Oracle Verify that:


l Oracle client software is installed.

l Oracle Service Name is correctly configured on the


client.
l Oracle DSN for ccq is created.

DB2 Verify that the DB2 client software is installed.

3. Restart the Tomcat server that hosts your Website application, as described in Starting and
stopping IC services on page 138:
4. If these do not resolve the problem, re-run the Configuration Tool on the system that hosts
the ICM server with the following information In the Web tab:
l Make sure the IC Login and IC Password fields contain a valid IC login and
password.
l Make sure the Database Login and Database Password fields contain a valid DBA
login ID and password for the database server.
l Check Configure Website.

Chat failure - system out of service


Problem: When you initiate a chat session from the Website, the chat client displays a
message stating that the server connection is established, then displays a "System is Out of
Service" message.
l The icmlog.txt file contains an "Agent Router Not Ready" error.
l The Alarm Monitor in IC Manager displays an "Error calling WACD Assign" alarm.

Solution: The solution depends upon the cause of the problem. Try each of the following
solutions:
If the ICM server is running, but either the ICM Bridge in the Attribute server or the functional
WebACD server is not available:
1. In IC Manager, start the Attribute server.

Installation and Configuration March 2012 459


Appendix B: Troubleshooting

2. Verify that the Attribute server can start the WebACD server.
If the ICM server is running but the ICM Bridge has not been configured correctly:
1. Verify the configuration of the Attribute server as described in Creating the Attribute
server on page 195.
2. Restart the Attribute server.
If the ICM, Attribute, and WebACD servers are running and the ICM Bridge has been
configured, but the ICM Bridge cannot login, or can login but cannot connect to the WebACD
server:
1. Verify the configuration of the Attribute server as described in Creating the Attribute
server on page 195.
2. Verify that the IC Login name and password in the ICM Bridge are valid. Re-type password
if necessary.
3. Restart the Attribute server.

Transcript failure - transcript not sent


Problem: Transcripts from completed chats are not sent to customers. Typically, this problem
occurs because the default SMTP server for the transcripts has not been set.

Solution: To set the default SMTP server for transcripts:


1. Set the SMTP Host parameter of the ICM server, as described in Configuring the ICM
server on page 228.
2. Restart the ICM server, as described in Starting and stopping IC services on page 138:

ICM server cannot bind to ports


Problem: The ICM server cannot bind to ports when stopped and restarted immediately. IC
performs a orderly shutdown of all the listening ports after the server is stopped. The ICM server
cannot bind to these ports again until after the shutdown is complete.

Solution: After you shutdown the ICM server:


1. Wait for approximately one minute to ensure the ICM server and service are completely
shutdown.
2. Restart the ICM server, as described in Starting and stopping IC services on page 138.

460 Installation and Configuration March 2012


Troubleshooting Web Management

Customer chat reports busy lines when ICM server running


Problem: The ICM server is running, but a customer chat cancels out saying that the lines are
busy.

Solution: Do the following:


l The Attribute server may not have established communication properly. Stop and start the
ICM server.s
l Ensure that the ICM server configuration on the Attribute tab of the Attribute server
includes the ICM server on the Website system where the customer is attempting to chat
with an agent.

Troubleshooting Website pages


This section includes the following problems that can occur with Website pages:
l Website does not start on page 461
l Webpage hangs while accessing Web Response Unit (WRU) docs on page 463
l Web Response Unit (WRU) does not search words containing a quote (') or Euro (*)
symbol on page 463
l Cannot access Website pages on page 464
l Changing the default language for chat tenant displays an invalid language error
message on page 465
l Public Website - Blank start page on page 465
l Customer Website cannot login to IC servers on page 466
l Customer management failure on page 466f

Website does not start


Problem: Website does not start.

Solution: Take the following troubleshooting steps:


1. Validate the Website user:
a. Verify that the Website user is logged in.
b. Check whether the Website user is locked.
2. Verify passwords:
a. Verify that the password for the Website user is the same password that was entered
in the Configuration Tool when you configured Web Management services.

Installation and Configuration March 2012 461


Appendix B: Troubleshooting

b. Verify that the database password is the same password that was entered in the
Configuration Tool when you configured Web Management services.
c. If the password was changed in IC Manager, re-run the Configuration Tool, as
described in Configuring Web Management services on page 201.
3. Review the website.log and website_general.log for the exact error.
a. Verify if the website.log file contains information about PDM shutdown hook.
b. Verify if the IC_INSTALL_DIR\IC73\comp directory contains a folder starting with
the name website. For example, website_backup. If such folder exists, remove
that folder from the IC_INSTALL_DIR\IC73\comp directory and restart the IC
Website server.
Note:
Note: The Website stops due to the servlet.jar file located in the WEB-INF\lib
directory of the folder started with name website.
For example, website_backup\WEb-INF\lib.
4. Verify the PDM logs:
a. Verify that the following logs are present in the IC_INSTALL_DIR\IC73\logs
directory:
l pdm_dco.log
l pdm_ccq.log
l pdm_qrepository.logs
If pdm_ccq and pdm_qrepository logs are not present, a PDM initialization error
has occurred. You can find the exact error in pdm_dco.log.
b. Verify that pdm_ccq.log or pdm_qrepository.log are 0kb in size.
If these logs are larger than 0kb in size, PDM initialization error may have occurred.
Possibly, native database drivers for SQL, Oracle, and DB2 have leading errors. You
can find these errors with error codes in these logs.
c. Verify that the pdm.xml file is present in the IC_INSTALL_DIR\IC73\etc directory.
d. If none of the above logs show errors, verify that you can access an IC Test page.
You can deploy an IC Test page from the Configuration Tool.
If you cannot access an IC Test page, a Tomcat issue has occurred. Check the
IC_INSTALL_DIR\IC73\logs\tomcat.log for the exact error.

462 Installation and Configuration March 2012


Troubleshooting Web Management

Webpage hangs while accessing Web Response Unit (WRU) docs


Problem: When you access the WRU - FAQ doc from the public website, the web page hangs
and the log is generated in the website.log file.

java.lang.OutOfMemoryError: Java heap space.


Could not access the FAQ page

Solution: This problem occurs when you create a WRU - FAQ doc from the Website Admin
Page by adding a document with more than 4 MB size. To resolve this error, you need to
customize the website using the config tool.
To customize the website
1. Open the config tool. For more information, see Run the configuration tool on page 401.
2. On the Web tab, right-click in the empty area and select Show Advanced Properties.
3. In the Website JVM Options field, modify the value -Xms64m -Xmx256m to -Xms128m
-Xmx512m. For more information, see Configuration Tool advanced properties on page 499
4. Click Apply Settings.
5. Click Ok.
6. Restart IC Website service.

Web Response Unit (WRU) does not search words containing a quote (') or
Euro (*) symbol
Problem: Searching does not work for words containing a quote or Euro symbol

Solution: To enable WRU to search all the words containing quote or euro symbol, you must
perform the following steps:
1. Navigate to the IC_INSTALL_DIR\IC73\fulcrum\fultext directory.
2. Create a new text file and add the following:
AL="'\u20AC"
Here \u20AC is added for the euro symbol and ' for a quote.
Note:
Note: You need to add the unicode value for the symbols that are indexed based on the
unicode character.
STOPLIST =
3. Save the file with name as: fs.stp.
4. Navigate to the IC_INSTALL_DIR\IC73\etc\wru_sql directory and open the
ec56.fte file.
5. Search the INSERT INTO statement.

Installation and Configuration March 2012 463


Appendix B: Troubleshooting

6. Remove the semicolon (;) after the closing parenthesis and before the INSERT INTO
statement.
7. Add the following statement before the INSERT INTO statement:
STOPFILE 'fs.stp';
8. Save and close the file.
9. Run the following command:
l For Windows: fulcrum_setup.cmd
l For Solaris: fulcrum_setup.sh
l For AIX: fulcrum_setup.sh

Cannot access Website pages


Problem: Either or both of the Administrative or Customer Website pages are unavailable from
the browser. This problem can occur for several reasons, including the following:
l Website cannot resolve the host name or locate the Web server.
l Website encounters DNS problems resolving location of the Web server
l Website did not initialize properly and has redirected browser to invalid URL.
l URL in Web browser contains the word "null"
l website.log file contains PDM error messages

Solution: Do the following:


If the browser displays an error, such as Host Name Not Resolved or Cannot Find Server:
l Restart the Web server, for example IIS, Oracle iPlanet server or IBM HTTP server.
l Restart the Tomcat applications, as described in Starting and stopping IC services on
page 138.
l Verify that the password you used for the IC Password field of the Configuration Tool
when you configured the Website has not expired.
If the Website is having DNS problems resolving location of the Web server:
1. Test for DNS issues by trying to access the home page of the Web server at the following
URL: http://<server>.<domain>.com
2. Test for DNS issues by trying to access home page of Web server with its IP address, for
example: http://123.123.123.123
3. Follow the instructions in Avaya IC Installation Planning and Prerequisites for configuring
DNS resolution.
4. Check to see if your Web browser proxy settings are interfering with host name resolution.
5. Consult your Network Administrator about the DNS resolution of the Web server.

464 Installation and Configuration March 2012


Troubleshooting Web Management

If another issue seems to be causing the problem, the PDM file may not be properly configured,
the database login credentials may be incorrect, database client software may be improperly
configured, or the Data server or Database server may be down. For solutions, see Chat failure
- no resources on page 458.

Changing the default language for chat tenant displays an invalid language
error message
Problem: If you try to change the default language for a chat tenant, the Invalid Language error
message is displayed

Solution: Execute the following steps to resolve this issue:


1. On the IC Website Multi-Tenant Administration page, click the Enable Languages link
in the left pane.
2. In the right pane, select EDS from the Select a tenant drop-down list and click Customize
Tenant Languages.
3. Select another language by selecting the option in the Default column.
For example, if English and French are the languages defined for the Tenant with default
language English, Select French as the default language.
4. In the Display Text column, enter the value for English language.
5. Click the Edit Languages button.
6. Now, select English as the default language again by selecting the option in the Default
column.
7. Click the Edit Languages button.

Public Website - Blank start page


Problem: When trying to access the customer Website, the browser displays:
l A blank start page containing just the Avaya logo
l A "website.pages.startpage" metadata error
l A "website.pages.public" metadata error
l A null pointer exception error message

Solution: The PDM file is not properly configured or database services are unavailable. For
solutions, see Chat failure - no resources on page 458.

Installation and Configuration March 2012 465


Appendix B: Troubleshooting

Customer Website cannot login to IC servers


Problem: The Website application is running but cannot login to IC core servers. This problem
can result in the following entries in the website.log file:
l Repeated login failed exception
l Repeated "Retry Toolkit Login after 60 seconds ..." message
See Login connection errors prevent a chat from occurring. This problem can display several
symptoms, including: on page 457 for solution.

Customer management failure


Problem: The Administrative Website causes repeated generic error messages when you:
l Add a customer from the Public Website
l Manage Customer accounts from the Multi Tenancy Administration Web pages

Solution: For each Workflow servers that runs customer management workflows:
1. Verify that the Workflow server is in the same IC domain as the IC Login used by the Web
Management application in the following file:
IC_INSTALL_DIR\IC73\comp\website\WEB-INF\web.xml.
This login is the one that was entered in the IC Login field of the Configuration Tool. See
the dsLogin parameter of the following file:
2. If a Workflow server is in a different domain from the IC Login, make sure the Workflow
server domain is in the failover path of the IC Login domain.
3. Build and load the customer management workflows in the Webcenter project. For more
information, see Using workflows for Web Management on page 223.
4. Restart the Workflow server.

Troubleshooting Web Management integration


The section includes the following problems that can occur with Web Management integration:
l Authentication key could not be retrieved on page 467
l Web browser does not open on page 467
l Browser encounters an internal error on page 468

466 Installation and Configuration March 2012


Troubleshooting Web Management

Authentication key could not be retrieved


Problem: You see an error message indicating that an authentication key could not be retrieved
when you select one of the following options from the Services menu in IC Manager:
l WebACD
l Web Response Unit (Self-Service)
l Multi-tenant Administration

Solution: Do the following:


1. Verify that IC Manager is configured to access Web Management, as described in
Integrating Web Management Administration on page 218.
2. Restart the Tomcat server that hosts your Website application, as described in Starting and
stopping IC services on page 138.
3. Restart IC Manager to verify whether your administrative login for IC Manager has just
reset its password:

Web browser does not open


Problem: The Web browser is not opened when you select one of the following options from
the Services menu in IC Manager:
l WebACD
l Web Response Unit (Self-Service)
l Multi-tenant Administration

Solution: Configure IC Manager for your Web browser:


1. In IC Manager, select Manager > Options.
2. Click the Environment tab.
3. Click the Ellipsis (…) button next to the Browser field.
4. Select from List.
5. Select Search Filesystem.
6. Select the drive where the browser is installed. Click Ok.
7. After the search is complete, select the Web browser from the list. Click Ok.
8. Click Ok.

Installation and Configuration March 2012 467


Appendix B: Troubleshooting

Browser encounters an internal error


Problem: The Web browser displays a message stating that there was an internal error, when
you select Services > WebACD in IC Manager. This problem typically indicates that the domain
of the URL used to access the WebACD server is different from the domain expected by the
WebAdmin plugin.

Solution: Do the following:


1. In IC Manager, verify that the following properties are the same:
l System/Configuration - ChatLoginServer
l WebACD server - WACD Web Server
l Configuration Tool - Web Server Host and Web Server Domain
2. If the ChatLoginServer value is different:
a. Enter the correct value.
b. Select Manager > Refresh.
3. If the WACD Web Server value is different:
a. Enter the correct value.
b. Restart the Tomcat server that hosts your Website application, as described in Starting
and stopping IC services on page 138.
c. Restart the WebACD server.
4. If the Configuration Tool values are different:
a. Rerun the Configuration Tool with the correct values
b. Restart the Tomcat server that hosts your Website application.
c. Restart the Web server.

Troubleshooting Web Scheduled Callback


This section contains the following problems you may encounter with Web Scheduled Callback:
l Callback cannot be scheduled on this date/time. Please try again... on page 469
l CreateRecord exception on page 469
l Scheduled calls are not delivered to agents on page 469
l Scheduled calls are not delivered to the agent at the scheduled time on page 469
l Sorry callback is closed right now! Please try again later on page 470

468 Installation and Configuration March 2012


Troubleshooting Web Management

Callback cannot be scheduled on this date/time. Please try again...


Problem: Scheduled calls are not registered from the Website. The Website user receives the
following error message:
Callback cannot be scheduled on this date/time. Please try again...
This problem usually occurs because the Website user attempted to schedule a call with a date
or time in the past.

Solution: The Website user must schedule a call with a time that is at least one minute ahead
of the current time.

CreateRecord exception
Problem: Scheduled calls are not registered from the Website. An alarm occurs with an
exception for CreateRecord.
This problem usually occurs because the Web Scheduled Callback workflow was not properly
uploaded to the database.

Solution: To solve this problem:


1. In Workflow Designer, open the webcenter project.
2. Build this project to reload the flows in the Workflow server.
3. Restart the Workflow server.

Scheduled calls are not delivered to agents


Problem: Scheduled calls are not delivered to agents.

Solution: This problem can occur for multiple reasons. For information about the specific error,
review the contents of the WSC log file.

Scheduled calls are not delivered to the agent at the scheduled time
Problem: Scheduled calls are scheduled but the call is not delivered to the agent at the
scheduled time. The delivery of the scheduled call to the agent is delayed.

Solution: Web Scheduled Callback is a time-bound feature. For Web Scheduled Callback to
work correctly, all IC servers and the database must be in the same time zone.
If the time on the systems that host IC servers and the database is not synchronized, a time lag
may occur between the scheduled time for the callback and the exact time that a Web
Scheduled Callback request is delivered to an agent.

Installation and Configuration March 2012 469


Appendix B: Troubleshooting

Sorry callback is closed right now! Please try again later


Problem: Scheduled calls are not registered from the Website. The Website user receives the
following error message:
Sorry callback is closed right now! Please try again later.
This problem usually occurs because the call is scheduled for a time that is outside of the
configured working hour range of the contact center.

Solution: Configure the working hours for the contact center, as described in Configuring the
Website for Web Scheduled Callback on page 247.

Troubleshooting DataWake
This section contains the following problem you may encounter with the DataWake feature of
Web Self-Service:
l Windows only - no DataWake records visible for customer on page 470

Windows only - no DataWake records visible for customer


Problem: An administrator or agent does not see any DataWake records for a customer in Web
Self-Service. This problem typically occurs because the Configuration Tool did not insert the
DataWake Sensor filter into IIS when you created the Website. As a result, the connector filter
for the Website Tomcat server is either not present or is a global filter. DataWake requires that
the connector filter be a local filter.

Solution: To add the local filter to IIS:


1. In Internet Services Manager, right-click on the Web Service where you installed the filter
for the Website and select Properties.
2. Click the ISAPI Filters tab.
3. If there is no dwsensor filter listed or the filter has a red arrow to the left:
a. Click Add.
b. Type dwsensor in Filter Name field.
c. Type the following directory and file name in the Executable field.
IC_INSTALL_DIR\IC73\bin\dwsensor.dll
d. Click Ok.
4. Click Ok in the ISAPI Filters tab.
5. In the Windows Services control panel, stop and restart the World Wide Web Publishing
Service.

470 Installation and Configuration March 2012


Troubleshooting Web Management

Web Management configuration files


Web Management uses the configuration files in the following table.

File Name File Location Description

web.xml IC_INSTALL_DIR\IC73\comp\ Web Management uses this Servlet API


website\WEB-INF\web.xml application startup file as a bootstrap file
to log into the IC core servers. Use the
Configuration Tool to update this file.
pdm.xml IC_INSTALL_DIR\IC73\etc\ This property configuration database
pdm.xml access file contains database and Data
server configuration information. Use the
Configuration Tool to update this file.
vesp.imp IC_INSTALL_DIR\IC73\etc\ IC server configuration files. The system
vespidl.pk vesp.imp that hosts Web Management must have
IC_INSTALL_DIR\IC73\etc\ copies of these files.
vespidl.pk
local.properties IC_INSTALL_DIR\IC73\ This configuration file contains the
servers\ definition of the Website application,
IC_INSTALL_DIR/IC73/ including the Classpath and JNI path
local.properties settings.

ICM server configuration files


The ICM server uses the configuration files in the following table.

File Name File Location Description

systemParms.txt IC_INSTALL_DIR\IC73\etc\ The ICM server uses this bootstrap file


systemParms.txt to log into IC Core servers. Use the
Configuration Tool to update this file.
pdm.xml IC_INSTALL_DIR\IC73\etc\ This property configuration database
pdm.xml access file contains database and Data
server configuration information. Use the
Configuration Tool to update this file.

Installation and Configuration March 2012 471


Appendix B: Troubleshooting

File Name File Location Description

cirssystemParms.txt IC_INSTALL_DIR\IC73\etc\ The CIRS server uses this bootstrap file


cirssystemParms.txt to log into IC Core servers. Use the
Configuration Tool to update this file.
vesp.imp IC_INSTALL_DIR\IC73\etc\ IC server configuration files. The system
vespidl.pk vesp.imp that hosts the ICM server must have
IC_INSTALL_DIR\IC73\etc\ copies of these files.
vespidl.pk

Web Management log files


Web Management uses the log files in the following table.

File Name File Location Description

<website>.log IC_INSTALL_DIR\IC73\logs\ This file is the main property


website.log configuration log file for Web
Management.
<website> is the value of the
dsObjectName property in the web.xml
file.
<website>_*.log IC_INSTALL_DIR\IC73\logs\ All other log files generated by the
website_*.log integration of the ICM server and the IC
servers.
<website> is the value of the
dsObjectName property in the web.xml
file.

ICM server log files


The ICM server uses the log files in the following table.

File Name File Location Description

icmlog.txt IC_INSTALL_DIR\IC73\logs\ This file is the main log file for the ICM
icmlog.txt server. This file contains server and
connectivity status and call events.
icmlog.txt - IC_INSTALL_DIR\IC73\logs\ This file is a temporary log file used by
icmlocalparms.txt icmlog.txt - the ICM server. Do not edit this file.
icmlocalparms.txt

472 Installation and Configuration March 2012


Troubleshooting Web Management

File Name File Location Description

<icm>_website.log IC_INSTALL_DIR\IC73\logs\ This file is the main log file for the
icm_website.log Website.
<icm> is the value of the
dsObjectName property in the
systemParms.txt file.
<icm>_*.log IC_INSTALL_DIR\IC73\logs\ All other log files generated by the
icm_*.log integration of the ICM server and the IC
servers.
<icm> is the value of the
dsObjectName property in the
systemParms.txt file.

Web Scheduled Callback log files


Web Scheduled Callback uses the log files in the following table.

File Name Description

wscallback.log This file is the main log file for Web Scheduled Callback. This
log includes all call statistics for Web Scheduled Callback.
If the jloader.log does not report exceptions or problems,
review this log file.
Note: wscallback.log may use the name specified in the
Web Scheduled Callback server configuration.
<server_name>_website.log This file is the main log file for the Web Scheduled Callback
server.
<server_name> is the name of the Web Scheduled Callback
server.
jloader.log This file includes all Web Scheduled Callback start up
information.

Installation and Configuration March 2012 473


Appendix B: Troubleshooting

Troubleshooting Avaya FTSE


This section includes information about the following troubleshooting problems that you may
encounter when you configure Avaya FTSE:
l Full text search configuration error messages on page 474.
l Verifying Web Self-Service configuration on page 475.
l Troubleshooting Web Self-Service pages on page 476.

Full text search configuration error messages


The following table includes some of the messages and errors that you might see when you
configure full-text searches. These messages can occur on any operating system.

Message Description

The object, "w_qw_wru_view", already You can ignore this message.


exists in database. This message does not indicate that you have
encountered a problem with the configuration.
ERROR at line 1: You can ignore this error. This message indicates
ORA-00955: name is already used by an that the view already exists.
existing object

execsql: execute failed You may see this error message twice in
SQLSTATE: SGS00, Native error: 0, fulcrum.err. This error occurs because the script
is attempting to drop a table that does not yet
error text [Hummingbird][SearchServer] exist.
Invalid table name
You can ignore this error when you run the
fulcrum_setup command for the first time on a
system. However, if you receive this error when
you repeat the command on a system,
investigate why the script cannot access the
database to perform the following tasks:
l unprotect table qw_wru_en

l drop table qw_wru_en

474 Installation and Configuration March 2012


Troubleshooting Avaya FTSE

Message Description

ld.so.1: /opt/Avaya/IC73/fulcrum/bin/ For Solaris only.


execsql: fatal: libftet.so: open failed: No You defined one of the following environment
such file or directory variables in your shell:
l ORACLE_HOME

To workaround this issue:


1. Unset ORACLE_HOME
2. Re-run fulcrum_setup.sh.
3. Reset the environment variable.
ld.so.1: /opt/Avaya/IC73/fulcrum/bin/ For AIX only.
execsql: fatal: libftet.so: open failed: No You defined one of the following environment
such file or directory variables in your shell:
l DB2DIR

To workaround this issue:


1. Unset DB2DIR
2. Re-run fulcrum_setup.sh.
3. Reset the environment variable.

Verifying Web Self-Service configuration


This section includes the following topics, which assist you to troubleshoot and verify the Web
Self-Service configuration:
l Verifying the Web Self-Service configuration on Microsoft Windows on page 475.
l Verifying the Web Self-Service configuration on Sun Solaris on page 476.
l Verifying the Web Self-Service configuration on IBM AIX on page 476.
Note:
Note: If any of the configuration settings are not present or are invalid, re-configure
Avaya FTSE as described in Configuring Avaya Full Text Search Engine on
page 235.

Verifying the Web Self-Service configuration on Microsoft Windows


To verify the Web Self-Service configuration:
1. In Windows ODBC Administration, verify that the following system DSN was successfully
created: ICWRU
2. In a text editor, such as Notepad, verify the Web Self-Service settings in the pdm.xml file:
a. Open the following file: IC_INSTALL_DIR\IC73\etc\pdm.xml

Installation and Configuration March 2012 475


Appendix B: Troubleshooting

b. Find the section between the following headings:


<QE name="fulcrum"> ... </QE>
c. Make sure that this section is not commented out.
3. In a text editor, such as Notepad, verify the database settings in the ec56.did file:
a. Open the following file: IC_INSTALL_DIR\IC73\etc\wru_sql\ec56.did
b. Find the entries for the database user name and password.
c. Confirm that these entries are valid.

Verifying the Web Self-Service configuration on Sun Solaris


To verify the Web Self-Service configuration:
1. Verify the database settings in the ec56.did file:
a. Open the following file: IC_INSTALL_DIR\IC73\etc\wru_sql\ec56.did
b. Find the entries for the database user name and password.
c. Confirm that these entries are valid.
2. Verify that the following script was created in IC_INSTALL_DIR/IC73/bin:
fulcrumenv.sh

Verifying the Web Self-Service configuration on IBM AIX


To verify the Web Self-Service configuration:
1. Verify that the following files were successfully created in IC_INSTALL_DIR\IC73\etc\
wru_sql
l ODBC.ini
l wru_createview.sql
2. Verify that the fulcrumenv.sh script was created in IC_INSTALL_DIR/IC73/bin.

Troubleshooting Web Self-Service pages


Problem: Web Self-Service fails and displays one or more of the following symptoms:
l Web Self-Service Management fails when trying to submit, update, or delete documents.
l You see generic error messages when trying to search FAQs.
l You see PDM errors in website.log when you search, submit, update, or delete
documents.

476 Installation and Configuration March 2012


Troubleshooting Avaya Agent and Web Agent issues

Solution: Do the following:


1. Repeat the steps to configure Avaya FTSE, as described in Configuring Avaya Full Text
Search Engine on page 235.
2. Verify the Web Self-Service configuration, as described in Verifying Web Self-Service
configuration on page 475.
3. Restart the ICM server, as described in Starting and stopping IC services on page 138.
4. If the problem still exists, determine whether the Web Management database access
manager (PDM) has lost database connectivity:
a. Verify that the Data server is running.
b. Verify that the Database server for the RDBMS is running.
c. Restart the Tomcat server that hosts your Website application, as described in Starting
and stopping IC services on page 138.

Troubleshooting Avaya Agent and Web Agent issues

Tip:
Tip: Further troubleshooting information for agent configurations is available in Avaya
Agent Integration and Avaya Agent User Guide.
This section includes the following problems that can occur when you configure and test Avaya
Agent and Web Agent:
l Avaya Agent - error upon log in on page 478
l Avaya Agent - layout not found on page 478
l Avaya Agent - login error after power failure on page 478
l Avaya Agent - license error for voice channel after failure on page 478
l Avaya Agent - cannot login after Task Manager shutdown on page 479
l Avaya Agent - email channel cannot be enabled on page 479
l Avaya Agent - error when transferring contact to virtual queue on page 479
l Avaya Agent - menu leaves blank space on page 479
l Avaya Agent - Windows Start menu hidden on page 480
l Avaya Agent - Prep wizard adds multiple paths on page 480
l Web Agent - displays but IC Email server light is red on page 480
l Web Agent - accelerator keys do not work in Russian environment on page 480
l Web Agent - hangs when an email message of large size is received on page 480

Installation and Configuration March 2012 477


Appendix B: Troubleshooting

l Web Agent - displays email message without in line images on page 481

Avaya Agent - error upon log in


Problem: Avaya Agent shows an error when an agent logs in.

Solution: Verify the configuration of the IC data source for the Workflow server that processes
events for the agent. For more information, see Creating a Workflow server on page 119.

Avaya Agent - layout not found


Problem: Avaya Agent displays the following message after login attempt: Avaya Agent Agent
layout not found.

Solution: Verify the layout configuration:


1. In IC Manager, navigate to the following configuration property for the individual agent or
for the workgroup: Agent/Desktop/Layout
2. Verify that the value of this property is set to the name of the Avaya Agent layout file,
without the CDL extension. For example, if your IC system includes the default English
Avaya Agent layout, type avaya_agent_en.

Avaya Agent - login error after power failure


Problem: A system that hosts Avaya Agent has a power failure while the application was
running. When power is restored, the agent receives an error attempting to log back in. For
example, Avaya Agent displays an error message, such as: The Object has disconnected from
its clients. This error can occur if the script cache (.sch) file on the agent desktop system has
been corrupted.

Solution: Delete the script cache files on the agent desktop system from all IC directories.
When the agent logs back in, IC automatically recreates the script cache files.

Avaya Agent - license error for voice channel after failure


Problem: After Avaya Agent fails, the agent can log back in to email channel and chat channel,
but cannot log back in to voice channel. Avaya Agent displays a license error when attempting
to log back in to voice channel.

Solution: To log in to the voice channel, agent can do one of the following:
l Login through Softphone
l Log out of Avaya Agent, then log back in again.

478 Installation and Configuration March 2012


Troubleshooting Avaya Agent and Web Agent issues

Avaya Agent - cannot login after Task Manager shutdown


Problem: Avaya Agent fails and you use Windows Task Manager to shutdown the application.
On subsequent login attempts, Avaya Agent displays a Login Failed message. This problem
usually occurs because the VTel application for Telephony continues to run in the background.

Solution: To shutdown the VTel application:


1. In Windows Task Manager, click the Processes tab.
2. Find the vtel.exe process.
3. Click End Process.

Avaya Agent - email channel cannot be enabled


Problem: You cannot enable the Email channel in Avaya Agent. This problem typically occurs
because the WebACD server is not properly configured for Email Management.

Solution: Add the configuration parameter defaultEmailCluster to the WebACD server.


For more information, see Configuring the WebACD server for Email Management on
page 307.

Avaya Agent - error when transferring contact to virtual queue


Problem: An agent receives an error when transferring a contact to a virtual queue. The agent
may see an error such as: Error occurred while searching the selected Object. Please select
new object and consult the administrator.
Virtual queue is visible and appears available for transfers in Unified Agent Directory. However,
this error typically occurs because the queue cache on the Workflow server that runs workflows
for the Unified Agent Directory was not updated when a new queue was created.

Solution: For every Workflow server in a User domain:


l Manually run the sys_transfer.update_vq_cache workflow.
l Restart the Workflow server.

Avaya Agent - menu leaves blank space


Problem: An Avaya Agent menu leaves a blank space on Avaya Agent when an agent clicks off
the menu. This problem is caused because Windows XP Professional does not repaint display
correctly.

Solution: To repaint and display the missing area:


1. Minimize Avaya Agent.
2. Restore Avaya Agent to full size.

Installation and Configuration March 2012 479


Appendix B: Troubleshooting

Avaya Agent - Windows Start menu hidden


Problem: The Start menu for Windows XP Professional displays behind Avaya Agent if Avaya
Agent is set to Always On Top. Windows XP Professional does not handle Always on Top
setting correctly.

Solution: To view and access the Start menu for Windows XP Professional, do one of the
following:
l Minimize Avaya Agent.
l Select the Avaya Agent Start menu and disable Always On Top. If you choose this option,
you must enable Always on Top again, if you do not want other applications to open on top
of Avaya Agent.

Avaya Agent - Prep wizard adds multiple paths


Problem: When installing Avaya Agent, during the prep wizard, in the Rich Client location
screen, if you click next and then back, the installer adds multiple installation paths.

Solution: To remove multiple path entries, edit the TargetDir property in the Agent.ini file.
This file is located in the config directory where the installer is extracted.

Web Agent - displays but IC Email server light is red


Problem: Web Agent displays, but the WACD light is green and the IC Email server light is
Red.

Solution: This problem can occur if you started the WebACD server before the License server.
When that occurs, the WebACD server cannot access an IC license. Stop and restart the
WebACD server.

Web Agent - accelerator keys do not work in Russian environment


Problem: For Web Agent in Russian environment, an agent uses an accelerator key to access
menu items, but nothing happens. Accelerator keys do not work for Web Agent in Russian.

Solution: Ensure agents who work with Web Agent in Russian are aware that accelerator keys
will not work.

Web Agent - hangs when an email message of large size is received


Problem: When an agent receives a large size email, the WebAgent hangs.

Solution: To resolve this problem, you need to set the JVM parameters in the
avaya_agent_<locale>.cdl file as mentioned below:

480 Installation and Configuration March 2012


Troubleshooting Avaya Agent and Web Agent issues

1. On the Design and Admin system, navigate to IC_INSTALL_DIR\IC73\design\


QConsole and open the avaya_agent_<locale>.cdl file.
2. In the WACEngine section, add the JVM parameter.
<QSection Name="WACEngine"
JavaVMParameters="-Xms<initial_size>-Xmx<max_size>/>
initial_size - The initial Java heap size. Default: 32m
max_size - The maximum Java heap size. Default: 64m
Note:
Note: You must configure the Java heap size sufficiently large so that you can receive
the large size emails.
3. In the Database Designer, open the ccq.adl file.
4. Generate Windows application. For more information, see Generating the Interaction
Center application on page 93.

Web Agent - displays email message without in line images


Problem: When an agent receives an email with in line images having HTTP/HTTPS
references, Web Agent does not display those images.

Solution: To resolve this problem, you need to set the proxy parameters in the
avaya_agent_<locale>.cdl file as mentioned below:
1. Navigate to IC_INSTALL_DIR\IC73\design\QConsole and open the
avaya_agent_<locale>.cdl file.
2. In the WACEngine section, add the proxy parameter.
<QSection Name="WACEngine"
JavaVMParameters="-Dhttp.proxyHost=[HostName]-Dhttp.proxyPort=[Por
tNumber]" />
HostName - The proxy server host name.
PortNumber - The proxy server port number.
3. In the DB Designer, open the ccq.adl file.
4. Generate Windows application. For more information, see Generating the Interaction
Center application on page 93.

Web Agent - e-mail channel is disabled when the default email cluster is
down and agent replies to an email
Problem: When the servers in the default e-mail cluster are not running and an agent replies to
an e-mail received from the servers other than the servers in the default email cluster, the e-mail
channel is disabled. However, the agent can still reply to the e-mail.

Installation and Configuration March 2012 481


Appendix B: Troubleshooting

Solution: This problem occurs because, for handling emails, the servers in the default e-mail
cluster should be running. You need to start the Email servers in the default e-mail cluster.
Note:
Note: You can configure the default email cluster in WebACD server. For more
information, see Configuring the WebACD server for Email Management on
page 307.

Web Agent - Templates are not displayed


Problem: In the Resource tree, the email templates are not listed under the Email Templates
node.

Solution: This problem occurs because email templates are retrieved from the servers in the
default email cluster. You need to start the Email servers in the default email cluster.
Note:
Note: You can configure the default email cluster in WebACD server. For more
information, see Configuring the WebACD server for Email Management on
page 307.

Troubleshooting Avaya Agent Web Client


This section contains the following problems you may encounter with Avaya Agent Web Client:
l Troubleshooting general Avaya Agent Web Client issues on page 482
l Troubleshooting the Java Application Bridge on page 484
l Troubleshooting log in issues on page 486
l Changing logging levels for Avaya Agent Web Client on page 488
l Troubleshooting IC Email issues on page 489

Tip:
Tip: For information about how to customize Avaya Agent Web Client, see Avaya
Agent Web Client Customization.

Troubleshooting general Avaya Agent Web Client issues


This section contains the following problems you may encounter with Avaya Agent Web Client:
l Avaya Agent Web Client starts but does not become available on page 483

482 Installation and Configuration March 2012


Troubleshooting Avaya Agent Web Client

l Automation server cannot create object on page 483


l Avaya Agent Web Client - Solaris issues after default shell changed on page 483
l Avaya Agent Web Client - AIX issues after default shell changed on page 483

Avaya Agent Web Client starts but does not become available
Problem: Avaya Agent Web Client appears to start, but never becomes available. All channels
display an hourglass and after a few seconds the "network loss connection" message box
appears.

Solution: Set the working directory property to a valid directory, as described in Configuring the
working directory property on page 343.

Automation server cannot create object


Problem: When agent receives a work item, Avaya Agent Web Client displays the following
message: "May be security settings are too high. Automation Server cannot create object"

Solution: On the agent desktop system, configure the security settings in the Internet Options
of Internet Explorer as described in Prerequisites for Avaya Agent Web Client on page 384.

Avaya Agent Web Client - Solaris issues after default shell changed
Problem: For Solaris, Avaya Agent Web Client does not function correctly if default shell is
changed after installing Avaya Agent Web Client software.

Solution: If you change the default shell, you must stop and restart the Web Client Connector
for Avaya Agent Web Client, as described in Starting and stopping Avaya Agent Web Client on
page 402.

Avaya Agent Web Client - AIX issues after default shell changed
Problem: For AIX, Avaya Agent Web Client does not function correctly if default shell is
changed after installing Avaya Agent Web Client software.

Solution: If you change the default shell, you must stop and restart the Web Client Connector
for Avaya Agent Web Client, as described in Starting and stopping Avaya Agent Web Client on
page 402.

Installation and Configuration March 2012 483


Appendix B: Troubleshooting

Troubleshooting the Java Application Bridge


This section contains the following problems you may encounter with the Java Application
Bridge:
l Java Application Bridge does not start on page 484
l Java Application Bridge does not start on Solaris on page 484
l Java Application Bridge does not start on AIX on page 484
l Alarms displays after refreshing Java Application Bridge on page 485
l Inaccessible UNIX path causes problems accessing attachments on page 486
l Invalid UNC to UNIX path mappings causes problems accessing attachments on page 486

Java Application Bridge does not start


Problem: Java Application Bridge does not start. Typically, the Java Application Bridge fails to
start because it is in the wrong domain, or the Web Client Connector is not up and running.

Solution: Verify that the Java Application Bridge is in an Avaya IC User domain and that
domain has the correct failover path. For more information, see Creating a Java Application
Bridge on page 390.
If the Java Application Bridge is in the correct domain, verify that the Web Client Connector
computer that hosts Avaya Agent Web Client is up and running.

Java Application Bridge does not start on Solaris


Problem: Java Application Bridge does not start automatically on Solaris.

Solution: Stop and restart the Web Client Connector and application for Avaya Agent Web
Client, as described in Starting and stopping Avaya Agent Web Client on page 402.

Java Application Bridge does not start on AIX


Problem: Java Application Bridge does not start automatically on AIX.

Solution: Stop and restart the Web Client Connector and application for Avaya Agent Web
Client, as described in Starting and stopping Avaya Agent Web Client on page 402.

icenv does reflect the correct java library path on AIX platform
Problem: The environment variable icenv does not reflect the correct java library path on the
AIX platform.

484 Installation and Configuration March 2012


Troubleshooting Avaya Agent Web Client

Solution: Follow the process mentioned below to resolve the problem.


1. Browse to the IC_INSTALL_DIR/IC73/bin location.
2. Open the icenv file for editing.
3. For the LIBPATH entry:
l Add the following path:
${AVAYA_IC73_HOME}/Java/jre/lib/ppc;${AVAYA_IC73_HOME}/Java/
jre/lib/ppc/j9vm
a. Modify the ${AVAYA_IC73_HOME}/Java/bin/classic path to
${AVAYA_IC73_HOME}/Java/jre/bin/classic.
4. Stop all servers and Stop Avaya IC.
5. Start Avaya IC.

Alarms displays after refreshing Java Application Bridge


Problem: The Alarm Monitor in IC Manager displays the following messages after you refresh
the Java Application Bridge:
l Refresh on Address Book cache failed
l Refresh on Address Book filter failed
Typically, a refresh of the Address Book fails for the following reasons:
l Database failure
l Slow response from database
l Network problems

Solution: Do the following:


1. Wait a short period of time, then attempt to refresh the Address Book again.
2. If the second refresh fails again, check the logs and verify that:
l The database is up and running.
l There are no network issues.
3. Check the following logs for messages:
l AvayaDebug.log
l AvayaErrors.log
l DCOBridge_<username>.log

Installation and Configuration March 2012 485


Appendix B: Troubleshooting

Inaccessible UNIX path causes problems accessing attachments


Problem: One or more of the UNIX paths are not accessible, so some attachments might not
be accessible. An alarm is generated if the Web Client Connector identifies a problem with the
an entry in the UNC to UNIX Path Mapping table.

Solution: Do the following:


1. Verify that all UNIX paths are accessible from the system that hosts the Web Client
Connector.
2. Correct the entry in the UNIX Path column of the UNC to UNIX Path Mapping field.
3. Restart the Web Client Connector for Avaya Agent Web Client.

Invalid UNC to UNIX path mappings causes problems accessing


attachments
Problem: One or more UNC to Unix path mappings are invalid and have been ignored, so
some attachments might not be accessible. An alarm is generated if the Web Client Connector
finds invalid entries in the UNC to UNIX Path Mapping field.

Solution: Do the following:


1. Verify all of the entries in the UNC to UNIX Path Mapping field.
2. Correct the invalid entries in the UNIX Path column of the UNC to UNIX Path Mapping
field.
3. Restart the Web Client Connector for Avaya Agent Web Client.

Troubleshooting log in issues


This section contains the following problems you may encounter when you log in to Avaya
Agent Web Client:
l Browser acts strangely when you open Avaya Agent Web Client on page 487
l Cannot access Avaya Agent Web Client start page without using port on page 487
l DCO bridge errors prevent login on page 487
l VESP bridge errors prevent login on page 487
l Avaya Agent Web Client start page returns an error after log in on page 488
l Avaya Agent Web Client freezes after log in on page 488

486 Installation and Configuration March 2012


Troubleshooting Avaya Agent Web Client

Browser acts strangely when you open Avaya Agent Web Client
Problem: The Web browser acts strangely when you attempt to open Avaya Agent Web Client.

Solution: Verify that you have completed all prerequisites for the agent desktop system, as
described in Prerequisites for Avaya Agent Web Client on page 384.

Cannot access Avaya Agent Web Client start page without using port
Problem: The Web Client Connector is hosted on a Windows or Solaris system, you cannot
access the start page for Avaya Agent Web Client without including the port in the URL. This
problem can occur if the Web server included with Windows or Solaris is not properly stopped
and restarted.

Solution: Check the HTTP server configuration that you are using for handling all the agents
requests. This HTTP server should be configured correctly to redirect the request to Web
Connectors.

DCO bridge errors prevent login


Problem: An agent cannot log in to Avaya Agent Web Client and the systemout log contains
DCO bridge errors. This problem can occur if Avaya Agent Web Client cannot locate the
required DLL file.

Solution: Verify that the environment or system variable is set correctly:


l For Windows, verify that the AVAYA_IC73_HOME environment variable is correctly set to
IC_INSTALL_DIR\IC73\. For example, if you installed in the default directory, the
environment variable should be set to C:\Avaya\IC73.
l For Solaris, verify that you started the Web Client Connector and application for Avaya
Agent Web Client with the aawcclient.sh script. For more information, see Starting and
stopping Avaya Agent Web Client on page 402.
l For AIX, verify that you started the Web Client Connector and application for Avaya Agent
Web Client with the aawcclient.sh script. For more information, see Starting and stopping
Avaya Agent Web Client on page 402.

VESP bridge errors prevent login


Problem: An agent cannot log in to Avaya Agent Web Client and the systemout log contains
VESP bridge related errors.

Solution: Verify the following values:


l The Admin account specified in the web.xml
l The JavaAppBridgeName setting in the aawcclient.bat and aawcclient.sh scripts.

Installation and Configuration March 2012 487


Appendix B: Troubleshooting

Avaya Agent Web Client start page returns an error after log in
Problem: The Avaya Agent Web Client start page returns an error when an agent attempts to
log in.

Solution: Do the following:


1. Verify that the names and values of the Avaya Agent Web Client settings are reflected in
the aawcclient.bat and aawcclient.sh scripts. A typographical error in the name or the
value of any of these settings can stop you from logging in to Avaya Agent Web Client. For
more information, see Deploying the application WAR file on page 400.
2. In IC Manager, verify that the value of the following agent property is set to
avaya_agent: Agent/Desktop/WebClient/Template.

Avaya Agent Web Client freezes after log in


Problem: Avaya Agent Web Client opens after an agent logs in, but remains frozen.

Solution: The prerequisites mentioned for Avaya Agent Web Client are not correctly set. For
more information, see Prerequisites for Avaya Agent Web Client on page 384.

Changing logging levels for Avaya Agent Web Client


This section contains the following information about how to change logging levels for Avaya
Agent Web Client:
l Changing the log level on a browser on page 488
l Changing the log level for Avaya Agent Web Client Connector on page 488

Changing the log level on a browser


In IC Manager, set the value of the following agent property to the desired level (trace or
debug):
Agent/Desktop/WebClient.LogLevelClient

Changing the log level for Avaya Agent Web Client Connector
The LogLevelServer agent property and the log4j loglevel work together. You must update
both of these items to get desired level of logging.
For the LogLevelServer property, in IC Manager, set the value of the following agent
property to the desired level (trace or debug):
Agent/Desktop/WebClient.LogLevelServer

488 Installation and Configuration March 2012


Troubleshooting Avaya Agent Web Client

For the log4j loglevel:


1. In the log4j.xml file, navigate to the loglevel entry below the root element.
2. Set the value of loglevel to trace or debug.
3. Save the log4j.xml file.
4. Redeploy the application WAR file, as described in Redeploying the application WAR file
(optional) on page 407.

Troubleshooting IC Email issues


This section contains the following problems you may encounter when you are working on
emails in Avaya Agent Web Client.
l Email channel is recovered even if the servers of default email cluster are not running on
page 489
l Avaya Agent Web Client hangs when the default email cluster is not running and agent
activates the deferred email and tries to reply that email on page 489

Email channel is recovered even if the servers of default email cluster are
not running
Problem: In Avaya Agent Web Client, the Email channel recovers even when the server in the
default email cluster is down and agent has emails received from the server other than the
servers in default cluster. Agent can compose a reply, however on clicking the Send button, an
error message appears.

Solution: This problem occurs because, for handling emails, the servers in the default email
cluster should be running. You need to start the Email servers in the default email cluster.
Note:
Note: You can configure the default email cluster in WebACD server. For more
information, see Configuring the WebACD server for Email Management on
page 307.

Avaya Agent Web Client hangs when the default email cluster is not
running and agent activates the deferred email and tries to reply that email
Problem: When an agent logs in and activates the deferred email received from the default
email cluster, the email message and the details are displayed as NULL if the servers in the
default email cluster are not running. When the agent click the Send button, the AAWC hangs
and the agent is unable to work on any contacts.

Installation and Configuration March 2012 489


Appendix B: Troubleshooting

Solution: This problem occurs because, for handling emails, the servers in the default email
cluster should be running. You need to stop the Avaya Agent Web Client application and start
the Email servers in the default email cluster.
Note:
Note: You can configure the default email cluster in WebACD server. For more
information, see Configuring the WebACD server for Email Management on
page 307.

Changing default service ports


This section includes the following topics:
l Changing the default ICM service ports on page 490
l Changing default service ports for servers on page 491

Changing the default ICM service ports


You can change some ICM service ports as described in the following topics:
l Changing the ICM tunnel port on page 490
l Changing the CIRS servlet port on page 491

Changing the ICM tunnel port


To change the ICM tunnel port:
1. On the system that hosts the ICM server, open the following file in a text editor:
IC_INSTALL_DIR\IC73\comp\website\WEB-INF\web.xml
2. In the section for the Tunnel servlet, add a new parameter with the value in the following
table:

Parameter Value

port new port number

3. Save the web.xml file.


4. Restart the Website.

490 Installation and Configuration March 2012


Changing default service ports

Changing the CIRS servlet port


To change the CIRS servlet port:
1. On the primary system that hosts the ICM server and the Website, open the following file
in a text editor: IC_INSTALL_DIR\IC73\comp\website\WEB-INF\web.xml.
2. In the section for the CIRS servlet, add a new parameter with the value in the following
table:

Parameter Value

port new port number

3. Save the web.xml file.


4. Restart the Website.

Changing default service ports for servers


You can change the default service ports, if required, as shown in the following topics:
l Changing the service port for the WebACD server on page 491
l Changing the service port for the ComHub server on page 492
l Changing the service port for the Paging server on page 492
l Changing the service port for the Attribute server on page 492

Changing the service port for the WebACD server


For more information about the WebACD server, see Creating the WebACD server on
page 191.
To change the service port for the WebACD server:
1. In IC Manager, update the WebACD server configuration:
a. Double-click the WebACD server in the list of servers.
b. Click the WACD tab.
c. Change the port number in the Service Port field.
2. In Notepad or another text editor, open the Webadmin.cfg file, and change the service port
property to the new port number.

Installation and Configuration March 2012 491


Appendix B: Troubleshooting

Changing the service port for the ComHub server


For more information about the ComHub server, see Creating the ComHub server on page 197.
To change the service port for the ComHub server:
1. In IC Manager, update the ComHub server configuration:
a. Double-click the ComHub server in the list of servers.
b. Click the ComHub tab.
c. Change the port number in the Service Port field.
2. In IC Manager, update the masterserverport property of the WebACD server:
a. In the list of servers, double-click the associated WebACD server in the same domain.
b. Click the WACD tab.
c. Change the value of the Comhub Port field to the new port.
3. In IC Manager, update the Paging server configuration:
a. In the list servers, double-click the Paging server.
b. Click the Paging tab.
c. Right-click on an empty area in the tab and select the Show Advanced Properties
box.
d. Change the value of the Comhub Port field to the new port.

Changing the service port for the Paging server


For more information about the Paging server, see Creating the Paging server on page 199.
To change the service port for the Paging server:
1. In IC Manager, update the Paging server configuration
a. Double-click the Paging server in the list of servers.
b. Click the Paging tab.
c. Change the port number in the Service Port field.
d. Click Apply.
e. Click OK.

Changing the service port for the Attribute server


For more information about the Attribute server, see Creating the Attribute server on page 195.
To change the service port for the Attribute server:
1. In IC Manager, update the Attribute server configuration:

492 Installation and Configuration March 2012


Troubleshooting Windows configuration

a. Double-click the Attribute server in the list of servers.


b. Click the Attribute tab.
c. Change the port number in the Port field.
2. In Notepad or another text editor, open the datawake.cfg file, and change the service
port property to the new port number.

Troubleshooting Windows configuration


You can receive an Out of Disk Space error even if the target drive is not full. If you install IC on
a drive other than C:\, IC uses the C:\Temp directory for staging the installation files.
To resolve this issue:
l Free up space on the C:\ drive
l Changing the TEMP environment variable of a system to point to a folder on another drive
For more information, see the Windows documentation provided by Microsoft.

Troubleshooting IIS applications


On a Windows server none of the virtual directories used by IC get created within IIS for the
Web Channel and Email Channel. The virtual directories include website, webadmin,
aicjakarta, icm, and rltemplateHelp.
To troubleshoot virtual directories
1. Run the Configuration Tool in diagnostic mode. Enter the following command from the \
ICroot\bin directory:
.\configure -d
where ICroot is the location of your IC software.
2. Look in the \ICroot\logs\General_Admin.log file for the error message, Input Error:
There is no script engine for file extension ".vbs".
where ICroot is the location of your IC software.
Note:
Note: The error means that Windows Script Host is either outdated, mis-configured, not
installed, or disabled. If this message is not present, then contact IC support and
send them the General_Admin.log file.
3. Reinstall the Windows Script Host version 5.6 from Microsoft's support website.

Installation and Configuration March 2012 493


Appendix B: Troubleshooting

4. If the same error message reappears in the General_Admin.log file, contact your local IT
department for further assistance.

Uninstalling IC
If you must uninstall IC from a system, perform the following steps to ensure that all services,
files, and related components are removed.
1. Uninstalling IC components on Windows on page 494.
2. Uninstalling IC servers on Solaris on page 495.
3. Uninstalling IC servers on AIX on page 496.
4. Uninstalling Web server components on page 496.
5. Uninstalling related third-party components on page 497.
6. Uninstalling Avaya Agent on page 497.
7. Uninstalling Avaya Agent Web Client on page 498.

Uninstalling IC components on Windows


Note:
Note: The IC uninstaller occasionally does not remove all entries to the Windows
registry. After you uninstall an IC component from a Windows system, you may
need to manually remove remaining entries from the Windows Registry.
To uninstall IC components on Windows:
1. In IC Manager, select Server > Shutdown to stop all IC servers on the system.
2. Close all IC applications on the target system.
3. Stop all IC 7.3 services and the World Wide Web Publishing for IIS service.
For more information about these services, see Starting and stopping services on
Windows on page 139.
4. In the Windows Control Panel:
a. Open Add/ Remove Programs.
b. Select Avaya IC 7.3 (component_name).
where component_name is the name of the IC component installed on the system,
such as Core Servers, Connector, or Administration.

494 Installation and Configuration March 2012


Uninstalling IC

c. Select Change/Remove to start the IC Uninstaller.


Follow the prompts in the IC Uninstaller to uninstall IC services, delete registry settings,
and remove files that are not in use.
5. In the Windows Control Panel, delete the IC environment variable:
a. Double-click System.
b. On the Advanced tab, select Environment Variables.
c. Select the IC environment variable in the System Variables box.
d. Click Delete.
e. Click Ok.
6. Delete the remaining folders and files in the IC_INSTALL_DIR\IC73\ directory.
7. Delete all shortcuts that you added to the desktop.
8. Open the Windows Registry and confirm that all IC entries have been removed.
9. Continue with Uninstalling Web server components on page 496 without restarting the
target system.

Uninstalling IC servers on Solaris

! CAUTION:
CAUTION: Do not use the rm -rf command to uninstall IC components from Solaris.
To uninstall IC servers on Solaris:
1. Close all IC applications on the target system.
2. In a command window on the target system, stop the IC servers as described in Stopping
all servers with the IC Admin utility on page 137.
3. In a command window on the target system, stop the IC services as described in Starting
and stopping services on Solaris on page 139.
4. Navigate to IC_INSTALL_DIR/IC73/
5. Locate the uninstaller for the component that you want to uninstall.
6. Execute the uninstaller.
The uninstaller removes all IC related files from the target system, including files that were
configured after installation, such as the vesp.imp file.
7. Remove all IC commands that you added to the UNIX startup script.
8. Delete the IC root directory.
9. Continue with Uninstalling Web server components on page 496 without restarting the
target system.

Installation and Configuration March 2012 495


Appendix B: Troubleshooting

Uninstalling IC servers on AIX

! CAUTION:
CAUTION: Do not use the rm -rf command to uninstall IC components from AIX.
To uninstall IC servers on AIX:
1. Close all IC applications on the target system.
2. In a command window on the target system, stop the IC servers as described in Stopping
all servers with the IC Admin utility on page 137.
3. In a command window on the target system, stop the IC services as described in Starting
and stopping services on AIX on page 142.
4. Navigate to IC_INSTALL_DIR/IC73/
5. Locate the uninstaller for the component that you want to uninstall.
The uninstaller removes all IC related files from the target system, including files that were
configured after installation, such as the vesp.imp file.
6. Remove all IC commands that you added to the UNIX startup script.
7. Delete the IC root directory.
8. Continue with Uninstalling Web server components on page 496 without restarting the
target system.

Uninstalling Web server components


Perform these steps if the target system includes a Web server. If the target system does not
include Web server components, continue with Uninstalling related third-party components on
page 497.
To uninstall Web server components:
1. For Tomcat, perform the following steps:
a. Delete all Tomcat servers that you created to host Web applications, such as the
Website and WebLM.
b. Uninstall Tomcat, if desired.
2. For the Web server, perform the following steps:
a. Remove the virtual directories from your Web site.
b. For IIS, remove the dwsensor and Jakarta Connector filters from the ISAPI Filters
tab.

496 Installation and Configuration March 2012


Uninstalling IC

Uninstalling related third-party components


Perform these steps to complete your uninstallation.
To uninstall related third-party components:
1. Uninstall all related third-party components that you installed on the target system.
For information on uninstallation procedures, see the manufacturer’s documentation.
2. If the target system has a Windows operating system, navigate to c:\Windows\Temp
and delete all numbered _istmp directories.
3. If the target system has a Windows operating system:
a. Navigate to C:\Documents and Settings\<install_user_name>\Local
Settings\Temp
b. Delete all ismpXXX and LREXXX.tmp directories.
4. Restart the target system.

Uninstalling Avaya Agent


Note:
Note: The IC agent application uninstaller does not always remove all entries to the
Windows registry. The remaining entries in the Windows Registry will not block
functionality for other applications on the system.
To uninstall Avaya Agent.
1. Close all IC applications on the target system.
2. In the Windows Control Panel:
a. Open Add/ Remove Programs.
b. Select Avaya IC 7.3 (Rich Client).
c. Select Change/Remove to start the IC Uninstaller.
Follow the prompts in the IC Uninstaller to uninstall IC services, delete registry settings,
and remove files that are not in use.
3. In the Windows Control Panel, delete the IC environment variable:
a. Double-click System.
b. On the Advanced tab, select Environment Variables.
c. Select the IC environment variable in the System Variables box.
d. Click Delete.
e. Click Ok.

Installation and Configuration March 2012 497


Appendix B: Troubleshooting

4. For the ...\Backup directory that was created by the agent installer:
a. Review the files in the directory.
b. Confirm that the System32 files are not required by another application.
c. Restore any files required by another application.
d. Delete the directory.
5. Delete any remaining folders and files in the IC_INSTALL_DIR\IC73\ directory.
6. Delete all shortcuts that you added to the desktop.

Uninstalling Avaya Agent Web Client


You must completely remove the Avaya Agent Web Client software and settings if you need to
re-install the software.
This section includes the following topics:
1. Uninstalling the Avaya Agent Web Client application on page 498.
2. Uninstalling Avaya Agent Web Client Connector on page 498.

Before you begin


Before you uninstall Avaya Agent Web Client, perform the following steps:
1. Ensure that all the agents are logged out.
2. Stop the Web Client Connector. For more information, see Starting and stopping Avaya
Agent Web Client on page 402.

Uninstalling the Avaya Agent Web Client application


1. Browse to the IC_INSTALL_DIR/IC73/tomcat/webapps location and delete the
avaya folder.
2. Browse to the IC_INSTALL_DIR/IC73/tomcat/war folder and delete the
webclient.war file.

Uninstalling Avaya Agent Web Client Connector


Follow the instructions in Uninstalling IC on page 494 to uninstall the Avaya Agent Web Client
Connector.

498 Installation and Configuration March 2012


Appendix C: Configuration Tool advanced
properties

On the Web tab, you can find advanced properties that includes the following properties for the
Java Virtual Machine:
l Initial heap size and maximum heap size
l Stack size

Tip:
Tip: Configure the advanced properties only if you expect a high volume of contacts or
access to the Web application. For example, configure the advanced properties
for the Website and the ICM server if you expect a high volume of chat contacts
from the customer Website. For information about performance and contact
volume, see the benchmarking information available through an Avaya
representative.
This section describes the advanced properties on the Web tab and how to access those
properties. Topics include:
l Format of the advanced properties on page 500.
l Accessing the advanced properties on page 499.
l Advanced properties on page 501.
l Using the recommended settings for the advanced properties on page 502.

Accessing the advanced properties


To access the advanced properties on the Web tab of the Configuration Tool:
1. Right-click in an empty space on the Web tab.
2. Select the Show Advanced Properties check box.

Installation and Configuration March 2012 499


Appendix C: Configuration Tool advanced properties

Format of the advanced properties


The advanced properties use the following format:
-<initial_Java_heap> -<maximum_Java_heap>
where:

Format Property Description

initial_Java_heap -Xms Sets the initial Java heap size for the Tomcat
application.
--JvmMs Sets the initial Java heap size for the Tomcat
service.
maximum_Java_heap -Xmx Sets the maximum Java heap size for the Tomcat
application.
--JvmMx Sets the maximum Java heap size for the Tomcat
service.

500 Installation and Configuration March 2012


Advanced properties

Advanced properties
The following table describes the fields on the Web tab for advanced properties.

Field Description Default value

Tomcat Setup The Multiple option creates Multiple


a separate Tomcat server
for each Web application.
Choose Multiple if the
computer hosts more than
one Web application, and
you want to start and stop
all Web applications
separately.
Web License Available only when you For Windows:
Manager JVM select Configure Web --JvmMs 32 --JvmMx 64 --JvmSs 96
Options License Manager.
For Solaris:
Entries must use the
following format: -Xms32m -Xmx64m -Xss96k
-<min_heap> For AIX:
-<max_heap> -Xms32m -Xmx64m -Xss96k
-<stack_size> Note: To increase the license capacity, you
must increase the minimum and maximum
heap size as mentioned below:
For Windows:
--JvmMs 256 --JvmMx 512 --JvmSs 96
For Solaris:
-Xms256m -Xmx512m -Xss96k
For AIX:
-Xms256m -Xmx512m -Xss96k
Email Available only when you For Windows:
Template select Configure Email --JvmMs 32 --JvmMx 64
Administration Template Administration.
JVM Options For Solaris:
Entries must use the
following format: -Xms32m -Xmx64m
-<min_heap> For AIX:
-<max_heap> -Xms32m -Xmx64m

Installation and Configuration March 2012 501


Appendix C: Configuration Tool advanced properties

Field Description Default value

Website JVM Available only when you For Windows:


Options select Configure Website. --JvmMs 64 --JvmMx 256
Entries must use the For Solaris:
following format:
-Xms64m -Xmx256m
-<min_heap>
-<max_heap> For AIX:
-Xms64m -Xmx256m
ICM JVM Available only on Windows, All Platforms:
Options when you select ICM -Xms64m -Xmx256m
Service.
Entries must use the
following format:
-<min_heap>
-<max_heap>
CIRS JVM Available only when you All Platforms:
Options select CIRS Service. -Xms32m -Xmx64m
Entries must use the
following format:
-<min_heap>
-<max_heap>

Using the recommended settings for the advanced


properties
The recommended tuning parameters in Interaction Center Administration Guide also includes
some recommended settings for the advanced properties.
After you install the development IC system as described in this document:
1. Review the tuning parameters in Interaction Center Administration Guide.
2. Verify the expected contact volume in the production system.
3. Test the recommended settings for the tuning parameters to find the optimal settings for
the production system.

502 Installation and Configuration March 2012


Index

Index

Advocate
see Business Advocate
Symbols agent accounts
.NET client, running . . . . . . . . . . . . . . . . 417 Avaya Agent . . . . . . . . . . . . . . . . .339
Avaya Agent Web Client . . . . . . . . . . . .343
cautions . . . . . . . . . . . . . . . . . . .329
A Client SDK . . . . . . . . . . . . . . . . . .345
accessing, advanced properties . . . . . . . . . . . 499 creating . . . . . . . . . . . . . . . . . . . .331
accounts Java Application Bridge . . . . . . . . . . 388, 412
Admin . . . . . . . . . . . . . . . . . . . . . 104 Web Services Bridge . . . . . . . . . . . . . 425
agent . . . . . . . . . . . . . . . . . . . . . 331 agent applications
creating . . . . . . . . . . . . . . . . . 102, 105 installation files . . . . . . . . . . . . . . . . 352
customer . . . . . . . . . . . . . . . . . . . . 309 agent installer
disabled . . . . . . . . . . . . . . . . . . . . 310 copying vesp.imp . . . . . . . . . . . . . . . 356
email . . . . . . . . . . . . . . . . . . . . . . 309 creating . . . . . . . . . . . . . . . . . . . . 355
human users . . . . . . . . . . . . . . . . . . 105 network drive . . . . . . . . . . . . . . . . . 358
icmbridge . . . . . . . . . . . . . . . . . . . 105 preparing for installation . . . . . . . . . . . . 357
Java Application Bridge . . . . . . . . . . 388, 412 testing . . . . . . . . . . . . . . . . . . . . 357
non-human users . . . . . . . . . . . . . . . . 103 agent properties . . . . . . . . . . . . . . . . . 345
passwords . . . . . . . . . . . . . . . . . . . 103 AgentAlreadyRunningMsg . . . . . . . . . . . . 377
Web Services Bridge . . . . . . . . . . . . . . 425 AgentDesktopCtr.ini . . . . . . . . . . . . . . . 376
website . . . . . . . . . . . . . . . . . . . . 104 agents
ACDname . . . . . . . . . . . . . . . . . . . . . 164 configuring for Address Book . . . . . . . . 344, 347
adding configuring for Avaya Agent . . . . . . . . . . 339
ICM servers to ICM Bridge . . . . . . . . . . . 281 configuring for Avaya Agent Web Client . . . . . 343
knowledge base . . . . . . . . . . . . . . . . 325 configuring for Unified Agent Directory . . . . . 341
routing hints . . . . . . . . . . . . . . . 225, 305 creating . . . . . . . . . . . . . . . . . . 329, 331
Address Book home directory . . . . . . . . . . . . . . . . 340
configuring agents . . . . . . . . . . . . 344, 347 installation . . . . . . . . . . . . . . . . . . 351
configuring Workflow server . . . . . . . . . . . 347 installing applications . . . . . . . . . . . 327, 351
ADL file . . . . . . . . . . . . . . . . . . . . . 74, 77 properties . . . . . . . . . . . . . . . . . . . 345
Admin account . . . . . . . . . . . . . . . . . . . 104 properties for Avaya Agent . . . . . . . . . . . 340
administration website properties for Avaya Agent Web Client . . . . . 343
configuring . . . . . . . . . . . . . . . . . . . 272 setting properties . . . . . . . . . . . . . . . 337
setting up . . . . . . . . . . . . . . . . . . . 272 troubleshooting . . . . . . . . . . . . . . 477, 484
Web application . . . . . . . . . . . . . . . . 272 Web Scheduled Callback . . . . . . . . . . . 245
administrative accounts working directory . . . . . . . . . . . 343, 345, 386
creating . . . . . . . . . . . . . . . . . . . . 105 agentsearch.update_searchresult . . . . . . . 348, 349
human users . . . . . . . . . . . . . . . . . . 105 AIX
non-human users . . . . . . . . . . . . . . . . 103 changing ownership . . . . . . . . . . . . . 41, 402
Administrative Content Analyzer server . . . . . . . 321 configuring full-text searches . . . . . . . . . . 241
administrator login . . . . . . . . . . . . . . . . . 23 installing
ADU server Avaya Agent Web Client connector . . . . . 32.
stopping . . . . . . . . . . . . . . . . . . . . 131 Server SDK . . . . . . . . . . . . . . . . 54.
updating . . . . . . . . . . . . . . . . . . . . 110 servers . . . . . . . . . . . . . . . . . . 32.
advanced properties installing Avaya Agent Web Client connector . . 32.
accessing . . . . . . . . . . . . . . . . . . . 499 installing Client SDK . . . . . . . . . . . . . . 32.
Configuration Tool . . . . . . . . . . . . . . . 499 prerequisites . . . . . . . . . . . . . . . . . 24.
recommended settings . . . . . . . . . . . . . 502 starting Client SDK server . . . . . . . . . 144, 417

Installation and Configuration March 2012 503


Index

starting IBM HTTP server . . . . . . . . . . . . 406 redeploying . . . . . . . . . . . . . . . . 407


starting Web Services server . . . . . . . 144, 431 configuring . . . . . . . . . . . . . . . . 383, 399
stopping Client SDK server . . . . . . . . 144, 417 configuring agents . . . . . . . . . . . . . . . 343
stopping Web Services server . . . . . . . 144, 431 configuring SSL . . . . . . . . . . . . . . . . 406
troubleshooting . . . . . . . . . . . . . . . . . 448 documents . . . . . . . . . . . . . . . . . . . 19
UNC to UNIX mapping . . . . . . . . . . . . . 396 IBM HTTP server . . . . . . . . . . . . . . . 404
updating full text index . . . . . . . . . . . . . 244 installing connector
updating index . . . . . . . . . . . . . . . . . 244 AIX . . . . . . . . . . . . . . . . . . . . . 32
windowing environment . . . . . . . . . . . . . 24 Solaris . . . . . . . . . . . . . . . . . . . . 30
analyze flow . . . . . . . . . . . . . . . . . . . . 288 Windows . . . . . . . . . . . . . . . . . . 28
applications Internet Explorer . . . . . . . . . . . . . . . 384
IC Repository . . . . . . . . . . . . . . . . . . 84 internet options . . . . . . . . . . . . . . . . 384
Interaction Center . . . . . . . . . . . . . . . . 93 Java Application Bridge . . . . . . . . . . 388, 390
AskForExitConformation . . . . . . . . . . . . . . 378 JRE version . . . . . . . . . . . . . . . . . . 385
Aspect ownership for UNIX . . . . . . . . . . . . . . 402
Telephony server . . . . . . . . . . . . . . . . 168 pop-up blockers . . . . . . . . . . . . . . . . 385
TSQS server . . . . . . . . . . . . . . . . . . 180 prerequisites . . . . . . . . . . . . . . . . . 384
associations proxy server settings . . . . . . . . . . . . . 384
Email Management . . . . . . . . . . . . . . . 298 re-installing . . . . . . . . . . . . . . . . . . 398
Telephony . . . . . . . . . . . . . . . . . . . 184 runtime settings, SSL . . . . . . . . . . . . . 406
Web Management . . . . . . . . . . . . . . . 221 testing . . . . . . . . . . . . . . . . . . . . 404
Attribute server troubleshooting
about . . . . . . . . . . . . . . . . . . . .
. 191 about . . . . . . . . . . . . . . . . . . . 482
adding ICM servers to ICM Bridge . . . . . . .
. 281 general . . . . . . . . . . . . . . . . . . 482
changing service port . . . . . . . . . . . . .
. 492 logging . . . . . . . . . . . . . . . . . . 488
creating . . . . . . . . . . . . . . . . . . .
. 195 logging in . . . . . . . . . . . . . . . 486, 489
ICM bridge . . . . . . . . . . . . . . . . . .
. 197 UNC to UNIX mapping . . . . . . . . . . . 392, 394
troubleshooting . . . . . . . . . . . . . . . .
. 461 WAR file . . . . . . . . . . . . . . . . . . . 400
Web configuration . . . . . . . . . . 205, 211, 216 Web Scheduled Callback . . . . . . . . . . . 245
autostart working directory . . . . . . . . . . . . . 343, 386
CIRS server on UNIX . . . . . . . . . . . 140, 143 Avaya Computer Telephony for IC
IBM HTTP server . . . . . . . . . . . . . . . . 143 see Telephony
ICM server on UNIX . . . . . . . . . . . 140, 142 Avaya IC ORB Service . . . . . . . . . . . . . . 135
Oracle iPlanet Server . . . . . . . . . . . . . . 141
services . . . . . . . . . . . . . . . . . . . . 138
Tomcat applications on UNIX . . . . . . . 142, 144 B
Avaya Agent base, knowledge . . . . . . . . . . . . . . . . . 324
agent properties . . . . . . . . . . . . . . .
. 340 BasicStartAgent.htm . . . . . . . . . . . . . . . 373
Citrix integration . . . . . . . . . . . . . . .
. 368 blender flows . . . . . . . . . . . . . . . . . . . 107
configuring agents . . . . . . . . . . . . . .
. 339 Blender server, creating . . . . . . . . . . . . . . 123
documents . . . . . . . . . . . . . . . . . .
. 19 bridge, Web Services . . . . . . . . . . . . . . . 424
home directory . . . . . . . . . . . . . . . .
. 340 building
installation files . . . . . . . . . . . . . . . .
. 352 Business Advocate databases . . . . . . . . 45, 49
Internet Explorer . . . . . . . . . . . . . . .
. 352 CCQ database . . . . . . . . . . . . . . . . . 86
internet options . . . . . . . . . . . . . . . .
. 352 IC Repository . . . . . . . . . . . . . . . . . . 76
log in error . . . . . . . . . . . . . . . . . .
. 478 Business Advocate
modifying layout . . . . . . . . . . . . . . .
. 86 creating environment . . . . . . . . . . . . . . 44
site preparation wizard . . . . . . . . . . . .
. 355 database schema . . . . . . . . . . . . . . 45, 49
Web Scheduled Callback . . . . . . . . . . .
. 245 documents . . . . . . . . . . . . . . . . . . . 20
XP paint error . . . . . . . . . . . . . . 479, 480 nethome . . . . . . . . . . . . . . 44, 45, 49, 51
Avaya Agent Web Client Nethome directory . . . . . . . . . . . . . . . . 44
Address Book . . . . . . . . . . . . . . . . . 344 permissions for ECB . . . . . . . . . . . . . . . 52
administrator privileges . . . . . . . . . . . . . 385 prerequisites . . . . . . . . . . . . . . . . . . 43
agent properties . . . . . . . . . . . . . . . . 343 requirements . . . . . . . . . . . . . . . . . . 43
application

504 Installation and Configuration March 2012


Index

TSQS server . . . . . . . . . . . . . . . . . 180


Citrix integration
C configuring . . . . . . . . . . . . . . . . . . 368
calendar, Web Scheduled Callback . . . . . . . . . 246 configuring INI file . . . . . . . . . . . . . . . 372
callback.checkcallbacktime . . . . . . . . . . . . . 247 executable tool
callback.contactcenterclosetime . . . . . . . . . . 248 components . . . . . . . . . . . . . . . . 376
callback.contactcenteropentime . . . . . . . . . . . 248 configuring . . . . . . . . . . . . . . . . . 375
CallCenterQ database INI file . . . . . . . . . . . . . . . . . . . 376
see CCQ database installing . . . . . . . . . . . . . . . . . . 376
cautions multiple Citrix servers . . . . . . . . . . . . 378
agent accounts . . . . . . . . . . . . . . . . . 329 installing applications . . . . . . . . . . . . . 370
Avaya Agent installation . . . . . . . . . . . . . 352 limitations . . . . . . . . . . . . . . . . . . . 369
Data server. . . . . . . . . . . . . . . . . . . 67 location of files . . . . . . . . . . . . . . . . 371
Design & Administration Tools . . . . . . . . . . 26 publishing applications . . . . . . . . . . . . . 369
server installation . . . . . . . . . . . . . . . . 25 seamless window . . . . . . . . . . . . . . . 369
Web Scheduled Callback . . . . . . . . . . . . 245 sequence for Avaya tools . . . . . . . . . . . 379
CCQ database Web browser tool
building . . . . . . . . . . . . . . . . . . . . 86 components . . . . . . . . . . . . . . . .373
connection set . . . . . . . . . . . . . . . . . 92 configuring . . . . . . . . . . . . . . . . .372
creating . . . . . . . . . . . . . . . . . . . 85, 92 installing . . . . . . . . . . . . . . . . . .373
database connection . . . . . . . . . . . . . . 87 multiple Citrix servers . . . . . . . . . . . .375
ccq.adl . . . . . . . . . . . . . . . . . . . . . . 75 updating HTML page . . . . . . . . . . . .374
ccqDBConnection . . . . . . . . . . . . . . . . . 87 CitrixClientURL . . . . . . . . . . . . . . . . 374, 376
CDL file . . . . . . . . . . . . . . . . . . . . . . 86 client login flow . . . . . . . . . . . . . . . . . . 125
Central Internet Routing Service . . . . . . . . . . 230 Client SDK
changing creating environment . . . . . . . . . . . . .415
ownership for UNIX . . . . . . . . . . . 39, 41, 402 deploying . . . . . . . . . . . . . . . . . . .409
service ports . . . . . . . . . . . . . . . . . . 491 documents . . . . . . . . . . . . . . . . . .
. 19
Web License Manager password . . . . . . . . 159 files. . . . . . . . . . . . . . . . . . . . . .
. 411
channels installing . . . . . . . . . . . . . . . . . . .410
email . . . . . . . . . . . . . . . . . . . . . . 283 AIX . . . . . . . . . . . . . . . . . . . .
. 32
Email Management . . . . . . . . . . . . . . . 298 Solaris . . . . . . . . . . . . . . . . . . .
. 30
servers . . . . . . . . . . . . . . . . . . 191, 286 Windows . . . . . . . . . . . . . . . . .
. 28
Telephony . . . . . . . . . . . . . . . . . . . 184 Java Application Bridge . . . . . . . . . . . .
. 411
voice . . . . . . . . . . . . . . . . . . . . . . 163 prerequisites . . . . . . . . . . . . . . . . .409
web . . . . . . . . . . . . . . . . . . . . . . 189 secondary ORB server environment . . . . . .410
Web Management . . . . . . . . . . . . . . . 221 SSL . . . . . . . . . . . . . . . . . . . 421, 431
character encoding. . . . . . . . . . . . . . . . . 436 Web Scheduled Callback . . . . . . . . . . . 245
chat Client SDK server
RONA . . . . . . . . . . . . . . . . . . . . . 189 starting . . . . . . . . . . . 139, 141, 144, 416, 417
Workflow server . . . . . . . . . . . . . . . . 220 stopping . . . . . . . . . . . . 142, 144, 416, 417
ChatLoginServer . . . . . . . . . . . . . . . 218, 274 ClientBarHight . . . . . . . . . . . . . . . . . . 377
ChatLoginServerPort . . . . . . . . . . . . . 219, 269 ClientBarWidth . . . . . . . . . . . . . . . . . . 377
ChatLoginServerProtocol . . . . . . . . . . . 219, 269 CM
ChatLoginServerWebsite . . . . . . . . . . . 218, 274 Telephony server . . . . . . . . . . . . . . . 166
CIRS server TSQS server . . . . . . . . . . . . . . . . . 179
additional ICM . . . . . . . . . . . . . .277, 279 ComHub server
autostart on UNIX . . . . . . . . . . . . .140, 143 about . . . . . . . . . . . . . . . . . . . . . 197
configuring . . . . . . . . . . . . . . . .
. . . 230 changing service port . . . . . . . . . . . . . 492
configuring for website . . . . . . . . . .
. . . 280 creating . . . . . . . . . . . . . . . . . . . . 197
start on UNIX . . . . . . . . . . . . . . .140, 143 Communication Manager
stop on UNIX . . . . . . . . . . . . . . .140, 143 TS . . . . . . . . . . . . . . . . . . . . . . 166
CIRS service . . . . . . . . . . . . . . 206, 211, 216 TSQS server . . . . . . . . . . . . . . . . . 179
Cisco UCC components
Telephony server . . . . . . . . . . . . . . . . 170 executable tool for Citrix . . . . . . . . . . . . 376

Installation and Configuration March 2012 505


Index

Web browser tool for Citrix . . . . . . . . . . . 373 secondary servers . . . . . . . . . . . . . . . . 37


configuration files send on enter for Japanese IMEs . . . . . . . . 446
ICM server . . . . . . . . . . . . . . . . . . . 471 servers . . . . . . . . . . . . . . . . . . . . 191
Web Management . . . . . . . . . . . . . . . 471 SSL for Avaya Agent Web Client . . . . . . . . 406
Configuration Tool SSL for Web Management . . . . . . . . . . . 267
administration website . . . . . . . . . . . . . 272 Telephony . . . . . . . . . . . . . . . . . . 163
Business Advocate . . . . . . . . . . . . . . . 44 UNC to UNIX mapping . . . . . . . . . . . 394, 396
customer Website . . . . . . . . . . . . . . . 274 Web browser tool for Citrix . . . . . . . . . . . 372
Email Template Administration . . . . . . . . . 289 Web Management . . . . . . . . . . . . . . . 189
initial configuration . . . . . . . . . . . . . . 35, 37 Web Management services . . . . . . . . . . 201
SDK server . . . . . . . . . . . . . . . . . . . 415 Web Scheduled Callback . . . . . . . . . . . 245
troubleshooting . . . . . . . . . . . . . . . . . 450 Web Services . . . . . . . . . . . . . . . 423, 429
Web . . . . . . . . . . . . . . . . . . . . . . 201 WebACD server . . . . . . . . . . . . . . . . 307
configuring Website . . . . . . . . . . . . . . . . . . . . 201
ACD name . . . . . . . . . . . . . . . . . . . 164 website . . . . . . . . . . . . . . . . . . . . 231
additional ICM server . . . . . . . . . . . 277, 278 Website for Web Scheduled Callback . . . . . . 247
administration website . . . . . . . . . . . . . 272 Workflow server . . . . . . . . . . . . 182, 220, 297
agents for Avaya Agent . . . . . . . . . . . . . 339 Workflow server for agents . . . . . . . . . . . 347
agents for Avaya Agent Web Client . . . . . . . 343 working directory . . . . . . . . . . . . . 343, 345
agents for Unified Agent Directory . . . . . . . . 341 connection sets
Aspect TS . . . . . . . . . . . . . . . . . . . 168 CCQ database . . . . . . . . . . . . . . . . . 92
Avaya Agent Web Client . . . . . . . . . 383, 399 IC Repository . . . . . . . . . . . . . . . . . . 82
Business Advocate . . . . . . . . . . . . . . . 44 connections
CCQ connection set . . . . . . . . . . . . . . 92 CCQ database . . . . . . . . . . . . . . . . . 87
CCQ database connection . . . . . . . . . . . 87 IC Repository . . . . . . . . . . . . . . . . . . 77
Cisco TS . . . . . . . . . . . . . . . . . . . . 170 console layout . . . . . . . . . . . . . . . . . . . 86
Client SDK . . . . . . . . . . . . . . . . . . . 409 Content Analyzer
CM TS . . . . . . . . . . . . . . . . . . . . . 166 adding knowledge base . . . . . . . . . . . . 325
Content Analyzer . . . . . . . . . . . . . . . . 321 Administrative server . . . . . . . . . . . . . 321
core servers . . . . . . . . . . . . . . . . 97, 108 configuring . . . . . . . . . . . . . . . . . . 321
customer Website . . . . . . . . . . . . . . . 274 knowledge base . . . . . . . . . . . . . . . . 324
Data server. . . . . . . . . . . . . . . . . . 66, 67 Operations server . . . . . . . . . . . . . . . 323
Data server for DB2 . . . . . . . . . . . . . . . 72 copying vesp.imp . . . . . . . . . . . . . . . . . 356
Data server for Oracle . . . . . . . . . . . . . 69 core servers
Data server for SQL Server . . . . . . . . . . . 67 configuring . . . . . . . . . . . . . . . . . 97, 108
email accounts . . . . . . . . . . . . . . . . . 309 recommended settings. . . . . . . . . . . . . . 110
Email Management . . . . . . . . . . . . . . . 283 CPU resources, IC Manager . . . . . . . . . . . . 27
Email Template Administration . . . . . . 289, 308 creating
executable tool for Citrix . . . . . . . . . . . . . 375 accounts . . . . . . . . . . . . 102, 388, 412, 425
FTSE . . . . . . . . . . . . . . . . . . . . . 235 Administrative Content Analyzer server . . . . . 321
full-text searches on AIX . . . . . . . . . . . . 241 agent accounts . . . . . . . . . . . . . . . . 331
full-text searches on Solaris . . . . . . . . . . . 238 agent installation files . . . . . . . . . . . . . 352
full-text searches on Windows . . . . . . . . . . 236 agent installation instructions . . . . . . . . . . 358
home directory . . . . . . . . . . . . . . . . . 340 agent installer . . . . . . . . . . . . . . . . . 355
HTTP Connector server . . . . . . . . . . . . . 445 agents . . . . . . . . . . . . . . . . 329, 331, 345
IC Email server . . . . . . . . . . . . . . . . . 286 Attribute server . . . . . . . . . . . . . . . . 195
IC Repository connection set . . . . . . . . . . 82 Blender server . . . . . . . . . . . . . . . . 123
IC Repository database connection . . . . . . . 77 Business Advocate environment . . . . . . . . . 44
ICM server . . . . . . . . . . . . . . . . . . . 228 CCQ database . . . . . . . . . . . . . . . . . 92
independent ICM . . . . . . . . . . . . . . . . 280 ComHub server . . . . . . . . . . . . . . . . 197
License server . . . . . . . . . . . . . . . . . 157 domains . . . . . . . . . . . . . . . . . . . 101
media channels . . . . . . . . . . . . . . 190, 335 EDU server . . . . . . . . . . . . . . . . . . . 116
Notification server . . . . . . . . . . . . . . . 444 email status . . . . . . . . . . . . . . . . . . 320
primary ICM for additional ICM . . . . . . . . . 278 HTTP Connector server . . . . . . . . . . . . 125
primary servers . . . . . . . . . . . . . . . . . 35 IC Email server . . . . . . . . . . . . . . 284, 286

506 Installation and Configuration March 2012


Index

IC Repository . . . . . . . . . . . . . . . . . . 82 CCQ . . . . . . . . . . . . . . . . . . . . . . 85
Java Application Bridge . . . . . . . . . . . . . 390 connection sets . . . . . . . . . . . . . . . 82, 92
knowledge base . . . . . . . . . . . . . . . . 324 connections . . . . . . . . . . . . . . . . . 77, 87
License server . . . . . . . . . . . . . . . . . 157 documents . . . . . . . . . . . . . . . . . . . 19
Notification server . . . . . . . . . . . . . . . 128 IC Repository . . . . . . . . . . . . . . . . . . 76
Operations Content Analyzer server . . . . . . . 323 Repository . . . . . . . . . . . . . . 206, 212, 217
Paging server . . . . . . . . . . . . . . . . . 199 dataserver type/alias . . . . . . . . . . . . . . 78, 88
Report server . . . . . . . . . . . . . . . . . . 118 DataWake . . . . . . . . . . . . . . . . . . 195, 196
routing hints DataWake, troubleshooting . . . . . . . . . . 468, 470
Email Management . . . . . . . . . . . .
. 305 DB2
Telephony . . . . . . . . . . . . . . . .
. 187 Data server . . . . . . . . . . . . . . . . . . . 72
Web Management . . . . . . . . . . . . .
. 225 DB2 Instance . . . . . . . . . . . . . . . . 36, 38
SDK server environment . . . . . . . . . . .
. 415 qdb2sp library . . . . . . . . . . . . . . . . . . 66
secondary Directory server . . . . . . . . . .
. 115 DB2 Port . . . . . . . . . . . . . . . . . . . . . 217
sites . . . . . . . . . . . . . . . . . . . .
. 98. DB2DIR . . . . . . . . . . . . . . . . . . . . . 242
Telephony server . . . . . . . . . . . . . . .
. 165 deleting, string table messages . . . . . . . . . . 443
TSQS server . . . . . . . . . . . . . . . . .
. 178 dependencies, servers . . . . . . . . . . . . . . 131
Web Scheduled Callback server . . . . . . . .
. 246 deploying
Web Services Bridge . . . . . . . . . . . . .
. 426 Avaya Agent Web Client . . . . . . . . . . 383, 399
WebACD server . . . . . . . . . . . . . . .
. 191 Client SDK . . . . . . . . . . . . . . . . . . 409
Workflow server . . . . . . . . . . . 182, 220, 297 Web Services . . . . . . . . . . . . . . . . . 423
creating Java Application Bridge . . . . . . . . . . 413 Design & Administration Tools
CTI cautions . . . . . . . . . . . . . . . . . . . . 26
See Telephony components . . . . . . . . . . . . . . . . . . . 27
customer account . . . . . . . . . . . . . . . . . 309 Database Designer . . . . . . . . . . . . . . . 77
Customer HTML Chat Client, Japanese . . . . . . . 446 installing . . . . . . . . . . . . . . . . . . . . 28
customer Website systems . . . . . . . . . . . . . . . . . . . . 27
configuring . . . . . . . . . . . . . . . . . . . 274 tips . . . . . . . . . . . . . . . . . . . . . . . 26
setting up separate . . . . . . . . . . . . . . . 274 directory
Web application . . . . . . . . . . . . . . . . 274 home . . . . . . . . . . . . . . . . . . . . . 340
customizing Avaya IC . . . . . . . . . . . . . . . 19 working . . . . . . . . . . . . . . . . . . . . 343
Directory server
routing hints . . . . . . . . . . . . . . 187, 225, 305
D secondary . . . . . . . . . . . . . . . . . . . 115
data models . . . . . . . . . . . . . . . . . . . . 19 updating . . . . . . . . . . . . . . . . . . . . 85
Data server directory, working . . . . . . . . . . . . . . . . . 345
cautions . . . . . . . . . . . . . . . . . . . . 67 disabled accounts . . . . . . . . . . . . . . . . 310
configuring . . . . . . . . . . . . . . . . . . . 66 DisableStartButtonAfterFirstClick . . . . . . . . . 378
DB2 . . . . . . . . . . . . . . . . . . . . . . 72 display time
Oracle . . . . . . . . . . . . . . . . . . . . . 69 CCQ database . . . . . . . . . . . . . . . . . 87
primary. . . . . . . . . . . . . . . . . . . . . 67 IC Repository . . . . . . . . . . . . . . . . . . 77
secondary . . . . . . . . . . . . . . . . . . . 74 documentation . . . . . . . . . . . . . . . . . . . 19
SQL Server . . . . . . . . . . . . . . . . . . 67 domains
troubleshooting . . . . . . . . . . . . . . . . . 453 administration . . . . . . . . . . . . . . . . . . 27
data sources creating . . . . . . . . . . . . . . . . . . . .101
Interaction Center . . . . . . . . . . . . . .
. 93. failover . . . . . . . . . . . . . . . . . . . .101
repository . . . . . . . . . . . . . . . . .
. 84. guidelines . . . . . . . . . . . . . . . . . . .100
understanding . . . . . . . . . . . . . . .
. 74. IC Email server . . . . . . . . . . . . . . 284, 286
Database Designer . . . . . . . . . . . . . .
. 77. Java Application Bridge . . . . . . . . . . 390, 414
Database Host . . . . . . . . . . . . . . . .212, 217 preconfigured . . . . . . . . . . . . . . . . . . 99
Database Login . . . . . . . . . . . . . 206, 212, 217 Web Services Bridge . . . . . . . . . . . . . 427
Database Password . . . . . . . . . . . 206, 212, 217 DontStartMultipleInstancesOfAgent . . . . . . 374, 377
database system . . . . . . . . . . . . . . . . . . 67 ds.ffd . . . . . . . . . . . . . . . . . . . . . . . 116
databases DUStore server
Business Advocate . . . . . . . . . . . . . . 45, 49 stopping . . . . . . . . . . . . . . . . . . . 131

Installation and Configuration March 2012 507


Index

updating . . . . . . . . . . . . . . . . . . . . 111 configuring . . . . . . . . . . . . . . . . . . 375


DisableStartButtonAfterFirstClick . . . . . . . . 378
DontStartMultipleInstancesOfAgent . . . . . . . 377
E INI file . . . . . . . . . . . . . . . . . . . . 376
ECB, verifying permissions . . . . . . . . . . . . . 52 installing . . . . . . . . . . . . . . . . . . . 376
EDU server MaximizeWindowOnLanchedAppExit . . . . . . 378
creating . . . . . . . . . . . . . . . . . . . . 116 MinimizeWindowOnLanchedAppStart . . . . . . 378
stopping . . . . . . . . . . . . . . . . . . . . 131 multiple Citrix servers . . . . . . . . . . . . . 378
EDUs
creating EDU server . . . . . . . . . . . . . . 116
email F
RONA . . . . . . . . . . . . . . . . . . . . . 283 failover, domains . . . . . . . . . . . . . . . . . 101
Workflow server . . . . . . . . . . . . . . . . 297 flows
Email Management Email Management . . . . . . . . . . . . . .
303
configuring . . . . . . . . . . . . . . . . . . . 283 loading . . . . . . . . . . . . . . . . . . . .
186
configuring WebACD server . . . . . . . . . . . 307 sample . . . . . . . . . . . . . . . . . . . .
107
configuring Workflow server . . . . . . . . . . . 298 system . . . . . . . . . . . . . . . . . . . .
107
email accounts . . . . . . . . . . . . . . . . . 309 Telephony . . . . . . . . . . . . . . . . . .
185
email status . . . . . . . . . . . . . . . . . . 320 Web Management . . . . . . . . . . . . . . .
223
Email Template Administration . . . . . . . . . 308 flush . . . . . . . . . . . . . . . . . . . . 69, 71, 73
optional configurations . . . . . . . . . . . . . 283 FTSE, configuring . . . . . . . . . . . . . . . . 235
prerequisites . . . . . . . . . . . . . . . . . . 284 full text searches, troubleshooting . . . . . . . . . 474
RONA . . . . . . . . . . . . . . . . . . . . . 283
routing hints . . . . . . . . . . . . . . . . . . 305
Workflow server . . . . . . . . . . . . . . . . 297 G
workflows . . . . . . . . . . . . . . . . . . . 303 generating
Email server IC Repository application . . . . . . . . . . . . 84
see IC Email server Interaction Center application . . . . . . . . . . 93
Email Template Administration guidelines
configuring Web application . . . . . . . . . . . 289 additional ICM server . . . . . . . . . . . . . 276
email status . . . . . . . . . . . . . . . . . . 320 domains . . . . . . . . . . . . . . . . . . . 100
integrating . . . . . . . . . . . . . . . . . . . 308 server naming . . . . . . . . . . . . . . . . . 109
JVM Options . . . . . . . . . . . . . . . . . . 501 Web Scheduled Callback . . . . . . . . . . . 246
EmailLoginServer . . . . . . . . . . . . . . . . . 308
EmailLoginServerPort . . . . . . . . . . . . . . . 308
EmailLoginServerWebsite . . . . . . . . . . . . . 308 H
EmailServer . . . . . . . . . . . . . . . . . . . . 308
Heap size . . . . . . . . . . . . . . . . . . . . 499
EmailServerPort . . . . . . . . . . . . . . . . . . 308
home directory . . . . . . . . . . . . . . . . . . 340
enabling localization . . . . . . . . . . . . . . . . 436
HTTP Connector server
environment
creating . . . . . . . . . . . . . . . . . . . . 125
Business Advocate . . . . . . . . . . . . . . . 44
Traditional Chinese . . . . . . . . . . . . . . 445
primary ORB . . . . . . . . . . . . . . . . . . 35
human users
secondary ORB . . . . . . . . . . . . . . . . 37
error messages
administrative accounts . . . . . . . . . . . . 105
creating . . . . . . . . . . . . . . . . . . . . 105
deleting . . . . . . . . . . . . . . . . . . . . 443
translating . . . . . . . . . . . . . . . . . . . 443
Event Collector Bridge, permissions . . . . . . . . . 52
executable tool
I
AgentAlreadyRunningMsg . . . . . . . . . . . . 377 IBM HTTP server
AskForExitConformation . . . . . . . . . . . . 378 AIX . . . . . . . . . . . . . . . . . . . . . . 406
caption properties . . . . . . . . . . . . . . . . 378 autostart . . . . . . . . . . . . . . . . . . . 143
CitrixClientURL . . . . . . . . . . . . . . . . . 376 Solaris . . . . . . . . . . . . . . . . . . . . 405
ClientBarHight . . . . . . . . . . . . . . . . . 377 Windows . . . . . . . . . . . . . . . . . . . 405
ClientBarWidth . . . . . . . . . . . . . . . . . 377 IC Data Source . . . . . . . . . . . . . . 206, 211, 216
components . . . . . . . . . . . . . . . . . . 376 IC Email server

508 Installation and Configuration March 2012


Index

about . . . . . . . . . . . . . . . . . . . . . 286 INI file


creating . . . . . . . . . . . . . . . . . 284, 286 configuring for Citrix . . . . . . . . . . . . . . 372
failover . . . . . . . . . . . . . . . . . . 284, 286 executable tool for Citrix . . . . . . . . . . . . 376
guidelines . . . . . . . . . . . . . . . . 284, 286 localization . . . . . . . . . . . . . . . . . . 436
IC Login . . . . . . . . . . . . . . . . . 206, 211, 216 initial configuration . . . . . . . . . . . . . . . 35, 37
IC Manager initialization flow . . . . . . . . . . . . . . . . . 124
Admin account . . . . . . . . . . . . . . . . . 104 installer, agent . . . . . . . . . . . . . . . . 352, 355
CPU resources . . . . . . . . . . . . . . . . . 27 installing
logging in . . . . . . . . . . . . . . . . . . . 28 additional ICM servers . . . . . . . . . . . . . 275
multiple instances . . . . . . . . . . . . . . . . 27 agent applications . . . . . . . . . . . . . 327, 351
stopping servers . . . . . . . . . . . . . . . . 136 Avaya Agent Web Client connector
troubleshooting . . . . . . . . . . . . . . . . . 456 AIX . . . . . . . . . . . . . . . . . . . . . 32
Web Management administration pages . . . . . 218 Solaris . . . . . . . . . . . . . . . . . . . . 30
IC Password . . . . . . . . . . . . . . . 206, 211, 216 Windows . . . . . . . . . . . . . . . . . . 28
IC Repository Client SDK
building . . . . . . . . . . . . . . . . . . . . 76 AIX . . . . . . . . . . . . . . . . . . . . . 32
connection set . . . . . . . . . . . . . . . . . 82 Solaris . . . . . . . . . . . . . . . . . . . . 30
creating . . . . . . . . . . . . . . . . . . . 76, 82 Windows . . . . . . . . . . . . . . . . . . 28
data source . . . . . . . . . . . . . 206, 212, 217 Client SDK components . . . . . . . . . . . . 410
database connection . . . . . . . . . . . . . . 77 DB2 qdb2sp library . . . . . . . . . . . . . . . 66
generating application . . . . . . . . . . . . . . 84 Design & Administration Tools . . . . . . . . . . 28
seed data . . . . . . . . . . . . . . . . . . . 83 executable tool for Citrix . . . . . . . . . . . . 376
updating Directory server . . . . . . . . . . . . 85 license . . . . . . . . . . . . . . . . . . . . 155
ICEmail flows . . . . . . . . . . . . . . . . . . . 107 on Citrix server . . . . . . . . . . . . . . . . 370
ICM Bridge prerequisites . . . . . . . . . . . . . . . . . . 22
adding ICM servers . . . . . . . . . . . . . . . 281 Server SDK
enable . . . . . . . . . . . . . . . . . . . . . 196 AIX . . . . . . . . . . . . . . . . . . . . .54
ICM server Solaris . . . . . . . . . . . . . . . . . . . .54
adding to ICM Bridge . . . . . . . . . . . . . . 281 Windows . . . . . . . . . . . . . . . . . .54
additional . . . . . . . . . . . . . . . . . . . 275 servers . . . . . . . . . . . . . . . . . . . . .28
autostart on UNIX . . . . . . . . . . . . . 140, 142 AIX . . . . . . . . . . . . . . . . . . . . .32
CIRS. . . . . . . . . . . . . . . . . . . . . . 230 Solaris . . . . . . . . . . . . . . . . . . . .30
CIRS for additional ICM . . . . . . . . . . . . . 279 Windows . . . . . . . . . . . . . . . . . .28
configuration files . . . . . . . . . . . . . . . . 471 Web browser tool for Citrix . . . . . . . . . . . 373
configuring . . . . . . . . . . . . . . . . . . . 228 Web Services components . . . . . . . . . . . 424
configuring additional . . . . . . . . . . . 277, 278 integrating
configuring independent second . . . . . . . . . 280 Email Template Administration . . . . . . . . . 308
configuring primary for additional ICM . . . . . . 278 Web Management administration pages . . . . 218
enabling CIRS . . . . . . . . . . . . . . . . . 280 integration, Citrix . . . . . . . . . . . . . . . . . 368
guidelines for additional . . . . . . . . . . . . . 276 Interaction Center application . . . . . . . . . . . . 93
ICM bridge . . . . . . . . . . . . . . . . . . . 197 Internet Explorer, Avaya Agent Web Client . . . . . 384
icmbridge account . . . . . . . . . . . . . . . 105
log files . . . . . . . . . . . . . . . . . . . . 472
start on UNIX . . . . . . . . . . . . . . . 140, 142 J
stop on UNIX . . . . . . . . . . . . . . . 140, 142 Japanese, send on enter . . . . . . . . . . . . . 446
troubleshooting . . . . . . . . . . . . . . 457, 461 Java Application Bridge
ICM service . . . . . . . . . . . . . . . 206, 211, 216 agent account . . . . . . . . . . . . . . . 388, 412
icmbridge account . . . . . . . . . . . . . . . . . 105 Avaya Agent Web Client . . . . . . . . . . . . 388
idl . . . . . . . . . . . . . . . . . . . . . . 69, 71, 73 Client SDK . . . . . . . . . . . . . . . . . . . 411
IMEs, Japanese . . . . . . . . . . . . . . . . . . 446 creating . . . . . . . . . . . . . . . . . . 390, 413
importing seed data . . . . . . . . . . . . . . . 83, 93 domain . . . . . . . . . . . . . . . . . . 390, 414
index setting up . . . . . . . . . . . . . . . . . 388, 411
updating on AIX . . . . . . . . . . . . . . . . 244 starting . . . . . . . . . . . . . . . . 391, 415, 429
updating on Solaris . . . . . . . . . . . . . . . 240 UNC to UNIX mapping . . . . . . . . . . . 392, 394
updating on Windows . . . . . . . . . . . . . . 236 Java client, running . . . . . . . . . . . . . . . . 417

Installation and Configuration March 2012 509


Index

JavaAppBridge Email Management . . . . . . . . . . . . . . 283


see Java Application Bridge prerequisites . . . . . . . . . . . . . . . . . 190
JRE version . . . . . . . . . . . . . . . . . . . . 385 Telephony . . . . . . . . . . . . . . . . . . 163
Web Management . . . . . . . . . . . . . . . 189
migrating . . . . . . . . . . . . . . . . . . . . . . 55
K MinimizeWindowOnLanchedAppStart . . . . . . . 378
keystoreFile . . . . . . . . . . . . . . . . . 422, 431 minimum Heap size . . . . . . . . . . . . . . . . 499
keystorePass . . . . . . . . . . . . . . . . 422, 431 minimum Stack size . . . . . . . . . . . . . . . 499
knowledge base . . . . . . . . . . . . . . . . . . 324 modifying
Avaya Agent layout . . . . . . . . . . . . . . . 86
SSL properties . . . . . . . . . . . . . . . . 269
L multiple database types . . . . . . . . . . . . . . . 67
multiple Tomcat
language abbreviations . . . . . . . . . . . . . . . 436 starting on UNIX. . . . . . . . . . . . . . 141, 143
layout, Avaya Agent . . . . . . . . . . . . . . . . 86 starting Website on UNIX . . . . . . . . . 141, 144
LCID abbreviations. . . . . . . . . . . . . . . . . 436 stopping on UNIX . . . . . . . . . . . . . 141, 143
license file . . . . . . . . . . . . . . . . . . . . . 22 stopping Website on UNIX . . . . . . . . . 141, 144
License server, configuring . . . . . . . . . . . . . 157 multiple, IC Manager . . . . . . . . . . . . . . . . 27
licenses
MultiVantage TS . . . . . . . . . . . . . . . . . 166
installing . . . . . . . . . . . . . . . . . . . . 155
licensing
about . . . . . . . . . . . . . . . . . . . . . 145 N
changing password . . . . . . . . . . . . . . . 159
installing license . . . . . . . . . . . . . . . . 155 naming, servers . . . . . . . . . . . . . . . . . 109
License server . . . . . . . . . . . . . . . . . 157 nethome . . . . . . . . . . . . . . . . 44, 45, 49, 51
prerequisites . . . . . . . . . . . . . . . . . . 145 Nethome directory . . . . . . . . . . . . . . . . . 44
limitations, Citrix integration. . . . . . . . . . . . . 369 network drive, agent installer . . . . . . . . . . . 358
loading flows . . . . . . . . . . . . . . . . . . . 186 non-human users
locale ID . . . . . . . . . . . . . . . . . . . . . 436 administrative accounts . . . . . . . . . . . . 103
localization creating . . . . . . . . . . . . . . . . . . . . 105
character encoding . . . . . . . . . . . . . . . 436 Java Application Bridge . . . . . . . . . . 388, 412
enabling . . . . . . . . . . . . . . . . . . . . 436 Web Services Bridge . . . . . . . . . . . . . 425
Japanese . . . . . . . . . . . . . . . . . . . 446 Notification server
language abbreviations . . . . . . . . . . . . . 436 alternate email encodings . . . . . . . . . . . 444
location creating . . . . . . . . . . . . . . . . . . . . 128
Citrix integration files . . . . . . . . . . . . . . 371
log files
ICM server . . . . . . . . . . . . . . . . . . . 472 O
Web Management . . . . . . . . . . . . . . . 472 Operations Content Analyzer server . . . . . . 323, 325
Web Scheduled Callback . . . . . . . . . . . . 473 Oracle
log levels . . . . . . . . . . . . . . . . . . . . . 488 Data server . . . . . . . . . . . . . . . . . . . 69
Logical Resource Manager Oracle SID . . . . . . . . . . . . . . . . . 36, 38
additional, database schema . . . . . . . . . . 49 Oracle iPlanet Server
first, database schema . . . . . . . . . . . . . 45 autostart . . . . . . . . . . . . . . . . . . . 141
login, administrator . . . . . . . . . . . . . . . 23, 385 starting . . . . . . . . . . . . . . . . . . . . 140
stopping . . . . . . . . . . . . . . . . . 141, 143
Oracle SID . . . . . . . . . . . . . . . . . 36, 38, 212
M ORACLE_HOME . . . . . . . . . . . . . . . . . 238
mailto . . . . . . . . . . . . . . . . . . . . . . . 309 ORB server
mapping, UNC to UNIX . . . . . . . . . . . . 392, 394 configuring . . . . . . . . . . . . . . . . . . . 35
MaximizeWindowOnLanchedAppExit . . . . . . . . 378 secondary . . . . . . . . . . . . . . 37, 410, 424
maximum Heap size . . . . . . . . . . . . . . . . 499 starting . . . . . . . . . . . . . . . . . . . . 134
maximum Stack size . . . . . . . . . . . . . . . . 499 stopping . . . . . . . . . . . . . . . . . . . 134
media channels orbsrv.exe . . . . . . . . . . . . . . . . . . . . 135
agents . . . . . . . . . . . . . . . . . . . . . 335 order, servers . . . . . . . . . . . . . . . . . . 131
outbound email flow . . . . . . . . . . . . . . . 289

510 Installation and Configuration March 2012


Index

P Q
pa_admin . . . . . . . . . . . . . . . . . . . . . 52 qdb2sp library . . . . . . . . . . . . . . . . . . . 66
Paging server qntorbsrv.exe . . . . . . . . . . . . . . . . . . 135
about . . . . . . . . . . . . . . . . . . . . . 199
changing service port . . . . . . . . . . . . . . 492
creating . . . . . . . . . . . . . . . . . . . . 199 R
passwords for accounts . . . . . . . . . . . . . . 103 Readme file . . . . . . . . . . . . . . . . . . . . 22
permissions recommended settings
agent installer . . . . . . . . . . . . . . . . . 351 advanced properties . . . . . . . . . . . . . . 502
verifying for ECB . . . . . . . . . . . . . . . . 52 core servers. . . . . . . . . . . . . . . . . . . 110
planning customization . . . . . . . . . . . . . . . 19 redeploying Avaya Agent Web Client . . . . . . . 407
pop-up blockers, Avaya Agent Web Client . . . . . . 385 refresh
ports IC Manager . . . . . . . . . . . . . . . . . . 281
changing service ports . . . . . . . . . . . . . 491 troubleshooting . . . . . . . . . . . . . . . . 456
email server . . . . . . . . . . . . . . . . . . 308 reinstalling
preconfigured domains . . . . . . . . . . . . . . . 99 Avaya Agent Web Client . . . . . . . . . . . . 398
preparing agent installer . . . . . . . . . . . . . . 357 Avaya IC . . . . . . . . . . . . . . . . . . . . 55
prerequisites. . . . . . . . . . . . . . . . . . . . 22 Report server
agent applications . . . . . . . . . . . . . . . 351 creating . . . . . . . . . . . . . . . . . . . . . 118
AIX . . . . . . . . . . . . . . . . . . . . . . 24 stopping . . . . . . . . . . . . . . . . . . . 131
Avaya Agent Web Client . . . . . . . . . . . . 384 Repository
Business Advocate . . . . . . . . . . . . . . . 43 see IC Repository
Client SDK . . . . . . . . . . . . . . . . . . . 409 Repository data source . . . . . . . . . . 206, 212, 217
core servers . . . . . . . . . . . . . . . . . 65, 97 repository.adl . . . . . . . . . . . . . . . . . . 75, 77
Email Management . . . . . . . . . . . . . . . 284 repositoryDBConnection . . . . . . . . . . . . . . 77
installation . . . . . . . . . . . . . . . . . . . 22 requirements
JRE version . . . . . . . . . . . . . . . . . . 385 administrator login . . . . . . . . . . . . . . 23, 385
licence . . . . . . . . . . . . . . . . . . . . . 22 agent installer . . . . . . . . . . . . . . . . . 351
licenses . . . . . . . . . . . . . . . . . . . . 145 Agent Site Preparation wizard . . . . . . . . . 354
media channels . . . . . . . . . . . . . . . . . 190 Business Advocate . . . . . . . . . . . . . . . 43
Solaris . . . . . . . . . . . . . . . . . . . . . 24 core servers. . . . . . . . . . . . . . . . . 65, 97
SSL . . . . . . . . . . . . . . . . . . . . . . 267 data sources . . . . . . . . . . . . . . . . . . 74
Telephony . . . . . . . . . . . . . . . . . . . 164 Email Management . . . . . . . . . . . . . . 284
UNC to UNIX mapping . . . . . . . . . . 392, 395 license . . . . . . . . . . . . . . . . . . . . . 22
Web Scheduled Callback . . . . . . . . . . . . 245 licenses . . . . . . . . . . . . . . . . . . . . 145
Web Services . . . . . . . . . . . . . . . . . 423 media channels . . . . . . . . . . . . . . . . 190
primary servers SSL . . . . . . . . . . . . . . . . . . . . . 267
creating environment . . . . . . . . . . . . . . 35 Telephony . . . . . . . . . . . . . . . . . . 164
Data server. . . . . . . . . . . . . . . . . . . 67 UNC to UNIX mapping . . . . . . . . . . . 392, 395
DB2 Instance . . . . . . . . . . . . . . . . . 36, 38 Web Scheduled Callback . . . . . . . . . . . 245
Oracle SID . . . . . . . . . . . . . . . . . . 36, 38 resource store, database schema . . . . . . . . . . 45
Prompter flows . . . . . . . . . . . . . . . . . . 107 response library manager . . . . . . . . . . . . . 289
properties Return on no answer
agents . . . . . . . . . . . . . . . . . . 337, 345 see RONA
Avaya Agent . . . . . . . . . . . . . . . . . . 340 rlmanager . . . . . . . . . . . . . . . . . . . . 289
Avaya Agent Web Client . . . . . . . . . . . . 343 RONA
Client SDK . . . . . . . . . . . . . . . . . . . 345 Email Management . . . . . . . . . . . . . . 283
home directory . . . . . . . . . . . . . . . . . 340 Telephony . . . . . . . . . . . . . . . . . . 163
working directory . . . . . . . . . . . . . 343, 345 Web Management . . . . . . . . . . . . . . . 189
proxy server, Avaya Agent Web Client . . . . . . . 384 root, changing ownership . . . . . . . . . . 39, 41, 402
routing hints . . . . . . . . . . . . . . . . . . . 305
adding . . . . . . . . . . . . . . . . . . 225, 305
Telephony . . . . . . . . . . . . . . . . . . 187

Installation and Configuration March 2012 511


Index

Web Management . . . . . . . . . . . . . . . 225 Paging . . . . . . . . . . . . . . .


. . . . . 199
RoutingHint table . . . . . . . . . . . . . . 225, 305 recommended settings. . . . . . . .
. . . . . . 110
running Agent Site Preparation wizard . . . . . . . . 355 reinstalling . . . . . . . . . . . . .
. . . . . . 55
runtime settings, SSL . . . . . . . . . . . . . . . 406 Report . . . . . . . . . . . . . . .
. . . . . . 118
secondary Directory . . . . . . . . .
. . . . . . 115
Solaris . . . . . . . . . . . . . . .
. . . . . . 30
S starting . . . . . . . . . . . . . . .
. . . . . 131
Samba . . . . . . . . . . . . . . . . . . . 392, 395 starting primary . . . . . . . . . . .
. . . . . . 35
sample workflows . . . . . . . . . . . . . . . . . 107 starting secondary . . . . . . . . . .
. . . . . . 37
SDK starting Telephony . . . . . . . . . .
. . . . . 182
Client SDK . . . . . . . . . . . . . 28, 30, 32, 409 startup dependencies . . . . . . . .
. . . . . 132
Server SDK . . . . . . . . . . . . . . . . . . 54 stopping . . . . . . . . . . . . . .
. . . . . 131
seamless window, Citrix . . . . . . . . . . . . . . 369 Telephony . . . . . . . . . . . . .
. . . . . 165
secondary servers troubleshooting . . . . . . . . . . .
. . . . . 451
Client SDK . . . . . . . . . . . . . . . . . . . 410 troubleshooting communications . . .
. . . . . 452
creating environment . . . . . . . . . . . . . . 37 TSQS server . . . . . . . . . . . .
. . . . . 178
Data server. . . . . . . . . . . . . . . . . . . 74 Web Management . . . . . . . . . .
. . . . . 138
ICM . . . . . . . . . . . . . . . . . . . . . . 275 Web Scheduled Callback . . . . . .
. . . . . 246
Web Services . . . . . . . . . . . . . . . . . 424 Web Services . . . . . . . . . . 139, 141, 144, 430
Secure Sockets Layer . . . . . . . . . . . . 267, 406 Web Services Bridge . . . . . . . . . . . 424, 426
security WebACD . . . . . . . . . . . . . . . 191, 268, 307
passwords . . . . . . . . . . . . . . . . . . . 103 Windows . . . . . . . . . . . . . . . . . . . . 28
setting up SSL . . . . . . . . . . . . . . . . . 267 Workflow
seed data, IC Repository . . . . . . . . . . . . . . 83 creating . . . . . . . . . . . . . . . . . . . 119
seed.cfg . . . . . . . . . . . . . . . . . . . . . . 92 Email Management . . . . . . . . . . . . . 297
send on enter, Japanese . . . . . . . . . . . . . . 446 Telephony . . . . . . . . . . . . . . . . . 182
sequence for Avaya tools . . . . . . . . . . . . . . 379 transfers and conferences . . . . . . . . . 347
Server SDK, installing . . . . . . . . . . . . . . . 54 Web Management . . . . . . . . . . . . . 220
servers service ports
administration . . . . . . . . . . . . . . . . . 27 attribute server . . . . . . . . . . . . . . . . 492
Administrative Content Analyzer . . . . . . . . . 321 changing . . . . . . . . . . . . . . . . . . . 491
ADU . . . . . . . . . . . . . . . . . . . . . . 110 ComHub server . . . . . . . . . . . . . . . . 492
AIX . . . . . . . . . . . . . . . . . . . . . . 32 Paging server . . . . . . . . . . . . . . . . . 492
Attribute . . . . . . . . . . . . . . . 191, 195, 281 WebACD server . . . . . . . . . . . . . . . . 491
Blender . . . . . . . . . . . . . . . . . . . . 123 services
Business Advocate . . . . . . . . . . . . . . . 44 starting on Windows . . . . . . . . . . . . . . 139
cautions and tips for installing . . . . . . . . . . 25 stopping on Windows . . . . . . . . . . . . . 139
Client SDK . . . . . . . . . 139, 141, 144, 415, 416 services, Web Management . . . . . . . . . . . . 201
ComHub . . . . . . . . . . . . . . . . . . . . 197 setting agent properties . . . . . . . . . . . . . . 337
configuring . . . . . . . . . . . . . . . . . . . 191 setting up
core . . . . . . . . . . . . . . . . . . . . 97, 108 administration website . . . . . . . . . . . . . 272
Data . . . . . . . . . . . . . . . . . . . . . . 66 Data server . . . . . . . . . . . . . . . . . . . 67
dependencies . . . . . . . . . . . . . . . . . 131 Java Application Bridge . . . . . . . . . . 388, 411
documents . . . . . . . . . . . . . . . . . . . 20 optional web configurations . . . . . . . . . . 189
DUStore . . . . . . . . . . . . . . . . . . . . 111 separate customer Website . . . . . . . . . . 274
EDU . . . . . . . . . . . . . . . . . . . . . . 116 Web Services Bridge . . . . . . . . . . . . . 424
HTTP Connector . . . . . . . . . . . . . 125, 445 sharing Nethome directory . . . . . . . . . . . . . 44
IC Email . . . . . . . . . . . . . . . . . 284, 286 ShowAgentsOnStartup . . . . . . . . . . . . 341, 342
ICM . . . . . . . . . . . . . . . . . . . 197, 228 ShowAgentState . . . . . . . . . . . . . . . . . 342
installing . . . . . . . . . . . . . . . . . . . . 28 ShowAllAgents . . . . . . . . . . . . . . . . . . 342
Java Application Bridge . . . . . . . . . . 390, 413 SID, Oracle . . . . . . . . . . . . . . . . . . 36, 38
License . . . . . . . . . . . . . . . . . . . . 157 site preparation wizard
naming . . . . . . . . . . . . . . . . . . . . . 109 Avaya Agent . . . . . . . . . . . . . . . . . 355
Notification . . . . . . . . . . . . . . . . 128, 444 sites, creating . . . . . . . . . . . . . . . . . . . 98
Operations Content Analyzer . . . . . . . . . . 323 SkillsSupport . . . . . . . . . . . . . . . . . . . 342

512 Installation and Configuration March 2012


Index

Solaris starting servers . . . . . . . . . . . . . . . . . . 131


changing ownership. . . . . . . . . . . . . 39, 402 status, email . . . . . . . . . . . . . . . . . . . 320
configuring full-text searches . . . . . . . . . . 238 stopping
installing ADU server . . . . . . . . . . . . . . . . . . 131
Avaya Agent Web Client connector . . . . . . 30 CIRS server on UNIX . . . . . . . . . . . 140, 143
Server SDK . . . . . . . . . . . . . . . . . 54 Client SDK server . . . . . . . . 142, 144, 416, 417
servers . . . . . . . . . . . . . . . . . . . 30 EDU server . . . . . . . . . . . . . . . . . . 131
installing Avaya Agent Web Client connector . . . 30 ICM server on UNIX . . . . . . . . . . . . 140, 142
installing Client SDK . . . . . . . . . . . . . . 30 multiple Tomcat instances on UNIX . . . . . 141, 143
prerequisites . . . . . . . . . . . . . . . . . . 24 Oracle iPlanet Server . . . . . . . . . . . 141, 143
starting Client SDK server . . . . . . . . . 141, 417 services on Windows . . . . . . . . . . . . . 139
starting IBM HTTP server . . . . . . . . . . . . 405 Web Services server . . . . . . 142, 144, 430, 431
starting Web Services server . . . . . . . 141, 430 Website on UNIX . . . . . . . . . . . . . 141, 144
stopping Client SDK server . . . . . . . . 142, 417 stored procedure library, qdb2sp . . . . . . . . . . 66
stopping Web Services server . . . . . . . 142, 430 string table messages
troubleshooting . . . . . . . . . . . . . . . . . 448 deleting . . . . . . . . . . . . . . . . . . . . 443
UNC to UNIX mapping . . . . . . . . . . . . . 394 translating . . . . . . . . . . . . . . . . . . 443
updating full text index . . . . . . . . . . . . . 240 Suggested Email Responses . . . . . . . . . . . 235
updating index . . . . . . . . . . . . . . . . . 240 sys_agentsearch.update_agentstate_cache . . . . 349
windowing environment . . . . . . . . . . . . . 24 sys_transfer.transfertovq . . . . . . . . . . . . . 349
SQL Server, Data server . . . . . . . . . . . . . . 67 sys_transfer.update_vq_cache . . . . . . . . . . 349
SSL system store, database schema . . . . . . . . . 45, 49
Avaya Agent Web Client runtime settings. . . . . 406 system workflows . . . . . . . . . . . . . . . . . 107
configuring for tenants . . . . . . . . . . . . . 270
configuring WebACD server . . . . . . . . . . . 268
editing configuration file . . . . . . . . . . . . . 269 T
modifying properties . . . . . . . . . . . . . . 269 target encoding . . . . . . . . . . . . . . . . . . 436
prerequisites . . . . . . . . . . . . . . . . . . 267 task ceiling . . . . . . . . . . . . . . . . . . . . 335
Tomcat. . . . . . . . . . . . . . . . . . 421, 431 task load . . . . . . . . . . . . . . . . . . . . . 335
Web Management . . . . . . . . . . . . . . . 267 Telephony
website configuration . . . . . . . . . . . . . . 268 ACDname parameter . . . . . . . . . . . . . 164
Stack size . . . . . . . . . . . . . . . . . . . . . 499 configuring . . . . . . . . . . . . . . . . . . 163
starting configuring Workflow server . . . . . . . . . . 184
Business Advocate . . . . . . . . . . . . . . . 44 documents . . . . . . . . . . . . . . . . . . . 20
CIRS server on UNIX . . . . . . . . . . . 140, 143 prerequisites . . . . . . . . . . . . . . . . . 164
Client SDK server . . . 139, 141, 144, 415, 416, 417 RONA . . . . . . . . . . . . . . . . . . . . 163
IBM HTTP server routing hints . . . . . . . . . . . . . . . . . . 187
AIX . . . . . . . . . . . . . . . . . . . . . 406 Workflow server . . . . . . . . . . . . . . . . 182
Solaris . . . . . . . . . . . . . . . . . . . 405 workflows . . . . . . . . . . . . . . . . . . . 185
Windows . . . . . . . . . . . . . . . . . . 405 Telephony server
ICM server on UNIX . . . . . . . . . . . 140, 142 about . . . . . . . . . . . . . . . . . . . . . 165
Java Application Bridge . . . . . . . . 391, 415, 429 Aspect . . . . . . . . . . . . . . . . . . . . 168
multiple Tomcat instances on UNIX . . . . 141, 143 Cisco . . . . . . . . . . . . . . . . . . . . . 170
Oracle iPlanet Server . . . . . . . . . . . . . . 140 CM . . . . . . . . . . . . . . . . . . . . . . 166
primary servers . . . . . . . . . . . . . . . . . 35 creating . . . . . . . . . . . . . . . . . . . . 165
sample clients . . . . . . . . . . . . . . . . . 417 starting . . . . . . . . . . . . . . . . . . . . 182
secondary servers . . . . . . . . . . . . . . . 37 temp tablespace name . . . . . . . . . . . . . 81, 91
servers . . . . . . . . . . . . . . . . . . . . . 132 templates, email . . . . . . . . . . . . . . . . . 308
services on Windows . . . . . . . . . . . . . . 139 test agents . . . . . . . . . . . . . . . . . . . . 331
Telephony server . . . . . . . . . . . . . . . . 182 testing
TSQS server . . . . . . . . . . . . . . . . . . 182 agent installation . . . . . . . . . . . . . . . 357
Web Management servers . . . . . . . . . . . 138 agents . . . . . . . . . . . . . . . . . . . . 331
Web Services server . . . . 139, 141, 144, 430, 431 Avaya Agent Web Client . . . . . . . . . . . . 404
Website on UNIX . . . . . . . . . . . . . 141, 144 time zones, Web Scheduled Callback . . . . . . . 246
Workflow server . . . . . . . . . . . . . 185, 223 timeout . . . . . . . . . . . . . . . . . . . . 77, 87

Installation and Configuration March 2012 513


Index

tips
agent accounts . . . . . . . . . . . . . . . . . 329
Avaya Agent installation . . . . . . . . . . . . . 352
U
Data server. . . . . . . . . . . . . . . . . . . 67 UADStringFormat. . . . . . . . . . . . . . . . . 342
Design & Administration Tools . . . . . . . . . . 26 UCC . . . . . . . . . . . . . . . . . . . . . . . 180
server installation . . . . . . . . . . . . . . . . 25 UCC, Cisco . . . . . . . . . . . . . . . . . . . 170
Web Scheduled Callback . . . . . . . . . . . . 245 UICountryOrRegion . . . . . . . . . . . . . . . . 442
Tomcat UILanguage . . . . . . . . . . . . . . . . . . . 441
autostart on UNIX . . . . . . . . . . . . . 142, 144 UNC to UNIX mapping
Setup . . . . . . . . . . . . . . . . . . . . . 501 about . . . . . . . . . . . . . . . . . . . 392, 394
SSL . . . . . . . . . . . . . . . . . . . 421, 431 configuring . . . . . . . . . . . . . . . . 394, 396
tools, Citrix . . . . . . . . . . . . . . . . . . . . 379 examples . . . . . . . . . . . . . . . . . 393, 396
Traditional Chinese prerequisites . . . . . . . . . . . . . . . 392, 395
HTTP Connector server . . . . . . . . . . . . . 445 requirements . . . . . . . . . . . . . . . 392, 395
Notification server . . . . . . . . . . . . . . . 444 Unified Agent Directory
TransferFlowName. . . . . . . . . . . . . . . . . 342 configuring agents . . . . . . . . . . . . . . . 341
translating, string table messages . . . . . . . . . . 443 configuring Workflow server . . . . . . . . . . 347
troubleshooting uninstalling
agent issues . . . . . . . . . . . .
. . . 477, 484 agent desktop applications . . . . . . . . . . . 497
Avaya Agent Web Client . . . . . .
. . . . . . 482 Avaya IC . . . . . . . . . . . . . . . . . . . 494
general . . . . . . . . . . . . .
. . . . . . 482 Avaya IC servers . . . . . . . . . . . . . 495, 496
logging . . . . . . . . . . . . .
. . . . . . 488 FTSE for AIX . . . . . . . . . . . . . . . . . 496
logging in . . . . . . . . . . . .
. . . 486, 489 FTSE for Solaris. . . . . . . . . . . . . . . . 495
Configuration Tool . . . . . . . . .
. . . . . . 450 FTSE for Windows . . . . . . . . . . . . . . 494
Data server. . . . . . . . . . . . .
. . . . . . 453 Windows . . . . . . . . . . . . . . . . . . . 494
DataWake . . . . . . . . . . . . .
. . . 468, 470 updating
full text searches . . . . . . . . . .
. . . . . . 474 ADU server . . . . . . . . . . . . . . . . . . . 110
ICM server . . . . . . . . . . . . .
. . . . . . 457 Directory server . . . . . . . . . . . . . . . . . 85
refresh in IC Manager . . . . . . . .
. . . . . . 456 DUStore server . . . . . . . . . . . . . . . . . 111
server communication . . . . . . . .
. . . . . . 452 index on AIX . . . . . . . . . . . . . . . . . 244
servers . . . . . . . . . . . . . . .
. . . . . . 451 index on Solaris . . . . . . . . . . . . . . . . 240
uninstalling . . . . . . . . . . . 494, 495, 496, 497 index on Windows . . . . . . . . . . . . . . . 236
verifying Web Self-Service . . . . . . . . 475, 476 Web browser tool for Citrix . . . . . . . . . . . 374
Web Management . . . . . . . . . . . . . . . 457 Workflow server . . . . . . . . . . . . . . . . . 119
Web Management integration . . . . . . . . . . 466 upgrading . . . . . . . . . . . . . . . . . . . . . 55
Web Self-Service . . . . . . . . . . . . . . . . 476
Website . . . . . . . . . . . . . . . . . 461, 476
Workflow server . . . . . . . . . . . . . 455, 456 V
Trusted Sites . . . . . . . . . . . . . . . . 352, 384 verifying
TS flows . . . . . . . . . . . . . . . . . . . . . . 107 permissions for ECB . . . . . . . . . . . . . . . 52
TS server Web Self-Service . . . . . . . . . . . . . 475, 476
see Telephony server vesp.imp, copying . . . . . . . . . . . . . . . . 356
TS.IncomingCall . . . . . . . . . . . . . . . . . . 185 voice
TSQS server prerequisites . . . . . . . . . . . . . . . . . 164
Aspect . . . . . . . . . . . . . . . . . . . . . 180 Workflow server . . . . . . . . . . . . . . . . 182
Cisco UCC . . . . . . . . . . . . . . . . . . . 180
CM . . . . . . . . . . . . . . . . . . . . . . 179
Communication Manager . . . . . . . . . . . . 179 W
creating . . . . . . . . . . . . . . . . . . . . 178
WACD flows . . . . . . . . . . . . . . . . . . . 107
starting . . . . . . . . . . . . . . . . . . . . . 182
WACD server
TsQueueStatistics server
see WebACD server
see TSQS server
WACD.QualifyChat . . . . . . . . . . . . . . . . 222
tuning parameters, servers . . . . . . . . . . . . . 110
WACD.QualifyEmail . . . . . . . . . . . . . . . 300
WAR file
deploying . . . . . . . . . . . . . . . . . . . 400

514 Installation and Configuration March 2012


Index

Web application prerequisites . . . . . . . . . . . . . . . . . 423


Email Template Administration . . . . . . . . . 289 secondary ORB server environment . . . . . . 424
Website . . . . . . . . . . . . . . . 205, 210, 215 SSL . . . . . . . . . . . . . . . . . . . 421, 431
Web browser tool starting server . . . . . . . . . . . . . . . . . 430
CitrixClientURL . . . . . . . . . . . . . . . . . 374 stopping server . . . . . . . . . . . . . . . . 430
components . . . . . . . . . . . . . . . . . . 373 Web Services Bridge . . . . . . . . . . . . . 424
configuring . . . . . . . . . . . . . . . . . . . 372 Web Services Bridge
DontStartMultipleInstancesOfAgent . . . . . . . 374 agent account . . . . . . . . . . . . . . . . . 425
installing . . . . . . . . . . . . . . . . . . . . 373 creating . . . . . . . . . . . . . . . . . . . . 426
multiple Citrix servers . . . . . . . . . . . . . . 375 domain . . . . . . . . . . . . . . . . . . . . 427
updating HTML page . . . . . . . . . . . . . . 374 setting up . . . . . . . . . . . . . . . . . . . 424
Web Client Web Services server
see Avaya Agent Web Client starting . . . . . . . . . . . 139, 141, 144, 430, 431
Web License Manager stopping . . . . . . . . . . . . 142, 144, 430, 431
changing password . . . . . . . . . . . . . . . 159 Web tab, advanced properties . . . . . . . . . . . 499
installing license . . . . . . . . . . . . . . . . 155 WebACD server . . . . . . . . . . . . . . . 191, 205
JVM Options . . . . . . . . . . . . . . . . . . 501 changing service port . . . . . . . . . . . . . 491
Web Management creating . . . . . . . . . . . . . . . . . . . . 191
administration pages . . . . . . . . . . . . . . 218 Email Management . . . . . . . . . . . . . . 307
configuration files . . . . . . . . . . . . . . . . 471 SSL . . . . . . . . . . . . . . . . . . . . . 268
configuring . . . . . . . . . . . . . . . . . . . 189 webadmin.cfg . . . . . . . . . . . . . . . . . . 269
configuring SSL . . . . . . . . . . . . . . . . 267 WebLM server . . . . . . . . . . . . . . . . . . 158
configuring Workflow server . . . . . . . . . . . 221 Website
ICM server . . . . . . . . . . . . . . . . . . . 228 account . . . . . . . . . . . . . . . . . . . . 104
log files . . . . . . . . . . . . . . . . . . . . 472 administration . . . . . . . . . . . . . . . . . 272
optional configuration . . . . . . . . . . . . . . 189 configuring . . . . . . . . . . . . . . . . 201, 231
refreshing IC Manager . . . . . . . . . . . . . 281 customer . . . . . . . . . . . . . . . . . . . 274
RONA . . . . . . . . . . . . . . . . . . . . . 189 enabling CIRS servlet . . . . . . . . . . . . . 280
routing hints . . . . . . . . . . . . . . . . . . 225 JVM Options . . . . . . . . . . . . . . . . . 502
servers . . . . . . . . . . . . . . . . . . . . . 201 SSL . . . . . . . . . . . . . . . . . . . . . 268
starting servers . . . . . . . . . . . . . . . . . 138 troubleshooting . . . . . . . . . . . . . . . . 461
troubleshooting . . . . . . . . . . . . . . . . . 457 Web application . . . . . . . . . . . . 205, 210, 215
website . . . . . . . . . . . . . . . . . . . . 231 Web Scheduled Callback . . . . . . . . . . . 247
website account . . . . . . . . . . . . . . . . 104 website account . . . . . . . . . . . . . . . . . 104
Workflow server . . . . . . . . . . . . . . . . 220 website.pages.public property . . . . . . . . . . . 270
workflows . . . . . . . . . . . . . . . . . . . 223 websitecontext . . . . . . . . . . . . . . . . . . 280
Web Scheduled Callback Windows
agent desktop applications . . . . . . . . . . . 245 Avaya Agent Web Client
calendar . . . . . . . . . . . . . . . . . . . . 246 starting . . . . . . . . . . . . . . . . . .402
configuring . . . . . . . . . . . . . . . . . . . 245 stopping . . . . . . . . . . . . . . . . . .402
creating server . . . . . . . . . . . . . . . . . 246 configuring full-text searches . . . . . . . . . .236
guidelines . . . . . . . . . . . . . . . . . . . 246 installing Avaya Agent Web Client connector . .
. 28
log files . . . . . . . . . . . . . . . . . . . . 473 installing Client SDK . . . . . . . . . . . . . .
. 28
requirements . . . . . . . . . . . . . . . . . . 245 installing Design & Administration Tools . . . .
. 28
time zones . . . . . . . . . . . . . . . . . . . 246 installing Server SDK . . . . . . . . . . . . .
. 54
Website . . . . . . . . . . . . . . . . . . . . 247 installing servers . . . . . . . . . . . . . . .
. 28
Web Self-Service starting Client SDK server . . . . . . . . . 139, 416
troubleshooting . . . . . . . . . . . . . . . . . 476 starting IBM HTTP server . . . . . . . . . . . 405
verifying . . . . . . . . . . . . . . . . . 475, 476 starting services . . . . . . . . . . . . . . . . 139
Web Services starting Web Services server . . . . . . . . 139, 430
configuring . . . . . . . . . . . . . . . . . . . 429 stopping Client SDK server . . . . . . . . . . 416
deploying . . . . . . . . . . . . . . . . . . . 423 stopping services . . . . . . . . . . . . . . . 139
documents . . . . . . . . . . . . . . . . . . . 20 stopping Web Services server . . . . . . . . . 430
files . . . . . . . . . . . . . . . . . . . . . . 424 updating full text index . . . . . . . . . . . . . 236
installing . . . . . . . . . . . . . . . . . . . . 424 verifying Web Self-Service . . . . . . . . . 475, 476

Installation and Configuration March 2012 515


Index

Workflow server
agents . . . . . . . . . . . . . . . . . . . .
. 347
chat . . . . . . . . . . . . . . . . . . . . .
. 220
configuring for Email Management . . . . . . .
. 298
configuring for Telephony . . . . . . . . . . .
. 184
configuring for Web Management . . . . . . .
. 221
email . . . . . . . . . . . . . . . . . . . . .
. 297
loading flows . . . . . . . . . . . . . . . . .
. 186
restarting . . . . . . . . . . . . . . . . . . .
. 303
starting . . . . . . . . . . . . . . . . . . 185, 223
troubleshooting . . . . . . . . . . . . . . 455, 456
updating . . . . . . . . . . . . . . . . . . . . 119
voice . . . . . . . . . . . . . . . . . . . . . . 182
workflows
documents . . . . . . . . . . . . . . . . . . . 20
Email Management . . . . . . . . . . . . . . . 303
incoming email . . . . . . . . . . . . . . . . . 187
loading . . . . . . . . . . . . . . . . . . . . . 186
qualify chat . . . . . . . . . . . . . . . . . . . 225
qualify email . . . . . . . . . . . . . . . . . . 305
sample . . . . . . . . . . . . . . . . . . . . . 107
system . . . . . . . . . . . . . . . . . . . . . 107
Telephony . . . . . . . . . . . . . . . . . . . 185
Web Management . . . . . . . . . . . . . . . 223
WorkflowServerName . . . . . . . . . . . . . . . 342
working directory
Avaya Agent Web Client . . . . . . . . . . . . 386
Client SDK . . . . . . . . . . . . . . . . . . . 345
configuring . . . . . . . . . . . . . . . . 343, 345

X
XML encoding . . . . . . . . . . . . . . . . . . . 436
X-Windows . . . . . . . . . . . . . . . . . . 24, 146

516 Installation and Configuration March 2012

You might also like