Osnadmin Channel Postscript

Example Usage

osnadmin channel join examples

Here's an example of the osnadmin channel join command.

• Create and join a sample channel mychannel defined by the application channel genesis block contained in file mychannel-genesis-block.pb. Use the orderer admin endpoint at orderer.example.com:9443.

  Copy

  
  osnadmin channel join -o orderer.example.com:9443 --ca-file $CA_FILE --client-cert $CLIENT_CERT --client-key $CLIENT_KEY --channelID mychannel --config-block mychannel-genesis-block.pb
  
  Status: 201
  {
    "name": "mychannel",
    "url": "/participation/v1/channels/mychannel",
    "consensusRelation": "consenter",
    "status": "active",
    "height": 1
  }
  
  

  Status 201 and the channel details are returned indicating that the channel has been successfully created and joined.

osnadmin channel list example

Here are some examples of the osnadmin channel list command.

• Listing all the channels that the orderer has joined. Note that the system channel will always be NULL because it is no longer supported from release v3.0 onwards.

  Copy

  osnadmin channel list -o orderer.example.com:9443 --ca-file $CA_FILE --client-cert $CLIENT_CERT --client-key $CLIENT_KEY
  
  Status: 200
  {
    "systemChannel": null,
    "channels": [
        {
            "name": "mychannel",
            "url": "/participation/v1/channels/mychannel"
        }
    ]
  }
  
  

  Status 200 and the list of channels are returned.

• Using the --channelID flag to list more details for mychannel.

  Copy

  osnadmin channel list -o orderer.example.com:9443 --ca-file $CA_FILE --client-cert $CLIENT_CERT --client-key $CLIENT_KEY --channelID mychannel
  
  Status: 200
  {
    "name": "mychannel",
    "url": "/participation/v1/channels/mychannel",
    "consensusRelation": "consenter",
    "status": "active",
    "height": 3
  }
  
  

  Status 200 and the details of the channels are returned.

osnadmin channel remove example

Here's an example of the osnadmin channel remove command.

• Removing channel mychannel from the orderer at orderer.example.com:9443.

  Copy

  osnadmin channel remove -o orderer.example.com:9443 --ca-file $CA_FILE --client-cert $CLIENT_CERT --client-key $CLIENT_KEY --channelID mychannel
  
  Status: 204
  

  Status 204 is returned upon successful removal of a channel.

osnadmin channel update examples

Here's an example of the osnadmin channel update command.

• Update the example of the my channel channel defined by the modified config contained in the my channel-config-envelope.pb file. Use the endpoint of the order administrator at order.example.com:9443.

  Copy

  osnadmin channel update -o orderer.example.com:9443 --ca-file $CA_FILE --client-cert $CLIENT_CERT --client-key $CLIENT_KEY --channelID mychannel --config-update-envelope mychannel-genesis-block.pb
  
  Status: 201
  {
    "name": "mychannel",
    "url": "/participation/v1/channels/mychannel",
    "consensusRelation": "consenter",
    "status": "active",
    "height": 1
  }
  
  

  Status 201 and the channel details are returned indicating that the channel has been successfully updated.

<a rel="license" href="http://creativecommons.org/licenses/by/4.0/"></a> This work is licensed under a <a rel="license" href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.