v2.2.5 Release Notes - January 28, 2022

Fixes

orderer - Fix bug when an orderer crashes at channel creation

This fix handles a scenario where an ordering service node crashes during channel creation.
Previously the ordering service node would attempt to re-create the channel upon next startup,
resulting in a panic with the following error:
"Error creating chain support: error creating consenter for channel: failed to restore persisted raft data: failed to create or read WAL: failed to open WAL: fileutil: file already locked".

peer - Discovery service does not consider full set of endorsement options

Due to a bug in the permutation logic, the discovery service may not consider the
full set of endorsement options for a given endorsement policy, potentially resulting in the following error:
"no peer combination can satisfy the endorsement policy".
The fix ensures that all endorsement options are considered for a given endorsement policy and set of peers.

Dependencies

Fabric v2.2.5 has been tested with the following dependencies:

Go 1.17.5
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
peer.deliveryclient.blockGossipEnabled: 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:

f7318ff Release commit for v2.2.5
c04cd7d Bump Go to 1.17.5 (release-2.2) (#3186)
4996e82 - Fix failure to generate all possible combinations (backport #3132) (#3150)
162f867 Add Information about AWS HSM
fcdc0b5 Backport setEvent information to 2.2 [ #2958 ]
acf88a0 [Backport] #2936 to release-2.2 (#2953)
eddb470 Unit test flake when rpc server stream not closed (backport #2935) (#2942)
19a137b Fix broken links for international workgroups (#2920)
2088b5f Update docs for Jira to GitHub issue transition
263ca9e Release commit for v2.2.4 (#2901)

See More

029e6ed Fixed a typo in private_data_tutorial
1eedcff Update Go to v1.16.7 and alpine to 3.14 (release-2.2)
851f838 Fix process termination waits in health tests (#2889)
e6a6a61 platform/golang: loosen assertion for Go 1.16.2 (release-2.2)
ba2a9f1 deps: bump testify (release-2.2) (#2886) [ #2336 ]
50064c8 Update x509.CertPool equality checks (#2880)
f441ba2 Change name of test network docker network in 2.2
859c7d5 Clean up Go modules (release-2.2) (#2876)
07ac9f5 Stop spamming for wait channel acquirement in orderer integration test
b076bd7 Options for GRPC message size configurable
c91b546 Change name of comm msg size default consts
da9e1bd Refactor max message sizes in comm client config
fbf7b93 FAB18529 added nil check in channel header parsing
9a6b351 Additional documentation for implicit private data collections
8fd2ad8 [FAB-18509] Stop panic of collection index path is wrong (#2726) (#2744)
62c68d1 Updated enrollUser function in write_first_app Doc (#2713)
a0dcb5c Update docs to clarify that an implicit collection can not have an index
2f7fd17 Fixed grammatical errors
f36fe03 [Doc-Update] + What is a commercial paper section
8b1d355 Fix a typo in CouchDB tutorial
4c77749 Fix typo
f3f170f Fix peerchaincode.md as well
30a0931 Add explanation of --ctor JSON string
b926247 Clarify orderers seeing the transaction data
f4feedb Cherry pick deploy CC fixes into release-2.2
68bc522 Clarify "identity expired" error messages (#2685) (#2688)
3a69034 Fix spelling mistakes in the Github Contributions page
ccecf10 [FAB-18484] Return transaction forwarding result back to the client synchronously
7e61944 [FAB-18487] Update broken link in 2.2 branch
186d9bf Typo fix in peer deployment guide in main (#2660)
31e41ce Update private_data_tutorial.rst
4cb453e Fix jq commands in create channel tutorial (#2662)
8851da3 Back port 2023 - skip empty ledge and 2635 - RetrieveBlockByNumber (#2648) [ #2023, #2635 ]
cc50451 Clarify doc for readset validations (#2647) (#2655)
3548215 Update secured_private_asset_transfer_tutorial.md
56b3689 [FAB-18479] Log error if orderer can't forward SubmitRequest to Raft leader
dd7e921 fix duplicate entry in code snippet
7871c26 Optionally disable gossip block forwarding (#2606)
bce75cf Update docs/source/upgrade_to_newest_version.md
678523b Govendor added to documentation
26b45ca Deploy a chaincode to new channel command issue
3f2158a Improve error message for invalid consenter cert (#2587)
94ace65 v2.2.3 release commit
d272122 Cherry pick removing duplicate word (#2523)
222fbc8 Add Security Model topic to docs
8116872 Fix link in international_languages.md
496c5f5 integration: PKCS#11 SKI to CKA_ID mapping test
d2d031e pkcs11: Add SKI to CKA_ID mapping for BCCSP [ #11 ]
7214be7 Prevent race that occurs after test timeout
6adcbce integration: backport chaincode_server_test
8843223 Back-fill tests for externalbuilder.Duration
796f760 This commit upgrades goleveldb. This upgraded version includes a fix for [ #2463 ]
fae13c3 Report correct reason of stream abort in orderer cluster
2b2e154 Log stream total lifetime
100a7e7 corrected organization labels
6320aed corrected Org1 text in Org2 box to Org2
8d0645b Update build to use Go 1.15
6cb530b Change string cast of int value to rune cast
d539244 Directives are in comment text instead of groups
a1b4d2d Implement legacy name constraints verification
4321503 Add test to assert on name constraint behavior
880914c Re-encode ECDSA CRL signature during MSP setup
8883d71 Add test to exercise signature validation change
cb3c87b deps: bump github.com/pkg/errors
f635afd Adjust etcdraft error assertions for go 1.15
5f19a00 Replace test cert fixtures with generated certs
aa7ad4f Set SKI, support multi hosts, add Signer to CA
684e255 Fix typos in a "Developing Applications" doc
358cba7 Update AZP Service Connection Name
913d2ab Prepare for next release v2.2.3 (#2347)
eb2b1ea Add peer log message for failure to invoke chaincode (#2339)
0583c22 Add test newtork download instructions to create a channel tutorial
bebb75f v2.2.2 release commit
a80c772 Add release notes for v2.2.2 (#2232)
1de0825 Fix the issue of Nil/Zero-length-byte-array value (#2310)
e5ecdef Remove system channel from Test Network tutorial
c25eb86 [FAB-15648] document update: Non-TLS orderer with etcdraft usage (#1678)
a861c00 cherry pick test network doc chaincode deployment fix
10c7839 Remove unreachable and unnecessary code in gossip membership (#2295)
6805515 Orderer deployment tutorial update
fba5d90 [doc] fix broken link
48bad48 [FAB-18170] Endorsement policy page discusses NodeSDK
ee8fcfc [FAB-18392] Clarify scope and limitations of test network
90326b8 [FAB-18252] Documentation should reference Java chaincode support
813be7f Remove anchor peers from configtx.yaml tutorial (#2257)
11526cf Cherry pick org3 edits to release-2.2 branch (#2256)
5953056 Split command in "add an org to network" tutorial
91d9621 Add more details to logging specification examples
7b1dbf1 Update image filter used by integration tests
2a8d96c Remove Short Names and Replace With Full Path in Fabric
b2a5aec Check correct error
73b39dc [FAB-18378] Log warning when peer is lagging behind and cannot catch up
d5d9965 [FAB-17039] Skip retrieving pvtdata from transient store when txid is missing (#2183) (#2201)
3496dfc [FAB-17954] Document CouchDB JSON determinism (#2187)
26cbec6 [FAB-18323] CherryPick: remove ephemeral from BCCSP SW options (#1553)
db9a56f Fixes Hardened to Hardware
a381654 remove repeated the
bbaa5b8 update private-data sample instruction for Asset owner string
82b4566 Remove reference to first-network
0a1fc23 [FAB-17727] Log warning if system channel has no consortium members (#2149)
935a5c2 Deploy production ordering service doc
c928359 Add release note for RSA CA changes
50ca5d4 Add integration test for MSPs with RSA CA certs
b3646e5 Restore RSA support for x509 public key import
4026413 Add check for invalid key before hitting couchdb (#2133) (#2135)
b8a095f Add persistent volume note to peer deploy guide
bf2ebb6 [FAB-18298] Default cluster cert and key (#2119)
cae9a63 Update Go to 1.14.12
b247ed4 Revert "Allow BCCSP config to be set using env var (#1900)"
d1b4524 Update Jira instructions in contributing guide
d1730da Cherry pick [FAB-18290] Add channel name to pvtdata reconciler log msgs (#2091)
99c2d12 Deduplicate orderer server TLS root CAs
1e15b64 Log TLS handshake duration
9c5b283 FAB-18244 single node catches up with snapshot (#1964) (#2021)
09234c0 Remove common name from private data doc
5a37306 Fixed TLS certs validation for consenters (release-2.2) (#2005) [ #1888 ]
6f3ad12 [FAB-18270] Disable debug of CouchDB response body
4d40d65 Peer deployment guide
70c41c1 Update help text in test net tutorial
8930c8c Fix Node OU error message
ab7104a Update release docs
4a63642 Cherry pick private data tutorial rebase
e36ca29 Add Troubleshooting topic to Test Network for Docker Desktop setting
e05c443 Allow tick interval override via orderer.yaml
32cb396 Fix chaincode lifecycle tutorial invoke
ceb23df Always Finalize the PKCS11 FindObject Operation
2d59f18 Corrected to capitalized function names.
6a370f7 Fix table width issue
f2e9e6e Allow BCCSP config to be set using env var (#1900)
6bd0699 Exercise a full end-to-end flow with PKCS11 (#1717)
0b3b95f removed unused variable
bf0b300 [FAB-17129] Configure peer and orderer to use PKCS#11 as BCCSP in integration test
8407bc8 Prepare for next release v2.2.2
74ac27c Add two and three digit publishing
344fda6 Release commit for v2.2.1
bebb5d8 Cherry pick secured asset transfer tutorial to 2.2
ba9eaff [FAB-18041] Add Node.js to CC as external service
107a867 Remove No Longer Relevant Release Note
99a01b2 Update release notes with FAB-18250
7b7ad6b Fix missing word
f9f3caf Add change in documentation to explain how to add collaborators in translation
61c05b8 [FAB-18250] Check Error Before Returning Session to Pool (#1937)
765bb73 Remove escc and vscc from list of system chaincodes
9906643 Update v2.2.1 release notes with latest fixes
c5cf627 Fix empty address in peer CLI ClientWait log
75046cf Remove GetSessionInfo Call
2e4527b Bug Fix: Saving big payloads by cache CouchDB (#1909)
fe684f8 Fix flakey raft/cft integration test
e2fa653 Add release notes for v2.2.1
6b1ac6f [FAB-18237] always update stateInfo message upon chaincode update
f32cb81 Bugfix in collection config history mgr (#1904)
3ee47a7 fix function name typo in store private data command
ffcbf25 Clarify tlsHandshakeTimeShift CLI help text (#1894)
673c364 Correct the explanation for signcerts in Membership section
68d13ed Update write_first_app.rst
dc8660b Regenerate peer CLI docs
6c9abf9 Peer CLI communicate with orderers with expired TLS certs (#1863)
6f76408 Bump fabric-config dep to 0.0.7
c5c1105 address review comments (#1890) (#1893)
a5a6acd pass unreconciled missing pvtdata to pvtdata store (backport to release-2.2) (#1886)
ee2bc1b pass unreconciled missing data info to ledger from reconciler (#1797)
bc00758 construct unreconciled missing pvtdata (#1699)
e500de9 deprioritize unreconcilable missingPvtData (#1721)
10cb4ea mv oldpvtdata commit to separate file
7eaead1 refactor pvtdatastore
659fe39 Adding notes for the usage of script during samples install
2d895c4 [FAB-18208] Do not sign gossip message if membership is empty
42da963 Convert Azure Pipeline To Stages (#1874)
6a02559 Fix data race in gossip/discovery test
7dcd9fd Minor doc fix to clear Sphinx local build error
09764d8 fix missing err check in the block commit path (#1543)
cc6dc99 minor cleanup of pvtdatastore
20f0697 reset leveldb batch after the commit
bebe131 Use directly leveldb batch (#1507)
99332da [FAB-18194] Fix service discovery for legacy installed chaincodes
0bd0ab2 Update RTD Placeholder
ef2632e [FAB-18191] Remove contents of leveldb dir instead of the dir itself when dropping dbs (#1828)
8dae484 [FAB-18120] Adding DevMode integration test for new lifecycle.
9da753a [FAB-18169] Add DevMode support in ChaincodeEndorsementInfoSource
8bbedb8 Revert "[FAB-18183] Bump sphinx in requirements.txt to v1.8.5"
bf8f6fc [FAB-18188] Log orderer and peer cert expiration date upon startup (#1804)
0e52fff [FAB-18171] Disregard certificate validity period in intra-orderer communication
445b997 [FAB-18183] Bump sphinx in requirements.txt to v1.8.5
2fc575c Cache bccsp keys generated from getECKey
7b8de81 Add object handle cache to PKCS#11 bccsp provider
bf2f3fc Make ecPoint a method on impl
2a22160 Make findKeyPairFromSKI a method on impl
86a5c64 Replace loadLib with initialize method
8a63732 Merge pkcs11/impl.go and pkcs11/pkcs11.go
f47ac7d Drain session pool before creating new sessions
4fd232e Add instructions for how to use @Mergifyio backport command
2d522b5 Update Add an Org to a Channel tutorial
2813aba Updates to CouchDB doc tutorial
4919fa7 Updated Using CouchDB to use asset transfer ledger queries smart contract
64c7600 Update Channel Update (Adding an Org) tutorial
7d6bb0f Update docs to replace fabcar references with basic asset transfer
1450e3c Add links for Go and Java sample applications
b8b7af7 Refactor tutorial to 'Writing Your First Chaincode'
14ad1d7 [FAB-18109] Update peer chaincode invoke
e042657 Fix code snippet display (#1759)
9783edb Write Your First App tutorial updates (#1757)
9563518 Update "Deploying a smart contract" tutorial. (#1756)
417bcd4 Update "Using the Fabric Test network" tutorial (#1755)
0b598c4 Update Write Your First Application Tutorial (#1754)
c4e310d Remove Use of Manifest Tool
5f16da8 Update RTD to Target Correct GH Release Branch
6491f6a Fix and improve discovery TLS authentication comments in document
50aea5e Update doc to reflect change in FAB-18163 (#1729)
25a5c40 FAB-18163 TLS Timeshift w/o Separate Cluster Port (#1724) (#1725)
f60c78a Add Raft metrics to Raft config doc
c932bb4 Use correct gossip SecretEnvelope reference
2821cfc Log Error When PKCS11 Key Not Found (#1679)
cce8553 fix: modify certificate alternate DNS duplication
6e97dd0 fix glossary.rst by reverting commit 21fa648
8d590c6 typo fix
05655d0 Fix link in Develop apps doc
67ce3cb Fix: Missing addToWallet.js in ls command output
534e87a Add link to Use a CA to deployment guide
9099e5b Fix international language make html instructions
3741860 Raft: Check suspect info once per suspect interval (#1600)
03f0544 Add LTS release status to What's New doc.
6be80ae Print channel name in learnAnchorPeers
dd556f3 Advice for translators, PRs and tools
5dc22d5 Remove ccenv dependency in platforms unit test
9bca8d6 Changes for i18n
5f11b9b Simple Typo fix
5ea85bc Fabric v2.2.0 release commit
7b1a1a2 Add release notes for v2.2
d2dfc63 Improve peer CLI error message when no orderer address passed (#1555)
9c3c599 [FAB-18054] Remove default value for top level orderer addresses if (#1550)
ff00d9b Improve private data logging (#1545)
62dfb2d Add org name to consortium error message
0de7fc1 Restore couchdb logger (#1532)
2169710 Use tcp for statsd and poll for metric arrival
568d346 Fix chaincode package example path
ac3f596 Remove Thirdparty Images From Bootstrap Script
9b187f5 Edits to style guide
a6ad407 Upgrade updates
8fd785a Deploy Chaincode Doc
4591d52 Add Check For CouchDB 3.1 (#1491)

This list of changes was auto generated.

hyperledger/fabric v2.2.5 on GitHub

v2.2.5 Release Notes - January 28, 2022

Fixes

Dependencies

Deprecations (existing)

Changes:

hyperledger/fabric v2.2.5
on GitHub