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

Channel Management

Peers communicate through channels. You can create channels and add organizations and peers to them.

Creating a Channel

  1. Log in to the BCS console.
  2. Click Channel Management in the navigation pane on the left. Click Create Channel in the upper right corner of the page.

    • The maximum number of channels for each instance is 2 for the basic edition and 4 for the professional edition.
    • In a consortium, channels cannot be created for invitees' instances.

  3. Select an instance, enter a channel name and description, and click OK.

Managing Channel Organizations and Peers

This operation is not supported for invitees.

  1. After the channel is created, click Manage Organization and Peer in the Operation column of the channel list.
  2. Select organizations and specify the number of peers you want to add to the channel.
  3. Click OK.

Other Operations

Table 1 Other operations

Operation

Description

Searching for a channel

Enter a channel name in the search box at the upper right corner of the Channel Management page to search for the channel.

Querying channels

A channel list is displayed on the Channel Management page. You can view the channel name, instance name, and the channel nodes.

Viewing a peer

Click View Peer in the Operation column of the channel list to view peer information by organization, including the Membership Service Provider (MSP) ID, peer details (name, IP address, port, and domain), and whether the peer has been added to the channel.

Removing peers in an organization from a channel

Click Manage Organization and Peer in the Operation column of the channel list. Decrease the value for Peers in Channel under Organizations to Join the Channel, then click OK to remove peers from the channel.

Figure 1 Managing organizations and peers
NOTE:

Keep at least 1 peer in the channel. To remove an organization from the channel, you can manually set the number of peers in the channel to 0.

Removing organizations from a channel

Click Manage Organization and Peer in the Operation column of the channel list. Under Organizations to Join the Channel, click Remove in the row that contains the target organization, then click OK to remove the organization from the channel.

Figure 2 Removing organizations from a channel
NOTE:

If an organization is listed in the endorsement policy of a chaincode, update the endorsement policy after the organization is removed from the channel. Otherwise, transactions will fail. For details, see Chaincode Management.

Deleting a channel

Click Delete in the Operation column, then click OK.

NOTE:

Clear all organization nodes in a channel before you delete it.