2020-11-11 15:33:51 +00:00
|
|
|
---
|
|
|
|
|
layout: docs
|
|
|
|
|
page_title: Upgrading to Vault 1.6.0 - Guides
|
|
|
|
|
description: |-
|
|
|
|
|
This page contains the list of deprecations and important or breaking changes
|
|
|
|
|
for Vault 1.6.0. Please read it carefully.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Overview
|
|
|
|
|
|
|
|
|
|
This page contains the list of deprecations and important or breaking changes
|
|
|
|
|
for Vault 1.6.0 compared to 1.5. Please read it carefully.
|
|
|
|
|
|
2023-07-18 21:07:55 +00:00
|
|
|
## Go version
|
2020-12-17 21:53:33 +00:00
|
|
|
|
2020-11-11 23:26:11 +00:00
|
|
|
Vault 1.6.0 is built with Go 1.15. Please review the [Go Release
|
|
|
|
|
Notes](https://golang.org/doc/go1.15) for full details. A few items of
|
|
|
|
|
particular note:
|
|
|
|
|
|
2020-12-17 21:53:33 +00:00
|
|
|
- Go 1.15 has dropped support for 32-bit binaries on macOS, iOS, iPadOS,
|
2020-11-11 23:26:11 +00:00
|
|
|
watchOS, and tvOS, and Vault is no longer issuing darwin_386 binaries
|
2020-12-17 21:53:33 +00:00
|
|
|
- Go 1.15 no longer treats the `CommonName` field on X.509 certificates as a
|
2020-11-11 23:26:11 +00:00
|
|
|
host name. X.509 certificates should be validated and potentially regenerated
|
|
|
|
|
before upgrading if they do not have Subject Alternative Names.
|
|
|
|
|
|
2023-07-18 21:07:55 +00:00
|
|
|
## Transform secrets engine storage upgrade
|
2020-11-11 15:33:51 +00:00
|
|
|
|
|
|
|
|
The Transform Secrets Engine (Enterprise only) will automatically upgrade the
|
|
|
|
|
storage of its configuration in order to accommodate the new transformation
|
2020-12-17 21:53:33 +00:00
|
|
|
type oriented configuration API. Secondaries will receive the
|
2021-04-06 17:49:04 +00:00
|
|
|
modifications via replication.
|
2020-11-11 15:33:51 +00:00
|
|
|
|
2023-07-18 21:07:55 +00:00
|
|
|
## Database engine interface upgrade
|
2020-11-13 17:44:21 +00:00
|
|
|
|
|
|
|
|
The Database Engine has changed the underlying interface between Vault and each database
|
2023-01-26 00:12:15 +00:00
|
|
|
implementation. This change allows use of [password policies](/vault/docs/concepts/password-policies)
|
2020-11-13 17:44:21 +00:00
|
|
|
within the Database engine. The API for the Database Engine has not changed, only the underlying
|
|
|
|
|
interface between Vault and the database plugins. All built-in database plugins (as well as the
|
|
|
|
|
[Oracle](https://github.com/hashicorp/vault-plugin-database-oracle) plugin) have been upgraded to
|
|
|
|
|
the new interface so no user actions are needed. Vault will continue to recognize existing custom
|
|
|
|
|
database plugins but the old interface should be considered deprecated and may be removed in a
|
2023-01-26 00:12:15 +00:00
|
|
|
future release. See our [upgrade guide for custom databases](/vault/docs/secrets/databases/custom) for
|
2020-11-13 17:44:21 +00:00
|
|
|
more information on upgrading custom database plugins.
|
2021-03-11 17:23:19 +00:00
|
|
|
|
2021-08-27 16:33:44 +00:00
|
|
|
@include 'alpine-314.mdx'
|
|
|
|
|
|
2023-07-18 21:07:55 +00:00
|
|
|
## Known issues
|
2021-03-11 17:23:19 +00:00
|
|
|
|
2021-03-13 01:59:50 +00:00
|
|
|
Due to the known issue, Transform Secrets Engine users are recommended to upgrade to version 1.6.4.
|
2021-08-23 21:58:06 +00:00
|
|
|
Due to the known issue, Lease Count Quota users with DR Secondaries are recommended to upgrade to version 1.6.6.
|
2021-03-11 17:23:19 +00:00
|
|
|
|
|
|
|
|
@include 'transform-upgrade.mdx'
|
2021-08-23 21:58:06 +00:00
|
|
|
|
|
|
|
|
@include 'lease-count-quota-upgrade.mdx'
|
