This public repository is read-only and no longer maintained.
Deploying an Odometer Application using MultiChain or Hyperledger Fabric blockchain technology.
In this hands-on example you will use either MultiChain or Hyperledger Fabric blockchain technology to develop and deploy a basic odometer application. This showcases how the service can be used to prevent mileage fraud in vehicles, with the blockchain rejecting any values lower than the previously entered mileage.
This use case is particularly useful when buying and selling vehicles, ensuring that no attempts have been made to dial back the mileage travelled to date.
To deploy this application on the MultiChain service you should have the following:
- A paid commerical SAP Cloud Platform Account, and a MultiChain subscription. This is a paid product, and is not available in demo
- A familiarity with creating MultiChain service instances
- An understanding of MultiChain streams and how they can be viewed on the MultiChain dashboard.
- Downloaded and install the Cloud Foundry command-line tool
- Downloaded and extracted the application source files from GitHub
- Have access to HTTP client software or library of your programming language of choice. In our example we use Postman, but should stress that this is not officially affiliated with SAP or the MultiChain Service.
- Have a good understanding of JSON-RPC commands and knowledge of using the command-line tool.
To download and deploy the MultiChain application, follow the below steps:
-
First download and extract the Odometer application source files from the SAP GitHub to your local computer.
-
Next create a MultiChain service instance with the name
mc-odometer. -
Now open the command-line tool and login to the Cloud Foundry using the command
cf login. You will then be asked for your User ID and Password. -
Once logged onto the Cloud Foundry, select your SAP Cloud Platform Organization and Space.
-
Now deploy your application using the command
cf push -f manifest-mc.yml.
The app will now be deployed to your global account on the SAP Cloud Platform.
When checking the manifest, you will see the following:
applications:
name: car-odometer-multichain
memory: 128M
disk_quota: 512M
buildpack: https://github.com/cloudfoundry/nodejs-buildpack.git
command: npm run start
host: car-odometer-multichain
services:
- mc-odometer
env:
multichainServiceName: mc-odometer
This means that the app has been successfully deployed, bound to your MultiChain service, and started in your global account.
To deploy this application on the Hyperledger Fabric service you should have the following:
- A familiarity with creating Hyperledger Fabric service instances: https://help.sap.com/viewer/9d945c48156348aabea50a88d4661033/BLOCKCHAIN/en-US/4c137a58ef7142d1b2e09aa791befe17.html
- An understanding of Hyperledger Fabric channels and how they can be viewed on the Hyperledger Fabric dashboard.
- Downloaded and installed the Cloud Foundry command-line tool: https://docs.cloudfoundry.org/cf-cli/install-go-cli.html
- Downloaded and extracted the application source files from GitHub: https://github.com/SAP/cloud-blockchain-odometer-example/archive/master.zip.
- Have access to HTTP client software or library of your programming language of choice. In our example we use Postman, but should stress that this is not officially affiliated with SAP or the MultiChain Service.Have a good understanding of JSON-RPC commands and knowledge of using the command-line tool.
To download and deploy the Hyperledger application, follow the below steps:
-
First download and extract the Odometer application source files from the SAP GitHub to your local computer.
-
Next create a Hyperledger Fabric channel service instance with the name
hlf-odometer. This requires you to select 'Channel' when prompted for your service instance plan. -
Now open the command-line tool and login to the Cloud Foundry using the command
cf login. You will then be asked for your User ID and Password. -
If necessary, select your SAP Cloud Platform Organization and Space.
-
Now deploy your application using the command
cf push -f manifest-hlf.yml.
Note: If you receive the error “The route car-odometer-multichain.cfapps.sap.hana.ondemand.com is already in use”, the app was already deployed on your landscape.
The app will now be deployed to your global account on the SAP Cloud Platform.
When checking the manifest, you will see the following:
applications:
name: car-odometer-hyperledger
memory: 128M
disk_quota: 512M
buildpack: https://github.com/cloudfoundry/nodejs-buildpack.git
command: npm run start
host: car-odometer-hyperledger
services:
- hlf-odometer
env:
ServiceName: hlf-odometer
This means that the app has been successfully deployed, bound to your Hyperledger service, and started in your global account.
There is no support provided for this application.
Copyright (c) 2019 SAP SE or an SAP affiliate company. All rights reserved. This file is licensed under the SAP Sample Code License except as noted otherwise in the LICENSE file: https://github.com/SAP/cloud-blockchain-odometer-example/blob/master/LICENSE