2021-11-17 13:46:07 +00:00
---
layout: docs
2022-06-06 10:28:48 +00:00
page_title: Troubleshoot the Vault EKM Provider
2021-11-17 13:46:07 +00:00
description: Troubleshooting steps for the Vault EKM Provider for Microsoft SQL Server.
---
2022-06-06 10:28:48 +00:00
# Troubleshooting the Vault EKM Provider
2021-11-17 13:46:07 +00:00
## Check Windows Event Logs
Logs from the Vault EKM provider will appear in Windows Event Viewer under
"Windows Logs" > "Application" with source "Transit Vault EKM Provider".
### Enable trace logging
If the logs in the Event Viewer don't give enough information to help debug
2023-01-26 00:12:15 +00:00
your issue, you can [enable trace logging](/vault/docs/platform/mssql/configuration#enabletrace).
2021-11-17 13:46:07 +00:00
Restart SQL Server for the config change to take effect, and you should see more
detailed logs in the same section of Windows Event Viewer.
2022-07-01 09:47:03 +00:00
## Error Codes
During installation, the EKM provider registers a manifest of coded event logs to aid debugging. You may see the following error codes during operation.
### 2050 License Error
The EKM provider was unable to verify that Vault has the correct license features. This
could be due to:
2023-01-26 00:12:15 +00:00
- An incompatible Vault Enterprise license - see the installation [prerequisites](/vault/docs/platform/mssql/installation#prerequisites) for the required license feature.
2022-07-01 09:47:03 +00:00
- Lack of network connectivity - Check Vault's audit logs to see if any requests are made to
authenticate via AppRole or query the `/sys/license/status` API.
- Misconfigured AppRole auth - Ensure you provided the correct Role ID and Secret ID when
configuring the SQL Server `CREDENTIAL`. See the
2023-01-26 00:12:15 +00:00
[installation instructions](/vault/docs/platform/mssql/installation) for an end-to-end working example.
2022-07-01 09:47:03 +00:00
- Incorrect policy permissions - The EKM provider requires the `read` capability
on the path `sys/license/status`. See the `tde-policy` created in the
2023-01-26 00:12:15 +00:00
[installation instructions](/vault/docs/platform/mssql/installation#configuring-vault)
2022-07-01 09:47:03 +00:00
for an example of a working policy.