Upgrading to fabric 2.0

If you are familiar with previous releases of Hyperledger Fabric, you’re aware that upgrading the nodes and channels to the latest version of Fabric is, at a high level, a four step process.

Backup the ledger and MSPs.
Upgrade the orderer binaries in a rolling fashion to the latest Fabric version.
Upgrade the peer binaries in a rolling fashion to the latest Fabric version.
Update the orderer system channel and any application channels to the latest capability levels, where available. Note that some releases will have capabilities in all groups while other releases may have few or even no new capabilities at all.

For a look at how these upgrade processes are accomplished, please consult these tutorials:

Upgrading your components. Components should be upgraded to the latest version before updating any capabilities.
Updating the capability level of a channel. Completed after updating the versions of all nodes.
Enabling the new chaincode lifecycle. Necessary to add organisation specific endorsement policies central to the new chaincode lifecycle for Fabric v2.0.

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.

Upgrading to Fabric 2.0

If you are familiar with previous releases of Hyperledger Fabric, you’re aware that upgrading the nodes and channels to the latest version of Fabric is, at a high level, a four step process.

Backup the ledger and MSPs.
Upgrade the orderer binaries in a rolling fashion to the latest Fabric version.
Upgrade the peer binaries in a rolling fashion to the latest Fabric version.
Update the orderer system channel and any application channels to the latest capability levels, where available. Note that some releases will have capabilities in all groups while other releases may have few or even no new capabilities at all.

For a look at how these upgrade processes are accomplished, please consult these tutorials:

Upgrading your components. Components should be upgraded to the latest version before updating any capabilities.
Updating the capability level of a channel. Completed after updating the versions of all nodes.
Enabling the new chaincode lifecycle. Necessary to add organisation-specific endorsement policies central to the new chaincode lifecycle for Fabric v2.0.