Skip to content

Documentation update to support hyperledger-composer v0.16 release

Compare
Choose a tag to compare
@rddill-IBM rddill-IBM released this 07 Dec 21:04
· 35 commits to master since this release

This release updates the tutorial to work with Hyperledger Composer V0.16.0. This is listed as the 'stable' release until Composer integrates with HyperLedger Fabric V1.1. The tutorial will be updated to work with VHyperLedger Composer V1.0 when that integration occurs.

The 1.3.1 release corrects 2 errors in the setup_Ubunut_Part_2.sh script and updates documentation for chapters 3 and 5.

Why do you care? This update will enable you to work with the latest and most current versions of Composer Playground as a way to share the business networks which you create in this tutorial.

#Key Changes:

  • Composer v0.15 introduced cards. This required changes in hlcAdmin.js and hlcClient.js modules to use cards instead of userid's and passwords to connect to the network.
  • As a result, the Admin user experience has been extended to include
    • support for issuing an Identity to a Member in one of the participant Registries
    • support for creating an Identity Card to a member for whom the issueIdentity process has been run
    • some Admin services are no longer needed. Those will appear with a yellow strikethrough in them. They have been left in the Admin UX for consistency with the tutorial videos.
    • a Help page has been added to the Admin UX to explain these changes.
  • The npm test process has changed to use the new identity card approach. To run npm test in any chapter, please use the following sequence of commands:
    • OSX
npm install
buildAndDeploy
npm test
- Ubuntu
npm install
./buildAndDeploy
npm test

#Upgrading to the new release on OSX or Ubuntu

First, get the updated code:

To get the latest version of this repository onto your local system, assuming that you have followed the recommendation to first fork this repository and then clone from your own id, issue the two following commands.
The first command tells git to use this repository as the upstream master. You only need execute this command once during the life of your local cloned repository.

git remote add upstream https://github.com/rddill-IBM/ZeroToBlockchain.git

The second command tells git to retrieve the latest information from the upstream master and integrate it into your local, cloned copy

git pull upstream master

If you have previously completed chapter 3 (creating your dev environment), you'll need to run the following commands to upgrade nodejs and the command line interface to the current version of hyperledger composer:
Once you have replicated the new code to your laptop, you need to execute the following commands if you had already completed chapter 3 (creating your dev environment)
UBUNTU
(1) run the setup part 1 command with options:
./setup_Ubuntu_Part_1.sh -g false
(2) run the part 2 command:
./setup_Ubuntu_Part_2.sh

OSX
run the OSX setup command with options:
./setup_OSX.sh -b false -g false

Both OSX and Ubuntu

If you are working with a chapter where you have previously run npm install, then

  • first delete the node_modules folder
  • then delete the package-lock.json file
  • then run npm install