This document provides installation instructions for Unified CCE 12.6(2) ES55. It also contains a list of Unified CCE issues resolved by this engineering special. Review all installation information before installing the product. Failure to install this engineering special as described can result in inconsistent Unified CCE behavior. This ES is applicable to both Unified CCE and Packaged CCE deployments.
This document contains these sections:
In the Product
Alert Tool, you can set up profiles to receive email notification of new
Field Notices, Product Alerts, or End of Sale information for your selected
products.
The Product
Alert Tool is available at https://www.cisco.com/cisco/support/notifications.html.
The Engineering Special (ES) is a cumulative update applied at the
Unified Contact Center Enterprise (CCE) server level. Each ES includes all
features, security patches, and resolved caveats from the base release,
tailored to specific server roles within the system. The ES packages are
categorized as follows:
Each ES is cumulative within its specific category. These ES
packages are released quarterly, but only if updates are available for that
category. If no changes are required for a category in a given quarter, an ES
for that category will not be issued.
To ensure the latest patches are applied:
Example:
If both Router/Logger/Rogger updates and Common ES
changes are required, first install the Router/Logger/Rogger
ES, followed by the Common ES to ensure all components are up-to-date.
This section lists the Unified CCE components on which you can and cannot install this Engineering Special.
You can install Unified CCE 12.6(2) ES55 on these Unified CCE component(s):
Do not install this engineering special on any components other than the following:
Note: AW corresponding to Router, Logger should be upgraded at the same time as Router and Logger.
To install Unified CCE 12.6(2) ES55, follow the steps:
1. Download the patch and copy the patch to the local server where patch is going to be installed.
2. Stop all ICM services and applications running on the server.
3. Run the patch installer exe and follow the instructions.
4. Reboot the server on successful completion of the patch install.
5. Start the ICM services.
If the Unified CCE Services are set to manual, using the Unified CCE Service Control, start all the Unified CCE Services.
NOTE: If needed to uninstall this ES permanently the tomcat version
should be 9.0.89 or lower. If the system has the higher version of tomcat,
downgrade it before uninstalling this ES
To uninstall Unified CCE 12.6(2) ES55, follow the steps:
Note: Remove patches in the reverse order of their installation. For example, if you installed patches 3, then 5, then 10 for a product, you must uninstall patches 10, 5, and 3, in that order, to remove the patches from that product.
Updated Features
Graceful shutdown
The Graceful shutdown feature allows you to perform maintenance activity such as firmware upgrades, apply security patches, and apply engineering specials (ES) without the need for a maintenance window. With this feature, actively used processes can be brought down while the backup processes take over, with minimal impact to the contact center day-to-day (Day 2) operations. Agent and supervisor states, call states, and call context can be maintained. Operations such as reskilling and changing an agent's team membership are not affected.
The Unified CCE core components for managing call and agent states, such as the Unified CCE Router, PGs, CTI Server, and Outbound Option Dialer, are duplexed. The duplex nature of these components means that the peer side can recover call and agent states and continue processing if any process in one side stops. While the peer side recovers call and agent states, it may not recover all information about call context.
The Unified CCE Logger and AW-HDS do not contribute directly to real time call and agent state activities. If one side of the Unified CCE Logger or AW-HDS stops, it can recover its state from its peer when it starts back up.
Once maintenance activity is done on one side, services can be started so that newly started side receive call and agent states from running side. Later other side can be gracefully shutdown for maintenance activity.
Dynamic state transfer
The Unified CCE core components transfer the running state to the other side for synchronous fault tolerant operation. This ensures that other side of the components uses the state and continue to process the calls, tasks, configuration, agent state from that point. The critical requirement for synchronous operation is to run both sides of applications with the same version of binary. During upgrade, both will not be on the same version, hence the complete service has to be brought down temporarily. With ES53 installed, transfer of state is allowed to the peer side without requiring a downtime, this allows the system to upgrade without a downtime and upgrades side continue to operate from an running state. This feature can be leveraged when upgrading the next ES on the system and applicable to the below components.
· Unified CCE Router
· Unified CCE Enterprise PG
· Unified CCE Media Routing (MR) PG
· Unified CCE Outbound Option Dialer
Unified CCE Enterprise Router Graceful
shutdown
With ES53 changes needed to support graceful shutdown on Router are added. When you invoke graceful shutdown on a side on Router, it performs checks whether other side can continue to handle calls, agent states etc once this side is shutdown.
Graceful shutdown on Router also shuts down Logger service on same box.
The request to graceful shutdown to the Router is rejected in following cases
· Router is running in simplex mode
· Other side would not have device majority once this side is shutdown
Limitations
When stopping one side of Router service, database and application gateway lookup may fail. This error condition can be appropriately handled in the routing script. If you are using the Outbound API to perform a bulk import of customer records during Logger shutdown, it may not complete. If you are running overwrite imports, you may need to rerun the import. If you are running append imports, some of the records may have been imported. You can either import the remaining records or delete the records and reimport them all.
PG graceful shutdown is improved to handle cases when there is state change in engineering special (ES). With this PG can be gracefully shutdown whether there is state change in engineering special or not.
Note: For more information, see the Graceful Shutdown section in the following guides:
· Administration Guide for Cisco Unified Contact Center Enterprise Release, 12.6(2) at https://www.cisco.com/c/en/us/support/customer-collaboration/unified-contact-center-enterprise/products-maintenance-guides-list.html
· Cisco Packaged Contact Center Enterprise Administration and Configuration Guide Release, 12.6(2) at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-maintenance-guides-list.html
This section provides a list of significant Unified CCE defects resolved by this engineering special. It contains these subsections:
This section lists caveats specifically resolved by Unified CCE 12.6(2) ES55.
Caveats in this section are ordered by Unified CCE component, severity, and then identifier.
|
Identifier |
Severity |
Component |
Headline |
ES Dependency |
|
CSCwj99951 |
2 |
dbconfig |
No
option to reload inventory.csv file if provided wrong info in inventory.csv
of Lab mode simplex. |
|
|
CSCwm10551 |
2 |
web.config.api |
The
standby campaign manager is crashing when processing replication file |
ES53
on Router |
|
CSCwf20752 |
2 |
scripteditor |
Issues
with ISE slowness when using different domain user with restricted access |
ES53
on Router |
|
CSCwk81097 |
2 |
aw.tools |
Tomcat
Upgrade to 9.0.90 and above causes tomcat service to crash |
|
|
CSCwi20694 |
2 |
db.logger |
Repeated
Open mutex errors in the logger process get filled and 100% CPU usage. |
ES53
on Router, ES54 on PG |
|
CSCwj90104 |
3 |
dbconfig |
Same
MsgBusId 797 in PCCE DB causes both CVP services to
fail to come up after synch from SPOG |
|
|
CSCwj94443 |
3 |
dbconfig |
PCCE
12.6(2) unable to add Voice gateway Using SSH |
|
|
CSCwk95118 |
3 |
dbconfig |
System_Attribute configuration update goes on loop every 5 secs |
|
|
CSCwm36545 |
3 |
dbconfig |
PCCE
15.0 - Simplex 2K Lab Mode (Fresh Install) : CUIC Live Data Source is unable
to become active. |
|
|
CSCwi67236 |
3 |
web.config.api |
Campaign
reservationPercentage is updated, although its was not set in update body |
|
|
CSCwi67276 |
3 |
web.config.api |
SSL
connections to outbound components fail when ICM key-store is empty |
|
|
CSCwk90933 |
3 |
web.config.api |
Enhance
Tomcat to Restart Only After Persistent WaitNamedPipe
Error for Over 3 Minutes |
|
|
CSCwk91735 |
3 |
web.config.api |
SSO
enabled Supervisors not able to access Phonebooks in SPOG |
|
|
CSCwi67716 |
3 |
web.config.ui |
Browser
refresh results into auto logout from UCCE session |
|
|
CSCwm08749 |
3 |
web.config.ui |
Agent
Trace Page not loading |
|
|
CSCwm42641 |
3 |
web.config.ui |
serviceability
improvement needed while executing InventoryDBUpdateTask
for TR upgrade |
|
|
CSCwm59279 |
3 |
web.config.ui |
UCCE
Miscellaneous page flickering issue |
|
|
CSCwi17731 |
4 |
web.config.ui |
Precision
Queue Wait Time Not Visible |
|
|
CSCwe68973 |
4 |
scripteditor |
Event
Viewer Logs showing multiple event ID 83 errors while opening ISE |
ES53
on Router |
|
CSCwm27294 |
6 |
web.config.api |
Additional
retry after 10 seconds for Unrecoverable DB error |
This Engineering Special will include the features, resolved caveats from previous Engineering Special released for components on the AW (Admin Workstation). If a prior ES has a dependency on other components of CCE, install the respective ES. Please refer to the Release Notes of previous Quarterly ES here: https://www.cisco.com/web/software/280840583/169154/Release_Document_1.html
Note: You can view more information on and track individual Unified CCE defects using the Cisco Bug Search tool, located at: https://bst.cloudapps.cisco.com/bugsearch/search?null.
You can access current Cisco documentation on the Support pages at the following sites:
To provide comments about this document, send an email message to the following address:
contactcenterproducts_docfeedback@cisco.com
We appreciate your comments.
Cisco.com is a starting point for all technical assistance. Customers and partners can obtain documentation, troubleshooting tips, and sample configurations from online tools. For Cisco.com registered users, additional troubleshooting tools are available from the TAC site.
Cisco.com provides a broad range of features and services to help customers and partners streamline business processes and improve productivity. Through Cisco.com, you can find information about Cisco and our networking solutions, services, and programs. You can also resolve technical issues with online technical support and download software packages. Valuable online skill assessment, training, and certification programs are also available.
Customers and partners can self-register on Cisco.com to obtain additional personalized information and services. Registered users can order products, check on the status of an order, access technical support, and view benefits specific to their relationships with Cisco.
The Cisco TAC site is available to all customers who need technical assistance with a Cisco product or technology that is under warranty or covered by a maintenance contract.
If you have a priority level 3 (P3) or priority level 4 (P4) problem, contact TAC by going to https://www.cisco.com/c/en/us/support/index.html.
P3 and P4 level problems are defined as follows:
In each of the above cases, use the Cisco TAC site to quickly find answers to your questions.
If you cannot resolve your technical issue by using the TAC online resources, Cisco.com registered users can open a case online by using the TAC Case Open tool at the following site: https://mycase.cloudapps.cisco.com/create/start/
If you have a priority level 1(P1) or priority level 2 (P2) problem, contact TAC by telephone and immediately open a case. To obtain a directory of toll-free numbers for your country, go to the following sites:
P1 and P2 level problems are defined as follows: