Skip to main content

DevProvider

Upgrading to fabric 2.0
hyperledge

When upgrading to Fabric 2.0, network operators and enterprise developers must follow a systematic migration process to maintain network availability, preserve data integrity, and take full advantage of newly introduced architecture improvements.

High-Level 4-Step Process for Upgrading to Fabric 2.0

Upgrading nodes and channels follows a simple four-step process:

  1. Backup the ledger and MSPs: Save all channel state databases and block ledgers. Back up all cryptographic MSP keys before making any changes.

  2. Upgrade the orderer binaries: Update orderer nodes one by one. This rolling update prevents downtime in the ordering service.

  3. Upgrade the peer binaries: Perform rolling binary updates across all peers. This keeps endorsement and validation active throughout the upgrade.

  4. Update channel capability levels: Update the system and application channels to the latest capability levels. Some releases introduce new capabilities across all groups. Others may introduce few or none.

Key Changes in the Fabric 2.0 Architecture

Fabric 2.0 brings major improvements to decentralized governance, privacy, and performance:

  • Decentralized Chaincode Lifecycle: Organizations must agree on chaincode rules before committing contracts to a channel.

  • External Chaincode Launchers: Chaincode can now run outside peer environments. This simplifies deployments on platforms like Kubernetes.

  • State Database Cache Performance: Fabric 2.0 improves read and write speeds for CouchDB and LevelDB.

    Upgrading to fabric 2.0

    Need skilled IT professionals?

Recommended Upgrade Tutorials & Guides

Consult these guides along with the official Hyperledger Fabric documentation:

  • Upgrading your components: Learn how to update binaries and Docker containers safely. Complete this step before updating capabilities.

  • Updating the capability level of a channel: Learn how to sign and submit channel configuration updates. Complete this step after updating node binaries.

  • Enabling the new chaincode lifecycle: Set up the required endorsement policies for Fabric 2.0 chaincode packages.

Automation Scripts and Command Support

Upgrading nodes and raising channel capabilities is now a standard routine. Because of this, specific commands are not listed here.

The fabric-samples repository no longer provides an automated upgrade script. Teams should use standard rolling upgrade practices. You can also use CI/CD pipelines to manage each phase safely.

Upgrade Automation & Command Notes

As the upgrading of nodes and increasing the capability levels of channels is by now considered a standard Fabric process, we will not show the specific commands for upgrading to the newest release. Similarly, there is no script in the fabric-samples repo that will upgrade a sample network from the previous release to this one, as there has been for previous releases.