Field Notice: FN - 72564 - OCS Application Unable to Access Keystore and Truststore - Software Upgrade Recommended

Available Languages

Updated:March 27, 2023

Document ID:FN72564

Bias-Free Language

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.

Notice

THIS FIELD NOTICE IS PROVIDED ON AN "AS IS" BASIS AND DOES NOT IMPLY ANY KIND OF GUARANTEE OR WARRANTY, INCLUDING THE WARRANTY OF MERCHANTABILITY. YOUR USE OF THE INFORMATION ON THE FIELD NOTICE OR MATERIALS LINKED FROM THE FIELD NOTICE IS AT YOUR OWN RISK. CISCO RESERVES THE RIGHT TO CHANGE OR UPDATE THIS FIELD NOTICE AT ANY TIME.

Revision History

Revision	Publish Date	Comments
1.0	20-Mar-23	Initial Release

Products Affected

Affected OS Type	Affected Software Product	Affected Release	Affected Release Number	Comments
NON-IOS	Base Software	RI	RI.2022.04, RI.2022.05, RI.2022.06, RI.2022.07, RI.2022.08, RI.2022.09, RI.2022.10, RI.2022.11, RI.2022.12, RI.2023.01	Cisco BroadWorks Release Independent

Defect Information

Defect ID	Headline
CSCwe43473	694972748 "Error: cannot manipulate the keyStore." on OCS

Problem Description

When you upgrade from a previous release between and including ADP_Rel_2022.04_1.340 to ADP_Rel_2023.01_1.292, while keeping the Open Client Server (OCS) application release to OCS_2022.03_1.220 or earlier, OCS will be unable to access the Keystore/Truststore with the legacy password.

Background

After an upgrade from a previous release between and including ADP_Rel_2022.04_1.340 to ADP_Rel_2023.01_1.292, while keeping the OCS application to release OCS_2022.03_1.220 or earlier, OCS will be unable to access the Keystore/Truststore. Without access to the certificates, OCS will no longer work properly.

Problem Symptom

This CLI error is displayed:

Error: cannot manipulate the keyStore

Workaround/Solution

Workaround

After an upgrade from a previous release between and including ADP_Rel_2022.04_1.340 to ADP_Rel_2023.01_1.292, upgrade the OCS application to between OCS_2022.04_1.340 and OCS_2023.01_1.290. Otherwise, an upgrade to the Application Delivery Platform (ADP) ADP_Rel_2022.03_1.220 or earlier to ADP_Rel_2023.02_1.251 will restore the password.

If the ADP was already upgraded from a previous release to between ADP_Rel_2022.04_1.340 and ADP_Rel_2023.01_1.292, upgrade to ADP_Rel_2023.02_1.251, which includes an executable script restoreKeystorePassword.pl to restore the password.

Solution

Releases between ADP_Rel_2022.04_1.340 and ADP_Rel_2023.01_1.292 have been recalled.

In order to resolve this issue, customers should download and install the updated version of the release:

ADP_Rel_2023.02_1.252
MD5 Checksum: 71bb116759fcfa0ce55285f787f9196a

For More Information

If you require further assistance, or if you have any further questions regarding this field notice, please contact the Cisco Systems Technical Assistance Center (TAC) by one of the following methods:

Receive Email Notification For New Field Notices

My Notifications—Set up a profile to receive email updates about reliability, safety, network security, and end-of-sale issues for the Cisco products you specify.