IPOCC9 1 7InstallationTaskBasedGuideIssue1 0
IPOCC9 1 7InstallationTaskBasedGuideIssue1 0
IPOCC9 1 7InstallationTaskBasedGuideIssue1 0
Release 9.1.7
Issue 1.0
05 2016
Legal
2014 - 2016 Avaya Inc.
All Rights Reserved.
Notice
While reasonable efforts have been made to ensure that the information in this document is
complete and accurate at the time of printing, Avaya assumes no liability for any errors. Avaya
reserves the right to make changes and corrections to the information in this document without the
obligation to notify any person or organization of such changes.
For full support, please see the complete document, Avaya Support Notices for Hardware
Documentation, document number 03600759.
For full support, please see the complete document, Avaya Support Notices for Software
Documentation, document number 03600758.
To locate this document on our website, simply go to http://www.avaya.com/support and search for
the document number in the search box.
Documentation disclaimer
"Documentation" means information published by Avaya in varying mediums which may include
product information, operating instructions and performance specifications that Avaya may generally
make available to users of its products and Hosted Services. Documentation does not include
marketing materials. Avaya shall not be responsible for any modifications, additions, or deletions to
the original published version of documentation unless such modifications, additions, or deletions
were performed by Avaya. End User agrees to indemnify and hold harmless Avaya, Avaya's agents,
servants and employees against all claims, lawsuits, demands and judgments arising out of, or in
connection with, subsequent modifications, additions or deletions to this documentation, to the
extent made by End User.
Link disclaimer
Avaya is not responsible for the contents or reliability of any linked websites referenced within this
site or documentation provided by Avaya. Avaya is not responsible for the accuracy of any
information, statement or content provided on these sites and does not necessarily endorse the
products, services, or information described or offered within them. Avaya does not guarantee that
these links will work all the time and has no control over the availability of the linked pages.
Warranty
Avaya provides a limited warranty on Avaya hardware and software. Refer to your sales agreement
to establish the terms of the limited warranty. In addition, Avayas standard warranty language, as
well as information regarding support for this product while under warranty is available to Avaya
customers and other parties through the Avaya Support website: http://support.avaya.com or such
successor site as designated by Avaya. Please note that if You acquired the product(s) from an
authorized Avaya Channel Partner outside of the United States and Canada, the warranty is
provided to You by said Avaya Channel Partner and not by Avaya.
"Hosted Service" means a hosted service subscription that You acquire from either Avaya or an
authorized Avaya Channel Partner (as applicable) and which is described further in Hosted SAS or
other service description documentation regarding the applicable hosted service. If You purchase a
Hosted Service subscription, the foregoing limited warranty may not apply but You may be entitled to
support services in connection with the Hosted Service as described further in your service
description documents for the applicable Hosted Service. Contact Avaya or Avaya Channel Partner
(as applicable) for more information.
Hosted Service
THE FOLLOWING APPLIES IF YOU PURCHASE A HOSTED SERVICE SUBSCRIPTION FROM
AVAYA OR AN AVAYA CHANNEL PARTNER (AS APPLICABLE), THE TERMS OF USE FOR
HOSTED SERVICES ARE AVAILABLE ON THE AVAYA WEBSITE,
HTTP://SUPPORT.AVAYA.COM/LICENSEINFO UNDER THE LINK "Avaya Terms of Use for Hosted
Services" OR SUCH SUCCESSOR SITE AS DESIGNATED BY AVAYA, AND ARE APPLICABLE TO
ANYONE WHO ACCESSES OR USES THE HOSTED SERVICE. BY ACCESSING OR USING THE
HOSTED SERVICE, OR AUTHORIZING OTHERS TO DO SO, YOU, ON BEHALF OF YOURSELF
AND THE ENTITY FOR WHOM YOU ARE DOING SO (HEREINAFTER REFERRED TO
INTERCHANGEABLY AS "YOU" AND "END USER"), AGREE TO THE TERMS OF USE. IF YOU
ARE ACCEPTING THE TERMS OF USE ON BEHALF A COMPANY OR OTHER LEGAL ENTITY,
YOU REPRESENT THAT YOU HAVE THE AUTHORITY TO BIND SUCH ENTITY TO THESE
TERMS OF USE. IF YOU DO NOT HAVE SUCH AUTHORITY, OR IF YOU DO NOT WISH TO
ACCEPT THESE TERMS OF USE, YOU MUST NOT ACCESS OR USE THE HOSTED SERVICE
OR AUTHORIZE ANYONE TO ACCESS OR USE THE HOSTED SERVICE. YOUR USE OF THE
HOSTED SERVICE SHALL BE LIMITED BY THE NUMBER AND TYPE OF LICENSES
PURCHASED UNDER YOUR CONTRACT FOR THE HOSTED SERVICE, PROVIDED,
HOWEVER, THAT FOR CERTAIN HOSTED SERVICES IF APPLICABLE, YOU MAY HAVE THE
OPPORTUNITY TO USE FLEX LICENSES, WHICH WILL BE INVOICED ACCORDING TO ACTUAL
USAGE ABOVE THE CONTRACT LICENSE LEVEL. CONTACT AVAYA OR AVAYAS CHANNEL
PARTNER FOR MORE INFORMATION ABOUT THE LICENSES FOR THE APPLICABLE HOSTED
SERVICE, THE AVAILABILITY OF ANY FLEX LICENSES (IF APPLICABLE), PRICING AND
BILLING INFORMATION, AND OTHER IMPORTANT INFORMATION REGARDING THE HOSTED
SERVICE.
Licenses
THE SOFTWARE LICENSE TERMS AVAILABLE ON THE AVAYA WEBSITE,
HTTP://SUPPORT.AVAYA.COM/LICENSEINFO OR SUCH SUCCESSOR SITE AS DESIGNATED
BY AVAYA, ARE APPLICABLE TO ANYONE WHO DOWNLOADS, USES AND/OR INSTALLS
AVAYA SOFTWARE, PURCHASED FROM AVAYA INC., ANY AVAYA AFFILIATE, OR AN AVAYA
CHANNEL PARTNER (AS APPLICABLE) UNDER A COMMERCIAL AGREEMENT WITH AVAYA OR
AN AVAYA CHANNEL PARTNER. UNLESS OTHERWISE AGREED TO BY AVAYA IN WRITING,
AVAYA DOES NOT EXTEND THIS LICENSE IF THE SOFTWARE WAS OBTAINED FROM
ANYONE OTHER THAN AVAYA, AN AVAYA AFFILIATE OR AN AVAYA CHANNEL PARTNER;
AVAYA RESERVES THE RIGHT TO TAKE LEGAL ACTION AGAINST YOU AND ANYONE ELSE
USING OR SELLING THE SOFTWARE WITHOUT A LICENSE. BY INSTALLING, DOWNLOADING
OR USING THE SOFTWARE, OR AUTHORIZING OTHERS TO DO SO, YOU, ON BEHALF OF
YOURSELF AND THE ENTITY FOR WHOM YOU ARE INSTALLING, DOWNLOADING OR USING
THE SOFTWARE (HEREINAFTER REFERRED TO INTERCHANGEABLY AS "YOU" AND "END
USER"), AGREE TO THESE TERMS AND CONDITIONS AND CREATE A BINDING CONTRACT
BETWEEN YOU AND AVAYA INC. OR THE APPLICABLE AVAYA AFFILIATE ("AVAYA").
Avaya grants You a license within the scope of the license types described below, with the exception
of Heritage Nortel Software, for which the scope of the license is detailed below. Where the order
documentation does not expressly identify a license type, the applicable license will be a Designated
System License. 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 You. "Software" means computer programs in object
IP Office Contact Center Installation
05 2016
code, provided by Avaya or an Avaya Channel Partner, whether as stand-alone products, preinstalled on hardware products, and any upgrades, updates, patches, bug fixes, or modified versions
thereto. "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. "Instance"
means a single copy of the Software executing at a particular time: (i) on one physical machine; or
(ii) on one deployed software virtual machine ("VM") or similar deployment.
License type(s)
Designated System(s) License (DS). End User may install and use each copy or an Instance of the
Software only on a number of Designated Processors up to the number indicated in the order. Avaya
may require the Designated Processor(s) to be identified in the order by type, serial number, feature
key, Instance, location or other specific designation, or to be provided by End User to Avaya through
electronic means established by Avaya specifically for this purpose.
Concurrent User License (CU). End User may install and use the Software on multiple Designated
Processors or one or more Servers, so long as only the licensed number of Units are accessing and
using the Software at any given 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 Software that permits one user to
interface with the Software. Units may be linked to a specific, identified Server or an Instance of the
Software.
Database License (DL). End User may install and use each copy or an Instance of the Software on
one Server or on multiple Servers provided that each of the Servers on which the Software is
installed communicates with no more than one Instance of the same database.
CPU License (CP). End User may install and use each copy or Instance of the Software on a
number of Servers up to the number indicated in the order provided that the performance capacity of
the Server(s) does not exceed the performance capacity specified for the Software. End User may
not re-install or operate the Software on Server(s) with a larger performance capacity without
Avayas prior consent and payment of an upgrade fee.
Named User License (NU). You may: (i) install and use the Software on a single Designated
Processor or Server per authorized Named User (defined below); or (ii) install and use the Software
on a Server so long as only authorized Named Users access and use the Software. "Named User",
means a user or device that has been expressly authorized by Avaya to access and use the
Software. At Avayas sole discretion, a "Named User" may be, without limitation, designated by
name, corporate function (e.g., webmaster or helpdesk), an e-mail or voice mail account in the name
of a person or corporate function, or a directory entry in the administrative database utilized by the
Software that permits one user to interface with the Software.
Shrinkwrap License (SR). You may install and use the Software in accordance with the terms and
conditions of the applicable license agreements, such as "shrinkwrap" or "clickthrough" license
accompanying or applicable to the Software ("Shrinkwrap License").
Heritage Nortel Software
"Heritage Nortel Software" means the software that was acquired by Avaya as part of its purchase of
the Nortel Enterprise Solutions Business in December 2009. The Heritage Nortel Software currently
available for license from Avaya is the software contained within the list of Heritage Nortel Products
located at http://support.avaya.com/LicenseInfo under the link "Heritage Nortel Products" or such
successor site as designated by Avaya. For Heritage Nortel Software, Avaya grants You a license to
use Heritage Nortel Software provided hereunder solely to the extent of the authorized activation or
authorized usage level, solely for the purpose specified in the Documentation, and solely as
embedded in, for execution on, or for communication with Avaya equipment. Charges for Heritage
Nortel Software may be based on extent of activation or use authorized as specified in an order or
invoice.
Copyright
05 2016
Except where expressly stated otherwise, no use should be made of materials on this site, the
Documentation, Software, Hosted Service, or hardware provided by Avaya. All content on this site,
the documentation, Hosted Service, and the product provided by Avaya including the selection,
arrangement and design of the content is owned either by Avaya or its licensors and is protected by
copyright and other intellectual property laws including the sui generis rights relating to the
protection of databases. You may not modify, copy, reproduce, republish, upload, post, transmit or
distribute in any way any content, in whole or in part, including any code and software unless
expressly authorized by Avaya. Unauthorized reproduction, transmission, dissemination, storage,
and or use without the express written consent of Avaya can be a criminal, as well as a civil offense
under the applicable law.
Virtualization
Each product has its own ordering code and license types. Note that each Instance of a product
must be separately licensed and ordered. For example, if the end user customer or Avaya Channel
Partner would like to install two Instances of the same type of products, then two products of that
type must be ordered.
Third Party Components
"Third Party Components" mean certain software programs or portions thereof included in the
Software or Hosted Service may contain software (including open source software) distributed under
third party agreements ("Third Party Components"), which contain terms regarding the rights to use
certain portions of the Software ("Third Party Terms"). As required, information regarding distributed
Linux OS source code (for those products that have distributed Linux OS source code) and
identifying the copyright holders of the Third Party Components and the Third Party Terms that apply
is available in the products, Documentation or on Avayas website at:
http://support.avaya.com/Copyright or such successor site as designated by Avaya. You agree to the
Third Party Terms for any such Third Party Components.
THIS PRODUCT IS LICENSED UNDER THE AVC PATENT PORTFOLIO LICENSE FOR THE
PERSONAL USE OF A CONSUMER OR OTHER USES IN WHICH IT DOES NOT RECEIVE
REMUNERATION TO (i) ENCODE VIDEO IN COMPLIANCE WITH THE AVC STANDARD ("AVC
VIDEO") AND/OR (ii) DECODE AVC VIDEO THAT WAS ENCODED BY A CONSUMER ENGAGED
IN A PERSONAL ACTIVITY AND/OR WAS OBTAINED FROM A VIDEO PROVIDER LICENSED TO
PROVIDE AVC VIDEO. NO LICENSE IS GRANTED OR SHALL BE IMPLIED FOR ANY OTHER
USE. ADDITIONAL INFORMATION MAY BE OBTAINED FROM MPEG LA, L.L.C. SEE
HTTP://WWW.MPEGLA.COM.
Note to Service Provider
The product or Hosted Service may use Third Party Components subject to Third Party Terms that
do not allow hosting and require a Service Provider to be independently licensed for such purpose. It
is your responsibility to obtain such licensing.
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.
IP Office Contact Center Installation
05 2016
05 2016
Table of Contents
Legal ........................................................................................ 2
Table of Contents ....................................................................................... 7
Licensing ............................................................................... 65
Licensing Obtaining the MAC Address of the Server ............................ 65
Centralized WebLM server....................................................................... 74
IP Office Contact Center Installation
05 2016
05 2016
05 2016
Configuring a WebUI Agent Web Access to search on a presented call ...... 348
Configuring WebUI Threshold ....................................................................... 353
Configuring WebUI Variable ......................................................................... 355
05 2016
10
05 2016
11
05 2016
12
05 2016
13
05 2016
14
Flow Chart
Obtain all required information prior to installation of IP Office Contact Center. Refer to the IP Office Contact Center
Required Information section of this guide.
Check that all hardware components and Telephony and Internet services are in place. Refer to the Site Preparation
Check list and the Planning Checklist within this guide.
Check that IP Office Contact Center requirements are satisfied prior to installing the IP Office Contact Centre Software.
Refer to the IP Office Contact Centre Requirements section of this guide.
Prepare the IP Office Contact Center server for installation. Refer to the Server Preparation section of this guide.
Install IP Office Contact Center Software. Refer to the Software Installation Checklist and the IP Office Contact
Center Installation sections of this guide.
License the IP Office Contact Center system. Refer to the Licensing section of this guide.
Create the IP Office Contact Center Certificate There are a number of ways in which a certificate can be created.
Therefore refer to the guides Contents pages as to the certificate creation options that are available.
Import the Certificate to the IP Office Contact Center. Refer to the Importing the Certificate into the IPOCC Server
section of this guide.
Import the Certificate to the Windows client as required. There are a number of methods that can be utilized. Therefore
refer to the guides Contents pages as to the options that are available.
Configure the IP Office Contact Centre - Will the Configuration Spreadsheet, Configuration Wizard or Example Task Flow
Templates be used?
Configuration Page
section
guide.
create a
to the
System
of this
Activate the default Task Flow. Refer to the Activating the Task Flow section of this
guide.
Import the Configuration file to the IP Office. Refer to the Importing the IP Office
Configuration File section of this guide. (Not required when Auto Sync is utilized).
Install the IP Office Contact Center User Interface software. Refer to the Installing the Contact Center User Interface on
the Agents PCs section of this guide.
05 2016
15
Note: The IPOCC IPO Sync service is automatically started and configured by default.
Therefore Auto Synchronization can be used in preference to a manual configuration
import to the IP Office regardless as to whether the configuration spreadsheet or Landing
Page Wizard is utilized.
Check that the requirements for an OVA deployment of IP Office Contact Center are
satisfied prior to OVA installation. Refer to the Requirements for implementation of IP
Office Contact Center as OVA section of this guide.
Install OVA on VMWare - Refer to the Install OVA on VMWare section of this guide.
Setup Network - Refer to the Setup Network section of this guide.
Set Computer Name- Refer to the Set Computer Name section of this guide.
Activate Windows - Refer to the Activate Windows section of this guide.
Apply changes to IP Office Contact Center - Refer to the Apply changes to IP Office
Contact Center section of this guide.
Install IP Office Contact Center Licenses - Refer to the Install IP Office Contact Center
Licenses section of this guide.
Import the Configuration Data into the IP Office and IP Office Contact Center - Refer to the
Import the Configuration Data into the IP Office and IP Office Contact Center section
of this guide.
Deploying IPOCC Chrome User Interface. Refer to the Deploying IP Office Contact
Center Chrome User Interface section of this guide.
Deploying the ICI Connector. Refer to the ICI Connector section of this guide.
05 2016
16
Task
Description
Notes
Planning Checklist
# Task
Description
Notes
On the Avaya
Support Site, in the
Enter Your Product
Here field, type IP
Office Contact
Center.
05 2016
17
# Task
Description
Notes
5 Download documents
from the Avaya Support Site
Documents and
Downloads.
Installation of endpoints
XMPP server
Agent workstations
On the Avaya
Support Site, in the
Enter Your Product
Here field, type IP
Office.
See Telephone
Support for Use with
IP Office Contact
Center section of
this guide.
Use the Site
preparation
checklist. In this
guide.
05 2016
18
Server Hardware
Depending on the required capacity, there are two Turnkey Servers (Preconfigured
Servers) available for purchase from Avaya, Please speak to your reseller if required.
Base Server
Small Appliance Server (100 Agents or
less)
Large Appliance Server (250 Agents or
less)
Description
R220 IP Office Contact Center Server
(R9.1 Software pre-loaded)
R630 IP Office Contact Centre Server
(R9.1 Software pre-loaded)
Network Delay
Packet Loss
Note: Before you can install IP Office Contact Center, you must ensure that the
appropriate servers are set up. For Appliance server specifications and
installation instructions, see the following documents at http://support.avaya.com:
Installing the Dell PowerEdge R630 Server
Maintaining and Troubleshooting the Dell PowerEdge R630 Server
05 2016
19
Supported Trunks
The Following Trunk Types are supported for Use with IP Office Contact Center
SIP
H.323
PRI (E1,T1,E1R2)
BRI
05 2016
20
05 2016
21
Server Preparation
Servers Computer Name
The servers computer name should only be comprised of letters and digits. It should
not contain spaces or underscores. The name should also begin with a letter rather than
a digit.
The Server interfaces depicted in this guide include both the Windows 2008 and
Windows 2012 server interface.
1. The servers computer name can be found by selecting Start, right clicking
Computer, then selecting Properties.
With Windows 2012 Server, right click on the Windows icon and select System
Windows
2008 Server
Windows
2012 Server
A. Right Click
B. Windows 2012 Server
2. The name will be displayed. To change the name, click the Change Settings
link.
05 2016
22
3. The System Properties are displayed. From the Computer Name tab click the
Change button and define the name in the Computer Name field. Click the OK
button.
4. As the servers name has been changed, you will be prompted to reboot the
server. Click the OK button.
05 2016
23
6. You will be prompted to restart the server, click the Restart Now button.
05 2016
24
Windows Firewall
Ensure that the Windows Firewall is enabled on the IP Office Contact Center server.
1. The Firewall settings can be checked by selecting Start, Control Panel.
2. With Windows 2012 server, right click on the Windows icon and select Control
Panel.
Windows
2012
Server
Windows
2008 Server
A. Right click
B. Windows 2012 Server
3. Select the System and Security link.
05 2016
25
5. Select the Turn Windows Firewall On or Off link. The firewall settings can be
checked / enabled.
Note: the Windows firewall must be enabled.
05 2016
26
Windows
2008 Server
2. To define the Time and Date settings on a Windows 2012 server, click the
Clock, Language and Region link.
Windows
2012 Server
05 2016
27
Windows 2012
Server
Windows
2012 Server
SNMP
Do not activate SNMP on the IP Office Contact Center server.
05 2016
28
IP Address
The IP Office Contact Center server requires a single static IP address utilizing TCP/IP
as the network protocol. IP Office Contact Center does not support the use of multiple
IP addresses on the same network card.
IP Office Contact Center does not support the use of multiple Network Interface Cards.
Power Settings
The IP Office Contact Center servers power settings should be configured as follows.
1. From the servers Control Panel, click the Power Options link.
2. With a Windows 2012 server, from the Control Panel select the Hardware link.
Windows
2012 Server
05 2016
29
Windows
2012 Server
Windows
2012 Server
Windows
2012 Server
05 2016
30
Windows
2008 Server
Windows
2012 Server
05 2016
31
Windows
2012 Server
Windows
2008 Server
Windows
2008 Server
05 2016
32
Windows
2012 Server
05 2016
33
Windows
2012 Server
Windows
2012 Server
05 2016
34
Windows
2012 Server
Windows
2012 Server
05 2016
35
Windows
2012 Server
Windows
2012 Server
05 2016
36
8. Select the Turn on DEP for essential Windows programs and services only
option. Then click the OK button.
Windows
2012 Server
Windows
2012 Server
05 2016
37
10. You will be prompted to restart the server, click the OK button.
Windows
2012 Server
Windows
2012 Server
05 2016
38
Each bulletin provides a link to any update software that is available for the Windows
Server. Certain updates may also be selected from the Windows Update site.
05 2016
39
Note: The only relevant products for which updates maybe required are Windows
Server 2008 R2 and Windows Server 2012 and the roles installed on the IP Office
Contact Center server, no other applications or roles require updating.
All security category updates with a severity rating of Critical, Important or Unspecified
should be applied as soon as possible, ideally within 5 working days of notification.
Note: No other updates should be installed without authorization from Avaya, as to do
so may cause loss of functionality.
Note: Avaya recommend that Automatic Windows Updates are disabled.
Task
Description
Install IP Office
Contact Center
Notes
05 2016
40
Windows
2008 Server
Windows
2012 Server
05 2016
41
Windows
2012 Server
6. The folder will contain a number of files including four vcredist installation files
Windows
2012 Server
7. Install the install vcredist_x64_2008.exe file by double clicking with the left
mouse button on the vcredist_x64_2008.exe file
Windows
2012 Server
8. Click Next.
05 2016
42
9. Click the I have read and accept the license terms check box, then click the
Install button.
05 2016
43
05 2016
44
Windows
2012 Server
12. Click the I have read and accept the license terms check box, then click the
Install button.
05 2016
45
05 2016
46
Windows
2012 Server
17. Click the I have read and accept the license terms check box, then click the
Install button.
05 2016
47
05 2016
48
Windows
2012 Server
21. Click the I have read and accept the license terms check box, then click the
Install button.
05 2016
49
05 2016
50
Windows
2008 Server
Windows
2012 Server
05 2016
51
Windows
2012 Server
Windows
2012 Server
05 2016
52
05 2016
53
05 2016
54
05 2016
55
10. As the components are installed, the status icons adjacent to the components
will change color from Grey to Green.
11. You will be notified when the installation of the IP Office Contact Center
Components has finished.
05 2016
56
13. The system will display a message requesting the system be rebooted.
14. Click the OK button.
Windows
2008 Server
05 2016
57
Windows
2012 Server
15. Then click on the Start button on the servers desktop, followed by Restart.
05 2016
58
Windows
2008 Server
With Windows 2012 server, click the Settings icon, then click the Power icon followed
by Restart.
Windows
2012 Server
05 2016
59
Windows
2012 Server
18. The Watchdog will display a message once it has successfully checked the
services. This window will close automatically.
05 2016
60
Windows
2008 Server
With Windows 2012 server, click the down arrow icon and click the TT display
icon.
Windows
2012 Server
05 2016
61
05 2016
62
23. The Trace Display window will open and show all the running services as
indicated by a green status icon. Any services that are yet to start will display a
grey icon; those that have just started will display a yellow icon. Any services that
have failed to start correctly will display a red icon. The service lights should
display as green within a few minutes.
Note: Until the IP Office Contact Center system is licensed the SMTP connector
will repeat a cycle from a green icon to a yellow icon and then a red icon.
05 2016
63
05 2016
64
Licensing
A license file has to be installed on a Web License Manager (WebLM) service for the IP
Office Contact Center system. This can be achieved by using the Web License
Manager utility which is available as part of the IP Office Contact Center software
installation or on a centralized WebLM server. The license file is obtained from Avaya
and is generated based upon the Server Host ID of the server upon which the WebLM
service will be installed.
Note: If the IP Office Contact Center Server has multiple network adapters, disable all
NICs that are not used for IP Office Contact Center. ONLY ONE NETWORK CARD IS
SUPPORTED.
Note: The WebLM Service on the Server Edition / Application Server must not be used
for IP Office Contact Center Installations.
The Technician is required to:
Using WebLM, obtain the Server Host ID
Login to PLDS.
Obtain the required License file as per the Sales order.
Once received, the license file is applied using the WebLM utility.
It is good practice to check that the licenses have successfully been applied to
the server.
Any additional licenses required for the IP Office can be obtained using the ADI
utility.
If using a Centralized WebLM server to provide the WebLM service. Please
follow the Centralized WebLM service section.
A complete list of IP Office Packaging and Order codes is available in the Avaya IP
Office Contact Center Reference Configuration guide.
05 2016
65
05 2016
66
05 2016
67
9. You will be prompted to change the password. Enter weblmadmin in the Current
password field.
10. Enter and confirm the new password, then click the Submit button (The
password is case sensitive).
05 2016
68
11. A prompt will be displayed confirming that the password has been successfully
changed.
Note: This password is critical as is it used for access to the Web License Manager
utility. Therefore a make note of the password you create.
12. Log back into Web License Manager, with the new password you have just
created.
05 2016
69
15. Make a note of the Server Host ID and choose WebLM Home.
05 2016
70
17. Once you have your license file, go back to WebLM and click the Install License
link.
18. Click the Browse button and browse to the license file.
05 2016
71
05 2016
72
22. Click on the CIE link and the installed Licensed Features will be displayed.
05 2016
73
05 2016
74
05 2016
75
6. Read the license agreement and then choose I accept the terms in the license
agreement and then select the Next button.
7. Choose Complete.
05 2016
76
8. In the License Server field type the name of the Server running the WebLM
service. Then if you are using Centralized WebLM server change the port to
52233. Then select the Next button.
9. The License client now installs and choose the Finish button when the
installation is complete.
05 2016
77
05 2016
78
05 2016
79
05 2016
80
05 2016
81
11. If Save as was selected, browse to a location and click the Save button.
05 2016
82
12. When the certificate has been saved, click the OK button.
05 2016
83
Note: As part of the configuration process, the type of certificates to be used must be
determined. The choice is to use IP Office Certificates or those from a trusted 3 rd Party.
05 2016
84
05 2016
85
16) Select (No Template) Legacy Key. This is an important step, without this
change the correct CSP cannot be selected.
Note: Always specify FQDN and hostname as DNS SAN entries if configuring
the server for access via an FQDN, with the FQDN first, otherwise specify just
the hostname, e.g. on CPE. The URL SAN entries should be omitted.
Some CAs may insist on FQDN entries and may not issue with hostname alone,
many will also ignore IP address entries (increasingly).
Include a single wildcard character * in the DNS SAN entry for the appropriate
domain prefix.
17) Select PKCS #10 and click Next.
18) In the Certificate Information section, click arrow button next to Details and
click Properties.
Note: some CAs may not issue certificates containing the Data encipherment
key usage, this should not impact proper SSL usage. The usages Key
encipherment and Digital signature are important
19) On the General tab, type the domain name of the certificate in the Friendly
Name field.
20) On the Subject tab, in the Subject Name field, enter the information below,
clicking Add after entering each type:
Note: Typically the street address and other company details are needed in the
subject for EV certificates, these are specified by the CA and are additional to the
standard subject DN attributes.
Type
Country
Value
Country Name (2 letter
code)
State
Locality
Organization
Organization Unit
Common Name
Email
Locality name
Organization name
Section/Department name
FQDN of server
Contact email address
Notes
The Country Name is a 2 letter code
defined by
https://www.iso.org/obp/ui/#home;
select Country codes, and click search
e.g. US
Spell out the state, do not abbreviate
otherwise the CSR will be invalid.
e.g. City
e.g. Company Name
e.g. IT
e.g. www.example.com
e.g. contact@example.com
21) Any entries not required (for example Organizational Unit Name) or not
requested by the CA should not be added.
05 2016
86
22) In the Alternative Name field, enter the information below, clicking Add after
entering each type:
Type
DNS
Value
DNS SAN entry
IP address (v4)
IP SAN entry
URL
Notes
The first Alternative Name field should
be DNS with the same value as the
Common Name.
e.g. www.example.com
e.g. example.com
e.g. 135.11.53.53
e.g. 135.11.53.63
e.g. sip:example.com
e.g. 135.11.53.53
05 2016
87
9) Click Next.
10) Select Place all certificates in the following store. Under Certificate Store,
make sure Personal is selected and click Next.
11) Complete the Certificate Import Wizard and click Finish.
05 2016
88
12) Check there is a key icon on the new certificate, if not the private key is not
present.
13) Repeat the import process to import the intermediate certificate file(s); there will
be no key icon with these new certificates. Again these must go into the
Personal certificate store.
14) Select the identity certificate and click Open, select Details and verify the
content are as expected. Select Certification Path and verify all the certificates
are present to the root certificate.
05 2016
89
05 2016
90
05 2016
91
5. Browse to the location of the p12 certificate and click the Open button.
6. Enter the Certificate password and then click the Apply button.
05 2016
92
05 2016
93
05 2016
94
05 2016
95
05 2016
96
05 2016
97
05 2016
98
05 2016
99
05 2016
100
13. Click the location and type a name and then select the Save button.
05 2016
101
05 2016
102
16. A message screen appears telling you that the Certificate has been successfully
exported. Click the OK button to close.
05 2016
103
05 2016
104
21. Using the Right Mouse Button on the Exported Certificate Click Install
Certificate.
22. Click the Store Location required and then select the Next button.
05 2016
105
23. Click Place all certificates in the following store and then select the Browse
button.
24. Click Trusted Root Certification Authorities and then select the OK button.
05 2016
106
05 2016
107
28. When you attempt to gain access to the IP Office Contact Center Server by
referencing the Host Name, a warning message is displayed.
05 2016
108
05 2016
109
2. Move the mouse cursor over the red X and then select to View site information.
05 2016
110
05 2016
111
05 2016
112
05 2016
113
05 2016
114
12. Click the location and type a name and then select the Save button.
05 2016
115
05 2016
116
15. A message screen appears stating that the Certificate has been successfully
exported. Click the OK button to close.
05 2016
117
05 2016
118
20. Using the Right Mouse Button on the Exported Certificate Click Install
Certificate.
21. Click the Store Location required and the select the Next button.
05 2016
119
22. Click the Place all certificates in the following store and then select the
Browse button.
23. Click Trusted Root Certification Authorities and then select the OK button.
05 2016
120
05 2016
121
27. When you attempt to access the IP Office Contact Center Server, you will not
receive a warning message.
05 2016
122
05 2016
123
2. Click I Understand the Risks and then select Add Exception button.
05 2016
124
05 2016
125
05 2016
126
5. Click the ipoffice-root certificate and then select the Export button.
05 2016
127
6. Click the location and type a name (adding .crt to the file name) and then select
the Save button.
05 2016
128
05 2016
129
05 2016
130
05 2016
131
05 2016
132
15. Browse to the exported Certificate and then click the Open button.
16. Click Trust this CA to identify websites and then select the OK button.
05 2016
133
05 2016
134
05 2016
135
20. When the IP Office Contact Center Administration page is reopened, the warning
message is no longer displayed.
05 2016
136
2. Move the mouse cursor over the red X and then select to View site information.
05 2016
137
4. Click Details.
05 2016
138
05 2016
139
9. Click Settings.
05 2016
140
10. Scroll the Window down until show advanced setting is displayed.
05 2016
141
05 2016
142
15. Click the pull down option Base64-encoded ASCII, single certificate.
05 2016
143
17. Click the exported certificate and select the Open button.
05 2016
144
05 2016
145
05 2016
146
24. When you reopen the IP Office Contact Center Administration page the warning
is no longer displayed.
05 2016
147
05 2016
148
4. Using an account that can change the security settings, fill out the username and
password and choose the OK button.
Note: For 500v2 the default access User is security. For Server Edition it is
Administrator
05 2016
149
6. Click Services.
05 2016
150
05 2016
151
Planning Checklist
# Task
Description
Notes
System Configuration
The required Topic Numbers to
be utilized.
IP Office IP Address
IP Office System Password
IP Office Service Password
SIP Domain
The privileges
available for
assignment are
Agent and
Supervisor
User Setup
The Users (Agents) to be
assigned.
The Profiles to be assigned with
the Users
Time Off Settings
The required Time Off Periods
and their recurrence patterns
05 2016
152
05 2016
153
5. The default User Name and Password required to login to the IP Office Contact
Center Administration page is Administrator. Enter Administrator in both the
Username and Password fields and then click the Login button. It is good
practice to change the default Administrator password used to access the
administrative interface of IP Office Contact Center.
05 2016
154
The Configuration Wizard navigation is completed using Next and Previous buttons.
The Maximum configuration limits that can be applied via the Wizard are:
100 Groups
20 Profiles
250 Users (Agent/Supervisor)
25 Time Off periods
7. If the IP Office Contact Center has not been initialized the Configuration Wizard
will start by displaying the System Configuration page. The Window is split into
IP Office Contact Center Installation
05 2016
155
two panels. IP Office Data and IP Office Contact Center SIP Connection
Setup (CHAP Configuration). Some of the fields will be prepopulated, whist
other fields are highlighted with Required to indicate that these fields require
information to be added.
Note: The combination of the Topic Code Prefix and the Start Topic Code will
produce the first IP Office Contact Center Topic number. In the above example, Topic
7001 equates to Topic Code Prefix 70 plus Start Topic Code 01. The first Topic Number
can therefore be configured by utilizing the above two fields.
05 2016
156
E. IP Office Service Port This must be defined as 7070 for Server Edition
and 8443 for IP Office 500v2. The default is 8443.
05 2016
157
05 2016
158
05 2016
159
05 2016
160
05 2016
161
8. Once all of the parameters have been completed, the administrator can test the
connection between the IP Office and IP Office Contact Center by clicking the
Test Connection button.
10. The corresponding errors will be highlighted by red exclamation mark symbols
adjacent to the fields in question.
05 2016
162
11. Enter the required details to correct the highlighted errors and retest the
connection by clicking the Test Connection button.
05 2016
163
05 2016
164
From this page, Agent Groups and Profiles can be created. Agent and Supervisor
Privileges can also be assigned. By default a single Group 1 and two Profiles are
available.
2. To change the name of an existing Group, enter a new name in the Group
Name field.
05 2016
165
3. To add a new Group click the Add Group button and update the Groups name
in the Group Name field.
05 2016
166
4. The new Group is assigned against the next available Topic number. In this
example the new Group Sales has been assigned against Topic ID 7002.
05 2016
167
05 2016
168
05 2016
169
10. Use the Privileges drop down to assign the required Privilege. The choices
available are Agent or Supervisor.
11. Click within the Group field and select the groups that are to be assigned against
this profile. In this example, a group named Support has been assigned. The first
group is assigned by default. Select any additional groups to be assigned.
05 2016
170
05 2016
171
2. To add new Users (Agents), enter the number of required users in the Number
of Users field.
05 2016
172
3. From the Profile Name drop down list select the Profiles to be assigned against
the users.
05 2016
173
4. In the Start Extension Number field, enter the first extension from which the
range of users will be created.
Note: If a single user is required, enter 1 in the Number of Users field and then select
the required Profile and the Extension Number to be assigned to the user.
5. Click the Add User button.
05 2016
174
6. The configured Users are displayed along with their assigned Profiles and
Extension Numbers.
05 2016
175
7. To change a Profile against an individual agent, click the Profile Name drop
down against the agent. Then select the required Profile.
8. In this example, Agent2100 name has been changed to Bob James by updating
the Name field and has been assigned the Supervisor Profile.
05 2016
176
9. Click Next.
05 2016
177
Recurrence settings:
A. None: The Time Off period will not repeat. Therefore the Begin Week and
End Week fields will be disabled.
B. Daily - The Time Off period will repeat on a daily basis at the configured
Time.
C. Weekly The Time period will repeat on a weekly basis at the configured
day and time.
D. Yearly The Time Off period will repeat on a yearly basis at the
configured date and time.
05 2016
178
05 2016
179
3. Enter a Name for the Time Off period, in this example the name Shutdown has
been added.
05 2016
180
4. As this is a one off event, the Recurrence has been set to None.
5. Click in the Start Date field, the current month is displayed. To select a different
month, click the current month.
05 2016
181
7. To select a year, click the currently displayed year and then the required year.
05 2016
182
8. Then select the required start date for this Time Off period from the displayed
calendar.
05 2016
183
9. In the Start Time field, enter the time from which this Time Off period will
commence.
05 2016
184
10. Repeat the process to add an End Date and End Time. The current date is
displayed in the End Date field. In this example, the End Date will be changed to
the 15th June 2016 with an End Time of 8:30am
05 2016
185
In the following example, a Weekly recurring Time Off period will be created.
1. Click the Add Time Off button.
05 2016
186
2. Enter a Name for the Time Off period, in this example the name Fire Alarm Test
has been added.
3. As this is a weekly event, click the Recurrence drop down box and select
Weekly.
05 2016
187
4. From the Start Weekday drop down box, select the day this weekly Time Off
period will commence. In this example, Friday has been selected.
5. In the Start Time field, enter the time from which this Time Off period will
commence.
05 2016
188
05 2016
189
8. Once all the required Time Off periods have been created, click Next.
05 2016
190
1. If required, the administrative can select the Previous button to return to any of
the Configuration Wizards pages to make modifications as required.
05 2016
191
2. The Preview Configuration pages scroll bar can be used to view all of the
configuration settings previously entered.
05 2016
192
4. An attention message is displayed. Read the message and once satisfied, click
Yes.
05 2016
193
Note: You will have to wait a minimum of 2 minutes before the Configuration Wizards
settings are applied. There are no progress bars to indicate how the configuration
changes are progressing.
5. You will be prompted, that the settings have been saved and that the IP Office
Contact Center requires restarting. Click Yes to logout and restart the services.
05 2016
194
6. Once the system has restarted, log back into the IP Office Contact Center
Administration interface.
05 2016
195
7. The system shows that the IP Office Contact Center system is no longer in a
default state.
8. The configuration changes that have been applied from the Configuration
Wizard, will be reflect in IP Office Contact Centers Windows client interface.
Therefore default Telephony Task Flows will be created for each of the Topics
created by the Configuration Wizard.
9. The Task Flows created by the Configuration Wizard are automatically activated.
05 2016
196
Description
Complete Configuration
Spread Sheet
Import the
DataImport.exe file.
Import the Configuration.csv file.
General system
Settings SIP extensions
Notes
Note*: The IPOCC IPO Sync service is automatically started and configured by default.
Therefore Auto Synchronization can be used in preference to a manual configuration
import regardless as to whether the configuration spreadsheet or Landing Page Wizard
is utilized.
1. Browse to the Avaya IP Office Contact Center Configuration file located in the
Utilities folder.
05 2016
197
Note: This IP Office Contact Center configuration file was previously copied to the
servers desktop during the initial part of the configuration.
2. Open the file by double clicking on the Avaya IP Office Contact Center
Configuration spread sheet icon
3. The Excel file should be configured so that Macros are enabled. To do this click
on File, Save As, Macro Enabled Workbook.
05 2016
198
Note: It is important that the Workbook is saved with a path that contains no
spaces / (blank) characters.
05 2016
199
6. If you are using an older version of Excel, for example within the Office
Professional 2010 suite, you may have to manually enable Macros. Reopen the
file and click File followed by Options.
05 2016
200
8. Click Macro Settings. Select the Enable All Macros radio button. Click the OK
button.
05 2016
201
05 2016
202
Note: The Excel file can only be used for IP Office 9.1.6 (R9.1 FP1) Contact Center
Installations, i.e. a 9.0.2 or 9.0.3, 9.1.0 Excel file cannot be used for a 9.1.6 installation.
13. Tips to help you complete the workbook can be viewed by clicking the red tool tip
icon against specific fields.
05 2016
203
15. It is imperative that you enter the correct IP Office Contact Center Hostname,
XMPP Hostname, XMPP Domain and UMR Domain. Fields with a red
background must be configured.
In this example, the IP Office Contact Center server hostname of abcipocc has
been added.
Note: The servers computer name should only comprise of letters and digits. It should
not contain spaces or underscores. The name should also begin with a letter.
05 2016
204
16. This can be checked on the server by opening a command prompt and typing
hostname after the prompt.
05 2016
205
18. From the Version drop down menu, ensure that you select the correct version of
IP Office software used for the installation. The Name PBXServer can be
changed to match the Host name of the Primary Server Edition.
19. If Chat and Email are not going to be used, these fields can be left as default.
20. If Chat is required, enter the name of the Chat (XMPP) server to be utilized in the
Name field. This name will identify the customers Chat server for example,
myxmppsrv
Note: Even if Chat or Email is not required, DO NOT delete the words CHANGE ME
from these fields.
05 2016
206
21. In the XMPP Hostname field, enter the Hostname of the customers XMPP
server.
22. In the XMPP Domain field, enter the Domain Name that is served by the XMPP
server.
23. If Email is to be utilized with IP Office Contact Center, in the E-Mail Domain field
enter the internally used Domain Name for email. Note that this is not the name
of the customers email server.
05 2016
207
27. The number of Chap channels used for Queue Device and IVR will automatically
update depending on the Number of Chap Channels selected from the drop
down box.
In this example, 120 Channels have been selected and the Queue Device
updated to 60 Channels and the IVR updated to 30 channels.
In this example, 300 Channels have been selected and the Queue Device
updated to 200 Channels and the IVR updated to 50 channels
05 2016
208
28. In the LocalIPAddress field, enter the IP Address of the IP Office Contact
Center server.
30. In the SIP Domain field, enter the SIP Domain in lowercase letters. This must
match the Domain Name set in the IP Office Manager under System, LAN1,
VoIP tab, Domain Name.
05 2016
209
31. Enter the IP Address of the DNS server used by IP Office Contact Center.
32. The SIP Extension is used for communication between the IP Office Contact
Center and the IP Office. This will automatically be added to the IP Office
settings when the configuration file is uploaded to the IP Office.
Note: The SIP Extension must be unique and cannot conflict with any other IP Office
extension and must not be in the Topic Number range.
33. Repeat this process for the remaining tabs. Remember that the red tool tips are
available against the fields to assist with configuration.
Note that some of the tabs, for example the Agent and Profile tabs contain
hidden columns that should be expanded so that the configuration data can be
entered. The columns can be expanded by clicking on the plus (+) icons.
05 2016
210
Note: Your IP Office extensions must not be in the extension range 70xxx and 80xxx as
by default these ranges are used by IVR and QDED lines.
34. When all of the tabs have been populated with configuration data, click the Data
Import tab then click on the Create Data Import button.
05 2016
211
Note: If the Create Data Import button is inactive, there may be a problem
caused by a Microsoft Security update. Please refer to the IP Office Contact
Center 9.1.6 FP Maintenance Task Based Guide Troubleshooting section.
35. The Data Import file will be created.
05 2016
212
05 2016
213
5. Select the DataImport.zip file created with the Excel spread sheet and then click
the Open button.
05 2016
214
6. The details within the zipped file are displayed on the right hand side of the
screen. Scroll down to see all of the details.
05 2016
215
A. Enter the IP Office Service User Name. This is typically the IP Office
Administrator account.
The Conf access User name is populated with this name.
05 2016
216
Note: A service account on IP Office could have been created for AutoSync
purposes. That account can be used if created. Please refer to the Creating a
New Account for the Auto Synchronization section of this guide.
B. Enter the IP Office Service Password. This is typically the IP Office
Administrator account password. The Conf access Password is
populated with this password.
Note: A service account on IP Office could have been created for AutoSync
purposes. That accounts password can be used if created. Please refer to the
Creating a New Account for the Auto Synchronization section of this guide.
C. Enter the IP Office System Password. This is the IP Office system
password. The PBX password in the database is populated with this
password.
8. Click the Apply button. The configuration will be uploaded.
05 2016
217
05 2016
218
05 2016
219
38. From the servers desktop, right click and select Paste.
05 2016
220
Note: Make a backup of the Database before you attempt to Import the Data
configuration file. Please refer to the IP Office Contact Center Maintenance Task Based
Guide for details relating to Database backups.
40. Double left click on the Data Import file to import the data.
41. The CCImportJobber screen is displayed. Enter the following and then click on
the Import data button.
A. Enter the IP Office Service User Name.
B. Enter the IP Office Service Password.
C. Enter IP Office System Password.
05 2016
221
42. The Data Import will be completed. Click the Finish button.
05 2016
222
43. Restart the server. From the servers desktop click Start followed by Restart.
With Windows 2012 server, click the Settings icon, then click the Power icon
followed by Restart.
05 2016
223
Windows 2012
Server
Windows 2012
Server
05 2016
224
Windows 2008
Server
With Windows 2012 server, click the down arrow icon and click the TT display
icon.
Windows 2012
Server
05 2016
225
Windows 2008
Server
47. Check that all components are running as indicated by green icons adjacent to
the components.
05 2016
226
05 2016
227
05 2016
228
05 2016
229
5. The first time you login with Administrator account, you will be asked to change
the default password. Click the OK button.
05 2016
230
7. To change the Administrator default password, click File and then select Change
password..
8. In the Old Password field, enter the password Administrator, then enter and
confirm the new password. Click the OK button.
05 2016
231
11. In this example, the Agent tab has been selected and the imported agents
details are displayed. This indicates that the data has successfully imported to
the database.
05 2016
232
05 2016
233
18. From the menu bar select Task flow set followed by Activate.
05 2016
234
If an error is encountered within the Task Flow, please refer to the Error List section of
the IP Office Contact Center Maintenance Task Based Guide.
20. Click the OK button.
21. The Task Flow can now be closed. Select Task flow set followed by the Close
button.
05 2016
235
23. The default Task Flow Set has to be defined. To do this click Task flow set
followed by Default task flow set
05 2016
236
24. You will be prompted that No default TF set configured. Click OK.
27. The server is now configured. For more information on the Task Flow Editor refer
to the IPOCC 9.1.7 Task Flow Editor - Telephony Task Based Guide
05 2016
237
Task
Description
1
2
Configuration.csv
VoIP
SIP Register
DNS
Notes
1. To import the configuration file, launch IP Office Manager and open the
configuration of the IP Office.
Note: If this is a new IP Office installation, due to Security enhancements, you will be
prompted to change the default System password when you first login to IP Office
Manager. This password can also be set from the IP Offices Security Settings
interface.
05 2016
238
2. From IP Office Managers menu bar, select File followed by Import/Export then
select Import.
05 2016
239
3. Locate the IP Office Configuration file that was created when the Data Import file
was produced. To do this click the browser button and browse to the location of
the configuration file.
4. The Configuration file will be shown as being available for selection. Click the
check box adjacent to the file.
05 2016
240
05 2016
241
10. Once rebooted, the uploaded IP Office configuration can be checked by logging
back into IP Office Manager and clicking the User link. The users that were
created and uploaded to the IP Office Contact Center will be the same as those
uploaded to the IP Office Configuration.
Note: Only users (relating to the agents) are created, therefore the extensions
associated for the users will have to be created manually via IP Office Manager.
05 2016
242
11. A user called Contact Center is also created, that is associated with the SIP
extension that was previously defined in the Data Import spread sheet. This SIP
extension is used as a connection path between IP Office and the Contact
Center server.
05 2016
243
12. A short code is also created that is used for routing calls from the IP Office to the
IP Office Contact.
05 2016
244
14. Ensure that the H323 Gatekeeper Enable check box is selected.
15. Ensure that the SIP Trunks Enable check box is selected.
05 2016
245
17. In the Domain Name field, ensure that the SIP domain is correct (in lower case
letters only).
Note: This is the SIP Domain name previously defined in the Data Import Spread
sheet under CHAP Server tab.
18. Select the TLS check box as TLS must be enabled. The default ports can be
used.
05 2016
246
19. Ensure that UDP and TCP are also selected. The default ports can be used.
05 2016
247
21. Save the configuration back to the IP Office. Click the Save icon.
22. You will be prompted to complete an Immediate reboot of the system. Click OK.
The IP Office will reboot.
23. Once the IP Office has rebooted, the server will also require a reboot. Log back
into the IP Office Contact Center Server. From the servers desktop click Start
followed by Restart.
05 2016
248
With Windows 2012 server, click the Settings icon, then click the Power icon followed
by Restart.
Windows 2012
Server
Windows 2012
Server
24. Once the server has rebooted, log back into the server via a remote desktop
connection.
25. Check that all of the servers components are running. To do this click Start
followed by All Programs, open the Avaya IP Office Contact Center folder.
Then open the Trace System folder.
05 2016
249
Windows 2012
Server
With Windows 2012 server, click the down arrow icon and click the TT display
icon.
Windows 2012
Server
05 2016
250
27. Check that all components are running as indicated by green icons adjacent to
the components.
05 2016
251
Windows 2008
Server
Windows 2008
Server
05 2016
252
Windows 2012
Server
Windows 2012
Server
4. From the Text To Speech Voice drop down boxes, the required Text to Speech
Voice to be used with IP Office Contact Center can be selected.
05 2016
253
Windows 2012
Server
Note: Voice Control Speech Configuration has different default values for Text-tospeech English Voice and Number of test to speech licenses on ISO deployment vs
OVA deployment:
05 2016
254
The Telephony (Tel) check will be disabled from an IP Office Contact Center
agent profile, if the corresponding User is deleted from the IP Office system or if
the User Type is changed to None in User Telephony Supervisor settings and
vice versa.
05 2016
255
05 2016
256
05 2016
257
Limitations of Synchronization
The following list details the limitations of the synchronization process.
Name/Telephony Name
IP Office Rules (no auto
sync)
IP Office Contact Center
Rules(no auto sync)
Auto Sync Rules
Extension Number
IP Office Rules(no auto
sync)
Short code synchronization is only one way from the IP Office Contact Center to
the IP Office.
Depending on the PBX type (IP Office 500V2 or Server Edition) the
synchronization time will vary.
05 2016
258
When an IP Office Server Edition solution contains Expansion units, all IP Office
Contact Center users created through synchronization will reside on the Primary
Server Edition.
All expansion unit passwords must be synchronized with the primary server
otherwise the users from the expansion will not be in sync. This can be
automatically achieved through Synchronize Service User and System
password.
Short codes will not be deleted from the IP Office in any case, even if a customer
deletes the corresponding access code from the IP Office Contact Center.
A separate web service user should be created to avoid the risk of the
Administrator user account being locked.
When loss of connectivity with the IP Office occurs, the synchronization service
will restart synchronization operations only when the disconnection periods
exceed 60 seconds.
05 2016
259
Rules of Synchronization
The IP Office is master of the data (name, number and password), apart from the short
codes where the IP Office Contact Center is the master. New or changed short codes
for topics are always copied to IP Office. When short codes are deleted in IP Office
Contact Center they are never deleted from the IP Office.
Note: When exchanging extension numbers from one user to another, this process
should be completed by removing both extensions first. Then saving the configuration
and updating it again with the new Extensions. This configuration should be completed
in the IP Office and the IP Office Contact Center will be updated after 90 seconds.
Information:
Telephone numbers in IP Office Contact Center are necessary to start monitoring users
in IP Office Taskserver.
For newly created users in the IP Office, the IP Office Contact Center uses the same
configuration data as detailed in the Configuration spreadsheet (i.e. Profile, User rights).
The data is created or modified in IP Office Contact Center:
Scenario
IPO
Before synchronize
IPOCC
IPO
After synchronize
IPOCC
05 2016
260
password 004711
Interfering data in IPO are
present:
Other user (no agent) with
same user extension 4711
exists.
IPOCC Supervisor changes
the number of an agent.
New agent telephony
number 4722.
Interfering data in IPO are
present:
Other user (no agent) with
same user extension 4722
exists.
none
Agent telephony
password: 004711
Telephone number: N/A
Before synchronize
IPOCC
IPO
After synchronize
IPOCC
05 2016
261
Before synchronize
IPO
IPOCC
After synchronize
IPO
IPOCC
05 2016
262
Reason: IPOCC Sync Service is not responding to particular request. The current
synchronization is still processing a sync service request with the IP Office. A restart of
the IPOCC Sync Service is required, if the message is repeatedly seen.
05 2016
263
Reason: IP Office rejected the synchronization operation request. Check the IP Office
configuration.
Synchronization Rejecting Simultaneous operation
05 2016
264
2. From the drop down box, select Avaya IP Office Contact Center.
05 2016
265
05 2016
266
05 2016
267
05 2016
268
05 2016
269
5. In the New User Password and Re-enter New User Password fields type a
password for the new User. For example, IPoffice123 and then select the OK
button.
6. Use the slide bar against Right Group Membership until Business Partner. Is
displayed.
05 2016
270
7. Click the Business Partner Right Group Membership and then click the OK
button.
05 2016
271
9. Now that the account has been created in the IP Office, we need to amend the
details in IP Office Contact Center with the new account. Login to IP Office
Contact Center and select Administration followed by Configuration and then
PBX
05 2016
272
11. If your IP Office Contact Center has been upgraded from for example 9.0.3,
change the Version to R9.1.6 and then select the OK button.
05 2016
273
A.
B.
C.
D.
E.
IP Address
Port
User
Password
Sync Interval
: IP Office Address
: 7070 for IP Office Server Edition, 8443 for 500v2
: Web Service User in IP Office
: Password of Web Server User in IP Office
: Poll time for synchronization (default 2 minutes)
14. Change the User and Password to the newly created account.
05 2016
274
15. Change the Sync Interval and then click the OK button.
Note: The Sync Interval has a different effect on IP Office 500 V2 systems and IP Office
Server Edition systems. For IP Office 500 V2, user synchronization from IP Office and
access codes synchronization from IP Office Contact Center is dependent on the sync
interval. For Server edition, user synchronization is almost instantaneous both-ways
and only access code Synchronization from IP Office Contact Center is dependent on
Sync interval. Therefore if IP Office Server Edition is used, it is advisable to keep a
higher Sync interval, as Access codes are not frequently changed and do not require
the default synchronization of 2 minutes.
16. Click the OK button to confirm the changes.
05 2016
275
05 2016
276
05 2016
277
Note: The Full Name setting is also synchronised to IP Office with the Telephone name
of the Agent in IP Office Contact Center, if the agent is created in IP Office Contact
Center.
05 2016
278
2. Change the IPOCC Agent Type to Agent from None, when creating a new
Agent or Supervisor in IP Office Manager.
05 2016
279
4. The Auto synchronisation will now create a new Agent in the IP Office Contact
Center.
5. The reverse can also take place if the New Agent/Supervisor is created in the IP
Office Contact Center. The auto synchronisation will create a new
Agent/Supervisor in the IP Office.
Note: Short codes should be consolidated to the solution level of IP Office Server
Edition. This process is completed through settings within IP Office Manager/Web
Manager. This will ensure that short codes are available at all systems in the solution
i.e. primary, secondary as well as expansion systems.
05 2016
280
The short code is created as part of the Auto Synchronisation process. It is useful to
note what the code references within IP Office Contact Center:
A) In the above example, Code 70XX represents the range of Topics used within IP
Office Contact Center.
B) The Telephone Number field references the IP Office Contact Center SIP Extension.
05 2016
281
05 2016
282
05 2016
283
05 2016
284
2. Scroll down until the Work hours User Rights field is displayed. This should be
Application. If it is not, change the setting to Application.
05 2016
285
5. If any changes are required, Save the configuration before closing IP Office
Manager.
05 2016
286
05 2016
287
3. Click the Sites button and add the hostname of the server in the following format:
http://<hostname>
Note: the server name in the screen capture below is for illustrative purposes only.
05 2016
288
Adding the Servers Host Name to the IP Office Contact Center User
PCs Host File
NOTE: Changing the IP Office Contact Center Users host file is not required if a DNS
entry has been created for the IP Office Contact Center server and the User is using the
DNS server.
Each IP Office Contact Center Users PC must have its host file amended to reference
the IP Office Contact Center servers hostname and IP address
The servers hostname can be checked from the servers command line:
1. Login to the server and from the start menu type cmd in the search box and
press enter.
A. Right Click
B. Windows 2012 Server
2. Type hostname after the prompt.
3. The servers hostname is displayed. In this example the servers host name is
abcipocc
05 2016
289
4. The host name of the server should be added to each IP Office Contact Center
users PC. Navigate to C:\Windows\System32\drivers\etc.
5. Right click on the hosts file and open with for example notepad.
A. Right Click
6. Add the servers IP Address and host file details in the following format, for
example 192.168.42.50 abcipocc abcipocc
05 2016
290
05 2016
291
English
Italian
European French
Latin American Spanish
German
1. The software can be found on the IP Office Contact Center installation CD within
the Client folder.
05 2016
292
3. A dialogue box is displayed. Click the Save drop down box, followed by Save
As.
05 2016
293
05 2016
294
05 2016
295
10. Enter the Host Name of the IP Office Contact Center server in the Hostname of
IP Office Contact Center Server field.
Note: The Hostname depicted below, is for illustrative purposes only.
11. All of the other settings can be left in their default state. Click Next.
05 2016
296
05 2016
297
With Windows 2012 server, select the down arrow icon followed by the User
Interface icon.
Windows
2012 server
05 2016
298
3. In the Username field, enter the user name that has previously been configured
for this agent.
05 2016
299
4. From the Telephony Extension drop down box, select the extension to be used
by this agent.
5. Enter the password for the user in the Password field. The default password for
logging in to the agent user interface is cc123456
05 2016
300
05 2016
301
This data forms the basis of the default calls flows that can be utilized after the
configuration has been uploaded to the IP Office Contact Center server and the default
task flow set activated. (As outlined in section Activating a Task Flow section of this
guide).
05 2016
302
The task flows that reflect the data added to the configuration spread sheet can be
viewed as follows:
1. From the IP Office Contact Center User Interface select Go to followed by Task
Flow Editor.
05 2016
303
5. If the Task Flow Set has previously been activated, you will be presented with
the following dialog box. To open a copy of the Default Task Flow Set, click the
OK button.
6. The Generate new task flow set window is displayed, enter a name for the task
flow as required. A password can also be entered to limit access to this Task
Flow set.
05 2016
304
9. Click the plus symbol, and the task flows will be displayed that correspond to the
number of Topics added to the configuration spreadsheet.
05 2016
305
Note: The individual elements within the default Call Flow may require additional
configuration before they can be utilised to meet the customers specific requirements.
05 2016
306
By double clicking on the Telephone Calls element, the Topic to which this Element will
be applied can be selected. In its default state, the call flow can direct an incoming call
to Topic 1.
2. A Logic element.
05 2016
307
The Telephone calls element is linked to a Logic element. A logic element can be used
to apply a logical condition to a step within the call flow. For example, it can be used to
test a Logic against a configured block time period. This will determine whether an out
of office message is played to callers when the Logic condition is satisfied, as defined
by the 1 in the condition. The call flow would therefore continue through the Elements
Y exit point. If the Logic condition is not met the call flow is directed through the
elements N exit point where it is linked to an addition Logic element labelled as a
Holiday.
3. An Announcement script element.
05 2016
308
This Logic element can be used to determine whether there is a holiday as defined by a
configured Time off period. If the Logic condition is satisfied, as defined by the Time
specific Holiday key word, the call flow is directed to the announcement script as
previously discussed. If the Logic condition is not satisfied, the call flow is directed to
the T1 Task Trap.
5. A Task Trap element
The Task Trap will ensure that any waiting call will remain in the call flow when the out
of office period commences, as defined by a configured Block Period. For example, if
the block period is defined so that the office closes at 5:30pm, any call that is routed
through the call flow at 5:29 will remain and queue in the call flow.
6. A Prioritised Distributor element
05 2016
309
This element allows the calls within the call flow to be distributed in a prioritized manner.
In the default call flow, the first priority is to direct the call to a defined Personal
Contact. The second priority will direct the call to the Last Agent who previously spoke
to this caller. The third priority will direct the call to a Logic element. This will determine
if the call should be directed to an agent group, on the condition that there is a free
agent available to which the call can be directed.
7. A Personal Contact element
This element links to a configured customer record within IP Office Contact Center.
05 2016
310
This element determines whether the last agent the customer spoke to on a previous
call, is available to take the customers new call. From the Topics Telephony tab, the
Routing can be selected and a Hold Duration can be defined, that will determine the
period of time the system will attempt to contact the last agent, before moving to the
next point in the call flow.
9. A Logic element
05 2016
311
This Logic element determines whether any agents are available and free to take a call
and if so, the call is then directed by the Y exit to Agent Group 1. If the condition
defined in the key word is not satisfied, the caller is directed to a New Task Element.
10. An Agent Group element
05 2016
312
If the condition of the Logic element determines that there are free agents available to
take the call, the call flow routes the call to Agent Group 1. The agent group must be
assigned with the agents who will be presented with Contact Center calls.
11. A New Task element
If the logic element determines that no agents are free, the call flow is directed to a new
task element that has a defined Task Condition. When the condition is satisfied the call
flow is directed to a Queue Full element. If not, the call flow is directed to an
announcement script that contains a recorded wait announcement.
12. A Queue Full element
05 2016
313
The Queue full element is used in conjunction with a configured Queue factor set
against a defined agent group. This will determine how many callers can queue based
upon the number of agents in the group and the assigned Agent Groups queue factor.
For example, a queue factor of 2 with 2 agents logged in would determine that 4 calls
can queue (2x2). In the default call flow, queued calls as determined by the queue
factor limit, are directed to an announcement script and a recorded wait message is
played to the caller. Additional calls beyond the limitation as defined by the queue factor
are directed to a drop element.
13. A Drop element
In this example, any calls that are presented beyond the limitation of the agents groups
configured queue factor and associated Queue Full element will be dropped.
05 2016
314
The announcement script will contain a recorded message. In this example a Wait
message played to queuing callers.
Note: The above definitions and descriptions of the default call flow are for guidance
only. The call flow will require amendment to reflect the individual customers call
routing/call flow requirements.
15. The call flow will require amending to reflect the customers own requirements.
The call flow can then be tested by dialling the Topic number for example, for
Topic 1 dial 701.
For further details relating to the configuration of Task Flows, please refer to the IP
Office Contact Center Task Flow Editor - Telephony Task Based Guide.
05 2016
315
WebRTC
The application itself can use its own integrated phone via Web RTC. Therefore
eliminating the requirement to have an associated, separate handset.
Up to 250 agents can use the IP Office Contact Center User Interface application
simultaneously (with or without WebRTC telephony).
For systems with less than 30 agents connected to an IP Office P500v2, WebRTC
support is available via the use of an Application Server. For Server Edition systems,
there is no need for additional servers for WebRTC support.
Note: To use the WebRTC on the IP Office Contact Center User Interface you need to
access the application with HTTPS (Port 28443) and not HTTP.
WebRTC Limitations
All WebRTC SIP extensions MUST be defined on the Primary Server when a Primary
Server is part of the topology (none on Secondary Server, IP500V2 Expansion or Linux
Expansion).
Server Edition Primary Server - LAN1 of the Server Edition Server should be used as
the interface for WebRTC calls or when using the IP Office Contact Center User
Interface application as the interface into the IP Office Server Edition solution.
Note: Avaya does support the IP500V2 with WebRTC enabled on an Application
Server. Avaya does not support Resiliency (Primary -> Secondary) automatically.
05 2016
316
05 2016
317
05 2016
318
Note: The Agent group field must be populated with the assigned agent group. This
affects customers who upgrade their systems from 9.0 releases, where issues may
occur if the agent group field is left empty.
05 2016
319
Prerequisites
Chromebook Requirements
Planning Checklist
# Task
Description
Notes
A valid
Google/Gmail
account is required
prior to application
download.
05 2016
320
The IP Office Contact Center User Interface offers the following functionality:
Answer Call
Make Call
DTMF
Hold/Unhold
Hangup/Release
Conference
Mute
Transfer
Supervisor type features (Listen, Intrude, Coaching, Whisper) - some of which
are available via short codes.
05 2016
321
05 2016
322
4. Type IP Office Contact Center Chrome User Interface in the search field and
press enter.
05 2016
323
7. Click the Add button to enable the use of the Chromebooks microphone
(WebRTC Clients only using HTTPS).
05 2016
324
10. Read the license agreement and Choose I accept the terms in the license
agreement.
05 2016
325
12. The applications Welcome page is displayed. Click the Application setting icon
to configure the application.
05 2016
326
13. Enter the required Application Settings as required, when complete click the
Save button.
A. IP Office Contact Center Server Hostname - Enter the host name of the IP
Office Contact Center Server.
B. IP Office Contact Center Server port number (Default 28443)
C. Integrated Phone (WebRTC) (Default on)
On will use a WebRTC phone
Off will use an existing IP Office Extension.
D. WebRTC Gateway Hostname - Enter the host name of the WebRTC
Server
E. Web RTC Gateway port number (Default 7070)
F. Logging Level
05 2016
327
14. Depending on the use of the WebRTC Integrated Phone, additional configuration
details may be required.
Integrated Phone On
05 2016
328
15. Enter the login details for the agent and click the Sign In button.
16. The Agent can now log in and the IP Office Contact Center Chrome User
Interface is displayed.
17. The IP Office Contact Center Chrome User Interface is now ready for use.
05 2016
329
05 2016
330
Note: If the WebRTC Configuration link is not visible, ensure that the WebRTC
Gateway service has started.
4. From the WebRTC Gateway System Settings interface, enter the following
parameters:
05 2016
331
Note: There are no Security Setting changes required if the IP Office has been
upgraded from 9.0 to 9.1, if the upgraded system is at default security setting.
If the upgraded system is not at default security settings then the message will be
displayed.
05 2016
332
05 2016
333
05 2016
334
5. Click the SIP Server Settings link. The Configuration mode is set to Auto by
default and configuration details are auto prepopulated.
Note: The WebRTC client currently supports TCP Transport Type only.
6. Select the Media Gateway Settings link. Configure the following settings as
required:
A.
B.
C.
D.
E.
05 2016
335
2) Public STUN server can be used for remote worker configuration and the details
can be entered in the Media Gateway Settings field as illustrated below.
05 2016
336
05 2016
337
2. Select the required Agent for which an picture will be assigned. Then click the
Edit button.
05 2016
338
05 2016
339
05 2016
340
05 2016
341
3. Enter the name ChromeAppAG for the group then click OK.
05 2016
342
05 2016
343
4. All the existing Agents Group must now be mapped to the Virtual Agent Group.
Select the require Agent Group (Non ChromeAppAG) that contains the agents to be
mapped and click the Edit button.
6. Select the Virtual group that was previously created, then click the OK button.
05 2016
344
05 2016
345
Repeat the above steps to assign all other agents groups as required.
05 2016
346
05 2016
347
05 2016
348
3. Double left click the agent who will use the Web User Interface from their IP Office
Contact Center Chrome User Interface application.
05 2016
349
7. In the URL Address field, enter the required websites address to be displayed.
8. Select the option to determine where the website will be displayed. Click the OK
button (If navigation is required within the browser window, it is recommended to use
the option in new browser window).
9. The website will be displayed, change the URL to reference the Webpage.
05 2016
350
10. Enter any additional websites as required. Then click the OK button.
11. From the IP Office Contact Center Chrome Interface application, the new web tabs
will be displayed.
05 2016
351
05 2016
352
For the defined monitoring values the following values can be defined:
Min.
Max.
Warning
Alarm
05 2016
353
05 2016
354
1. From the IP Office Contact Center Configuration page, click the System Menu,
followed by General.
05 2016
355
3. Browse to the require image. Select the image and click the Open button.
05 2016
356
05 2016
357
05 2016
358
2. Choose the Supervisor profile that your supervisor is assigned to and then
select the Edit button.
05 2016
359
7. Click the Realtime information tick box and then select the OK button.
05 2016
360
05 2016
361
ICI Connector
Overview
ICI (Integrated Communication Interface) is an interface specified by SAP that can
connect to a SAP System.
The ICI Connector utilizes a SOAP HTTP (Simple Object Access Protocol) server to
provide features of the Contact Center to SAP Applications.
The ICI Connector implements an interface defined by SAP. At the time of writing this is
SAP Integrated Communication Interface Version 3.07.
Agent Features
Login/Logoff
Sign In/Out of Agent Groups
Pause
Wrap Up/After Call Work
Telephony Features
Implemented Features
05 2016
362
Feature
Availability
Notes
Base Telephony
yes
Call Center
Telephony
yes
Log on / log off, set ready or not ready, automatic wrap up and
finish (display of wrap up status only for agent state)
Pause codes
no
Agent Free
Seating
yes
Automatic Number Identification (ANI) Identify call number of
incoming caller. Find customer record based on ANI
yes
Screen Transfer
yes
Presence
Information
yes
yes
Auto Registration
of Extensions
no
Auto
Deregistration of
Extensions
yes
Sending DTMF
tones
yes
Simple CTI
yes
Number correction
during dialing
yes
Number correction
for display
yes
05 2016
363
Feature
Availability
Notes
Item- / Call
Attached Data
Handling
optional
Requirements
Supported SAP Versions
The ICI Connector supports SAP CRM 7.0 EHP3.
Supported Operating Systems
ICI Connector is supported with the following operating systems.
English
German
For the IP Office Contact Center ICI Connector to function there are a number
configuration features that have to be considered. These include:
Assignment SAP User Agent
The assignment of a SAP User to an IP Office Contact Center telephony agent is
associated via their IP Office Contact Center Login Name.
The agents defined IP Office Contact Center Agent System Name and the Telephony
Name must be entered in capital letters.
System variables
Following IP Office Contact Center CallTags must be configured:
Name: SAPCALLHANDLE
Type: System
Data Type: String
05 2016
364
Name: SAPCALLTAG
Type: System
Data Type: String
The Call Tags are inherited during Transfer and Conference call sequences.
Consequently Tags for consultation calls will be ignored.
Following screen capture illustrates a configuration example for the Call Tags
SAPCALLHANDLE.
1. To define a Call tag, from the IP Office Contact Centers administrative interface,
select System followed by Tag list
05 2016
365
05 2016
366
Free Seating
The agent data has to be configured in Contact Center.
If no Free Seating is offered (SAP Work Center Type 0), then each Contact Center
Agent has to be assigned a System Call Tag with the information of the predefined
extension number.
The name of the Tag (for example SAPAgentDefaultDevice as default) can be
configured in the ICI Connector.
Assignment Topic default agent group
For each IP Office Contact Center Topic an agent group has to be configured. The
assignment between Topic and Agent Group is utilized by the ICI Connector.
Forced order code / FOC
The feature forced order code of the Contact Center System is not supported.
Dialer with assignment to topic
You have to configure a system variable.
Example: SAPAgentOutboundDialTopic(default value)
You have to configure the system variable also in the ICI Connector configuration.
With the system variable you can configure a topic for each agent individually.
IP Office
Calls directed to the SAP system from IP Office Contact Center, must be in canonical
format for Customer Recognition to take place.
IP Office must distribute external call numbers in a format that includes the country
code.
For example: +Country/RegionCode (AreaCode) SubscriberNumber
05 2016
367
Scope of services
The ICI Connector provides the Telephony interface for IP Office Contact Center
agents.
Note: there is a differentiation between the SAP terms Queue and Agent Group and
the IP Contact Center Contact Center terms Topic and Agent Group.
A SAP user can logon/off from a group in the SAP interface. This simulates a logon/-off
from queues, as Topics in the Contact Center have an agent group assigned by default.
IP Office Contact Center Topics numbers are configured in SAP and calls can be routed
via Queue Presence Information in the corresponding Topics.
Mapping Agent State and SAP Workmode
Following table shows the transformation of Contact Center agent states and the SAP
Workmode
Note: the SAP User Workmode is a build state similar to the Telephony, E-Mail and
Chat states of IP Office Contact Center.
Agent State
NotReady
Undefinded
Pause
Pause
Ready
Logged on ready
Busy
BusyACD
PostWorking
PostWorking
ForcedOrderCode
Other states
Logged off
SAP Workmode
SAP User Workmode
Agent State
Pause
Logged on ready
Ready
Logged off
05 2016
368
Status
Explanation
No free seating
User-based workcenter
identification
Example:
raptor.pal.sap.corp
Hostname
Example: raptor
IP address
Example: 12.14.48.23
05 2016
369
Installation
The following components must be installed on the server:
Field
Explanation
License Server
Port
5. Optional:
Field
Explanation
Port
Enter the port number of the Tomcat WebServers which the master license server
(WebLM) uses.
Normally you can use the default port 8080
5. Click on Next. The Ready to Install the Program dialog box appears.
6. Click Install. The installation takes approximately 5 seconds.
7. Click the Finish button.
05 2016
370
05 2016
371
4. Read and accept the License agreement and then click the Next button.
5. Click the Complete option and then select the Next button.
05 2016
372
6. Type in the Name of the ICI Connector field ICIConnector and then select the Next
button.
7. Type in the required fields and then click the Next button.
A. ICI Connector port (Default 1077).
B. Enter the PBX Taskserver name.
C. Enter the host name where the ICI Connector has been installed.
D. CORBA connection port (Default 2809).
E. Enter the host name or the TCP/IP address of the server where the Trace
system is running.
05 2016
373
05 2016
374
05 2016
375
Adding the ICI Connector to the IPOCC Watchdog to Auto Start the connector
The new ICI Connector must be added to the IP Office Watchdog to ensure that the ICI
Connector starts whenever the IP Office Contact Center is rebooted.
Note: The user which starts the ICI Connector must have administrator rights (writing
registry access)
1. Click the Windows icon.
05 2016
376
05 2016
377
05 2016
378
8. Change the As level to 12 using the pull down and type in the Name field ICI
Connector. Then click the OK button.
05 2016
379
10. Click L12 Name=ICI Connector and then click the Run- Add button.
11. Fill out the fields and then click the OK button.
A. Type ICI Connector
B. Type ICIConnector.exe
05 2016
380
C. Enter the location directory of the ICIconnector.exe (for example C:\Program Files
(x86)\Avaya\IP Office Contact Center\ICI Connector
D. Enter the ICI Connector name.
This is the name of the ICI Connector as defined during the Setup process
E. Type the location directory of the ICIconnector.exe (for example C:\Program Files
(x86)\Avaya\IP Office Contact Center\ICI Connector
F. Change the Delay until next start to 5
05 2016
381
05 2016
382
14. The IP Office Contact Center Watchdog must now be restarted (Note: This will stop all
contact Center Services). With the Right Mouse button click the Windows icon and
select Run.
Windows
2012 server
05 2016
383
16. Scroll down until you can see the IPOCC Watchdog Service. Click the IPOCC
Watchdog and then select the Restart button.
05 2016
384
Windows
2012 server
Windows
2012 server
19. You should now see at Step 12 the ICI connector starting.
05 2016
385
05 2016
386
Windows
2012 server
Windows
2012 server
3. Enter the user service and the service password and then click the Login button.
05 2016
387
4. Click GetData.
05 2016
388
8. Edit the settings required and then click the SetData button to save the settings. The
table below details the required paramaters.
Field
Explanation
NameServiceHost
NameServicePort
StringCatalog
ICIPort
PABXTSName
SubstSeperator
see below
InboundSubstRules
OutboundSubstRules
05 2016
389
Field
Explanation
49;0; means leading 49 is replaced by 0
00;; means leading 00 is replaced by (empty
string)
You can have several rules. The rules are
referenced one after another beginning on the
left of the call number up to the first match
Note: The greater the number of rules created,
the longer the notification period for telephony
data
TelNumberHead
TelAreaPrefix
TelAreaCode
TelCountryPrefix
TelCountryCode
TelInternalDeviceLength
TelOutsideLineAccess
TelInternalNumberExtensionEnabled
TelInternationalCallMinLength
ThreadPoolSize
WorkCenterType
EventThreadPoolSize
05 2016
390
Field
Explanation
events (CallState Agentstate-changes) from
Contact Center as requests to the SAPSystem
by SOAP
WrapupDurationMinutes
The value used to manually extend the postprocessing time when extended by the SAP
agent
A Value == 0 will be set to 5 from ICI
Connector. Default 600
AgentDefaultDeviceKeyName
AgentOutboundDialTopicKeyName
AgentOutboundDialDefaultTopicName
RegisterDelaymSecs
SubscriptionTimeOutMinutes
05 2016
391
Field
Explanation
Connector. Default 4800
ItemIdTimeOutSecs
TraceHost
TracePort
05 2016
392
DE (German)
EN (English)
05 2016
393
05 2016
394
05 2016
395
05 2016
396
05 2016
397
Configuration Check
In the configuration tool ConfigUI.exe you can check the configuration for call number
normalization by CheckTelnumberSubst.
05 2016
398
05 2016
399
3. In the Name field type SAPAgentDefaultDevice and then click the OK button.
5. The Tag must now be assigned to each Agent. Click an Agent and then select the Edit
button.
05 2016
400
05 2016
401
10. Click the Tag SAPAgentDefaultDevice and then select the OK button.
05 2016
402
11. In the Value field, type the Extension number of the User and then select the OK button.
05 2016
403
05 2016
404
SAP Settings
The following settings must be defined in the SAP System.
Configure SAP
Transaction sm59
05 2016
405
2. In the TargetHost field, enter the name or the IP address of the system where the ICI
Connector runs.
3. In the ServiceNo field, enter the ICI Port (see configuration ICI Connector)
05 2016
406
6. Check No Logon.
05 2016
407
05 2016
408
8. From the Special options tab enter the HTTP protocol version.
05 2016
409
05 2016
410
No connection
If no connection is established the following message is displayed in the status line.
Error Analysis
TTraceConsole
When using TTraceConsole the ICI Connector name is displayed under which the
configuration data is saved (In this example, ICI_PABX_HH1)
05 2016
411
05 2016
412
PrintUser,"enter ICIUserId, i.e. LoginName ,'*' or empty parameter = list of all User")
-
05 2016
413
PrintConfig,"Print ConfigData"
-
05 2016
414
05 2016
415
With the transaction crm_ici_trace the SOAP dialog between SAP and the ICI
Connector can be displayed for user, where SAPTrace is enabled.
05 2016
416
TestTool TestUITabs
By using the TestUITabs.exe the connection and interaction of the ICI Connectors with
the Contact Center can be tested. The Test Tool uses the same SOAP dialogs as the
SAP System.
05 2016
417
Note: When several instances of the Test Tool software are used, the
LocalSoapListenPort has to be unique for each instance.
05 2016
418
05 2016
419
By selecting the check boxes as illustrated above, entering the devices number and
clicking the Subscribe button, the agent can be logged into the Contact Center. In this
example, the device address +1122 has been entered under the Telefony field.
Note: Each Telefony call numbers requires a leading +
From the Phone tab, Telephony functions can be tested.
05 2016
420
By clicking the Subscribe button, the device defined in the ContainerId field in this
example +1122 is monitored. By clicking the Dial button, the number entered as the
target for example +1123, is dialed.
05 2016
421
1123 is an internal call number and due to the substitution rules of the used test system,
1123 has been converted to 49 40 2392 1123.
05 2016
422
Use of License
As defined within WebLM.
https:/<WeblmServerName>:8443/WebLM/weblmviewstandardlic.jsp?product=CIE&id=
weblm.pagesidebar.main.menu.licensedproducts|{standard.product.name}
05 2016
423
Salesforce
Introduction
The IP Office Contact Center Salesforce Application (ISA) integrates the Salesforce
CRM Application with IP Office Contact Center. By using ISA, contact center agents can
use the Salesforce CRM application as their primary user interface. Therefore an agent
can handle voice calls, even if there is no IP Office Contact Center User interface
installed on the agents desktop.
ISA will be installed and configured on Salesforce, while CRM Connector is installed
and configured on the IP Office Contact Center Server. The agent will access the
Salesforce CRM application via their web browser. ISA can be deployed as a Console
App, or as a standard App.
Note: Some features such as screen popping, are not supported in standard mode.
Additionally, the standard mode app has limitations, therefore ISA should be deployed
in Console mode only.
Term
CRM
IPOCC
CTI
ISA
WSC
Description
Customer Relationship Management
IP Office Contact Center
Computer-Telephony Integration
IP Office Contact Center Salesforce Application
Web Services Collection
Planning Checklist
# Task
1 Ensure that a
Salesforce login
account is created to
access Salesforce.
Description
This is required to
allow the IP Office
Contact Center
agent to login to
the Salesforce
platform.
IP Office Contact
Center version
9.1.6 FP is
required
Notes
Supported editions of Salesforce
are Enterprise Edition, Unlimited
Edition, Performance Edition
and Developer Edition. Service
cloud capability must be
available to agents.
If the customer has an existing
9.0.X system or 9.1.0 system,
the server will require upgrading
to IP Office Contact Center 9.1.6
FP. Please refer to the IP Office
9.1.6 FP Maintenance Task
Based Guide.
05 2016
424
Supported Browsers
Firefox 32+
Chrome 39+
Supported Features
The following agent functionality is provided in ISA:
Login
Logout
Changing Agent State to Available/Not Available.
Sign-In/Sign-Out to Agent Groups
Answer Call
Release(Drop)
Hold/UnHold
Make Outbound Call
Consult
Transfer
Conference
Job Codes
Wrap-Up
The following Salesforce functionality is provided in ISA:
Call Log
Screen Pop
Click To Dial
IP Office Contact Center Installation
05 2016
425
Install the CRM Salesforce application onto the IP Office Contact Center Server
Configure the CRM Connector properties file
Restart the IP Office Contact Center Watchdog
Install the CRM Salesforce application onto the IP Office Contact Center
Server
1. Prior to Salesforce CRM being installed, the IP Office Contact Center Watchdog
must be stopped. Click the Windows icon and select Run.
Windows
2012 server
05 2016
426
3. Scroll down until the IP Office Contact Center Watchdog service is displayed.
Click the service and then select the Stop link.
05 2016
427
7. Read the End-User License Agreement and click I accept the terms in the
license agreement and then select the Next button.
05 2016
428
05 2016
429
05 2016
430
1. Using the right mouse button, click to Open with on the file.
05 2016
431
Note: The Salesforce session time out value can be obtained by logging into
Salesforce, and navigating to Setup>Security Controls>Session Settings>Timeout
value
The Salesforce session timeout value is specified in hours. The default Salesforce
Session timeout value is 2 hours.
4. Click the X button to close.
05 2016
432
6. For the new Salesforce CRM connector to start, the IP Office Contact Center
Watchdog must be started. Click the Windows icon and select Run.
Windows
2012 server
05 2016
433
8. Scroll down until you can see the IP Office Contact Center Watchdog service.
Click the service and then click the Start button.
05 2016
434
Installing ISA
1. Ensure you are logged into Salesforce. The ISA package link is provided in the
release notes shipped with the IP Office Contact Center software.
2. Once you access the package URL, click the Continue button.
05 2016
435
Configuring ISA
The following steps are required for the configuration of ISA:.
1.
2.
3.
4.
05 2016
436
05 2016
437
7. Browse to the logo files location, select the file and then click the Open button.
05 2016
438
8. Click the Save button. The document (image file) has been uploaded.
05 2016
439
2. Under Setup, navigate to Build -> Create -> Apps, as illustrated below.
3. When Apps is selected, the following screen is displayed. Click the New button.
05 2016
440
5. Enter an App Label and App Name for the Console App as per the conventions
of your organization.
6. To provide a logo for the app, click Insert an Image. This is not mandatory. If a
logo is not required at this time, go to step 16.
7. Select the uploaded document for your logo. If the logo document is not
displayed, please recheck the format of your document.
05 2016
441
9. Select the Navigation Tab items to be displayed in console mode, then click the
Next button.
05 2016
442
10. Click the required radio buttons to determine how records will be displayed and
then click the Next button.
11. Select the Profiles to be used with the new application and then click the Save
button.
Next assign to profiles.
05 2016
443
12. The App configuration data will be saved. The app can be selected from the
Salesforce menu, which is available from the top right of the interface.
13. Once the console app (ISA Console in this case) is selected, your screen layout
will change. Further changes to the layout will occur, if additional configuration is
completed. Observe the area at the bottom right hand side. You will notice a
Phone icon, with the text Phone.
05 2016
444
14. Click on Phone, the softphone will pop. If IP Office Contact Center is
configured, the login screen is displayed as, illustrated below.
05 2016
445
2. A getting started screen maybe displayed. If so, click the Continue button.
4. Edit the Field below, and the click the Save button.
05 2016
446
5. Enter the IP Address of the IP Office Contact Center Server. Edit the port
number, as provided in CRM Connector. The default value is 28443.
05 2016
447
E. Use Directory for Contact Details. When enabled for internal calls, ISA will
display contact information, by searching the Contact Center Directory. Directory
Numbers are required for this function to be utilized.
F. Access code for external OutCC. This code is used for outbound dialing.
6. Each agent who requires access to the ISA must be defined. From the
Administer interface, click Manage Users followed by Users.
7. Click the Edit button adjacent to the required user.
8. To make the application available to that user, in the user configuration interface,
edit the Call Center field and select the Call Center look up button.
05 2016
448
05 2016
449
3. Select the Is Default Layout checkbox. From the Select Call Type drop down
box, select Inbound.
05 2016
450
4. Click the options to be displayed for a call from Caller ID, Dialed Number.
6. An Account look up only displays one account. If multiple matches are found,
only the Account name is displayed. Account look up search parameters can be
added from the Available field to the Selections field.
05 2016
451
7. A Contact look up only displays one contact. If multiple matches are found only
the contact Name is displayed. Contact look up search parameters can be added
from the Available field to the Selections field.
8. A Lead look up only displays one Lead. If multiple matches are found only the
contact lead Name is displayed. Lead look up search parameters can be added
from the Available field to the Selections field.
Determines where the screen pop will occur. It can pop within the existing
browser window, or it can pop into a new browser tab. (If the browser being used
does not support tabs, it can pop into a new browser window).
05 2016
452
Determines what action will commence if no matches are found. The options are
to have no pop at all, or to pop to a new Salesforce object (e.g. a new Contact)
Determines the action to perform with a unique match. The supported options
are:
o Dont pop any screen
o Pop detail page
Determines the action to perform when multiple matches occur. The supported
options are:
o Dont pop any screen
o Pop to search page
05 2016
453
1. Once the required settings have been defined, click the Save button. ISA is now
available to those agents.
05 2016
454
05 2016
455
Note: If the internet connection is via a proxy, an exception needs to be added in the
browser for IP Office Contact Center Server. Unexpected Connection failures can
occur over a proxy connection.
Login to Salesforce using the Salesforce URL.
Login to ISA
Once the agent has logged into Salesforce, the IP Office Contact Center Salesforce
App(ISA) will be loaded in the bottom right side of the browser, as illustrated below.
NOTE: Salesforce provides a variety of default dummy data. Therefore a number of
default records may initially be displayed, in addition to your own records.
The agent must click on the Phone button to pop ISA.
05 2016
456
05 2016
457
05 2016
458
Note: The Agent State is visible on the top right, as a select option widget. The green
icon indicates that the agent is available. The red icon indicates that the agent is on
breaktime. The state of the agent can also be updated by the Supervisor or the Agent
themselves from the IP Office Contact Center User Interface. The changes are reflected
in ISA.
05 2016
459
Receiving Calls
After successful login, Agents can receive incoming calls. When an incoming call is
presented to the agent, the Call Pickup button will be illuminated green. It will also
blink. Details about the incoming call are also displayed, as illustrated below.
A. Topic Name
B. Call Direction
C. Caller Name
D. Phone Number
E. Call Type
F. Call Alert Indicator
An Agent can accept a call by clicking on the Call Pickup button. Once the call is
answered, the conversation starts and the screen is updated as illustrated. The duration
and direction of the call is shown along with incoming contact details. The incoming
Contact must be pre-configured in Salesforce, otherwise the contact will be shown as
Unknown.
05 2016
460
Hold/UnHold
A Call can be put on hold by the agent or the other party. The Agent can put the call on
hold, by clicking on the Hold button. Once the call is placed on hold, the Hold button is
illuminated. The call status will also be modified.
The call can be taken off hold, by once again clicking the Hold button The status of the
call will change accordingly.
Drop Call
To drop/release a call, click on the Call Release button. The buttons color will change
to Red.
05 2016
461
Outbound Call
To make an outbound call, click on the Dial Pad button. A dialog box appears. Select
whether an internal or external number is to be dialed. In the Dial dialog box, enter the
number to be dialed, and then click the Dial button.
Once the Dial button is clicked, the dialog disappears and the status of the call and the
called party is displayed.
05 2016
462
Once the other party accepts the call, the call is connected. The call status is updated to
Conversation, as illustrated below.
Consult
During an ongoing call, an agent may wish to discuss/consult the call with another
agent. The agent clicks the Consult button. On clicking the consult button, a dialog box
opens.
05 2016
463
The agent enters the number of the extension to be consulted, and then clicks Dial. The
current call is placed on Hold. The status of the consult call is displayed.
A. The original call is placed on hold
B. Consult call
Once the other agent accepts the call, the conversation commences, as illustrated
below
05 2016
464
During the consult call (or between any two calls), the agent can switch between the
calls by clicking on the respective call area panel.
A. First Call Area
B. Second Call Area
After the consult call is completed, the agent clicks on the Call Release button. The
consult call is ended.
Note: Ensure that the consult call is the active call.
When the consult call ends, the original call is still in a Hold state. Therefore to
unhold the call the agent must once again click the Hold button.
To end the call, click the Call Release button.
IP Office Contact Center Installation
05 2016
465
Transfer
To Transfer an existing call, the agent clicks the Dial Pad button, enters the number to
which the call is to be transferred. The original call is automatically placed on hold.
Once the other party has picked up the call, the call is connected. To complete the
transfer process, click the Transfer button.
Once the transfer button is clicked, the call is transferred from the agent.
Conference
During an ongoing call, an agent can conference another agent to join the call. The
agent clicks the Dial Pad button and dials the third party. The original call goes on
Hold.
When the other party accepts the call, they are ready to join the conference with the
original agent and the caller.
05 2016
466
To join these two calls in a conference, the agent clicks Conference button.
If the agent wishes to add another party into the conference, they follow the same
process. i.e. dial the number, connect the call and then click on the Conference button.
To drop out of the conference, click the Call Release button.
Job Codes
An Agent can add Job Codes relating to the call, by clicking on the Job Code button.
After clicking on the button, the agent will see a pop-up dialog as illustrated below.
05 2016
467
The agent can select the Job Code from the list and click Send. Job codes can be
manually added by entering the code in the box, clicking Add, and then selecting the
code and clicking Send.
Wrap-Up
If wrap up is configured, an Agent enters the wrap-up state after the call ends. By
clicking on the wrap-up button, the agent can end the Wrap up. When the agent is in
wrap-up, the timer shows the period left before wrap-up will expire.
Logout
To logout, click the Logout button.
05 2016
468
Call Log
By default, completed calls are logged and saved in Salesforce, when the
corresponding contact object is available.
If the incoming contact number is present in multiple objects of same or different type,
the call log will not be saved.
Calls logs for incomplete/abandoned calls will not be saved.
Call logs are saved to Salesforce Task object of the Contact.
The following fields are saved by ISA in Call logs.
o Contact id
o Subject (the default value "CALL" will be stored)
o Status- will always be stored as completed state
o Phone and email id will automatically be updated from contact
o Duration (in seconds)
o Call Type
Call Logs will always be displayed in the activity history of the contact.
Note: Call Logs are not a replacement for IP Office Contact Center call related reports.
The two are independent of each other. Salesforce Call logs, saves or updates the Task
object in Salesforce. Salesforce will only have information related to the current
User/Agent.
Topic Call : An inbound topic call initiated from customer will be saved in call log. The
topic call will be visible in comments field and will be saved in following format Topic
call - <topicnumber>
Screen Pop
Configure the softphone layout option as given under the Configuring Softphone
Layout section of this guide. Once the configuration is in place, the screen pop on calls
feature is enabled.
Note: Screen pop will occur on Inbound, and Outbound calls. The Phone Number
(Dialed or Incoming) will be used as the key to search for Salesforce objects.
Note: Screen Pop is not supported in Standard mode.
Known Issues:
IP Office Contact Center Installation
05 2016
469
After screen pop occurs, Salesforce doesnt relinquish User Interface control to IP
Office Contact Center Salesforce App. Consequently the Agent is not able to type
anything in ISA dial pad. The workaround is that the Agent needs to click once in
Salesforce area, and then click on ISA.
https://success.salesforce.com/issues_view?id=a1p30000000SyTGAA0
Uninstalling the ISA Application
1. To uninstall the application, click on Setup and navigate to Build, followed by
Installed Packages.
2. Click on Installed Packages.
05 2016
470
05 2016
471
6. The uninstall process can take a number of minutes to complete. The status of
the package is displayed in the Uninstalled Packages panel.
7. To completely remove the package, click the Del button. The package is deleted
from the SFDC a/c.
If a user is logged into the ISA App User Interface and is logged off from the
Telephony via Supervisor console or Agent console of the Contact Center User
Interface, the user will automatically be logged off from ISA App User Interface.
The following message is displayed: "Agent was logged off via Supervisor
console or via external endpoint."
If a user is logged off from the ISA App User Interface, the user is also logged off
from the Telephony in the Contact Center User Interface.
If a user is logged into the ISA App User Interface and is in idle state for a period
of 60 minutes, then session timeout occurs from the CRM Connector. In this
05 2016
472
case, the user is automatically logged off the User Interface and the following
message is displayed: "IPOCC Server session timed out for the logged in Agent."
If a user is logged into the ISA App User Interface and the network connection is
lost and they then attempt to use the interface for example, to dial a number, the
user is automatically logged out of the user Interface and the following message
is displayed: "Connection to IPOCC Server was closed or lost unexpectedly".
o A user will only receive a connection lost message when they perform an
operation via the interface, as the web socket connection is alive and
remains so for a long period, believing that connection will be restored.
Therefore the App is not notified of the loss of connection, until a request
is sent to server.
If the CRMConnector is already installed and the IP Office Contact Center Server
is upgraded, the CRMConnector will not be upgraded. The CRMConnector
would therefore require to be manually upgraded in a similar manner to a fresh
installation.
05 2016
473
Security
Port Usage Tables
Port Usage Table Heading Definitions
Source System: System name or type that initiate connection requests.
Source Port: This is the default layer-4 port number of the connection source.
Valid values include: 0 65535. A (C) next to the port number means that the
port number is configurable.
Destination System: System name or type that receives connection requests.
Destination Port: This is the default layer-4 port number to which the connection
request is sent. Valid values include: 0 65535. A (C) next to the port number
means that the port number is configurable.
Network/Application Protocol: This is the name associated with the layer-4 protocol
and layers-5-7 application.
Optionally Enabled / Disabled: This field indicates whether customers can
enable or disable a layer-4 port changing its default port setting. Valid values
include: Yes or No
No means the default port state cannot be changed (e.g. enable or disabled).
Yes means the default port state can be changed and that the port can either be
enabled or disabled.
Default Port State: A port is either open, closed or filtered.
Open ports will respond to queries
Closed ports may or may not respond to queries and are only listed when they can be
optionally enabled.
Filtered ports can be open or closed. Filtered UDP ports will not respond to queries.
Filtered TCP will respond to queries, but will not allow connectivity.
Description: Connection details. Add a reference to refer to the Notes section
after each table for specifics on any of the row data, if necessary.
Below
are
the
tables
which
document
the
port
usage
for
this
05 2016
product.
474
Destination
Port
(Configurable
Range)
IP Office Contact
Center
25
SMTP
25
IP Office Contact
Center
110
POP3
110
IP Office Contact
Center
143
IMAP
143
IP Office Contact
Center
389
IP Office Contact
Center
465
SMTPS
465
IP Office Contact
Center
587
SMTP
587
IP Office Contact
Center
993
IMAPS
993
IP Office Contact
Center
995
POP3S
995
IP Office Contact
Center
2525
System
SMTP
IP Office
Contact Center
POP3
IP Office
Contact Center
IMAP
IP Office
Contact Center
LDAP
SMTPS
IP Office
Contact Center
SMTP
IP Office
Contact Center
IMAPS
IP Office
Contact Center
POP3S
IP Office
Contact Center
SMTP
Network /
Application
Protocol
Optionally
Enabled /
Disabled?
Default Port
State
Description
25
TCP
Yes
Open
25
TCP
Yes
Open
110
TCP
Yes
Open
POP3IMAP4_connector (POP3)
110
TCP
Yes
Open
POP3IMAP4_connector (POP3)
143
TCP
Yes
Open
143
TCP
Yes
Open
389
TCP
Yes
Open
465
TCP
Yes
Open
465
TCP
Yes
Open
587
TCP
Yes
Open
587
TCP
Yes
Open
993
TCP
Yes
Open
993
TCP
Yes
Open
995
TCP
Yes
Open
995
TCP
Yes
Open
2525
TCP
Yes
Open
Port
(Configurable
Range)
POP3IMAP4_connector (IMAP)
POP3IMAP4_connector (IMAP)
POP3IMAP4_connector (IMAP)
POP3IMAP4_connector (IMAP)
POP3IMAP4_connector (POP3)
POP3IMAP4_connector (POP3)
C3000, SMTP module (only used in our
Google cloud product - SendGrid)
Source
System
Destination
Port
(Configurable
Range)
System
IP Office
Contact Center
Network /
Application
Protocol
Optionally
Enabled /
Disabled?
Default Port
State
Description
2809
TCP
Yes
Open
5056
TCP
Yes
Open
5060
TCP
Yes
Open
Port
(Configurable
Range)
User Interface
2809
IP Office Contact
Center
5056
IP Office Contact
Center
5060
IP Office
5100
IP Office
Contact Center
5100
TCP
Yes
Open
IP Office Contact
Center
5222
XMPP
(External or
IP Office)
5222
TCP
Yes
Open
XMPP
(External or
IP Office)
5222
IP Office
Contact Center
5222
TCP
Yes
Open
IP Office Contact
Center
5223
XMPP
(External Only)
5223
TCP
Yes
Open
XMPP
(External only)
5223
IP Office
Contact Center
5223
TCP
Yes
Open
PostgreSQL
5432
5432
TCP
Yes
Open
IP Office Contact
Center
7070
7070
TCP
HTTP
HTTPS
No
Open
IP Office
IP Office
Database
IP Office
8080
8080
TCP
IP Office
Contact Center
User Interface
No
05 2016
Open
476
Source
System
Destination
Port
(Configurable
Range)
IP Office Contact
Center
8443
IP Office Contact
Center
8443
System
IP Office
WebLM
Network /
Application
Protocol
Optionally
Enabled /
Disabled?
Default Port
State
Description
8443
TCP/HTTPS
No
Open
IP500V2 SyncProcess
Core WebApplications (HTTPS Port)
8443
TCP/HTTPS
No
Open
8443
TCP
No
Open
10001
TCP
No
Open
10300
TCP
No
Open
Port
(Configurable
Range)
WebLM
User Interface
8443
IP Office Contact
Center
10001
Watchdog
IP Office
Contact Center
User Interface
10300
TTrace Console
10300
IP Office
Contact Center
10300
TCP
No
Open
TTrace Console
10301
IP Office
Contact Center
10301
TCP
No
Open
TTrace Console
10302
IP Office
Contact Center
10302
TCP
No
Open
IP Office Contact
Center
18080
18080
TCP/HTTP
No
Open
IP Office Contact
Center
18443
18443
TCP/HTTPS
No
Open
TomCat
TomCat
IP Office
Contact Center
Web Admin
CRM Connector
Wallboard/DirectWS
WebUI (ChromeApp
and Browsers)
StatViewer
WebChatDialog
28080
Web Admin
28443
IP Office
Contact Center
WebLM
WebLM
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
direction
Internal
Trace
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
direction
Trace
Console
Data
Web Service Collection
Web Service Collection
TomCat
28080
TCP/HTTP
No
Open
28443
TCP/HTTPS
No
Open
05 2016
477
TomCat
Source
System
Destination
Port
(Configurable
Range)
System
Port
(Configurable
Range)
Network /
Application
Protocol
Optionally
Enabled /
Disabled?
Default Port
State
RTP/UDP
No
Open
Description
CRM Connector
Wallboard/DirectWS
WebUI (ChromeApp
and Browsers)
StatViewer
WebChatDialog
IP Office
40750-50750
IP Office
Contact Center
49152-53247
IP Office
Contact Center
User Interface
49901
49901
TCP
No
Open
Autodialer service
Used by IPOCC UI
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
direction
Open
Open
Open
callflow configuration
Used by IPOCC UI
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
direction
Open
IP Office
Contact Center
User Interface
49906
49906
TCP
No
IP Office
Contact Center
User Interface
49910
49910
TCP
No
IP Office
Contact Center
User Interface
49919
49919
TCP
No
IP Office
Contact Center
User Interface
49921
49921
TCP
No
05 2016
478
Source
System
Destination
Port
(Configurable
Range)
System
Port
(Configurable
Range)
Network /
Application
Protocol
Optionally
Enabled /
Disabled?
Default Port
State
Description
IP Office Contact
Center
49922
IP Office
Contact Center
49922
TCP
No
Open
Internal
UM database access service
IP Office Contact
Center
49923
IP Office
Contact Center
49923
TCP
No
Open
Internal
UM database access service
Monitoring Service
Used by IPOCC UI
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
direction
IP Office
Contact Center
User Interface
49924
User Interface
49940
IP Office Contact
Center
50796
IP Office Contact
Center
50797
49924
TCP
No
Open
IP Office
Contact Center
49940
TCP
No
Open
50796
TCP
Yes
Open
50797
TCP
Yes
Open
User Interface
51000
51000
TCP
No
User Interface
User Interface
51011
User Interface
51013
IP Office
Contact Center
IP Office
Contact Center
Messaging service
Used by IPOCC UI and Chrome App
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
direction
TCP
No
Open
51011
TCP
No
Open
51013
TCP
No
Open
479
IP Office port
Open
51001 51003
05 2016
IP Office port
UI SessionManager (UMR-Client,
StatViewer, TRViewer)
Used by IPOCC UI, Chrome App and
WSC
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
direction
IP Office
Contact Center
51001 51003
IPO Taskserver
UMR Admin
User Interface observes Addressbook
Admin Application.
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
Source
System
Destination
Port
(Configurable
Range)
System
Port
(Configurable
Range)
Network /
Application
Protocol
Optionally
Enabled /
Disabled?
Default Port
State
Description
direction
IP Office
Contact Center
User Interface
51014
51014
TCP
No
Open
IP Office
Contact Center
User Interface
51015
IP Office
Contact Center
51015
TCP
No
Open
Addressbook server
Used by IPOCC UI
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
direction
52000
TCP
No
Open
Chat Taskserver
Using CORBA Bidirectional GIOP.
Firewalls must open this port in both
direction
User Interface
52000
Web Service
Application
52100-52109
IP Office
Contact Center
52100-52109
HTTP
No
Open
Web Service
Application
52110-52119
IP Office
Contact Center
52110-52119
HTTP
No
Open
Web Service
Application
52120-52129
IP Office
Contact Center
52120-52129
HTTP
No
Open
Web Service
Application
52130-52139
IP Office
Contact Center
52130-52139
HTTP
No
Open
Web Service
Application
52140-52149
IP Office
Contact Center
52140-52149
HTTP
No
Open
IP Office Contact
Center
52233
52233
TCP
No
Open
WebLM
IP Office
Contact Center
User Interface
53002
User Interface
53009
IP Office
Contact Center
WSC DirectoryWS
WSC TaskWS
WSC MonitoringWS
WSC ManagementWS
WSC UMRWS
Only used in Cloud System
53002
TCP
No
Open
53009
TCP
No
Open
05 2016
480
Source
System
Destination
Port
(Configurable
Range)
System
Port
(Configurable
Range)
Network /
Application
Protocol
Optionally
Enabled /
Disabled?
Default Port
State
Description
53010
Wallboard
55100
IP Office
Contact Center
53010
TCP
No
Open
55100
TCP
No
Open
Destination
Port
System
Network /
Application
Optionally
Protocol
Disabled?
2525
TCP
Port Interface
(Configurable
Range)
SMTP
Description
Yes
Open
Enabled /
IP Office Contact
Center
2525
WebUI (Browsers)
WebChatDialog
28080
IP Office
Contact Center
28080
TCP/HTTP
No
Open
WebUI (Browsers)
WebChatDialog
28443
IP Office
Contact Center
28443
TCP/HTTPS
No
Open
05 2016
481
Interface
User Interface
Description
Home: Displays the home area.
Telephony: Displays the telephony area.
Realtime information: Displays the real time
information area.
Reporting: Displays the reporting area.
Agent Status Reports: Displays the agent
evaluation area.
Contact Detail Reports: Displays the contact
evaluation area.
Error list: Displays the date time, code, and
the error description.
Configuration: Displays the standalone
Configuration module.
UI Config: Displays the UI configuration area.
Task Flow Editor: Displays the standalone
Task flow editor module
IVR Editor: Displays the standalone IVR
editor module.
Dialer: Displays the standalone Dialer
module.
Email Configuration: Displays the Email
administration module.
Text Block Administration: Displays the Text
block administration module.
Address Book Administration: Displays the
Address book configuration module.
IP Office Contact
Center
IP Office Contact
Center
IP Office Contact
Center
IP Office Contact
Center
IP Office Contact
Center
IP Office Contact
Center
IP Office Contact
Center
Web Service
Programming interface
Wallboard
TTrace
WebLM
WebChatDialog
05 2016
483
05 2016
484
Registered Ports
Unlike well known ports, these ports are not restricted to the root user. Less common
services register ports in this range. Avaya uses ports in this range for call control.
Some, but not all, ports used by Avaya in this range include: 1719/1720 for H.323,
5060/5061 for SIP, 2944 for H.248 and others. The registered port range is 1024
49151. Even though a port is registered with an application name, industry often uses
these ports for different applications. Conflicts can occur in an enterprise when a port
with one meaning is used by two servers with different meanings.
Dynamic Ports
Dynamic ports, sometimes called private ports, are available to use for any general
purpose. This means there are no meanings associated with these ports (similar to
RFC 1918 IP Address Usage). These are the safest ports to use because no
application types are linked to these ports. The dynamic port range is 49152 65535.
Sockets
A socket is the pairing of an IP address with a port number. An example would be
192.168.5.17:3009, where 3009 is the socket number associated with the IP address.
A data flow, or conversation, requires two sockets one at the source device and one
at the destination device. The data flow then has two sockets with a total of four logical
elements. Each data flow must be unique. If one of the four elements is unique, the
data flow is unique. The following three data flows are uniquely identified by socket
number and/or IP address.
Data Flow 1:
Data Flow 2:
Data Flow 3:
172.16.16.14:1234
172.16.16.14.1235
172.16.16.14:1234
10.1.2.3:2345
10.1.2.3:2345
10.1.2.4:2345
Data flow 1 has two different port numbers and two different IP addresses and is a valid
and typical socket pair.
Data flow 2 has the same IP addresses and the same port number on the second IP
address as data flow 1, but since the port number on the first socket differs, the data
flow is unique.
Therefore, if one IP address octet changes, or one port number changes, the data flow
is unique.
Socket Example Diagram
Client
HTTP-Get
Source 192.168.1.10:1369
TCP-info
Destination 10.10.10.47:80
Destination 192.168.1.10:1369
Web Server
Source 10.10.10.47:80
05 2016
485
Figure 1. Socket example showing ingress and egress data flows from a PC to a web
server
Notice the client egress stream includes the clients source IP and socket (1369) and
the destination IP and socket (80). The ingress stream has the source and destination
information reversed because the ingress is coming from the server.
Understanding Firewall Types and Policy Creation
Firewall Types
There are three basic firewall types:
Packet Filtering
Firewall Policies
The goals of firewall policies are to monitor, authorize and log data flows and events.
They also restrict access using IP addresses, port numbers and application types and
sub-types.
This paper is focused with identifying the port numbers used by Avaya products so
effective firewall policies can be created without disrupting business communications or
opening unnecessary access into the network.
Knowing that the source column in the following matrices is the socket initiator is key in
building some types of firewall policies. Some firewalls can be configured to
automatically create a return path through the firewall if the initiating source is allowed
IP Office Contact Center Installation
05 2016
486
through. This option removes the need to enter two firewall rules, one for each stream
direction, but can also raise security concerns.
Another feature of some firewalls is to create an umbrella policy that allows access for
many independent data flows using a common higher layer attribute. Finally, many
firewall policies can be avoided by placing endpoints and the servers that serve those
endpoints in the same firewall zone.
Windows
2012 server
2. Double left click on Event Viewer.
05 2016
487
05 2016
488
5. Click Security.
05 2016
489
05 2016
490
Details tab.
05 2016
491
05 2016
492
OVA Deployment
Requirements for implementation IP Office Contact Center as OVA
For details relating to the recommended specifications for the installation of IP Office
Contact Center utilising OVA on VMWare, refer to the IP Office Contact Center
Reference Configuration Guide.
Note: The OVA available from Avaya is based on Windows Server 2012.There is no
Windows Server 2008 R2 OVA available from Avaya.
Note: As IP Office Contact Center 9.1.6 does not have any new OVA provision, OVA
deployments should therefore use IP Office Contact Center 9.1 GA OVA and the
applications upgraded to IP Office Contact Center 9.1.6
The installation of the IP Office utilizing OVA on VMWare includes the following main
steps:
1.
2.
3.
4.
5.
6.
05 2016
493
8. On servers desktop you will find a number of useful shortcuts and a document
readme.rtf, which contains detailed instructions of the next configuration steps.
Steps after OVA Deployment
2. Setup Network:
9. In the System Tray the Network and Sharing Center is marked with an
exclamation point.
10. Right click and open Network and Sharing Center.
11. Click Ethernet and then Properties.
12. Remove the check from Internet Protocol Version 6 (TCP/IPv6) check box.
13. Select Internet Protocol Version 4 (TCP/IPv4).
14. Click Properties.
Note: DO NOT enable 'Obtain an IP address automatically'!
15. Enter the required IP address settings by completing the Use the following IP
address fields. According to your networking topology, adjust the IP address,
Subnet mask, Default gateway and Preferred DNS server settings..
16. Confirm by pressing OK
17. Press the Close button (twice).
3. Set Computer Name
18. Using the keyboard, press the Windows Key together with e.
19. With the explorer right-click on This PC and select Properties.
20. Behind Computer name click Change settings.
21. Click the Change button.
22. Change the Computer name as required and click OK. Use only computer
names with numbers (0-9) and letters (A-Z, a-z), no special characters can be
used!
23. Confirm the Popup window You must restart your computer to apply these
changes. At this point, continue without rebooting.
24. Press the OK button.
25. In the Popup window named You must restart your computer to apply these
changes click Restart Later.
4. Activate Windows
26. Click Activate Windows
27. Enter your Product key and then click Activate Windows.
28. Close all windows and reboot the server!
29. After reboot mark your new network as Private Network. Please note that in a
Private network the IP Office Contact Center server will not reply to any Ping
requests although Remote Desktop sessions to the servers will still be
connected.
5. Apply Changes to IP Office Contact Center
30. After the reboot has completed, log back in and open Services and stop the IP
Office Contact Center Watchdog service.
31. Click on the servers Windows button.
05 2016
494
Windows
2012 server
Windows
2012 server
05 2016
495
34. Select the IPOCC Watchdog service and then click on the Stop link.
05 2016
496
36. This is indicated by only a Start link being displayed in relation to the
Watchdog Service.
05 2016
497
39. Wait while configuration is prepared. As soon as you are presented with dialog
enter password for Database Access. User: sa, Password: Administrator.
40. Click Apply.
41. Wait for completion of the AdjustHostname utility and then reboot the server!
6. Install IP Office Contact Center Licenses
Refer to the Licensing section of this guide.
7. Import Configuration data in the IP Office and IP Office Contact Center
Refer to the Preparing the Configuration Data For Use with the Excel Spread
Sheet section of this guide.
Or
Use the Configuration Wizard Refer to the Configuration Wizard System
Configuration Page section of this guide.
Troubleshooting after OVA Installation
If during the OVA installation the new network is marked as Public Network you will not
be able to ping the server or make a remote connection to the IP Office Contact Center
server.
If you have forgotten to mark your new network as Private Network, after the server
has restarted, you can re-mark from a Public to Private Network as follows:
:
1. Open Windows PowerShell by selecting the Windows button.
Windows
2012 server
05 2016
498
Windows
2012 server
4. The profile can be checked to validate that the changes have been made by
using this command
Get-NetConnectionProfile
05 2016
499
05 2016
500
Avaya Documentation
http://support.avaya.com/
Avaya IP Office Contact Center Task Based Guides
IP Office Contact Center Configuration Maps
Please note, only the IP Office Contact Center Task Based Guides listed above are
available from Avaya. Further IP Office Task Based Guide documentation as listed
below is available directly from ITEL. http://www.iteluk.com/
ITEL IP Office Task Based Guides
Initial Installation
1.
2.
3.
4.
5.
6.
7.
8.
9.
05 2016
501
Voicemail Pro
24. IP Office Voicemail Pro Summary Guide
25. IP Office Voicemail Pro Voicemail User Guide
One X Portal & IP Office Applications
26. IP Office One X Portal Guide
27. IP Office One X Mobile Preferred Implementation
28. IP Office Plug-in for Microsoft Outlook
29. IP Office MS Lync Plugin
30. IP Office Avaya Flare
31. IP Office One X Mobile Essential
Customer Call Reporter CCR
32. IP Office Customer Call Reporter Configuration Guide
33. IP Office Customer Call Reporter Wallboard Guide
Contact Store & Receptionist Console
34. IP Office Contact Store
35. IP Office Receptionist Console
Maintenance
05 2016
502
05 2016
503