From 620ed461ca6f56fbde95632ca62b325cf37b2047 Mon Sep 17 00:00:00 2001 From: MadelineMurray <43356962+MadelineMurray@users.noreply.github.com> Date: Wed, 17 Jun 2020 19:40:17 +1000 Subject: [PATCH] Updated for 1.5 (#1082) * Updated for 1.5 Signed-off-by: Madeline * Edit Signed-off-by: Madeline --- CHANGELOG.md | 42 +++++++++++++++++++++++++++++++++--------- docs/1_5_Upgrade.md | 25 ------------------------- 2 files changed, 33 insertions(+), 34 deletions(-) delete mode 100644 docs/1_5_Upgrade.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 4ac21768f6..a9eb7c56dd 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,10 @@ # Changelog -## Breaking change upcoming in v1.5 +## 1.5 Breaking changes + +When upgrading to 1.5, ensure you've taken into account the following breaking changes. + +### Docker users with volume mounts To maintain best security practices, we're changing the `user:group` on the Docker container to `besu`. @@ -19,17 +23,37 @@ UID because the username may not exist inside the docker container. Ensure the d is owned by that user. ### Remove Manual NAT method -The NAT manager's `MANUAL` method has been removed. -It is now necessary to use the `NONE` method which has the same behavior. -### Fast Sync by Default for Named Networks -The default sync mode for named permissionless networks, such as the Ethereum mainnet and testnets is now FAST. -The default is unchanged for private networks. -This default is what most users want when they are syncing but if you want to full sync, you can still do so with `--sync-mode=FULL` +The NAT manager `MANUAL` method has been removed. +If you have have been using the `MANUAL` method, use the `NONE` method instead. The behavior of the +`NONE` method is the same as the previously supported `MANUAL` methods. + +### Privacy users + +Besu minor version upgrades require upgrading Orion to the latest minor version. That is, for +Besu <> Orion node pairs, when upgrading Besu to v1.5, it is required that Orion is upgraded to +v1.6. Older versions of Orion will no longer work with Besu v1.5. + +## 1.5 + +### Additions and Improvements + +- The default sync mode for named permissionless networks, such as the Ethereum mainnet and testnets, is now `FAST`. + The default is unchanged for private networks. That is, the sync mode defaults to `FULL` for private networks. + Use the [`--sync-mode` command line option](https://besu.hyperledger.org/Reference/CLI/CLI-Syntax/#sync-mode) to change the sync mode. [\#384](https://github.com/hyperledger/besu/pull/384) + +### Bug fixes -## Upcoming 1.5 release +### Known Issues + +Known issues are open issues categorized as [Very High or High impact](https://wiki.hyperledger.org/display/BESU/Defect+Prioritisation+Policy). -The [1.5 release](docs/1_5_Upgrade.md) is scheduled for early July. +#### Previously identified known issues + +- [Scope of logs query causing Besu to hang](KNOWN_ISSUES.md#scope-of-logs-query-causing-besu-to-hang) +- [Eth/65 loses peers](KNOWN_ISSUES.md#eth65-loses-peers) +- [Fast sync when running Besu on cloud providers](KNOWN_ISSUES.md#fast-sync-when-running-besu-on-cloud-providers) +- [Privacy users with private transactions created using v1.3.4 or earlier](KNOWN_ISSUES.md#privacy-users-with-private-transactions-created-using-v134-or-earlier) ### Additions and Improvements - local permissioning TOML config now supports additional keys (`nodes-allowlist` and `accounts-allowlist`). diff --git a/docs/1_5_Upgrade.md b/docs/1_5_Upgrade.md deleted file mode 100644 index 86893150d3..0000000000 --- a/docs/1_5_Upgrade.md +++ /dev/null @@ -1,25 +0,0 @@ -# Upgrading to Hyperledger Besu v1.5 - -## Docker users with volume mounts - -To maintain best security practices, we're changing the `user:group` on the Docker container to `besu`. - -What this means for you: - -* If you are running Besu as a binary, there is no impact. -* If you are running Besu as a Docker container *and* have a volume mount for data, ensure that the -permissions on the directory allow other users and groups to r/w. Ideally this should be set to -`besu:besu` as the owner. - -Note that the `besu` user only exists within the container not outside it. The same user ID may match -a different user outside the image. - -If you’re mounting local folders, it is best to set the user via the Docker `—user` argument. Use the -UID because the username may not exist inside the docker container. Ensure the directory being mounted -is owned by that user. - -## Privacy users - -Besu minor version upgrades require upgrading Orion to the latest minor version. That is, for -Besu <> Orion node pairs, when upgrading Besu to v1.5, it is required that Orion is upgraded to -v1.6. Older versions of Orion will no longer work with Besu v1.5. \ No newline at end of file