All Products
Search
Document Center

Add an internal organization to an external channel

Last Updated: Jul 28, 2021

After you create an organization in Alibaba Cloud BaaS, you can submit an application to add the organization to a channel in an external Hyperledger Fabric environment.

Add an internal organization to an external channel

Prerequisites

  • The addresses of peer and orderer nodes in the external channel are combinations of domain names and port numbers, which are accessible from the Internet.
  • The organizations in the external channel use the same type of state database as the organizations in Alibaba Cloud BaaS. The default state database is CouchDB.
  • If the version of a consortium in BaaS is V1.4, the Hyperledger Fabric version of the external organization is V1.4.2 or higher and lower than V2.0. If the version of a consortium in BaaS is V2.2, the Hyperledger Fabric version of the external organization is V2.2.x.
  • (Recommended) A management chaincode is deployed in every organization in the external channel to manage the organizations in a centralized manner. For more information, see Management chaincode.

Procedure

  1. (Alibaba Cloud BaaS user) Log on to the Alibaba Cloud BaaS console. In the My Organizations section of the Overview page, click the name of the target organization.

  2. (Alibaba Cloud BaaS user) Click the Channels tab and click Join Hybrid Channel in the upper-right corner.Join a hybrid channel (1)

  3. (Alibaba Cloud BaaS user) In the Join Hybrid Channel pane that appears, click Download Join Request to download the request file. Then, send the request file to the administrator of the external Hyperledger Fabric environment.Download request file

  4. (Administrator of the external Hyperledger Fabric environment) Use the blockchain platform to which the target channel belongs or the Hyperledger Fabric command-line interface (CLI) to add the organization information that is contained in the request file to the configurations of the target channel. For more information about how to use the Hyperledger Fabric CLI, see Adding an Org to a Channel. We recommend that you use the management chaincode to coordinate the tasks among the organizations in the channel in this step.

  5. (Administrator of the external Hyperledger Fabric environment) Generate a response file and send it to the Alibaba Cloud BaaS user.Response file

  6. (Alibaba Cloud BaaS user) Log on to the Alibaba Cloud BaaS console. In the My Organizations section of the Overview page, click the name of the organization to be added. Click the Channels tab and click Join Hybrid Channel in the upper-right corner.Join a hybrid channel (2)

  7. (Alibaba Cloud BaaS user) In the Join Hybrid Channel pane, upload the response file or enter the response information in the field and click Join.Upload response file

  8. (Alibaba Cloud BaaS user) Download the management chaincode, deploy it in the added organization, and bind it to the external channel. This way, the organization can manage the channel together with other organizations. For more information, see Management chaincode.