Release notes

Important: You are not looking at the latest product documentation. Make sure you are reading the documentation that matches the version of the software that you are using. Switch to product version 2.1.3, 2.5, 2.5.1, 2.5.2 (latest)

Use these release notes that are grouped by date to learn about the latest changes to IBM® Blockchain Platform 2.5.

See Installing patches for instructions on how to apply patches to your existing nodes. Patches are cumulative. This means that if multiple patches, for example 1.4.7-0 and 1.4.7-1, are available for a node, you should always select the latest patch, 1.4.7-1 in this case, wherever possible because it includes the fixes from the previous patches as well.

1 Oct 2020

CA, Peer, and ordering node patch 1.4.7-3, 2.1.1-3

Miscellaneous bug fixes and security patches.

9 Sept 2020

CA, Peer, and ordering node patch 1.4.7-2, 2.1.1-2

Miscellaneous bug fixes and security patches.

Certificate expiration dates have been added throughout the component details, making it easier to monitor and track certificate expiration dates. See Certificate Management to learn more about your responsibilities. In addition, it is now possible to enable Node OU support for your MSPs and channels through the console. Read more about Node OU support, why this is important, and how to simplify certificate renewal for the MSPs on your network.

14 July 2020

CA, Peer, and ordering node patch 1.4.7-1, 2.1.1-1

Miscellaneous bug fixes and security patches.

Users who installed the IBM Blockchain Platform 2.5 before July 14, 2020 should install the 2.5 fix pack. If you install the IBM Blockchain Platform 2.5 after July 14, 2020, the platform will contain all the bug fixes and improvements that are provided by the fix pack, and you do not need to apply the fix pack.

18 June 2020

Peer and ordering node patch 1.4.7-0

IBM considers this a critical patch that you should apply at your nearest opportunity. Not applying this patch risks being susceptible to a data integrity issue if you experience a CouchDB or underlying storage crash on your peer. This patch updates the CouchDB delayed_commits configuration property to false. The prior setting could cause the peer's CouchDB database to be in an inconsistent state in the event of a CouchDB or underlying storage system crash. The new setting ensures that a peer will recover from crashes in a consistent state. As always, it is recommended to utilize an endorsement policy that requires multiple peers to endorse a transaction, to avoid an inconsistency from a single peer from impacting the overall blockchain network state.

To be certain that your peers have no database corruption, you should reprovision your peers.

Miscellaneous bug fixes and security patches.

Fabric peer and ordering node images

The platform introduces the capability to deploy new peer and ordering nodes based on either Hyperledger Fabric v1.4 or v2.x. Deploying peer and ordering nodes with the latest Fabric images is recommended to ensure that you have access to current Fabric fixes and features. It is not currently possible to migrate existing nodes to Fabric v2 images.

Elimination of Docker daemon dependency

Leveraging the Fabric v2 external chaincode launcher capability, when you deploy a peer based on the Fabric v2.1.1 image, smart contracts are deployed into their own pod rather than inside a container on the peer pod.

Multizone-capable storage

If your Kubernetes cluster is configured to use multizone-capable storage, new peer and ordering nodes can be deployed that leverage multizone storage, effectively extending their high availability across cluster zones.See Multizone-capable Storage for more information.

Kubernetes version upgrade

IBM Blockchain Platform requires Kubernetes v1.15 - v1.18. If your existing Kubernetes cluster is running v1.14 or lower, you need to upgrade your cluster before you can update your existing blockchain components to this latest release.