About this Document

This document provides installation instructions for CVP12.6(2) ES18. It also contains a list of CVP 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 CVP behavior.

This document contains these sections:

Sign Up for Email Notification of New Field Notices

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.

About Cisco CVP (and CVP Engineering Specials)

This Engineering Special patch Includes:

 

CVP Compatibility and Support Specifications

CVP Version Support

CVP 12.6(2)

CVP Component Support

This section lists the CVP components on which you can and cannot install this engineering special.

Supported CVP Components

You can install CVP12.6(2) ES18 on these CVP components:

Unsupported CVP Components

N/A

CVP Engineering Special Installation Planning

Planning for maintenance window and downtime

The installation or uninstallation of this patch requires a planned maintenance window with some expected downtime of a few seconds / minutes. No

Note : This ES mandates usage of FQDN only for Cloud Connect publisher, subscriber.

Deployments in which ip address / hostname is configured are recommended to reconfigure using FQDN before the ES installation.

For Details on updating the cloud connect configurations refer

Installing CVP12.6(2) ES18

  1. It is mandatory to install 12.5.1 as a base and 12.6.2 FCS before installing CVP12.6(2) ES18. The ES18 is a cumulative ES and can be installed on top of previous ES'es.
  2. Before installing the patch, the audio files must be backed up from the C:\Cisco\CVP\VXMLServer\Tomcat\webapps\CVP\audio folder.
  3. Take backup of all the custom files, if any. The custom files are located in the lib folder of the application-specific directory in the VXML server. For example, the files for HelloWorld custom application are located in the C:\Cisco\CVP\VXMLServer\Application\Helloworld\lib folder
  4. Take backup of all the files if any customizations have been made to C:\Cisco\CVP\jre folder.
  5. Before installing the patch, stop the following services if they are running. For more details refer 12.6.2 Installation and Upgrade Guide.
    1. AppDynamics Machine Agent
    2. Cisco AMP Orbital service
    3. Windows Defender Advanced Threat Protection Service
    4. Windows Defender Antivirus Network Inspection Service
    5. Windows Defender AntiVirus Service

Patching Unified CVP VXMLServer and CallServer:

  1. Stop CVP VXMLServer service and CallServer service.
  2. Run the patch installer.
  3. Reboot the machine.

Patching Unified OPSConsoleServer:

  1. Stop Cisco CVP OPSConsoleServer service.
  2. Run the patch installer.
  3. Reboot the machine.

Patching Unified CVP Reporting Server:

  1. Stop CVP CallServer service.
  2. Run the patch installer.
  3. Reboot the machine.

Post Installation Steps:

  1. Ensure that all services are up and running after the patch is installed.
  2. Ensure that the audio folder is created under \Cisco\CVP\VXMLServer\Tomcat\webapps\CVP
  3. Restore the backed-up audio files and the custom files.
  4. Restore all the customizations made to the jre folder.

Note:

1.      The below changes on CVP Server are applicable only for customer impacted by this defect CSCwk35847

·         Stop CallServer Service.

·         Change the below parameter in the sip.properties file to true

SIP.DisconnectCallerOn4xx = true

·         Save the property file and restart the CallServer service

 

2.      The following registry entries are added to below locations as part of this ES patch installation. However, if a custom Java application uses a different keystore, ensure that the required trust certificates are imported into the appropriate keystore.

 

Registry paths:

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\WebServicesManager\Parameters\Java

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\VXMLServer\Parameters\Java

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\OPSConsoleServer\Parameters\Java

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software   Foundation\Procrun 2.0\CallServer\Parameters\Java

 

Registry Entries:

-Djavax.net.ssl.trustStore=C:\Cisco\CVP\conf\security\.keystore

-Djavax.net.ssl.trustStorePassword=<keystore_password>

-Djavax.net.ssl.trustStoreType=JCEKS

 

3.      The below changes on CVP Server are applicable only for customer impacted by CSCwn22247

 

·         Remove below registry entries from CVP Server:

 

Registry Path: 

Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\CallServer\Parameters\Java

 

Entries to be removed:

-Djavax.net.ssl.trustStore=C:\Cisco\CVP\conf\security\.keystore

-Djavax.net.ssl.trustStorePassword=XXXXX

-Djavax.net.ssl.trustStoreType=JCEKS2.

                

·         Restart Call Server service

 

Post installation steps for Remote Custom API Server: ( Only for Customers executing Custom Code remotely using Remote Custom API server )

Note: This ES mandates usage of FQDN/Hostname instead of ip address for secure HTTP and gRPC calls using Remote Execution of Custom Code.

Details steps for configuration of Remote Custom API server : https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/customer_voice_portal/12-6-2/configuration/guide/ccvp_b_1262-configuration-guide-for-cisco-unified-customer-voice-portal/ccvp_m_1262_remote-custom-api-server-configuration.html

The below steps are to be performed by customers already using Remote Execution of Custom Code.

  1. Stop the Tomcat server in Remote Custom API server.
  2. Take backup of all custom code dependency files from the %Apache Software Foundation%\Tomcat 9.0\webapps\customapis

                                i.            application.properties file located at %Apache Software Foundation%\Tomcat 9.0\webapps\customapis\WEB-INF\classes.

                              ii.            log4j2.xml file located at %Apache Software Foundation%\Tomcat 9.0\webapps\customapis\WEB-INF\classes.

  1. Copy the latest customapis.war file located at %CVP_HOME%\util\remoteexecution folder of the VXML Server.
  2. Replace the latest customapis.war file in the Remote Custom API Server in the webapps folder of Tomcat (for example, C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps).
  3. Start Tomcat server in Remote Custom API server.
  4. A folder named customapis is created in %Apache Software Foundation%\Tomcat 9.0\webapps.
  5. Replace the backup files in the %Apache Software Foundation%\Tomcat 9.0\webapps\customapis folder at their respective locations.
  6. Re-start Tomcat server in Remote Custom API server.

Uninstall Directions for CVP12.6(2) ES18

  1. To uninstall this patch, go to Control Panel.
  2. Select "Add or Remove Programs".
  3. Find the installed patch in the list and select "Remove".

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.

Installing Call Studio 12.6(2)          

Call Studio 12.6(2) ISO installer is available at ES18 location.

  1. Run the installer from the ISO and complete the installation.
  2. Reboot the machine.

Uninstall Directions for Call Studio 12.6(2)

1.      To uninstall this patch, go to Control Panel.

2.      Select "Add or Remove Programs".

3.      Find the installed patch in the list and select "Remove".

 

Resolved Caveats in this Engineering Special

This section provides a list of significant CVP defects resolved by this engineering special. It contains these subsections:

Note: You can view more information on and track individual CVP defects using the Cisco Bug Search tool, located at: https://bst.cloudapps.cisco.com/bugsearch/search?null.

Resolved Caveats in CVP12.6(2) ES18

ES18 is a cumulative ES and contains all defect fixes for ES04, ES11 and ES15.

Identifier

Headline

CSCwj90053

Export configuration on OAMP page (server) getting 500 Internal Error with ES 15 and ES 11

CSCwj99057

CVP VXML Server requires cleanup for Login properties file.

CSCwj49487

CVP - Web Server Allows Password Auto-Completion

CSCwj49477

Cisco Voice Portal - Web Server Transmits Cleartext Credentials

CSCwj50509

CVP Negative Values for "STATS_ICM_ACTIVE_CALLS" Indicate Wrong Active Call Count Handling

CSCwk15854

CVP ES started the CVP and VXML services

CSCwk35847

CVP sends CONNECTFAILURE to ICM and TRANSFER2Agent to CM when there is 488 on Ringback SDP exchange

CSCwk49628

OAMP WSM should fetch version details again if the version is null and not from cache     

CSCwi92998

CVP port 8000 and 7000 use default index.jsp

CSCwk74047

CVP Graceful shutdown command fails.

 

Resolved Caveats in CVP12.6(2) ES15

Identifier

Headline

CSCwj08330

CVP Callserver stopping/stuck after Tomcat crash

CSCwi35541

Cosmetic errors while transferring VXML Application from OAMP page (server) to VXML servers

CSCwi81309

CVP 12.6(2) ES11 has incorrect parameter added to vxml.properties file

CSCwh40680

CVP to reconsider the 488 Response as Failure during Agent Transfe so ICM dont use Traget Requery

CSCwi61852

 

CVP fails to connect to u2c with response code 0 on production tenant

 

Resolved Caveats in CVP12.6(2) ES11

Identifier

Headline

CSCwf97996

Error Checking Deployment Status on CVP OAMP for CourtesyCallback

CSCwh17686

Agent to Agent transfer failure leading to 500 internal errors from CUCM

CSCwi44800

Math Element Not Working Post 12.6(2) ES10 Install

 

Resolved Caveats in CVP12.6(2) ES04

Identifier

Headline

CSCwf27113

Evaluation of CVE-2023-24998 against Cisco Voice Portal (CVP)

CSCwf25557

SPOG location update isn't correct.

CSCwf42047

Malicious user can upload executable files to CVP OAMP file to log messages

CSCwf04115

Reporting Server failover due to SQL exception

CSCwe95138

Reimage.bat does not work due to log4j classes

CSCwf41120

Cloud Connect 12.6(2) Does Not Correctly Respect Certificate Chain

New Feature in CVP12.6(2) ES18

New Feature in CVP12.6(2) ES15

New Feature in CVP12.6(2) ES11

Note:  Enhanced error handling of Cx element :

Enhanced error handling for Cx is implemented in the ES11 which is necessary to address a crucial fix related to error handling situation while cloud services are unavailable thus enhance the overall stability of our systems.

For this feature it is mandatory to update the Cx application with the new exit state and redeploy them on the VXML Server using the CallStudio provided in this ES. Also VVB 12.6.2 to be upgraded to ES-03 or above.

 

New Feature in CVP12.6(2) ES04

 

Obtaining Documentation

You can access current Cisco documentation on the Support pages at the following sites:

Documentation Feedback

To provide comments about this document, send an email message to the following address:

contactcenterproducts_docfeedback@cisco.com

We appreciate your comments.

Obtaining Technical Assistance

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

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.

Technical Assistance Center

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.

Contacting TAC by Using the Cisco TAC Site

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/

Contacting TAC by Telephone

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: