v2.0.0-beta Release Notes - December 12, 2019

What's New in Hyperledger Fabric v2.0

The following new major features are included in the v2.0.0 Beta release.
For additional details, see the What's New documentation.

FAB-11237: Decentralized chaincode governance

Fabric 2.0 introduces decentralized governance for chaincode, with a
new process for installing a chaincode on your peers and starting it on a
channel. The new Fabric chaincode lifecycle allows multiple organizations to
come to agreement on the parameters of a chaincode, such as the chaincode
endorsement policy, before it can be used to interact with the ledger.

FAB-13584: External chaincode launcher

While chaincode is still run in a docker container by default in Fabric v2.0,
the external chaincode launcher feature empowers operators to build and launch
chaincode with the technology of their choice.

Private data enhancements

FAB-10889: Implicit org-specific collections
FAB-15066: Endorsement policies for collections
FAB-13581: memberOnlyWrite collection configuration option
FAB-13527: GetPrivateDataHash chaincode API
FAB-12043: Option to include private data in block events

The private data enhancements enable new private data application patterns.

FAB-103: State database cache for CouchDB

A new peer cache improves performance when using CouchDB state database.

Fixes

All fixes as of release v1.4.4 are also included in v2.0.0-beta.

For the full list of fixes, refer to the release change log.

Changes

FAB-11144: Removal of native token support

The native token support included in v2.0.0-alpha has been removed.
An improved implementation is being evaluated for future releases.

FAB-5177: The ccenv build image no longer includes the shim

The shim package and dependencies for go chaincode are no longer included in
the chaincode build environment. Chaincode packages that do not include their
own dependencies will no longer successfully build on the peer. We strongly
recommend that existing go chaincode be updated to vendor the
github.com/hyperledger/fabric-chaincode-go/shim package and its dependencies.
While there are many tools for managing vendored dependencies, we recommend
moving directly to go modules and vendoring with go mod vendor.

FAB-15366: Logger removed from chaincode shim

Chaincode that used the shim's NewLogger() will need to shift to a new
logging mechanism. Chaincode logging is intended to be the responsibility
of the application developer. As such it should be handled using tools and
libraries that make the most sense to the chaincode developer and the
application in general. Chaincode developers can forward STDOUT and STDERR
from the chaincode container to the peer container by setting
CORE_VM_DOCKER_ATTACHSTDOUT=true. While not recommended for production,
once enabled, each chaincode will receive its own logging channel and
STDOUT and STDERR will be integrated in the peers log on a per-line basis.
A production grade approach would be to run a log aggregation service and
forward your logs to the aggregation service.

FAB-16213: The go chaincode entities extension has been removed

Chaincode implementations that used the entities extension package from an
earlier version of Fabric will need to vendor a 1.x version of the package
for as part of their chaincode package.

FAB-14720: Support for CAR chaincode package format removed

FAB-15285: Support for invoking system chaincodes from user chaincodes
has been removed.

System chaincodes, for example QSCC, are intended to be
invoked by a client rather than by a user chaincode. Invoking from a user
chaincode caused deadlocks in prior releases.

FAB-15390: Support for peer's Admin service has been removed.

The peer's Admin service exposed APIs such as GetLogSpec() and SetLogSpec().
Instead of using these services, utilize the HTTP operations service that was
introduced in v1.4.0.

FAB-16303: GetHistoryForKey returns results from newest to oldest

In prior releases, the GetHistoryForKey chaincode API had no
guarantees on the order of returned results.
Starting in Fabric v2.0, the GetHistoryForKey chaincode API
will return results from newest to oldest in terms of ordered transaction
height (block height and transaction height within block).
This will allow applications to iterate through the top results
to understand recent changes to a key.

FAB-16722: The 'provisional' genesis method of generating the system channel
for orderers has been removed.

Existing users of the provisional genesis method
should instead set BootstrapMethod to 'file', and generate a genesis block file
using configtxgen. Orderer nodes will then use the generated file for the
orderer system channel.

FAB-16477 and FAB-17116: New configuration for orderer genesismethod and genesisfile

The orderer config general.genesismethod and general.genesisfile are replaced
by the new general.bootstrapmethod and general.bootstrapfile.

FAB-15343: System Chaincode Plugins have been removed.

As part of a general
move away from go plugins as an extension mechanism for Fabric, the ability to
add system chaincodes via go plugins has been removed. Users wishing to extend
Fabric with custom system chaincodes may rebuild the peer binary with the
system chaincode built into the binary. This system chaincode should then be
defined and initialized like any other user chaincode would be. This new model
is very similar to the plugin model (which required that the plugin to be built
at the same exact commit of Fabric), and addresses the significant shortcomings
around the lifecycle and validation of system chaincode transactions.

FAB-11096: Docker images with Alpine Linux

Hyperledger Fabric Docker images will now use Alpine Linux,
a security-oriented, lightweight Linux distribution.

FAB-11096: Bash not available in Docker images with Alpine Linux
Bash is no longer available in Fabric images. Utilize Alpine's built-in
sh or ash instead.

FAB-16987: Go version has been updated to 1.13.4.

Deprecations

FAB-15754: The 'Solo' consensus type is deprecated.

The 'Solo' consensus type has always been marked non-production and should be in
use only in test environments, however for compatibility it is still available,
but may be removed entirely in a future release.

FAB-16408: The 'Kafka' consensus type is deprecated.

The 'Raft' consensus type was introduced in v1.4.1 and has become the preferred
production consensus type. There is a documented and tested migration path from
Kafka to Raft, and existing users should migrate to the newer Raft consensus type.
For compatibility with existing deployments, Kafka is still supported,
but may be removed entirely in a future release.

FAB-7559: Support for specifying orderer endpoints at the global level
in channel configuration is deprecated.

Utilize the new 'OrdererEndpoints' stanza within the channel configuration of an organization instead.
Configuring orderer endpoints at the organization level accommodates
scenarios where orderers are run by different organizations. Using
this configuration ensures that only the TLS CA certificates of that organization
are used for orderer communications, in contrast to the global channel level endpoints which
would cause an aggregation of all orderer TLS CA certificates across
all orderer organizations to be used for orderer communications.

Known Issues and Workarounds

FAB-12134: Same chaincode source receiving fingerprint mismatch error

When using the legacy chaincode lifecycle, chaincode installed in different
ways may result in "chaincode fingerprint mismatch data mismatch" error
upon instantiation. This may happen when installing chaincode by using
different SDKs. To workaround the problem, package the chaincode prior to
installation and instantiation, by using the "peer chaincode package" command.

Known Vulnerabilities

FAB-8664: Peer should detect and react when its org has been removed

This is a relatively low severity problem, because it requires a significant
conspiracy of network admins, but it will be addressed in a future release.

Resolved Vulnerabilities

None.

For the full list of improvements and fixes, refer to the release change log:
https://github.com/hyperledger/fabric/blob/master/CHANGELOG.md#v200-beta

Changes:

242b1e3 [FAB-17247] Release fabric v2.0.0-beta
16d8436 Update byfn download command
6de9dc2 Change 'node' language to 'javascript'
7cd1eda Add release notes for v2.0.0-beta
5deab9a Merge pull request #399 from pamandrejko/FAB-14083
402a077 [FAB-17199] Add new test network tutorial
2420fa5 Merge branch 'master' into FAB-14083
1432b66 [FAB-14083] Chaincode as an external service documentation
f93acfa [FAB-17239] What's new links 2.0 beta
c37f8cf [FAB-17240] Small fix to upgrade doc

See More

2e44a2a [FAB-16906] Chaincode launcher doc
79a4e8c Modified doc links and a few edits
e73407f [FAB-14086] Chaincode launcher doc
c3a3723 Merge pull request #384 from wlahti/FAB-17160
5e4ede7 [FAB-16754] Upgrade doc
339e682 Add two digit release variable
7d91ef4 What's New in Fabric v2.0 Beta
a4bf700 Update prereq doc for Go 1.13.x
cce46ac Add an instantiation policy cache layer
6f32be4 FAB-17160 Ensure peer can be started without any docker requirements
c2c5183 FAB-17170 externalbuilder pass metadata unmangled
e7f5ab8 FAB-16731 Use org1peer0 in lifecycle test
5b722b5 Merge pull request #385 from jyellick/FAB-17170-lowercase-json
84845ff FAB-17170 Peer CLI should encode mdata lowercase
b1d37c6 Attempt to fix flaky integration ApproveForMyOrg
206795d Merge pull request #377 from satota2/FAB-17196
77de117 Merge pull request #381 from idiota101/gossipUpdate
b430f81 [FAB-16125] fix allow ledger test to succeed when no tests are run
76765db Copy if rename fails during external build
49ed882 [FAB-17196] Fix broken md structures in docs
3e3b0fc [FAB-17135] Document private data enhancements in v2.0
96fefd0 FAB-17222 updating go version to go1.13.4 in vagrant dev_env
00eecd1 Fix incorrect block metadata documentation (#378)
4149c6d Merge pull request #376 from yacovm/tlsRotate
3cce10a [FAB-17220] Dynamically build TLS config in Raft client handshake
f5799c0 FAB-17057 Generate crypto during orderer/common/server UT (#373)
c3720b4 Fix for FAB-16996, Removed solo and kafka refference in BYNF doc
05706bb Merge pull request #370 from mastersingh24/fab-14693
46ccaf0 [FAB-15035] Remove couchdb HTTP Request headers from debug log
bf085a2 FAB-14693 Vendor updated fabric-amcl package
1b8be06 [FAB-16937] complete by hooking CC fwork with ext. CC
4bde8c4 [FAB-17141] Update fabric docs for updated go programming model
0b4ca1c [FAB-17116] Add orderer config change to release note
09ad9dc [FAB-17188] unit test for couchDB revision fetching functions
64c888f Bump IT pull retry threshold to 7s
31a2d51 FAB-16437 Remove common mocks
2402250 FAB-16437 Remove unused common/mocks
6de732f FAB-16437 Remove common/mocks/config
a1f2794 FAB-16437 Remove common/mocks/peer
5025cad [FAB-17150] Clean up temp dir on configure_test
0bfcd36 Merge pull request #357 from nikhil550/FAB-16157
169fc51 [FAB-15724] Improve migration integration test
f84b1f0 Merge pull request #352 from mastersingh24/kill-common-mocks2
f02440d Merge pull request #348 from caod123/fix-it-flake
0999e0e [FAB-16157] Remove references to alpha and disclaimers
fc0a9e9 [FAB-17165] Reduce pvtdata pull-retry threshold to 3s in IT core_template
9dcb65e FAB-17177] Config block shouldn't verify itself in block replication (#355)
9fa8172 Merge pull request #333 from fnlctrl/patch-1
c0f019e Merge pull request #323 from Shubham-koli/patch-1
03576df fixed typo.
e6a9bde FAB-16437 Remove common/mocks from v20 validator
b8aaafc FAB-16408 Deprecate the Kafka based orderer
6e52f56 FAB-16437 Remove common/mocks from v13 validator
b6830f1 FAB-15343 Document removal of SCC Plugins
24d1954 replace http with https in install.rst
f2dbb66 Merge pull request #321 from guoger/err-msg-improvement
e3188cf FAB-16437 Remove common/mocks from v12 validator
6044822 FAB-16687 reduce mutex contention in validator
151ea02 [FAB-17133] Add branch to AZP trigger
da8b99c Amend GitHub workflow guidance
94c3a09 Merge pull request #337 from btl5037/azp_gate
29dd911 fix for FAB-17156, clean up main_test folder by defer
7a309c7 FAB-17161 improve error message
f0422d6 [FAB-17166] Gate UT, IT and DocBuild
4947729 fix FAB-17153, change temp folder mode to remove
0264eb6 fix FAB-17148 defer to delete 'bccsp-sw' directory (#328)
ab4d595 [FAB-17132] Add Parallel Strategy to Integration Tests
ea93b8f Merge pull request #325 from guoger/FAB-17158-ignore-test
e779196 [FAB-17135] Private data sharing doc
db73af2 fix FAB-17146
027d751 FAB-17158 ignore util test using build tag
4cec60e Merge pull request #327 from yacovm/golintgossip
01d1eb4 Golint gossip/gossip/
c5d4087 FAB-17157 rm createTempDir method
e939f9c [FAB-17116] Use bootstrapmethod for raft consensus
dd26403 Merge pull request #313 from btl5037/action_trigger
7f30434 [FAB-17136] Fix the typo error (#318)
543e38c FAB-16393 Cleanup endorser logging
24afa12 [FAB-11241] Move Profiling init Service external
cfae78e [FAB-17133] Add Action to Trigger CI
db3b1cc Remove read-only note and Gerrit reference
8e33173 FAB-17105 - Fixing broken links
87f6240 Merge pull request #301 from maniankara/master
d00b96e Merge "[FAB-16117] Add test to kill cc container in IT"
c18a194 docs/source/channel_update_tutorial.rst: CHANNEL_NAME variable missing in 2 places in channel update tutorial
fb56820 [FAB-17123] Update dep for fabric-protos-go
8d073c1 [FAB-17123] Revert FAB-17038
fc86d1a Add PULL_REQUEST_TEMPLATE.md
ef4b79f Merge "FAB-16812 Update bootstrap script"
2869d92 Merge "[FAB-16376] MSP_1.4.3: support for admincerts"
71f40ed Merge "[FAB-17115] Update doc for GitHub migration"
07b2f14 Merge "[FAB-15900] Add pkcs11 section to orderer.yaml"
75e51fb Merge "[FAB-16890] move build out of container runtime"
78471de Merge "[FAB-16842] prep for for ext CC config"
603dbf7 [FAB-16117] Add test to kill cc container in IT
01a80e4 Merge "FAB-16477 Fix regression in orderer bootstrap"
ecec58b [FAB-15900] Add pkcs11 section to orderer.yaml
6d98cac [FAB-17115] Update doc for GitHub migration
4a75c13 Merge "[FAB-16118] Add IT for MSP unauthorized Peer"
a1b83d4 FAB-16477 Fix regression in orderer bootstrap
8105eff FAB-16812 Update bootstrap script
061ef6a [FAB-16118] Add IT for MSP unauthorized Peer
fc53b9d Merge "[FAB-17086] Update references in master for v1.4.4"
4a3c65c Merge "[FAB-16574] Cache results of msp.Validate function"
0ae7c3d Merge "Add rebuild test with real ledger data"
7cbbc74 Merge "[FAB-15066] Add additional IT"
a9572d6 [FAB-16890] move build out of container runtime
fead9d9 [FAB-16842] prep for for ext CC config
3d8825e Add rebuild test with real ledger data
ddd24b9 [FAB-15066] Add additional IT
bbdfa7f Merge "[FAB-16560] Fix review comments"
f747ff1 [FAB-16574] Cache results of msp.Validate function
d41953a Merge "FAB-17097 Implemented recommendations after review"
8eab735 Merge "FAB-17097"
ba2b328 Merge "[FAB-16921] Upgrade older ledger data w/ couchdb"
2c5c442 Merge "[FAB-17118] Make CI scripts executable"
29056b0 [FAB-16921] Upgrade older ledger data w/ couchdb
127e224 Merge "[FAB-16169] Separate unmarshalling from validation"
96651c6 Merge "Convert creation block to genesis block early on"
67d4f6f Merge "FAB-16969"
c665f14 [FAB-17118] Make CI scripts executable
f421582 Merge "[FAB-16169] clean up tests"
3adcab3 Merge "Minor cleanup for orderer without a system channel"
8aca8e7 Merge "[FAB-16169] CR Comments"
5c898da Merge "[FAB-16377] Perform validation of channel ID"
7cc8760 Merge "[FAB-16170] hdr validation for endorser transactions"
60ef90d Merge "[FAB-15066] Enable endorsement policies for collections"
1946812 Merge "[FAB-15066] Cleanup pvtdata integration test"
454a9fa Merge "[FAB-17114] Add AZP support for Fabric"
2d9bacd Merge "FAB-16573 Ledger consistency is across channel"
2cc9258 Merge "[FAB-15226] Re-enable gossip integration test"
9de6ec5 Merge "integrate cache with LoadCommittedVersion"
e08ff81 Merge "cache config via core.yaml"
0f2c4b6 Merge "integrate cache with statecouchdb"
102ea3c Merge "[FAB-16477] Use bootstrap file for raft consensus"
b77fbe6 Merge changes I37685688,Ia45f537b,Ibd9b6849,I1ed90b94
be073f2 FAB-17097 Implemented recommendations after review
0830665 [FAB-17114] Add AZP support for Fabric
b852a86 [FAB-15066] Enable endorsement policies for collections
cc39bc7 Minor cleanup for orderer without a system channel
36ed75c Merge "Minor restructure of externalbuilders"
5c49542 Merge "[FAB-16397] Check file names for spaces"
ee778bc Break out small functions and add godoc
109fccb Rename externalbuilders package to externalbuilder
6257073 Implement Stop on the externalbuilders.Instance
3032e8e Implement a session handle to running processes
4704ed5 [FAB-15066] Cleanup pvtdata integration test
59a4bfa [FAB-16169] Separate unmarshalling from validation
9772163 [FAB-16397] Check file names for spaces
af55876 Minor restructure of externalbuilders
1b99fdd Merge "Minor cleanup of externalbuilders_test.go"
929f654 [FAB-16560] Fix review comments
3107016 [FAB-16169] clean up tests
8a70b67 [FAB-16169] CR Comments
30a1c6c [FAB-16377] Perform validation of channel ID
20dbb4a [FAB-16170] hdr validation for endorser transactions
1b3c683 Merge "FAB-16286 Unexport and rename IT func"
4cfafee Merge "[FAB-16712] Update Java chaincode doc links"
48c9819 FAB-17097
9d1c247 Merge "[FAB-17095] MCS not to print identities as bytes"
b86a86f Merge "[FAB-17095] Pretty print peer identities in gossip"
f30f3f0 Merge "[FAB-17038] Update peer.ApplicationPolicy references"
6baa59e FAB-16286 Unexport and rename IT func
fd55ee2 Merge changes I14846f8d,I7aec7028
2e4d92e Merge "FAB-16663 Defang Stalebot"
66ab59f Merge "[FAB-17052] pretty print EndpointCriteria TLS CAs"
29bd8c5 integrate cache with LoadCommittedVersion
e9be627 cache config via core.yaml
67fccab integrate cache with statecouchdb
6cd02a6 [FAB-17095] MCS not to print identities as bytes
0cd1107 [FAB-17095] Pretty print peer identities in gossip
49fbc47 FAB-16663 Defang Stalebot
3cbb0bc Minor cleanup of externalbuilders_test.go
caeebd8 [FAB-17086] Update references in master for v1.4.4
0411196 Merge "Remove persistence.PackageProvider"
019c7ab Merge "FAB-16286 protolator understand ChaincodeHeaderExt"
a0ab031 FAB-16286 IT with forged RWset for LSCC IP failure
7b19faa FAB-16286 Split raft Broadcast/Deliver IT tool out
2e75f66 [FAB-16712] Update Java chaincode doc links
33139a9 [FAB-17092] Update bootstrap.sh
b268b11 [FAB-17052] pretty print EndpointCriteria TLS CAs
59bad46 FAB-16286 protolator understand ChaincodeHeaderExt
3ec743b [FAB-17038] Update peer.ApplicationPolicy references
048351a Merge "[FAB-17032] Fix some errors in the doc."
d919905 [FAB-16477] Use bootstrap file for raft consensus
86f53bc Remove persistence.PackageProvider
a282f71 Merge "[FAB-15814] Add endpoint for versioning metadata"
445fd06 Merge "Allow orderer startup with no system channel defined"
028d9fb Merge "Do not require reboot when re-adding consenter"
b66fc33 [FAB-15814] Add endpoint for versioning metadata
727850f Allow orderer startup with no system channel defined
eb65b8e Convert creation block to genesis block early on
cce2247 Do not require reboot when re-adding consenter
34587f7 [FAB-17060] Remove s390x from multiarch script
85aebd6 Merge changes Ibc1eb5c0,Ide57e8ca,Ic2d69839
f594c20 FAB-15754 Add solo deprecation to release-notes
1c18f83 FAB-15754 Deprecate solo orderer
1e39899 [FAB-17032] Fix some errors in the doc.
18dbbb0 FAB-15754 Fix and re-run generateHelpDocs.sh
af69416 Relocate raft config specific helpers to raft tests
ce7aca8 Merge "External launch metadata uses PEM encoding"
f4c7914 Merge changes from topic "kill-common-mocks"
59064f3 [FAB-15226] Re-enable gossip integration test
cd8c374 Merge "[FAB-15066] Update fabric-protos-go dep"
9463d0f Merge "[FAB-15982] gossip IT test with no leader election"
f62a2c0 FAB-16437 Remove common/mocks/policies
5d23cfa Merge "FAB-17001 Delete chaincode package on build fail"
94ab790 FAB-16573 Ledger consistency is across channel
f52af9a External launch metadata uses PEM encoding
946056c FAB-16544 IT for orderer endpoint overrides
5758c93 Merge "Generate block fixtures in orderer/common/server UT"
f876f2f FAB-16437 Remove common/mocks/msp
03710df Merge "FAB-16437 Remove common/mocks from protoutil"
7254385 Merge "Add fake generation directives discovery/support/mocks"
31534f0 Merge "remove existing lscc state cache"
a90f67d Merge "vendor fastCache to use as ledger cache"
4940b1f [FAB-15982] gossip IT test with no leader election
7aa4a81 [FAB-15066] Update fabric-protos-go dep
7b3fafc Merge "refactor statecouchdb committer"
6617030 FAB-16437 Remove common/mocks from protoutil
6aa4978 Merge "Add consensus type ectdraft in orderer/README.md"
3867a47 Merge "[FAB-15389] Fix private data dissemination"
ef5ff5d remove existing lscc state cache
3a8dae8 vendor fastCache to use as ledger cache
2448b5e FAB-16544 Properly detect node-readdition
b97ca73 [FAB-15389] Fix private data dissemination
ffa3335 Merge "Complete chaincode execution on stream termination"
53a1bce refactor statecouchdb committer
5665cf5 Merge "FAB-16940 report underlying error msg in configtx"
5ebf39e FAB-16995 Note removal of provisional bootstrap
930e53d Merge "Add integration test for failing external builder"
e8618c4 Merge "refactor kv_ledger_provider"
f27b122 Merge "Extract ccenv-1.4 test to its own file"
4952829 Merge "Address CR comments for FAB-17000"
2332eea Merge "[FAB-17000] Warn when cert expiration is nigh"
649d563 Address CR comments for FAB-17000
9b266bd Merge "Add timeout configuration for chaincode install"
8ff17e1 FAB-17001 Delete chaincode package on build fail
6325fe1 Add consensus type ectdraft in orderer/README.md
fbb4c89 Complete chaincode execution on stream termination

This list of changes was auto generated.

hyperledger/fabric v2.0.0-beta on GitHub