Updated on 2023-09-19 GMT+08:00

Forming a Consortium

After creating a consortium blockchain, you can invite tenants to join it. In addition, you can invite others through different channels to form a consortium blockchain.

  • Existing BCS instances of Fabric v1.1.0 can be upgraded to v1.4.0. BCS instances of Fabric v1.1.0 can no longer be created.
  • BCS instances corresponding to Fabric v1.4.0 can be upgraded to the version corresponding to Fabric v2.2. If one member in a consortium blockchain has upgraded to Fabric v2.2, all consortium members must also upgrade to v2.2. Otherwise, transactions will fail. For details about upgrading the version, see 3.
    • BCS v3.x.x corresponds to Hyperledger Fabric v1.4.0.
    • BCS v4.x.x corresponds to Hyperledger Fabric v2.2.
  • For existing consortium blockchains of v1.1.0, an invitee can still create a blockchain of v1.1.0 and join the consortium.

Inviting a Tenant

Create a consortium blockchain to invite others to join the consortium.

  1. Log in to the BCS console.
  2. Click Member Management in the navigation pane on the left. Click Invite Tenant in the upper right corner of the page.
  3. In the Invite Tenant window, select your BCS instance and channel, and enter the invitee's name.

    Figure 1 Inviting a tenant

  4. (Optional) Click Add Tenant to invite multiple tenants.

    A maximum of 40 tenants can be invited.

  5. Click OK. An invitation notification is sent to the invitee.

Accepting/Declining an Invitation

When you are invited to join a consortium blockchain, you will receive a notification. You can either accept or decline it.

  1. Log in to the BCS console.
  2. Click Notification Management in the navigation pane on the left. On the Notification Management page, locate the notification and click View Details in the Operation column.

    • To accept the invitation, select the organization that you want to add to the consortium, and then click Accept.
    • To decline the invitation, click Decline.
      • An invitee can select an existing BCS instance from the drop-down list box or click Create Instance to create a new one.

        An invitee can accept invitations sent by only one inviting party. To accept invitations from other inviting parties, the invitee must create new BCS instances.

        If an invitee receives multiple invitations from multiple channels of an inviting party, the invitee can create a BCS instance using one of the channels, and use the same BCS instance to accept invitations from other channels.

      • For details about how to create a BCS instance, see Instance Deployment. To successfully join a consortium blockchain, certain parameters of your instance must have the same settings as the inviting party's BCS instance, such as the blockchain type, consensus mechanism, and security mechanism. Therefore, these parameters are dimmed on the instance configuration page and cannot be modified.