Skip to content

fix(gh-5510): set 3.1.5 as bootstraip and install-fabric defaults#5511

Closed
syndbg wants to merge 1 commit into
hyperledger:mainfrom
syndbg:fix-stale-setup-instructions
Closed

fix(gh-5510): set 3.1.5 as bootstraip and install-fabric defaults#5511
syndbg wants to merge 1 commit into
hyperledger:mainfrom
syndbg:fix-stale-setup-instructions

Conversation

@syndbg

@syndbg syndbg commented Jul 12, 2026

Copy link
Copy Markdown

Type of change

  • Bug fix

Description

The installation documentation states that the latest Fabric version is installed by default, but install-fabric.sh and bootstrap.sh default to v2.5.16.

This can pair v2.5 binaries and images with fabric-samples main, whose optional BFT configuration requires Fabric v3.0 or later. configtxgen then rejects the SmartBFT and ConsenterMapping configuration keys.

When running the BFT test-network scenario:

./network.sh createChannel -bft

configtxgen fails with:

  Error unmarshalling config into struct:
  * 'Profiles[ChannelUsingBFT].Orderer' has
  invalid keys: ConsenterMapping, SmartBFT

This PR updates the installer defaults, generated help output, and documentation to the latest Fabric release, v3.1.5.

Additional details

Tested via:

  • Executing scripts/install-fabric.sh
  • Executing scripts/bootstrap.sh
  • ./scripts/install-fabric.sh -h that it correctly shows the default too.

Related issues

Fixes #5510

  • Update scripts/bootstrap.sh and scripts/install-fabric.sh to default to the latest release v3.1.5

@syndbg syndbg requested review from a team as code owners July 12, 2026 21:43
@syndbg syndbg force-pushed the fix-stale-setup-instructions branch from eb4017d to a71aaae Compare July 12, 2026 21:43
…faults

As mentioned in hyperledger#5510,
BFT config in fabric-samples requires Fabric 3.x.x

Signed-off-by: Anton Antonov <anton.synd.antonov@gmail.com>
@syndbg syndbg force-pushed the fix-stale-setup-instructions branch from a71aaae to 7e78358 Compare July 12, 2026 21:44
@pfi79

pfi79 commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

We'll make version 3 the default when it becomes LTS.
The documentation says that only v3 works with bft
Currently in install-fabric.sh you can transfer the fabric version by running install-fabric.sh --help

@pfi79 pfi79 closed this Jul 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Default installer pairs Fabric v2.5.16 with incompatible fabric-samples main

2 participants