This readme provide instructions on how to run blobber locally
- Clone the Blobber repository using the command
git clone https://github.com/0chain/blobber.git
- In the git/blobber run the following command
chmod +x ./docker.local/bin/blobber.init.setup.sh
./docker.local/bin/blobber.init.setup.sh
NOTE: For mac user please run below:
chmod +x ./docker.local/bin/blobber.init.setup-mac.sh
./docker.local/bin/blobber.init.setup-mac.sh
- Setup a network called testnet0 for each of these node containers to talk to each other.
docker network create --driver=bridge --subnet=198.18.0.0/15 --gateway=198.18.0.255 testnet0
Note: Run all scripts as sudo
- Set up the block_worker URL
A block worker URL is a field in the blobber/config/0chain_validator.yaml
and blobber/config/0chain_blobber.yaml
configuration files that require the URL of bloockchain network you want to connect to.For testing purposes we will connect to the beta 0chain network and replace the default URL in blobber/config/0chain_validator.yaml and 0chain_blobber.yaml with the below-mentioned URL.
block_worker: http://beta.0chain.net/dns
- Go back to the blobber directory and build blobber containers using the scripts below
./docker.local/bin/build.base.sh
./docker.local/bin/build.blobber.sh
./docker.local/bin/build.validator.sh
Note: Run all scripts as sudo. This would take few minutes.
To link to local gosdk so that the changes are reflected on the blobber build please use the below command(optional)
./docker.local/bin/build.blobber.dev.sh
For Mac with Apple M1 chip use the following guide to build and start blobbers.
Now register a Wallet using zboxcli to perform storage operations on blobbers.Build instructions for zbox are here
- Verify whether Zbox has properly build by running the following command
./zbox
- To register a wallet on Zbox to be used both by the blockchain and blobbers. Use the following Zbox command
./zbox register
Successful Response:
Wallet Registered
- Now navigate to the .zcn folder (this is created during zbox build)
cd $HOME/.zcn/
- Open the wallet.json file. It should be similar to the similar to the output below:
{"client_id":"4af719e1fdb6244159f17922382f162387bae3708250cab6bc1c20cd85fb594c",
"client_key":"da1769bd0203b9c84dc19846ed94155b58d1ffeb3bbe35d38db5bf2fddf5a91c91b22bc7c89dd87e1f1fecbb17ef0db93517dd3886a64274997ea46824d2c119","keys":[{"public_key":"da1769bd0203b9c84dc19846ed94155b58d1ffeb3bbe35d38db5bf2fddf5a91c91b22bc7c89dd87e1f1fecbb17ef0db93517dd3886a64274997ea46824d2c1>
"private_key":"542f6be49108f52203ce75222601397aad32e554451371581ba0eca56b093d19"}],"mnemonics":"butter whisper wheat hope duck mention bird half wedding aim good regret maximum illegal much inch immune unlock resource congress drift>
"version":"1.0","date_created":"2021-09-09T20:22:56+05:30"}
-
Copy the client_id value and paste it into blobbers and validators settings. The files can be found in
blobber/config
directory. -
Open both the
blobber/config/0chain_validator.yaml
andblobber/config/0chain_blobber.yaml
and edit thedelegate_wallet
value with yourclient_id
value.
11 Now run the blobbers by navigating into blobber directories for Blobber1 (git/blobber/docker.local/blobber1) and run the container using
# For locally build images
../bin/blobber.start_bls.sh
# For remote images
../bin/p0blobber.start.sh
Note: Replace the localhost form docker.local/p0docker-compose.yml
to your public IP if you are trying to connect to another network .
- Ensure the port mapping is all correct:
docker ps
This should display the container image blobber_blobber and should have the ports mapped like "0.0.0.0:5050->5050/tcp"
- Now check whether the blobber has registered to the blockchain by running the following zbox command
./zbox ls-blobbers
In the response you should see the local blobbers mentioned with their urls for example http://198.18.0.91:5051 and http://198.18.0.92:5052
Sample Response:
- id: 0bf5ae461d6474ca1bebba028ea57d646043bbfb6a4188348fd649f0deec5df2
url: http://beta.0chain.net:31304
used / total capacity: 14.0 GiB / 100.0 GiB
last_health_check: 1635347306
terms:
read_price: 26.874 mZCN / GB
write_price: 26.874 mZCN / GB / time_unit
min_lock_demand: 0.1
cct: 2m0s
max_offer_duration: 744h0m0s
- id: 7a90e6790bcd3d78422d7a230390edc102870fe58c15472073922024985b1c7d
url: http://198.18.0.92:5052
used / total capacity: 0 B / 1.0 GiB
last_health_check: 1635347427
terms:
read_price: 10.000 mZCN / GB
write_price: 100.000 mZCN / GB / time_unit
min_lock_demand: 0.1
cct: 2m0s
max_offer_duration: 744h0m0s
- id: f65af5d64000c7cd2883f4910eb69086f9d6e6635c744e62afcfab58b938ee25
url: http://198.18.0.91:5051
used / total capacity: 0 B / 1.0 GiB
last_health_check: 1635347950
terms:
read_price: 10.000 mZCN / GB
write_price: 100.000 mZCN / GB / time_unit
min_lock_demand: 0.1
cct: 2m0s
max_offer_duration: 744h0m0s
- id: f8dc4aaf3bb32ae0f4ed575dd6931a42b75e546e07cb37a6e1c6aaf1225891c5
url: http://beta.0chain.net:31305
used / total capacity: 13.3 GiB / 100.0 GiB
last_health_check: 1635347346
terms:
read_price: 26.874 mZCN / GB
write_price: 26.865 mZCN / GB / time_unit
min_lock_demand: 0.1
cct: 2m0s
max_offer_duration: 744h0m0s
Note: When starting multiple blobbers, it could happen that blobbers are not being registered properly (not returned on zbox ls-blobbers
).
Blobber registration takes sometime and adding at least 5 second wait before starting the next blobber usually avoids the issue.
- Now you can create allocations on blobber and store files.
Note: If unable to create new allocations as shown below.
./zbox newallocation --lock 0.5
Error creating allocation: transaction_not_found: Transaction was not found on any of the sharders
To fix this issue you must lock some tokens on the blobber.Get the local blobber id using the ./zbox ls-blobbers
and use the following command
zbox sp-lock --blobber_id f65af5d64000c7cd2883f4910eb69086f9d6e6635c744e62afcfab58b938ee25 --tokens 0.5
- Your network connection depends on the block_worker url you give in the
config/0chain_blobber/validator.yaml
and0chain_blobber.yaml
config file.
block_worker: http://198.18.0.98:9091
This works as a dns service, You need to know the above url for any network you want to connect, Just replace it in the above mentioned file.
For example: If you want to connect to test network
block_worker: https://test.0chain.net/dns
- Get rid of old unused docker resources:
docker system prune
- To get rid of all the docker resources and start afresh:
docker system prune -a
- Stop All Containers
docker stop $(docker ps -a -q)
- Remove All Containers
docker rm $(docker ps -a -q)