Getting Started
2 minute read
The GBN solution is running on VPF and ThPA cloud environments. However, in case it is desired to install the solution on the user machine, the following instructions should be followed. The solution in based on Hyperledger Fabric technology, therefore knowledge of Fabric concepts, technological stack and some experience with configuration and deployment of a Fabric network is required.
Contents
Prerequisites
Since the GBN solution is built using Hyperledger Fabric technology, and is built on top of a Fabric blockchain network, we recommend checking out Fabric prerequisites documentation to download and install all required packages and tools.
- Docker - v1.12 -> v1.19
- Docker Compose - v1.8 or higher
Download recommended docker version Docker Desktop Community 2.1.0.1 from - https://docs.docker.com/docker-for-mac/release-notes/ . (New docker version might throw errors during deployment as being incompatable with the provided Fabric containers).
- Git client - needed for clone commands
- Node.js v8.9.4 or 8.17.0 - can be downloaded from here https://nodejs.org/es/blog/release/v8.17.0/
- Xcode (in case of Mac environment)
Installation
Hyperledger Fabric network components can be run as docker containers and configured and deployed using docker-compose. The documentation for installation of fabric docker components can be found here
Download all of the requisite Hyperledger Fabric binaries and docker images as demonstrated below with curl command, and tag the images with the ‘latest’ tag. Optionally, specify a version for fabric, fabric-ca and thirdparty images. If versions are not specified, the latest available versions will be downloaded.
On the Network repository there is a install script that will execute the installation of the network and the deployment of the minimum components required. Download and execute.
bash install.sh
Testing
The test are on the Chain code copy that the install script will be cloned. Only execute the test scritps:
# Go to test chaincode dir
cd ~/gbn/gbn-datagobernance-chaincode/cc_DataGovernance
# install artifacts on cli container
./scripts/install_cc.sh
# Execute the tests
./scripts/run_tests.sh
Frontend
The production version of frontend component has been uploaded. So, in order to run it:
- Open a terminal
- Enter the project folder
- Run command http-server dist/
Credits
Component Management:
- Alexandros Zerzelidis - alexander_zerzelidis@iti.gr
- Daniel Felix Garcia - daniel.felix.garcia.latorre@nttdata.com
Chaincode development:
- Vasilis Siopidis - vasisiop@iti.gr
Network development:
- Alejandro Aparicio Blasco - alejandro.aparicio.blasco@everis.nttdata.com
- Daniel Vilas Perulan - daniel.vilas.perulan@nttdata.com
- Vasilis Siopidis - vasisiop@iti.gr
Blockchain client development:
- Vasilis Siopidis - vasisiop@iti.gr
Frontend development:
- Konstantinos Glykos - glykos@iti.gr