v2.3.1
v2.3.1 Release Notes - February 3, 2021
Fixes
peer - incorrect handling of values set to empty byte array in node chaincode
Peer should handle key values set to nil or empty byte arrays as a delete of the key.
While the behavior worked as expected when using Go chaincode and Java chaincode,
if using node chaincode it did not work correctly when setting key values to empty byte arrays.
This fix ensures that peer will interpret empty byte arrays as deletes even for node chaincodes.
If using node chaincode with private data, if you had set private data values to an empty
byte array, the private data hash would have been committed incorrectly to the state database.
To repair the state database, after applying the fix, with the peer stopped, request that
the state database be rebuilt by calling "peer node rebuild-dbs" or by deleting the state database.
Upon the next start, the peer will rebuild the state database from the already processed block store.
If subsequent transactions had referenced the existence of such a private data hash by calling
GetPrivateDataHash, then the subsequent transactions may have been processed incorrectly and
the peer will need to additionally reprocess blocks, which can be triggered by calling
"peer node reset" instead of "peer node rebuild-dbs".
If the peer joined channels from a snapshot, "peer node rebuild-dbs" and "peer node reset"
are not available since the peer does not have all blocks since the genesis block. In
these cases the peer will need to be replaced with a new peer that re-joins from the snapshots.
If using regular channel data only and not private data, the empty byte array will not
have been committed, and therefore no action is required on the peer beyond applying the fix.
orderer - incorrect osnadmin flag --channel-id
The osnadmin CLI introduced in v2.3.0 used an incorrect flag --channel-id.
The flag has been corrected to be --channelID in order to be consistent
with other CLIs.
Dependencies
Fabric v2.3.1 has been tested with the following dependencies:
- Go 1.14.12
- CouchDB v3.1.1
Deprecations (existing)
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.
Additionally, the fabric-kafka and fabric-zookeeper docker images are no longer updated, maintained, or published.
Fabric CouchDB image is deprecated
v2.2.0 added support for CouchDB 3.1.0 as the recommended and tested version of CouchDB.
If prior versions are utilized, a Warning will appear in peer log.
Note that CouchDB 3.1.0 requires that an admin username and password be set,
while this was optional in CouchDB v2.x. See the
Fabric CouchDB documentation
for configuration details.
Also note that CouchDB 3.1.0 default max_document_size is reduced to 8MB. Set a higher value if needed in your environment.
Finally, the fabric-couchdb docker image will not be updated to v3.1.0 and will no longer be updated, maintained, or published.
Users can utilize the official CouchDB docker image maintained by the Apache CouchDB project instead.
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.
FAB-17428: Support for configtxgen flag --outputAnchorPeersUpdate
is deprecated.
The --outputAnchorPeersUpdate
mechanism for updating anchor peers has always had
limitations (for instance, it only works the first time anchor peers are updated).
Instead, anchor peer updates should be performed through the normal config update flow.
FAB-15406: The fabric-tools docker image is deprecated
The fabric-tools docker image will not be published in future Fabric releases.
Instead of using the fabric-tools docker image, users should utilize the
published Fabric binaries. The Fabric binaries can be used to make client calls
to Fabric runtime components, regardless of where the Fabric components are running.
FAB-15317: Block dissemination via gossip is deprecated
Block dissemination via gossip is deprecated and may be removed in a future release.
Fabric peers can be configured to receive blocks directly from an ordering service
node by using the following configuration:
peer.gossip.orgLeader: true
peer.gossip.useLeaderElection: false
peer.gossip.state.enabled: false
FAB-15061: Legacy chaincode lifecycle is deprecated
The legacy chaincode lifecycle from v1.x is deprecated and will be removed
in a future release. To prepare for the eventual removal, utilize the v2.x
chaincode lifecycle instead, by enabling V2_0 application capability on all
channels, and redeploying all chaincodes using the v2.x lifecycle. The new
chaincode lifecycle provides a more flexible and robust governance model
for chaincodes. For more details see the
documentation for enabling the new lifecycle.
Changes:
- 2f69b42 Release commit for v2.3.1
- 17b7e4f Add peer log message for failure to invoke chaincode (#2339)
- fc63fcd Test network does not work with latest Docker
- 8dc9930 Minor updates related to documentation for commands and more osnadmin updates (release-2.3) (#2322)
- c29420c Rename --channel-id to --channelID in osadmin
- 410ba71 Participation edits to network concept doc
- f682cad Fix the issue of Nil/Zero-length-byte-array value (#2309)
- 23b677c Remove system channel from Test Network tutorial
- 1dc0b47 [FAB-15648] document update: Non-TLS orderer with etcdraft usage (#1678)
- b144d49 cherry pick test network doc chaincode deployment
See More
- 7996176 [FAB-18398] Added osnadmin binary to tools image (#2275)
- 7debdef Remove unreachable and unnecessary code in gossip membership (#2294)
- f99cff0 Orderer deployment tutorial update
- b4548dd [doc] fix broken link
- a4a86d6 Minor create channel doc typos
- c8d3e08 Even more edits to docs for participation API (#2208) (#2281)
- 06866fb Revert "Minor create channel doc typos" backport
- e24a05e Pass GO_TAGS to tools container (#2278)
- c2758ef Raft configuration doc issue after mergify backport (release-2.3)
- 157f556 [FAB-18170] Endorsement policy page discusses NodeSDK
- f3cb99e [FAB-18392] Clarify scope and limitations of test network
- d486efb [FAB-18252] Documentation should reference Java chaincode support
- 377290d Remove anchor peers from configtx.yaml tutorial (#2257)
- e6b55b1 Update "add an org" tutorial to not use CLI
- cd578f3 Split command in "add an org to network" tutorial
- 0b2c755 Add more details to logging specification examples
- 56a0861 Minor create channel doc typos
- c8cc666 Update image filter used by integration tests
- 4d213ba Add Language Argument to DeployCC Calls
- 9ab9368 Check correct error
- 06eb9b1 [FAB-18378] Log warning when peer is lagging behind and cannot catch up
- e5e858a Fix unusual dash character in channel participation tutorial
- 5da3b0f [FAB-17039] Skip retrieving pvtdata from transient store when txid is missing (#2183) (#2200)
- cc5a77c More doc edits for system channel removal
- 0e774df Remove Short Names and Replace With Full Path in Fabric
- c91961c Edits to orderer and capabilities concept for participation API
- eb22bbf [FAB-17954] Document CouchDB JSON determinism (#2187)
- b1fb856 Fix name of CHANNEL_CONFIG_BLOCK in the Channel participation API tutorial (#2186)
- bd49126 Update README.md to include link to Fabric v2.3 documentation
- 94fffbb Orderer deploy guide edits for participation API (#2148)
- a455146 Fixes Hardened to Hardware
- 537ef5c remove repeated the
- 4c67ed3 update private-data sample instruction for Asset owner string
- ef8ff19 Remove reference to first-network
- ec81f3e Release commit for v2.3.0 (#2144)
- 2ff4e0e Clarify clientRootCAs guidance in core.yaml
- 4c4ddfc Clarify clientRootCAs guidance in core.yaml and TLS docs (#2142)
- bc33cbb [FAB-18322] Check panic message in TestInitializeServerConfig (#2140)
- 504caaf What's New documentation for v2.3.0 (#2126)
- e7b81ba Update core.yaml, orderer.yaml and docs for TLS (#2141)
- d5ed80d Add release note for RSA CA changes
- a09f0e7 Add integration test for MSPs with RSA CA certs
- 52f511d Restore RSA support for x509 public key import
- c545195 Deploy production ordering service doc
- 5f2034f Add check for invalid key before hitting couchdb (#2133)
- 1f6fb08 Chan.Part.API: Onboarding and follower CFT IT (#2094)
- 39a8545 Fab-18337 Ch.Part.API: Test join system channel with app channels (#2128)
- ab55d50 Add persistent volume note to peer deploy guide
- cb683e5 Chan.Part.API: avoid flakiness after removing system channel (#2111)
- 48bf409 [FAB-18319] Ch.Part.API: IT Remove and rejoin channel from orderer (#2085)
- 7055007 Nominate Will Lahti as Fabric Maintainer
- c174728 [FAB-18179] Channel Participation API Tutorial
- c08c5e3 Update v2.3.0 release notes
- 09c0d75 Revert "[FAB-18179] Channel Participation API tutorial"
- 40e845b [FAB-18179] Channel Participation API tutorial
- 1f59e41 Remove unused type (#2120)
- d997115 Update Contribution guide to point to RFC process
- 01bfbba Update Go to 1.14.12
- 4a7efe9 Remove custom errors from pvtdata store
- 5dcdf81 Remove custom error types from txmgr package
- 24868e9 Remove custom error types (#2110)
- cd99b4e Enforce Admin.TLS.ClientAuthRequired in orderer config (#2107)
- a01cda4 Allow osnadmin to connect without TLS (#2106)
- 7f6b5dd [FAB-18315] Ch.Part.API: Add remove failure metric for chain status (#2108)
- b9a8338 Add snapshots to peer deploy checklist (#2109)
- 4f1e093 kvledger/test for snapshot generation and bootstrap
- e5ebb7b Remove the temp folder on error during snapshot generation (#2104)
- 941f0af Document additional snapshot considerations
- f1058a8 [FAB-18333] Fix panic in cluster/comm#TestRenewCertificates
- 4e7201b Revert "Allow BCCSP config to be set using env var (#1900)" (#2093)
- b8f76ae Remove Jira screenshots (#2103)
- ca26271 Redirect integration test logs to GinkgoWriter
- cd623d7 Update Jira instructions in contributing guide
- 01394c7 Chan.Part.API: Rename pendingops/joinblock to pendingops/join
- 45afdbd Update channel_update_tutorial.rst with joinbysnapshot
- 421dddf Remove unimplemented funcitons
- c590e37 Prevent race that occurs after test timeout
- 901fe6c [FAB-18329] Fix data race in cluster/comm_test#TestRenewCertificates (#2089)
- 73853ef Chan.Part.API: join system channel using config block IT (#2082)
- 1e90c88 osnadmin command reference (#2077)
- 4b134cf Chan.Part.API: Rename cluster relation to consensus relation (#2086)
- d54ed92 Chan.Part.API: channel participation relation/status metrics (#2025)
- cc77194 Ch.Part.API: Allow retry of failed removals (#2083)
- 1f372da [FAB-18318] IT: verify DUPLICATE_TXID error when resubmitting old tx on a peer bootstrapped from snapshot (#2084)
- 6a56a06 Update configtxgen log messages for app chan genesis block (#2076)
- 7f6ead9 [FAB-18132] Ch.Part.API: Remove ledger resources asynchronously (#2027)
- 17f075c Add function TxIDExists and use in validation path
- d620ab3 [FAB-18298] Default cluster cert and key
- 636c361 Rename cluster relation member to consenter (#2079)
- 348e2c7 Add default snapshot directory to core.yaml (#2068)
- 4db7e4c Add osnadmin to Makefile
- 2b1b989 [FAB-18290] Add channel name to pvtdata reconciler log msgs
- c15e44e Minor refactoring
- a37ea5c Minor Refactoring
- bf57390 Optimize importing snapshot data into pvtdatastore
- 596f720 [FAB-18307] IT: set deprioritizedDataReconcilerInterval to prevent CI flake (#2070)
- 32da54c [FAB-17953] IT: add tests to verify channel config can be retrieved on a peer bootstrapped from snapshot (#2064)
- 91af918 IT: Add ACL test for snapshot related CLI cmds (#2061)
- ea81d21 osnadmin CLI (#1907)
- d7b1ed1 Chan.Part.API: config-tracker IT flake fix
- b106d05 Updated comment for channel participation API
- 0d4c878 Fix link in snapshot doc
- 8620090 Use -c instead of -C for channelID in snapshot cli cmds
- 0edadac Peer snapshot documentation
- fac5bd1 [FAB-17953] IT: verify pvtdata reconciliation when bootstrapping by snapshot (#2052)
- 46cdc03 [FAB-17800] Update peer node command doc
- 2bf53e6 FAB-18291 Ch.Part.API: BlockPuller that can be stopped (#2050)
- 067f09b FAB-18301 Registrar.JoinChannel takes the wrong lock type (#2058)
- e4c54fa Chan.Part.API: config-tracker IT
- 275b545 [FAB-17800] Update reset/rollback/rebuild/upgrade_dbs cmd descriptions for snapshot
- dd22478 Add function GetChannelConfig in cscc and use in peer client
- 8758bde Update fabric-protos-go dependency (#2057)
- dedcf42 Add doc files for peer snapshot commands
- cf678be Cleanup system channel w/ genesis block IT (#2055)
- 8899f5a Avoid duplicated follower chain.Halt()
- 286293a s/assert/require in orderer/common/follower UT
- a216637 check if desired version of samples exists
- 0d4e6ed Fix CouchDB tutorial queries
- c9439d8 [FAB-18130] Chan.Part.API: Creating the system channel with a genesis block, so no onboarding is
- 2198c09 Minor refactor/log change for orderer startup
- 62a8808 Rename channel particicpation CFT filerepo directory to pendingops
- 8f7e37a Chan.Part.API: IT cleanup/improvements
- 44caec4 nwo.GetConfigBlock retry until success
- 687f58d Refactor and export pvtdata test funcs for marbles_private chaincode (#2048)
- b810925 FAB-18283 Ch.Part.API: StatusReport on evicted etcdraft.Chain (#2049)
- 2c921bc Return errors in rollback/rebuild commands when using snapshots
- a143ea9 Minor update to joinbysnapshot cmd response msg
- d59af2c Expose new Admin endpoint on orderer for the channel participation API (#1939)
- 60b5053 Update location of snapshots folder in IT
- e071f57 [FAB-17953] Add integration tests for snapshot feature (leveldb and couchdb, no pvtdata)
- 105aeeb Make snapshots folder directly under <peer.fileSystemPath>
- 44f6ef5 Pass channel config to service discovery
- 90733a0 Log TLS handshake duration (#2032)
- 7b2b9f0 [FAB-18082] Make RemoveChannel crash fault tolerant (#1952)
- 91886f6 FAB-18108 Ch.Part.API: simplify follower.Chain flow control (#2026)
- d0eb424 Update tests to use CouchDB 3.1.1
- 48d532f Deduplicate orderer server TLS root CAs (#2029)
- 3c57d11 Copy Into Correct Slice To Ensure Keystore Password is Set
- c6f07dd FAB-18276 Ch.Part.API: extractSystemChannel must skip empty ledger (#2023)
- 69bc731 Remove common name from private data doc
- 0ae1f5a FAB-18198 Ch.Part.API: Restructure registrar init (#2015)
- 56118d0 IT - update MSP and consenters set in single config update
- da83764 Update Nikhil Gupta's email address in maintainer file
- d43e5dd Add stringer for channelID type (#2016)
- 0ee3295 Persist complete collection in the private blockstore (#2010)
- 4e2ac6f [FAB-18270] Disable debug of CouchDB response body
- 192b03b [FAB-17800] Reset/Rollback returns error if a channel was bootstrapped from a snapshot (#1990)
- 9d02571 Fix bug in consenter cert validation logic
- 330dc72 Chan.Part.API: test member to follower transition
- ecf0bb7 Miscellaneous channel participation IT cleanup
- b0a7291 Peer deployment guide
- 02ff2a3 UT improvements for common/blockledger/fileledger (#1998)
- 9adde2e Update help text in test net tutorial
- e6fcef5 Update release docs
- 60fa282 Fix Node OU error message
- 114f030 Shutdown blockstore (if open) before dropping ledger (#1992)
- f79abaa Add Troubleshooting topic to Test Network for Docker Desktop setting
- 8c684eb Avoid panic when re-attempting system channel removal
- 49dbea4 Allow tick interval override via orderer.yaml (#1981)
- 3f93c17 Improve consistency with channel participation errors (#1974)
- 4b1e6b7 Fix chaincode lifecycle tutorial invoke
- f5201e9 Minor Fix - Add channelID in snapshot mgmt logs
- 568e08c Private data edits
- 99d7182 Always Finalize the PKCS11 FindObject Operation
- 335de61 Add high level logging for snapshot generation and bootstrap from a snapshot
- 9ab2d38 Couchdb indexes during bootstrap from a sanpshot for legacy chaincodes
- 5455e2f [FAB-18111] Add docs for DevMode using new lifecycle
- 886d3cc FAB-18192 Fixed TLS certs validation for consenters. (#1888)
- e904f0e Fix table width issue
- e264d1b FAB-18244 single node catches up with snapshot (#1964)
- f4a612c Corrected to capitalized function names.
- 37b2bff Validate pvt-data during reconciliation for bootstrapped ledger (#1947)
- 4afc136 [FAB-18235] Properly handle Newest when a peer is bootstrapped from a snapshot (#1936)
- 0a9f766 Allow BCCSP config to be set using env var (#1900)
- fa0213f [FAB-18127] Chan.Part.API IT: Join as follower (#1861)
- 20eb852 Updates in master for v2.2.1 release
- 3935378 Add two and three digit publishing
- fb3ad73 Discover CLI fails fast when given inappropriate certificate file
- 79a4e01 Fix orderer/common/multichannel flake when removing channel
- 03375dc Fix TestKeyCache
- a288fe4 [FAB-18250] Check Error Before Returning Session to Pool
- fc0c3e2 Chan.Part.API: Int test for forbidden join actions
- d52a9e8 Chan.Part.API: Int tests for forbidden actions w/ system channel
- 5f09b3b Private data tutorial edits
- 69bd5cf Remove escc and vscc from list of system chaincodes
- a11fa5f Enable pvtdata store to receive pvtdata hashes during bootstrap (#1927)
- 356bf04 Fix empty address in peer CLI ClientWait log
- 1eec843 Remove GetSessionInfo Call
- bf5917f [FAB-18234] Add joinbysnapshotstatus CLI command (#1910)
- d083849 [FAB-17691] Add BootstrappingSnapshotInfo to BlockchainInfo (#1922)
- 646260e Bug Fix: Saving big payloads by cache CouchDB (#1909)
- 3a8440d Fix flakey raft/cft integration test (#1916)
- 5152bea [FAB-18234] Update fabric-protos-go dependency (#1919)
- 5bcb5e0 Implement interface SnapshotPvtdataHashesConsumer for pvtdata store (#1908)
- e801c2f [FAB-17691] Update fabric-protos-go dependency (#1914)
- d76553a [FAB-18237] always update stateInfo message upon chaincode update
- bbc5f5f [FAB-18164] Change CreateLedgerFromSnapshot to async (#1889)
- 17858a5 Update 'Using Private Data in Fabric' tutorial
- d67feb1 Bugfix in collection config history mgr
- b89e02b [FAB-18235] Update fabric-protos-go dependency (#1899)
- 379f6f0 Clarify tlsHandshakeTimeShift CLI help text (#1896)
- 39601e2 Update write_first_app.rst
- 5a372b9 Correct the explanation for signcerts in Membership section
- 6bf0542 address review comments (#1890)
- ebfd084 FAB-17911 Ch.Part.API: join system channel (#1884)
- 91f0866 pass unreconciled data to the pvtstore commit
- de6c1fa minor refactoring of missing pvtdata retrieval test
- fd8559f add config for deprioritized missing data access interval
- 2b9694d FAB-18233 Ch.Part.API: BlockPuller verify skip-genesis (#1885)
- ca9b032 Ch.Part.API: Save joinblock on JoinChannel (#1608)
- 4ce4e10 Adding notes for the usage of script during samples install
- cbf16f0 Peer CLI communicate with orderers with expired TLS certs (#1863)
- 298695a [FAB-18171] Update Raft administration guide
- 31ae545 FAB-18210 private halt() respect exported Halt()
- 9b2cada Chan.Part.API: remove system channel IT
- c22382d Chan.Part.API: implement remove system channel
- cd6ce4a [FAB-18208] Do not sign gossip message if membership is empty
- 65d0b62 Fix data race in gossip/discovery test
- 331d950 FAB-18204 Ch.Part.API: decouple multichannel and etcdraft (#1862)
- 20bd103 Minor doc fix to clear Sphinx local build error
- e7830f8 Remove dead code from gossip/state.go (#1866)
- b534995 Create statedb indexes when creating ledger from snapshot (#1864)
- d5c0fe2 [FAB-18126] Chan.Part.API IT: Join as member
- 195d69e Format code in chaincode docs
- 6179383 FAB-17915 Ch.Part.API: switch member to follower (#1847)
- 0c10c0a [FAB-18194] Fix service discovery for legacy installed chaincodes
- 75d4c8d pass unreconciled missing data info to ledger from reconciler (#1797)
- 737a116 Update RTD Placeholder
- adb5884 [FAB-18191] Remove contents of leveldb dir instead of the dir itself when dropping dbs (#1828)
- 98e706c deprioritize unreconcilable missingPvtData (#1721)
- 2ec0485 [FAB-18125] Remove removeStorage flag from channel participation API (#1780)
- 2b27d51 Fixes softhsm default config path
- 5f89938 Populate metadata-hint db from snapshot files (#1826)
- e43b104 Document the doc-merge label
- ddffd90 Update Doc Build Process Doc
- ceb56c7 Revert "[FAB-18183] Bump sphinx in requirements.txt to v1.8.5"
- fd56abb Use proto message for statedb snapshot export (#1805)
- bd7180c [FAB-18188] Log orderer and peer cert expiration date upon startup (#1804)
- 47bcd5b Revert "Peer deployment guide"
- f209329 Peer deployment guide
This list of changes was auto generated.