This document provides installation instructions for Unified CCE 12.5(1) ES21. 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 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.
This section lists the Unified CCE components on which you can and cannot install this engineering special.
You can install Unified CCE 12.5(1) ES21 on these Unified CCE components:
Do not install this engineering special on components other than the following:
Installation of this patch requires the all ICM services to be
shut down during the entire period of installation. It is always recommended to
install this ES during a scheduled downtime.
1. Using
the ICM Service Control, stop all the ICM services running on the system.
2. Launch
the Installer provided for ES21 and follow the instructions on
the screen.
3. Check the version of tomcat installed by running <ICM HOME>\tomcat\bin\version.bat . If its 9.0.37 or higher, then do the following steps
4. Using
the ICM Service Control, start all ICM services again.
Note: The FTP credentials will be lost after patch uninstallation, and this needs to be configured again after uninstallation.
Pre Uninstallation
1.
Login into CCE Web Administration.
2.
Go to inventory.
3.
Disable all the CVP servers which are marked as
media server.
Uninstall Patch
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.
Post uninstallation
4.
Restart ICM box after uninstallation.
5.
Login to CCE Web Administration.
6.
Go to inventory.
7.
Edit one of the CVP machine.
8.
Trigger full sync.
This section provides a list of significant Unified CCE defects resolved by this engineering special. It contains these subsections:
Note: You can view more information on Unified CCE defects and track individual defects by using the Cisco Bug Search tool, located at: https://bst.cloudapps.cisco.com/bugsearch/search?null.
This section lists caveats specifically resolved by Unified CCE 12.5(1) ES21.
Caveats in this section are ordered by UNIFIED CCE component, severity, and then identifier.
| Identifier | Severity | Component | Headline |
|---|---|---|---|
| CSCvt74130 | 2 | dbconfig | PCCE2K Upgrade Wizard error |
| CSCvv12160 | 3 | dbconfig | External HDS save fails from Inventory after component update |
| CSCvv21519 | 3 | dbconfig | CUIC user group membership revoked for bulk user during PCCE sync |
| CSCvu91063 | 6 | dbconfig | PCCE 12.5 4K/12K Deployment Type - Peripheral Gateway API does not work |
| CSCvv04451 | 3 | template | Finesse gadget does not load in cceadmin Device Configuration |
| CSCvu25506 | 2 | web.config.api | Agent create/update with default SkillGroup failing with 500 error |
| CSCvv07804 | 2 | web.config.ui | CCE Administration Unable to Update IDS Subscriber Name |
| CSCvv43901 | 2 | web.config.ui | SPOG does not allow resetting SIGDigits back to 0 |
Caveats are ordered by severity then defect number.
Defect Number: CSCvt74130
Component: dbconfig
Severity: 2
Headline: PCCE2K Upgrade Wizard error
Symptom:
Error is occured, FTP server credentials must be blank when FTP is disabled
Conditions: The issue is hit while configuring the deployment credentials in PCCE2k wizard
Workaround: Update Machine_Service set Pairing='false' where ServiceType=1029;
Further Problem Description: In our PCCE functional testbed, we tried rerunning fresh Install wizard when inventory was not displaying, and we hit the error
Defect Number: CSCvu25506
Component: web.config.api
Severity: 2
Headline: Agent create/update with default SkillGroup failing with 500 errorn>
Defect Number: CSCvv07804
Component: web.config.ui
Severity: 2
Headline: CCE Administration Unable to Update IDS Subscriber Name
Symptom:
IDS Service Secondary server shows with alert.
In the Tomcat logs, messages similar to the following are seen:
0000146424: 10.20.10.10: Jul 20 2020 08:34:07.389 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: Executing VosSubscribersScanTask
0000146425: 10.20.10.10: Jul 20 2020 08:34:07.403 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: Rest call: GET https://10.10.10.50:8553/ids/v1/config/core application/json
0000146426: 10.20.10.10: Jul 20 2020 08:34:07.463 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: Rest call: GET https://10.10.10.50:8553/ids/v1/status?details=full application/json
0000146427: 10.20.10.10: Jul 20 2020 08:34:07.482 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: ids-association: getSubscriberMachineHost returns [10.10.10.151] for 10.10.10.50[5015]
0000146428: 10.20.10.10: Jul 20 2020 08:34:07.483 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: Adding external sub: id=null name=116ids3.css.ccbu.com host=116ids3.css.ccbu.com
0000146429: 10.20.10.10: Jul 20 2020 08:34:07.492 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: Deleting external sub: id=5016 name=116ids2.css.ccbu.com host=116ids2.css.ccbu.com
0000146430: 10.20.10.10: Jul 20 2020 08:34:07.492 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: ==> recordToDelete table name: Machine_Host id: 5016
0000146431: 10.20.10.10: Jul 20 2020 08:34:07.493 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: ==> recordToDelete table name: Machine_Address id: 5016
0000146432: 10.20.10.10: Jul 20 2020 08:34:07.494 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: ==> recordToDelete table name: Machine_Service id: 5061
0000146433: 10.20.10.10: Jul 20 2020 08:34:07.494 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-6-REST_API_INFO: ==> recordToDelete table name: Machine_Service id: 5062
0000146434: 10.20.10.10: Jul 20 2020 08:34:07.496 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-3-REST_API_EXCEPTION: %[exception=java.lang.NullPointerException][message_string=Error executing task VosSubscribersScanTask]: The REST API has caught an exception
0000146435: 10.20.10.10: Jul 20 2020 08:34:07.497 -0700: %CCBU_pool-1-thread-39-Infrastructure-1548628-3-EXCEPTION_INFO: %[build_date=Jul 28, 2017 3:37 PM][build_type=rel][exception=java.lang.NullPointerException
at com.cisco.ccbu.cce.unifiedconfig.api.sso.SsoManager.getUsernameForComponent(SsoManager.java:254)
at com.cisco.ccbu.cce.unifiedconfig.api.sso.SsoManager.getComponentSSOConfig(SsoManager.java:95)
at com.cisco.ccbu.cce.unifiedconfig.api.inventory.VosSubscribersScanTask.getSsoConfiguration(VosSubscribersScanTask.java:265)
at com.cisco.ccbu.cce.unifiedconfig.api.inventory.VosSubscribersScanTask.addSsoConfigAndAddToDeleteList(VosSubscribersScanTask.java:218)
at com.cisco.ccbu.cce.unifiedconfig.api.inventory.VosSubscribersScanTask.updateDatabase(VosSubscribersScanTask.java:200)
at com.cisco.ccbu.cce.unifiedconfig.api.inventory.VosSubscribersScanTask.findAndProcessSubscribersList(VosSubscribersScanTask.java:129)
at com.cisco.ccbu.cce.unifiedconfig.api.inventory.VosSubscribersScanTask.syncIdsSubscribers(VosSubscribersScanTask.java:106)
at com.cisco.ccbu.cce.unifiedconfig.api.inventory.VosSubscribersScanTask.execute(VosSubscribersScanTask.java:64)
at com.cisco.ccbu.cce.unifiedconfig.tasks.TaskBase.call(TaskBase.java:36)
at com.cisco.ccbu.cce.unifiedconfig.tasks.TaskBase.call(TaskBase.java:26)
at com.cisco.ccbu.cce.unifiedconfig.tasks.TaskExecutor.execute(TaskExecutor.java:62)
at com.cisco.ccbu.cce.unifiedconfig.tasks.TaskExecutor.run(TaskExecutor.java:49)
at com.cisco.ccbu.infra.threads.ThreadPoolManager$FixedDelayRunnable.run(ThreadPoolManager.java:793)
at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source)
at java.util.concurrent.FutureTask.run(Unknown Source)
at com.cisco.ccbu.infra.threads.InstrumentedRunnable.run(InstrumentedRunnable.java:92)
at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source)
at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source)
at java.lang.Thread.run(Unknown Source)
at com.cisco.ccbu.infra.threads.ThreadPoolThread.run(ThreadPoolThread.java:164)
Conditions: Following the rename of the IDS Subscriber Node.
Workaround: None at this time.
Defect Number: CSCvv43901
Component: web.config.ui
Severity: 2
Headline: SPOG does not allow resetting SIGDigits back to 0.
Symptom:
On the SPOG 12.5, Device configuration -> CVP call server -> SIP TAB -> SigDigits -> the value here is set as "select" by default, (this will be set as 0 in SIP.property file).
however, when we change this to let's say "4", there is no way to reset it back to 0.
Conditions: When the sigdigit is changed to any value.
Workaround: NA
Further Problem Description: On the SPOG 12.5, Device configuration -> CVP call server -> SIP TAB -> SigDigits -> the value here is set as "select" by default, (this will be set as 0 in SIP.property file).
However, when we change this to let's say "4", there is no way to reset it back to 0.
Defect Number: CSCvv04451
Severity: 3
Headline: Finesse gadget does not load in cceadmin Device Configuration
Defect Number: CSCvv12160 Component: dbconfig Severity: 3 Headline: External HDS save fails from Inventory after component update Defect Number: CSCvv21519 Component: dbconfig Severity: 3 Headline: CUIC user group membership revoked for bulk user during PCCE sync Defect Number: CSCvu91063 Component: dbconfig Severity: 6 Headline: PCCE 12.5 4K/12K Deployment Type - Peripheral Gateway API does not work ES# Identifier Severity Component Headline ES5 CSCvt61292 3 aw.tools ECC CTI variable size check enforcement to be relaxed and a warning be displayed if size is exceeded ES7 CSCvs85018 2 dbconfig Finesse gadget is not loading in CCEAMDIN in PCCE labonly mode ES7 CSCvs64183 3 dbconfig PCCE registration of SSO clients fail in SPOG ES7 CSCvs77949 3 dbconfig Agents with TraceON enabled for 12k is 400 in Doc vs 100 in System Capacity (pcce webadmin) ES7 CSCvs96235 3 dbconfig PCCE exeeded configuration limit should not trigger Service Busy state ES7 CSCvt09634 3 dbconfig PCCE 4K/12K day 1 validations are not exercised for both Main Site and Remote Sites ES7 CSCvu00949 3 dbconfig SPOG: Cloud Connect Integration page not working in Lab Only mode ES7 CSCvt07963 5 dbconfig [VPAT Observation] Keyboard visual focus is not visible on some elements ES7 CSCvs48546 3 template SSO supervisor : cceadmin fails to load due to bundle mismatch ES7 CSCvs56462 3 template Miscellaneous page fails to load with InternalServerError when there are no NetworkVRU's in system ES7 CSCvt05248 3 template In 4k, While deleting a peripheral set, the validation errors are not getting listed in UI ES7 CSCvs77189 2 web.config.ui Cannot Switch to HCS 4K Deployment if Total Dialed Numbers on All CVP Route Clients Exceeds 4000 ES7 CSCvt01048 3 web.config.ui CVP shows OUT_OF_SYNC every 10 mins after CloudConnectInventoryScanner ES12 CSCvs21511 3 dbconfig PCCE 12K: HDS fails to register to SSO mode ES12 CSCvs49920 3 dbconfig Not able to switch PrincipalAW when DF Service is down on the existing PrincipalAW ES12 CSCvs79502 3 dbconfig PCCE4k: Able to add Machines to inventory with Same MachineName ES12 CSCvt65662 3 dbconfig NullPointerException during PCCE 4K/12K fresh install when Rogger is simplexed in the CSV ES12 CSCvs64057 2 template Reason Codes doesn't show in Teams gadget for the first time ES15 CSCvu54806 2 dbconfig Not able to update credentials of Remote Site CUCM PUB ES15 CSCvu85367 2 dbconfig Symmetric Key exception observed intermittently 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:
Symptoms:
1. Finesse gadget does not load in cceadmin Device Configuration
2. Desktop - resource page is blank.
All the other components (except Finesse) work fine.
Conditions: PCCE 4k deployment and 12k deployment
Workaround: Use Finesse CfAdmin page to configure CTI and AW ip addresses
Symptom:
External HDS save fails from Inventory
Conditions: Delete Diagnostic Portal Service for HDS machine
Workaround: NA
Symptom:
PCCE sync calling the User Update REST call with default ?All User? group and not considering the existing associated groups into consideration.
This happens to the set of supervisor users whose attributes (like SSO enablement) gets updated in PCCE
Conditions: PCCE 12.0
CUIC 12.0
Workaround: None
Symptom:
Peripheral Gateway API returns a 403 response in PCCE 4K/12K deployment type for version 12.5.
For example, if we send below request,
https://servername/unifiedconfig/config/peripheralgateway
It returns a 403 response.
Access to servername was denied. You don't have authorization to view this page.
In Tomcat logs, we can see this:
REST_API_INFO: %[url=/unifiedconfig/config/peripheralgateway]: The specified URL is not enabled for the user or user type Administrator
Conditions: When trying to use Peripheral Gateway API in PCCE 12.5 4K/12K deployment type
Workaround: None
Resolved Caveats of
Previous ES’s included in this Engineering Special
Obtaining Documentation
Documentation
Feedback
Obtaining
Technical Assistance
Cisco.com
Technical
Assistance Center
Contacting TAC by
Using the Cisco TAC Site
Contacting TAC by Telephone