Add Oracle Blockchain Platform Participant Organizations to the Network

This topic contains information about joining an Oracle Blockchain Platform participant organization to an Oracle Blockchain Platform network.

Typical Workflow to Join a Participant Organization to an Oracle Blockchain Platform Network

Here are the tasks the founder and participants organizations need to perform to set up a blockchain network.

Adding Participant Organizations to a Blockchain Network

Task Who Does This? Description More Information
Export the participant organization's certificates and import them into the network

Participant organization outputs certificates

Founder organization uploads certificates

In the participant organization's instance, use the wizard to output the certificates into a JSON file and sends them to the founder organization.

The founder uploads the certificates to add the participant to the network.

Join a Network

Import Certificates to Add Organizations to the Network

Download the founder organization's ordering service settings information and upload it to the participant organization

Founder organization downloads ordering service settings information

Participant organization uploads ordering service setting information

In the founder’s instance, download the ordering service settings information (JSON file).

Then in the participant’s instance, use the wizard to upload the ordering service settings. This enables the participant to communicate on the network.

Join a Network
Export and import the participant organization's peer nodes

Participant organization exports peers

Founder organization imports peers

In the participant’s instance, export the peers that you want to use on the network.

Then in the founder’s instance, import the peer nodes.

Export and Import Peer Nodes

Join Participant Organizations to the Channel and Set Anchor Peers

Task Who Does This? Description More Information
Create a channel Founder organization

In the founder’s instance, create a channel that the founder and participants use to communicate. Add the founder’s peers to the channel.

You must select any newly added participants and assign them permissions on the channel.

Note that instead of creating a new channel, you can add participants to an existing channel.

Create a Channel
Join participants to the channel Participant organization In the participant’s instance, join the channel that was created in the founder’s instance. Join a Peer to a Channel
Set anchor peers on the founder and participants

Founder organization

Participant organization

In the founder and participant instances, specify which peers you want to use as anchor peers. You must select at least one anchor peer for each member. Add an Anchor Peer

Deploy the Chaincode Across the Blockchain Network

Task Who Does This? Description More Information
Install the chaincode on the founder Founder organization In the founder’s instance, upload and install the chaincode. Choose the peers to install the chaincode on. Use Quick Deployment
Instantiate the chaincode and specify an endorsement policy on the founder Founder organization

In the founder’s instance, instantiate the chaincode to activate it on the network.

An endorsement policy is required to specify the number of members that must approve chaincode transactions before they’re submitted to the ledger.

Instantiate a Chaincode

Specify an Endorsement Policy

Install the chaincode on the participant Participant organization

In the participant’s instance, install the chaincode that your network will use.

Because you’ll install the same chaincode that you installed and instantiated on the founder, you don’t need to instantiate the chaincode on the participant. When the participant installs the chaincode, it’s already instantiated.

Use Quick Deployment

Expose the Chaincode’s REST API and Run Transactions

Task Who Does This? Description More Information
Configure the founder’s REST proxy node Founder organization In the founder’s instance, modify the REST proxy node’s attributes to specify the channel, chaincode, and peers that the network will use for transactions. View and Edit the REST Proxy Node Configuration
Configure the participant’s REST proxy node Participant organization In the participant’s instance, modify the REST proxy node’s attributes to specify the channel, chaincode, and peers that the network will use for transactions. View and Edit the REST Proxy Node Configuration
Invoke the chaincode and monitor network activity and ledger updates

Founder organization

Participant organization

Begin using your network’s chaincode for transactions.

Both the founder and the participants can use their consoles to find out information about the activity on the network. Specifically, you can use the console’s Channels tab to locate information about specific ledger transactions

Find Information About Nodes

View a Channel’s Ledger Activity

Join a Network

Participant organization are required to complete a wizard to join a blockchain network. The wizard displays the first time the participant organization opens its instance.

The wizard assists the participant organization with exporting the certificates to a JSON file to give to the network founder. The wizard also helps the participant import the founder’s ordering service settings. For more information about the steps the founder and participant must complete to create a network, see Typical Workflow to Join a Participant Organization to an Oracle Blockchain Platform Network.
The participant’s dashboard won’t display until the wizard has been completed. If you're a network founder, then this wizard is never displayed.
  1. Open the participant organization's console.
    The wizard that you’ll use to join a network is displayed.
  2. In the wizard, click Export Certificates and click the Export button.
    The Export dialog is displayed and includes the name of the JSON file the export will create.
  3. Specify where to save the file. Click OK to save the certificates file.
  4. Send the certificates JSON file to the network’s founder. The network founder will import the participant’s certificates file into the network.
  5. Get the ordering services settings JSON file from the network founder. You'll import this file into your instance.
  6. In the wizard, click Import Ordering Service Settings.
  7. Click Upload Ordering Service Settings.
    The File Upload dialog is displayed.
  8. In the File Upload dialog, browse for and select the JSON file containing the founder’s ordering service settings information. Usually this file is named <founderinstancename>-orderer-settings.json. Click Open.
    The Current Orderer Address field updates with the address that Oracle Blockchain Platform extracted from the JSON file.
  9. Click Submit.
    Your console’s Dashboard tab is displayed.