Troubleshooting TKU upgrade failures and warnings

When you observe failures or warnings during TKU upgrade, use the troubleshooting steps described in this section to either resolve the problem or create a BMC Support case.

Issue symptom

An unexpected message is displayed received when uploading a TKU file in the BMC Discovery UI at Manage > Knowledge > Upload.

Issue scope

1. Upload is unsuccessful
   • Invalid zip file: Technology-Knowledge-Update-2021-06-2-ADDM-12.1_.zip
2. Pattern Activation Failed

   • No changes have been committed.

     Change to module AmazonWebServices.Accounts failed because Function ListTagsForResource 
     not found - namespace Organizations does not contain function at line 222.Change to 
     module AmazonWebServices.CloudFront failed because Function CloudFront not found - 
     namespace AWS does not contain function at line 142.Change to module 
     AmazonWebServices.OrganizationalUnits failed because Function ListTagsForResource not found - 
     namespace Organizations does not contain function at line 138.Change to module 
     AmazonWebServices.SSMParameterStore failed because Function GetServiceSetting not found - 
     namespace SSM does not contain function at line...<etc>

3. Pattern Activation Failed
   • No changes have been committed.
     Change to module Oracle.OracleRDBMS failed because Pattern DatabaseServer is deprecated.

Resolution

The numbered solutions listed here correspond to the numbered items in the Issue scope section:

1. For unsuccessful upload errors, check that the archive is correct and complete. A corrupt or truncated download may cause this error.
2. For pattern activation failures of this type, where there are many dependencies, an incorrect archive target can cause issues. For example, if you attempt to load Technology-Knowledge-Update-2021-06-2-ADDM-11.3+.zip on a version 12.1 appliance, it causes a failure. Apply the correct version for the appliance, which in this example is Technology-Knowledge-Update-2021-06-2-ADDM-12.1+.zip.
3. For pattern activation failures of this type, the error can be caused by the customization of a TKU pattern existing before the application of a new TKU. In this example, Oracle.OracleRDBMS.DatabaseServer.

For other errors, take a screenshot of the error and the page showing the currently installed TKU modules, and any custom patterns. Then open a case with BMC Support with this information.