2021-07-28 15:46:40 +00:00
---
layout: docs
2021-12-08 21:52:51 +00:00
page_title: Upgrading to Vault 1.8.x - Guides
2021-07-28 15:46:40 +00:00
description: |-
This page contains the list of deprecations and important or breaking changes
2021-12-08 21:52:51 +00:00
for Vault 1.8.x. Please read it carefully.
2021-07-28 15:46:40 +00:00
---
# Overview
This page contains the list of deprecations and important or breaking changes
2021-12-08 21:52:51 +00:00
for Vault 1.8.x compared to 1.7. Please read it carefully.
2021-07-28 15:46:40 +00:00
## License Enhancements
Licenses and EULA enhancements have been introduced in the Vault 1.8 release.
These changes are important for Enterprise customers to review. They do not affect
OSS users. Please see the [License](/docs/enterprise/license) documentation for more details.
## Deprecations
The following API endpoints have been deprecated and will be removed in a future release:
* `sys/license` to manage licenses in storage; it is recommended to use
[License Autoloading](/docs/enterprise/license/autoloading) instead.
* `/gcp/token/:roleset` and `/gcp/key/:roleset` paths for generating secrets for rolesets
in GCP Secrets. Use `/gcp/roleset/:roleset/token` and `/gcp/roleset/:roleset/key` instead.
2021-10-07 19:35:56 +00:00
-> **Note:** Policies containing globs should be avoided when giving users read access
to `/gcp/roleset` to avoid giving users permissions to generate tokens.
2021-07-28 15:46:40 +00:00
## Go Version
Vault 1.8.0 is built with Go 1.16. Please review the [Go Release
Notes](https://golang.org/doc/go1.16) for full details. Of particular note:
- Go 1.16 has added support for darwin/arm64. Vault binaries for this platform are
now available supporting the Apple M1 CPU.
2021-08-27 16:33:44 +00:00
@include 'alpine-314.mdx'
2021-12-08 21:52:51 +00:00
@include 'entity-alias-mapping.mdx'
2022-01-27 22:36:50 +00:00
@include 'pki-forwarding-bug.mdx'
2022-04-25 16:55:58 +00:00
@include 'raft-panic-old-tls-key.mdx'
2021-08-03 15:54:55 +00:00
## Known Issues
2021-10-28 21:46:14 +00:00
- MSSQL integrations (storage and secrets engine) will crash with a "panic: not implemented" error
([#12830](https://github.com/hashicorp/vault/issues/12830)). This affects Vault versions
1.8.0 and up. It will be fixed in the next minor update.
2021-08-03 15:54:55 +00:00
- Vault Enterprise binaries for `arm64` architectures will crash immediately when using production-ready storage backends. This issue is addressed in Vault 1.8.1.
2021-08-12 17:45:32 +00:00
- AWS Auth using the [EC2 method](https://www.vaultproject.io/docs/auth/aws#ec2-auth-method)
fails with the error `failed to verify the signature`. This effects 1.8.0 and 1.8.1 and there
2021-09-08 20:14:51 +00:00
is not a workaround. The issue was fixed in Vault 1.8.2.
2021-08-24 17:07:26 +00:00
- Configuration files in RedHat packages for Vault were not properly flagged as
config files for `fpm`, causing user-edited files on disk to be replaced with
the defaults when a new package was installed. This
[issue](https://github.com/hashicorp/vault/issues/12275) affects RedHat
packages for Vault 1.8.0 and the 1.8.1-0 package, and is fixed in 1.8.1-1 and up.
2021-10-07 19:35:56 +00:00
- The introduction of `/gcp/roleset/:roleset/token` and `/gcp/roleset/:roleset/key` could inadvertently give
users the ability to generate tokens and key if globs are used in policies. To avoid issues like this,
2022-04-25 16:55:58 +00:00
globs should be avoided in policies to help adhere to the principle of least privilege. See the
2021-10-07 19:35:56 +00:00
[roleset documentation](/docs/secrets/gcp#rolesets) for more information.
