Master Node Setup
The Master Node includes several services:
- dashboard: Provide Web UI for operators.
- restserver: Provide RESTful APIs for chain consumers.
- watchdog: Watch for health checking.
More details can be found at the architecture doc.
It can be deployed by in 2 steps.
- Clone code
- Run setup script
- Hardware: 8c16g100g
- Docker engine: 1.10.0~1.13.0 (Docker 17.0+ support is experimental)
- docker-compose: 1.8.0~1.12.0
You may check
make are installed to clone the code.
$ sudo aptitude install git make -y $ git clone http://gerrit.hyperledger.org/r/cello && cd cello
Command help - make
To know more what the following make commands does please refer make_support page.
For the first time running, please setup the master node with the setup.sh.
$ make setup-master
Make sure there is no error during the setup. Otherwise, please check the log msgs.
To start the whole services, please run
$ make start
To stop or restart the whole services, run
make stop or
Redploy a service
To redeploy one specific service, e.g., dashboard, please run
$ make redeploy service=dashboard
To check the logs for all the services, please run
$ make logs
To check the logs for one specific service, please run
$ make log service=watchdog
Now you can access the
MASTER_NODE_IP:8080 to open the Web-based operational dashboard.
The application configuration can be imported from file named
By default, it also loads the
config.py file as the configurations.
The mongo container will use local
/opt/cello/mongo path (Must exist locally) for persistent storage.
Please keep it safe by backups or using more high-available solutions.
Work with MacOS
In MacOS, Docker cannot mount local path from host by default. Hence for mongo container data volume, users need to:
- Make sure the
/opt/cellopath exists locally, and it is writable for the current user account.
make setup-mastershould handle this already.
- Add the path to sharing list in the preference of Docker for MacOS, to make it mountable by container.
This work is licensed under a Creative Commons Attribution 4.0 International License.