upstream/vault
1
0
Fork 0
mirror of https://github.com/hashicorp/vault.git synced 2026-02-03 20:40:45 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions 11

docs: add troubleshooting sub-section on plugins (#11858)

Browse source 
* docs: add troubleshooting sub-section on plugins

* docs: fix grammatical error
This commit is contained in:
Calvin Leung Huang 2021-06-14 12:50:43 -07:00 committed by GitHub
parent c5a1e06ee9
commit e1e1cce150
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
1 changed files with 21 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
website/content/docs/internals/plugins.mdx
View file

@ -120,6 +120,27 @@ settings. Like Vault, plugins support [the use of mlock when available](/docs/co
plugin executable in your [plugins directory](/docs/internals/plugins#plugin-directory) must be
given the ability to use the `mlock` syscall.
### Troubleshooting
#### Unrecognized remote plugin message
If the following error is encountered when enabling a plugin secret engine or
auth method:
```sh
Unrecognized remote plugin message:
This usually means that the plugin is either invalid or simply
needs to be recompiled to support the latest protocol.
```
Verify whether the Vault process has `mlock` enabled, and if so run the
following command against the plugin binary:
```sh
sudo setcap cap_ipc_lock=+ep <plugin-binary>
```
# Plugin Development
~> Advanced topic! Plugin development is a highly advanced topic in Vault, and