Composer v0.20.8

Hyperledger Fabric supports the ability to upgrade your version of fabric. However if you were running Hyperledger Fabric 1.1 and wanted to upgrade to a newer level of fabric, which requires Composer 0.20, it was not possible to upgrade to this level of Composer. You would have to find a way to start fresh and reload your data as you could not upgrade your business network to use Composer 0.20.

This release of Composer has removed the restriction to allow users to be able to upgrade their Hyperledger Fabric 1.1 version to a newer version of Hyperledger Fabric, then be able to upgrade your business network to use the Composer 0.20 runtime. To upgrade you should use version 0.20.8 of the composer-cli to perform the upgrade and you should also remove any Composer dependencies that might exist in your package.json of your BNA. You should also update your client applications to use version 0.20.8 of the Composer sdks and/or also upgrade to using 0.20.8 of the Composer Rest Server.

This capability is being added to make it easier for people to first upgrade to Hyperledger Fabric 1.4 then work on porting their composer application to the new programming models now available in Hyperledger Fabric 1.4.

⚠️Do NOT upgrade your version of Composer to 0.20 if you are running Hyperledger Fabric 1.1 and plan to remain at Hyperledger Fabric 1.1. Composer 0.20 is not compatible ⚠️Once you have upgraded, you CANNOT downgrade to Composer 0.19 even if you can downgrade Hyperledger Fabric back to 1.1. You cannot revert the Composer version change.

Notes

⚠️ If using the Composer tooling to create a Hyperledger Fabric development server, this will now be creating a v1.2.1 server by default. If you are using a different level of Composer v0.16.x, you will need to set the relevant environment variable via export FABRIC_VERSION=hlfvXX when using the Hyperledger Fabric development servers provided by Composer:

hlfv1 for Fabric v1.0
hlfv11 for Fabric v1.1
hlfv12 for Fabric v1.2

The fabric-dev-servers package provided is meant only as a simple hyperledger fabric setup to help you get started with developing with composer using a real fabric. It is not meant to be extended or as a basis for a custom fabric. If you are wondering where versions for hyperledger fabric v1.3 or v1.4 are, these are explicitly not included because you can develop your application using the development fabric 1.2 and still be able to deploy and run it on a fabric 1.3 or 1.4 system.

⚠️ There are multiple support splits across differing Fabric levels, so please be careful with what versions are being used:

• 0.20.0 and above are compatible with the Fabric 1.2.0, 1.2.1, 1.3.0 and 1.4.x driver only
• v0.18.2, v0.19.0 and above are compatible with the Fabric 1.1.0 driver only
• v0.18.0 -> v0.18.1 are compatible with the Fabric RC1 driver only
• v0.17.3 -> v0.17.6 are compatible with Fabric alpha driver only
• v0.17.0 -> v0.17.2 are compatible with Fabric preview driver only

⚠️ The is a change in the business network lifecycle administration, and business network card commands between v0.18.2 and v0.19.0