IBM Blockchain Images
IBM Blockchain Docker images are based on Hyperledger Fabric v1.0 with a number of enhancements for serviceability. These images also benefit from a complete series of tests for functionality, stability, and performance across the following supported system platforms: z Systems and LinuxONE (s390), Power (ppc64le), and x86.
Once testing is complete, IBM signs the images and places them on the IBM Blockchain Docker Hub repository (https://hub.docker.com/r/ibmblockchain/). Eligibility for an IBM support agreement is based on the use of these images.
From this site, you can access IBM Blockchain Docker images, information, and links to successfully download and run IBM Blockchain. IBM Blockchain is an implementation based upon the Linux Foundation's open source Hyperledger Fabric project. This open source project consists of code contributions by active Hyperledger Fabric members.
The IBM Blockchain code is based upon the Hyperledger Fabric v1.0.0-rc1 code level and enhanced for serviceability.
Technical support may be purchased only when using the IBM Blockchain images available from the IBM Blockchain Docker Hub repo. Support will not be provided for images that have been altered. Please see the Getting Support section below for more information.
Samples provided for blockchain network setup are intended only as examples, and should not be used as a prescription for setting up, administering, and operating an individual blockchain network or solution. For additional help setting up and operating a blockchain network, IBM recommends use of IBM Lab Services.
Additional information can be found below under the heading Documentation Links.
All downloadable images are supported on platforms capable of running the required prerequisites, provided in the Getting Started information.
Sample Network Setup
Refer to the "first-network" subdirectory in the fabric-samples repository for a series of sample docker-compose scripts. Instructions for running a network against these files can be found in the Build Your First Network section of the Hyperledger Fabric documentation.
These are sample docker-compose yaml files that contain the fundamental components for a Fabric network. They are not meant to be a prescriptive approach to your individual network or solution. However, the exposed configuration provides a functional baseline from which you may begin building out your network. To leverage the IBM Blockchain docker images, you need to make a few minor alterations to the file(s). As per standard docker implemenation, each container is specified against an image. You'll notice that the Hyperledger Fabric docker-compose files are appropriately tagged against Hyperledger Fabric Images. Simply replace the Hyperledger Fabric
image specification with the IBM Blockchain specification and drop the architecture (x86_64, ppc64le, s390x) from image.
version: '2' services: orderer.example.com: container_name: orderer.example.com image: hyperledger/fabric-orderer:x86_64-1.0.0-rc1 environment: - ORDERER_GENERAL_LOGLEVEL=debug - ORDERER_GENERAL_LISTENADDRESS=0.0.0.0 - ORDERER_GENERAL_GENESISMETHOD=file - ORDERER_GENERAL_GENESISFILE=/etc/hyperledger/configtx/twoorgs.genesis.block - ORDERER_GENERAL_LOCALMSPID=OrdererMSP - ORDERER_GENERAL_LOCALMSPDIR=/etc/hyperledger/msp/orderer working_dir: /opt/gopath/src/github.com/hyperledger/fabric/orderer
version: '2' services: orderer.example.com: container_name: orderer.example.com image: ibmblockchain/fabric-orderer:1.0.0-rc1 environment: - ORDERER_GENERAL_LOGLEVEL=debug - ORDERER_GENERAL_LISTENADDRESS=0.0.0.0 - ORDERER_GENERAL_GENESISMETHOD=file - ORDERER_GENERAL_GENESISFILE=/etc/hyperledger/configtx/twoorgs.genesis.block - ORDERER_GENERAL_LOCALMSPID=OrdererMSP - ORDERER_GENERAL_LOCALMSPDIR=/etc/hyperledger/msp/orderer working_dir: /opt/gopath/src/github.com/hyperledger/fabric/orderer
Once you have made these alterations, you can proceed with customizing and running your Fabric instance.
For additional learning and assistance on administering and operating a blockchain network, refer to the following links:
Educational information: IBM DeveloperWorks
Educational and technical information: Hyperledger Fabric Documentation
Docker specific information: Docker Documentation
FAQs and troubleshooting: Stack Overflow
When building production networks, IBM offers technical support which can be purchased. Start by ordering through Passport Advantage and Passport Advantage Express
Additional Support Channels
- Connect with IBM Blockchain expertise at the IBM Blockchain Support page.
- Rocket Chat is a great resource to consult with the Hyperledger Fabric community and component subject matter experts.