This document provides an overview of deploying and using IBM Blockchain Platform, which leverages Hyperledger Composer. It discusses key concepts like assets, participants, and transactions. It then outlines the workflow for developing and deploying a business network, including defining the structure, packaging it, generating definitions, and more. It also covers how to interact with the network by retrieving certificates and installing/starting it. Finally, it discusses deploying the REST server to IBM Cloud by using Cloudant as a cloud-based wallet to store network cards and share them, as well as deploying the composer-rest-server docker container.

1. Blockchain on IBM Cloud
Definition and deploy: high level overview
Simone Romano
simone.romano1@ibm.com
08/2018 / © 2018 IBM Corporation

2. IBM® Blockchain Platform
08/2018 / © 2018 IBM Corporation
IBM® Blockchain Platform leverages the Hyperledger
Composer open source development toolset
Key concepts:
• Assets
• tangible or intangible goods, services, or property, and are
stored in registrie
• Participants
• Participants are members of a business network. They may own
assets and submit transactions
• Transactions
• Transactions are the mechanism by which participants interact
with assets

3. IBM® Blockchain Platform
08/2018 / © 2018 IBM Corporation
BND - Business Network Definition
yo hyperledger-composer:businessnetwork

4. IBM Blockchain deploy workflow
08/2018 / © 2018 IBM Corporation
Develop the network
Creating the business
network structure
Defining the business
network
Packaging the business
network
Deploy the network
Generate the
business network
definition (BND)
Modelling assets,
participants, and
transactions
Generate the
deployable
business network
archive file (.bna)
Interact with the network
Retrive admin secret
Creating a certificate
authority card
Adding the certificates to
the Starter Plan instance
Creating an admin
business network card
Installing and starting the
business network
Ping the business network
to ensure it is running
correctly
doc doc
composer network
ping -c admin@my-
network
Installing the REST server
Running the REST server
doc
Deploy the REST server
Create Cloudant Service
Share network card
through Cloudant
Deploy composer-rest-server
docker on IBM Cloud

5. Deploy the REST server
08/2018 / © 2018 IBM Corporation
Deploy the REST server
Create Cloudant Service
Share network card
through Cloudant
Deploy composer-rest-server
docker on IBM Cloud
• By default, composer store the cards local /home/user/.composer
• To be able to expose the REST APIs we need to use a cloud-based
wallet:
• Cloudant is a solution
Workflow:
• Install composer-wallet-cloudant
• npm install -g @ampretia/composer-wallet-cloudant
• Create the cardstore-cloudant.json file
• Create the cloudant database (more details here)
• Update the cardstore-cloudant.json file (more details here)
• export NODE_CONFIG=$(cat cardstore-cloudant.json)
• Now each composer operation will use the cloudant wallet and
not the locally cards store
• Create and import a new card to cloudant wallet
• composer card create
• composer card import
• Deploy ibmblockchain/composer-rest-server docker to ibmcloud by
specifying the NODE_CONFIG environment variable (more details here –
step 10)

6. References
08/2018 / © 2018 IBM Corporation
• Hyperledger Composer
• Develop the network
• Deploy the network
• Interact with the network
• Expose REST APIs through docker
• Troubleshooting:
• Runtime not compatible
• Runtime not compatible - docker