Release Notes for Avaya Proactive Contact 5.

0 Agent API

Release Notes for Avaya Proactive Contact 5.0 Agent API

Release Notes for Avaya Proactive Contact 5.0 Agent API

which the Software is installed communicate with no more than a

single instance of the same database.
Copyright@2011
CPU License (CP):
Notice:
End User may install and use each copy of the Software on a number
While reasonable efforts were made to ensure that the information in
of Servers up to the number indicated by Avaya provided that the
this document was complete and accurate at the time of printing,
performance capacity of the Server(s) does not exceed the
Avaya Inc. can assume no liability for any errors. Changes and
performance capacity specified for the Software. End User may not
corrections to the information in this document might be incorporated
re-install or operate the Software on Server(s) with a larger
in future releases.
performance capacity without Avaya's prior consent and payment of
Documentation disclaimer:
an upgrade fee.
Avaya Inc. is not responsible for any modifications, additions, or
Named User License (NU):
deletions to the original published version of this documentation
Customer may: (i) install and use the Software on a single
unless such modifications, additions, or deletions were performed by
Designated Processor or Server per authorized Named User (defined
Avaya. Customer and/or End User agree to indemnify and hold
below); or (ii) install and use the Software on a Server so long as only
harmless Avaya, Avaya's agents, servants and employees against all
authorized Named Users access and use the Software. "Named
claims, lawsuits, demands and judgments arising out of, or in
User," means a user or device that has been expressly authorized by
connection with, subsequent modifications, additions or deletions to
Avaya to access and use the Software. At Avaya's sole discretion, a
this documentation to the extent made by the Customer or End User.
"Named User" may be, without limitation, designated by name,
Link disclaimer:
corporate function (e.g., webmaster or helpdesk), an e-mail or voice
Avaya Inc. is not responsible for the contents or reliability of any
mail account in the name of a person or corporate function, or a
linked Web sites referenced elsewhere within this documentation,
directory entry in the administrative database utilized by the Product
and Avaya does not necessarily endorse the products, services, or
that permits one user to interface with the Product.
information described or offered within them. We cannot guarantee
Shrinkwrap License (SR):
that these links will work all the time and we have no control over the
With respect to Software that contains elements provided by third
availability of the linked pages.
party suppliers, End User may install and use the Software in
Warranty:
accordance with the terms and conditions of the applicable license
Avaya Inc. provides a limited warranty on this product. Refer to your
agreements, such as "shrinkwrap" or "clickwrap" license
sales agreement to establish the terms of the limited warranty. In
accompanying or applicable to the Software ("Shrinkwrap License").
addition, Avaya’s standard warranty language, as well as information
The text of the Shrinkwrap License will be available from Avaya upon
regarding support for this product, while under warranty, is available
End User’s request (see “Third-party Components" for more
through the Avaya Support Web site: http://www.avaya.com/support
information).
License:
Copyright:
USE OR INSTALLATION OF THE PRODUCT INDICATES THEEND
Except where expressly stated otherwise, the Product is protected by
USER'S ACCEPTANCE OF THE TERMS SET FORTHHEREIN AND
copyright and other laws respecting proprietary rights. Unauthorized
THE GENERAL LICENSE TERMS AVAILABLEON THE AVAYA
reproduction, transfer, and or use can be a criminal, as well as a civil,
WEB SITE http://support.avaya.com/LicenseInfo/ ("GENERAL
offense under the applicable law.
LICENSE TERMS"). IF YOU DO NOT WISH TO BE BOUND BY
Third-party components:
THESE TERMS, YOU MUST RETURN THE PRODUCT(S) TO THE
Certain software programs or portions thereof included in the Product
POINT OF PURCHASE WITHIN TEN (10) DAYS OF DELIVERY
may contain software distributed under third party agreements ("Third
FOR A REFUND OR CREDIT. Avaya grants End User a license
Party Components"), which may contain terms that expand or limit
within the scope of the license types described below. The applicable
rights to use certain portions of the Product ("Third Party Terms").
number of licenses and units of capacity for which the license is
Information identifying Third Party Components and the Third Party
granted will be one (1), unless a different number of licenses or units
Terms that apply to them is available on the Avaya Support Web site:
of capacity is specified in the Documentation or other materials
http://support.avaya.com/ThirdPartyLicense/
available to End User. "Designated Processor" means a single stand-
Preventing toll fraud:
alone computing device. "Server" means a Designated Processor
"Toll fraud" is the unauthorized use of your telecommunications
that hosts a software application to be accessed by multiple users.
system by an unauthorized party (for example, a person who is not a
"Software" means the computer programs in object code, originally
corporate employee, agent, subcontractor, or is not working on your
licensed by Avaya and ultimately utilized by End User, whether as
company's behalf). Be aware that there can be a risk of toll fraud
stand-alone Products or pre-installed on Hardware.
associated with your system and that, if toll fraud occurs, it can result
"Hardware" means the standard hardware Products, originally sold by
in substantial additional charges for your telecommunications
Avaya and ultimately utilized by End User.
services.
License type(s)
Avaya fraud intervention:
Designated System(s) License (DS):
If you suspect that you are being victimized by toll fraud and you
End User may install and use each copy of the Software on only one
need technical assistance or support, call Technical Service Center
Designated Processor, unless a different number of Designated
Toll Fraud Intervention Hotline at +1-800-643-2353 for the United
Processors is indicated in the Documentation or other materials
States and Canada. For additional support telephone numbers, see
available to End User. Avaya may require the Designated
the Avaya Support Web site: http://www.avaya.com/support
Processor(s) to be identified by type, serial number, feature key,
Trademarks:
location or other specific designation, or to be provided by End User
Avaya and the Avaya logo are either registered trademarks or
to Avaya through electronic means established by Avaya specifically
trademarks of Avaya Inc. in the United States of America and/or other
or this purpose.
jurisdictions. All other trademarks are the property of their respective
Concurrent User License (CU):
owners.
End User may install and use the Software on multiple Designated
Downloading documents:
Processors or one or more Servers, so long as only the licensed
For the most current versions of documentation, see the Avaya
number of Units are accessing and using the Software at any given
Support Web site: http://www.avaya.com/support
time. A "Unit" means the unit on which Avaya, at its sole discretion,
bases the pricing of its licenses and can be, without limitation, an
agent, port or user, an e-mail or voice mail account in the name of a
person or corporate function (e.g., webmaster or helpdesk), or a
directory entry in the administrative database utilized by the Product
that permits one user to interface with the Software. Units may be
linked to a specific, identified Server.
Database License (DL):
Customer may install and use each copy of the Software on one
Server or on multiple Servers provided that each of the Servers on
Release Notes for Avaya Proactive Contact 5.0 Agent API

Table of contents
1. Prerequisites ...................................................................................................................................... 3
1.1. Hardware requirements...................................................................................................................... 3
1.2. Obtaining Avaya Proactive Contact 5.0 Agent API ............................................................................ 4
2. Installation .......................................................................................................................................... 5
2.1. Pre-installation procedure .................................................................................................................. 5
2.2. Upgrade procedure ............................................................................................................................ 5
2.3. Installation procedure ......................................................................................................................... 5
2.4. Updating certificates for Avaya Proactive Contact 4.2 Agent API clients .......................................... 6
3. Uninstallation procedure .................................................................................................................... 6
4. List of fixed issues, known issues, troubleshooting, enhancements, and improvements.................. 7
5. Contact support .................................................................................................................................. 7

Page 1
Release Notes for Avaya Proactive Contact 5.0 Agent API

Revision history
Version Date
0.1 November 22, 2010
0.2 December 30, 2010
0.3 January 28, 2011
0.4 February 25, 2011
0.5 March 28, 2011

Page 2
Release Notes for Avaya Proactive Contact 5.0 Agent API

This document is the release notes for Avaya Proactive Contact 5.0 Agent API.

1. Prerequisites
1.1. Hardware requirements
This section provides information on the minimum hardware requirements to
support this release of Avaya Proactive Contact 5.0 Agent API.
Minimum system requirements for Windows XP Service Pack 2 (32-bit or 64-bit
Operating System):
• 800 MHz processor
• 512 MB RAM
• 1 GB free disk space
• DVD drive
• Network capable
• Microsoft Internet Explorer 6.0 or later

Minimum system requirements for Windows Vista Enterprise Edition (32-bit or

64-bit Operating System):
• 1 GHz 32-bit / 64-bit processor
• 1 GB RAM
• 1 GB free disk space
• DVD drive
• Network capable
• Microsoft Internet Explorer 7.0 or later
NOTE: For additional hardware requirements to support Vista, see the Microsoft
Website at: http://technet.microsoft.com/en-us/library/cc507845.aspx
Minimum System Requirements for Windows 7 Enterprise Edition (32-bit or 64-
bit Operating System):
• 1 GHz 32-bit / 64-bit processor
• 1 GB RAM
• 1 GB free disk space
• DVD drive
• Network capable
• Microsoft Internet Explorer 8.0 or later

Page 3
Release Notes for Avaya Proactive Contact 5.0 Agent API

NOTE: For additional hardware requirements to support Windows 7 Enterprise

Edition, see the Microsoft Website at: http://windows.microsoft.com/en-
IN/windows7/products/system-requirements
Minimum System Requirements for Windows 2008 Server Edition (32-bit or 64-bit
Operating System):
• 1.4 GHz 32-bit / 64-bit processor
• 1 GB RAM
• 1 GB free disk space
• DVD drive
• Network capable
• Microsoft Internet Explorer 8.0 or later
NOTE: For additional hardware requirements to support Windows 2008 Server
Edition (32-bit or 64-bit Operating System), see the Microsoft Website at:
http://www.microsoft.com/windowsserver2008/en/us/system-requirements.aspx

1.2. Obtaining Avaya Proactive Contact 5.0 Agent API

You can order the CD of Avaya Proactive Contact 5.0 Agent API using the high-
level bundle code 700500965. There are two ways to obtain this release:
1. Ordering the installation CD labeled Avaya Proactive Contact 5.0 Agent
API, Material ID: 700501569.
2. Downloading the ISO file from Avaya support site and writing it to a CD.
To download the ISO file:
1. Go to Avaya support site: http://www.avaya.com/support
2. In the left pane, click Downloads.
3. In the Please enter the name of your product text box, type Proactive
Contact.
4. Select the Proactive Contact option that appears below the text box.
The system redirects the Webpage to the Avaya Proactive Contact page.
5. From the version drop-down box, select 5.0.x.
6. Download the Avaya Proactive Contact 5.0 Agent API ISO image.
To write the ISO file to a CD:
1. Insert a blank writable CD in the CD/DVD drive.

NOTE: You can use any available CD writing tool, such as Roxio or Nero
to write the ISO file to a CD.
2. Select the Image burning option from the CD writing software.

Page 4
Release Notes for Avaya Proactive Contact 5.0 Agent API

• For Roxio, select Copy > Burn image.

• For Nero Express, select Image > Project > Copy > Disc
Image or Saved Project.
3. Browse and select the ISO image for burning. Wait until the CD burning is
completed.
4. Label the CD, Avaya Proactive Contact 5.0 Agent API. Material ID:
700501569.

2. Installation
This section describes the procedure to install and uninstall Avaya Proactive Contact 5.0
Agent API.
2.1. Pre-installation procedure
None
2.2. Upgrade procedure
If you are upgrading from any previous version of Avaya Proactive Contact Agent
API, then you must first uninstall the previous version of Agent API. To uninstall
the Agent API, follow the uninstallation procedure described in the Uninstallation
Procedure section in this document.
Note: You need to upgrade the custom applications to take advantage of the
new features or modifications in the latest Agent API.
2.3. Installation procedure
To install Avaya Proactive Contact 5.0 Agent API:
1. Log in with the local administrator privileges.
2. Insert the Avaya Proactive Contact 5.0 Agent API installation CD in the
CD/DVD drive of the desktop.
3. Browse the CD and run setup.exe.
NOTE: If you are trying to install Avaya Proactive Contact 5.0 Agent API
on a remote desktop, then copy the setup.exe to the target local drive and
then continue with the installation procedure.

Page 5
Release Notes for Avaya Proactive Contact 5.0 Agent API

4. In the Welcome screen, click Next.

5. On the License Agreement page, select I accept the terms of the
license agreement.
6. Click Next.
7. In the Choose Destination Location screen, click Next.
8. In the Setup Type screen, click Next.
9. In the Start Copying files screen, click Next.
10. Click Finish.
2.4. Updating certificates for Avaya Proactive Contact 4.2 Agent API
clients
For Avaya Proactive Contact 4.2 Agent API client, certificates need to be updated to
connect to Avaya Proactive Contact 5.0 dialer. Certificates are available on the Avaya
Proactive Contact 5.0 dialer.
1. Close any running Agent API client application.
2. Take a backup of the existing key/certificates files.
3. Copy the key/certificate files from dialer available under
“/opt/avaya/pds/openssl/” to the location where your Agent API client
certificates are present.
NOTE: The files corresponding to agentClient_key.pem and agentClient_cert.pem (or
whatever names are present- as a result of somebody changing the name- in
%WINDIR%\moagent32.ini configuration file) on the Dialer are named as
agent_key.pem and agent_cert.pem respectively.
NOTE: If you do not have access to Avaya Proactive Contact 5.0 Dialer, contact Avaya
Professional Services, Support, or service provider to obtain the key/certificates.

3. Uninstallation procedure
To uninstall Avaya Proactive Contact 5.0 Agent API:
1. Go to Start > Settings > Control Panel.
2. Double-click Add/Remove Programs.
For Windows Vista and Windows 7 Enterprise, click Programs and
Features.
3. Select the current product and click Change/Remove.
For Windows Vista and Windows 7 Enterprise, click Uninstall/Change.
4. Follow the onscreen instructions.
5. Click Finish when the Uninstall Complete message is displayed on the
screen.

Page 6
Release Notes for Avaya Proactive Contact 5.0 Agent API

4. List of fixed issues, known issues, troubleshooting,

enhancements, and improvements
For information on Customer Fixed Issues, Known Issues, Troubleshooting, and
Improvements as included in the Avaya Proactive Contact 5.0 release, see List of Fixed
Issues, Improvements, Known Issues, and Troubleshooting for Avaya Proactive Contact
5.0 (Dialer, OS, Agent, Agent API, Supervisor, and Database) on the Avaya Support site
at: http://www.avaya.com/support

5. Contact support
You can contact Avaya Proactive Contact Technical Support through Internet, e-mail, or
telephone. To contact Avaya Proactive Contact Support by telephone, call at one of the
following numbers:
Global Support Services (GSS) +1 800 242 2121
Canada Customer Care Center +1 800 387 4268
Remote Service Center Hungary +36 1238 8807
Caribbean and Latin America +1 786 331 0860
EMEA Services - Post Sales Technical Support +31 70 414 8720
Asia/Pacific Regional Support Center +800 2 28292 78 / +65 6872 5141 and
+0080066501243 (India)
For details on contact information, visit: http://www.avaya.com/support

Page 7