:_mod-docs-content-type: ASSEMBLY
ifdef::context[:parent-context: {context}]

[id="troubleshooting-key-manager-hsm-adoption_{context}"]

= Troubleshooting Key Manager HSM adoption

:context: troubleshooting-hsm

[role="_abstract"]
Review troubleshooting guidance for common issues that you might encounter while you perform the HSM-enabled Key Manager (Barbican) service adoption.

If issues persist after following the troubleshooting guide:

* Collect adoption logs and configuration for analysis.
* Check the HSM vendor documentation for vendor-specific troubleshooting.
* Verify HSM server status and connectivity independently.
* Review the adoption summary report for additional diagnostic information.

include::../modules/proc_resolving-config-validation-failures.adoc[leveloffset=+1]

include::../modules/proc_resolving-missing-HSM-file-prerequisites.adoc[leveloffset=+1]

include::../modules/proc_resolving-connectivity-issues.adoc[leveloffset=+1]

include::../modules/proc_resolving-HSM-secret-creation-failures.adoc[leveloffset=+1]

include::../modules/proc_resolving-custom-image-registry-issues.adoc[leveloffset=+1]

include::../modules/proc_resolving-hsm-backend-detection-failures.adoc[leveloffset=+1]

include::../modules/proc_resolving-database-migration-issues.adoc[leveloffset=+1]

include::../modules/proc_resolving-service-startup-failures.adoc[leveloffset=+1]

include::../modules/proc_resolving-performance-and-connectivity-issues.adoc[leveloffset=+1]



ifdef::parent-context[:context: {parent-context}]
ifndef::parent-context[:!context:]
