Releases: rddill-IBM/ZeroToBlockchain
correct font problem in Ubuntu
Chapter 2.1 Documentation updated with new PDF
Ubuntu setup part 1 updated to install fonts necessary to view documentation.
For those who have already gone through the installation process, you can resolve this by running the following command and accepting the license agreements when prompted:
sudo apt-get install ubuntu-restricted-extras
Kubernetes Deploy on IBM Cloud is available
This release includes a new Chapter 13, which explains and automates the deploy to a free IBM Cluster using Kubernetes so that your Blockchain demonstration can be made available to anyone!
Update start_rest_server.sh
The 1.3.2 release replaces the start_rest_server.sh
script to work with V0.16, providing a card rather than a user id and apassword. This should complete the updates to 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
Documentation update to support hyperledger-composer v0.16 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
Updated to Hyperledger Composer v0.16.0
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.
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
Multilingual support
This release adds Spanish, Chinese and Japanese translated presentations to the Documents folder.
This release adds Spanish, French, Chinese, Japanese translations to the UX. Language is chosen by clicking on the 'select language' menu option and then selecting the language of your choice. Web pages are updated to the new language on the following request.
V 1.1 Updated to HyperLedger Composer V0.14
This release updates the build to use HyperLedger Composer V0.14. All chapters are updated with new admin code and queryBlockchain code and permissions. From a learning perspective, only Chapter 5 is affected, and that is primarily changing the user id used for admin connect from "PeerAdmin" to "admin". Some changes had to be made to the routines which listen for events on the blockchain, to create the rolling list of blocks as they are added to the chain.
Logic in the hlcClient.js file is unchanged.
To get the latest code, open a terminal window on your OSX or Ubuntu system and navigate to the ZeroToBlockchain folder.
commit all of your changes to your code e.g.
git add .
(enter)git commit -m 'an illuminating comment on this commit'
(enter)git push
(enter)
Type in:
git remote add upstream git://github.com/rddill-IBM/ZerotoBlockchain.git
(enter)
then type:
git pull upstream master
(enter)
V1.0.2: Updated typos in Readme files
Minor update to correct typos in readme files and link them all to the master readme file.
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
Removed extraneous permissions from C10-12
There were permissions in C10-12 required for HyperLedger Composer V0.14, but which were incompatible with V0.13. These have been removed.
Version 1.0
Version 1.0 has all code for Chapters 1-12 in place. This release is based on V0.13 of HyperLedger Composer. Version 1.1 will update this code base to V0.14 of HyperLedger Composer and I will update again when Composer gets to Version 1.0.
This version is multi-lingual and provides user experience support for English (UK and US), Japanese, Chinese and European French. Additional support is planned for LA Spanish.
A future (later in November) release will add a chapter on deploying the dev environment to IBM Bluemix using Kubernetes and a chapter on how to debug Composer errors inside a Docker container.