☁️
Züs
  • About Züs
  • Concepts
    • Architecture
      • Mining on the Züs Blockchain
        • Onboarding a New Miner or Sharder
        • Block Production Protocol
        • Block Finalization
        • Merkle Patricia Trees(MPT) and Recovery
        • View Change and Distributed Key Generation(DKG)
      • Payment
      • Storage
      • Token Bridge Protocol
      • Resources
    • Tokenomics
      • Staking Process
      • Block Rewards
      • Delegation
    • Store
    • Earn
    • Build
    • NFT
  • Resources
    • Whitepapers
      • Tokenomics Paper
      • Architecture Paper
      • Storage Paper
    • Patents
      • NON-FUNGIBLE TOKEN BLOCKCHAIN PROCESSING
      • FREE STORAGE PROTOCOL FOR BLOCKCHAIN PLATFORM
      • TRANSFERRING CONTENT VIA PROXY RE-ENCRYPTION
      • STREAMING CONTENT VIA BLOCKCHAIN TECHNOLOGY
      • SPLIT-KEY WALLET ACCESS BETWEEN BLOCKCHAINS
      • ENFORCING SECURITY PARAMETERS SPECIFIED BY AN OWNER ON A BLOCKCHAIN PLATFORM
      • CLIENT AUTHENTICATION USING SPLIT KEY SIGNING ON A BLOCKCHAIN PLATFORM
      • BLOCKCHAIN CONTENT PURCHASING PROTOCOL
      • BLOCKCHAIN BASED PRIVACY COMPLIANCE PLATFORM
      • SYSTEMS AND METHODS OF SELF-ADMINISTERED PROTOCOLS ON A BLOCKCHAIN PLATFORM
      • SYSTEMS AND METHODS OF AGGREGATE SIGNING OF DIGITAL SIGNATURES ON MULTIPLE MESSAGES SIMULTANEOUSLY U
      • SYSTEMS AND METHODS OF BLOCKCHAIN PLATFORM FOR AUTOMATED ASSET BASED PROVISIONING OF RESOURCES
      • SYSTEMS AND METHODS OF SELF-FORKING BLOCKCHAIN PROTOCOL
      • SYSTEMS AND METHODS OF SUSTAINABILITY PROTOCOL USING DISTRIBUTED BLOCKCHAIN APPLICATION WITH IoT SEN
      • SYSTEMS AND METHODS OF BLOCKCHAIN PLATFORM FOR DISTRIBUTED APPLICATIONS
  • API Reference
    • Endpoints
      • Block
      • Client
      • Connection
      • DNS
      • File
      • Smart Contracts
      • Blobber Stats
      • Transactions
      • Miners and Sharders
        • Stats
        • State
        • Diagnostics
        • Configuration
        • Smart Contract State
        • Smart Contract Stats
        • Chain Stats
  • Hackathon
    • Register to Hackathon
      • How to Add Members to Hackathon Team
    • Repos
    • Documentation
  • Products
    • Bolt
      • Get Started
      • Stake
      • Activity
      • Buy ZCN
      • Sell ZCN
      • Send Tokens
      • Receive Tokens
      • Settings
        • Manage Profile
        • Wallet
        • Read Pool
      • Troubleshooting
    • Vult
      • Sign Up
      • Upload File
      • Upload an Encrypted File
      • Upload a File to a Folder
      • Share a Uploaded File
      • Move a Uploaded File
      • Delete a File
      • Make File Available Offline
      • Troubleshooting
    • Atlus
      • Dashboard Overview
      • Service Providers
      • Charts
        • Market Charts
        • Network Charts
        • Storage Charts
        • Züs Explainer
      • Blockchain
      • Server Map
    • Blimp
      • Sign Up
        • Buy ZCN for Storage
      • Use Blimp as Direct Storage
      • Use Blimp as S3 Server
        • S3 Operations
      • Use Blimp for Cloud Migration
      • Manage Allocations
        • Extend Size
        • Extend Duration
        • Add Blobber
        • Replace Blobber
        • Make allocation Immutable
        • Freeze Allocation
        • Cancel Allocation
    • Chimney
      • Get Started
      • Deploy Blobber on Own Server
      • Deploy Blobber on Rented Server
      • Stake Blobber
      • Add Blobber
      • Monitor Blobbers
      • Visualize Blobber Logs
      • View Blobber Rank
    • Chalk
      • Sign Up
      • Create NFT Collection
        • Buy ZCN for NFT via ERC token
        • Buy ZCN for NFT via Credit card
      • Explore NFT Collections
      • My NFTs
      • Profile
        • Withdraw Earnings
        • Manage Collections
  • Guides
    • Zus GO SDK
    • Zus JS SDK
    • Zbox CLI
      • Repo
      • Get Started
      • Creating and Managing Allocations
      • Uploading and Managing Files
      • Lock and Unlock Tokens
      • Tips and Troubleshooting
    • Zwallet CLI
      • Repo
      • Get Started
      • Zwallet Operations
      • Staking on miners and sharders
      • Burn and Mint Tokens using Zwallet
      • Troubleshooting
    • Add a Blobber
      • Repo
      • Getting Started
    • Add a Miner/Sharder
      • Repo
      • Getting Started
    • Setup a Blockchain
      • Repo
      • Quickstart
        • Understand the Script
      • Step 1: Set up the project
      • Step 2: Setup the network for Züs components
      • Step 3: Initialize and Build the Züs components
      • Step 4: Start Sharder and Miner Containers
      • Step 5 : Create a wallet using zwalletcli
      • Step 6: Starting the blobber containers
      • Step 7: Validate Züs deployment
      • Step 8: Creating an Allocation on Blobber
      • Restarting Sharder and Miner Containers with CleanDB.
      • Additional Tips and Troubleshooting
    • Glossary
  • Support
    • Help Center
      • Community
      • Issues on Github
      • Contact Us
Powered by GitBook
On this page
  • Install WSL on Windows
  • Install Homebrew and mockery on Mac and Linux
  • Windows Dependencies for Zbox and ZwalletCLI
  • Additional Mac Troubleshooting
  • Troubleshooting Guide for Blobbers Setup (Mac M1 or M2)
  1. Guides
  2. Setup a Blockchain

Additional Tips and Troubleshooting

PreviousRestarting Sharder and Miner Containers with CleanDB.NextGlossary

Last updated 1 year ago

Install WSL on Windows

To install WSL (Windows Subsystem for Linux) from Command Prompt, use these steps:

  1. Open Start on Windows

  2. Search for Command Prompt, right-click the top result, and select the Run as administrator option.

  3. Type the following command to install the WSL on Windows and press Enter:

    wsl --install

4. Restart your computer to finish the WSL installation on Windows.

5. Once you complete the steps, the latest version of the Ubuntu Linux distribution will be installed. 6. Now to start the Linux at any time on windows open the command prompt again and type:

wsl

Install Homebrew and mockery on Mac and Linux

1. Run Homebrew installation script

Here is the command, just run it-

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2. Add Homebrew to your PATH

To run the brew command after installation, we need to add it to our system path…

eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"

Note: This step is not required for mac.

3. Check Brew is working fine

To ensure everything is working correctly to use brew, we can run its command-

brew doctor

Sample Response:

Your system is ready to brew.

4. Now install mockery

brew install mockery

or for Apple Silicon

arch -arm64 brew install mockery

Sample Response when retrieving mockery version should be similar to this:

mockery --version
24 Nov 22 03:53 IST INF Starting mockery dry-run=false version=v2.15.0
v2.15.0

Note: At the time of installation the latest mockery version is 2.15.0.

Windows Dependencies for Zbox and ZwalletCLI

Additional Mac Troubleshooting

These are additional tips for Mac in case you cannot get the setup running.

  • Provide at least 5GB or more RAM to Docker.

  • Increase Docker Swap to 3GB or more.

  • Update Docker to the latest version.

Troubleshooting Guide for Blobbers Setup (Mac M1 or M2)

If blobbers and validators containers are not coming up while doing local setup, then you can try these steps:

  • You can try removing wallet.json file from ~/.zcn directory and recreate a wallet by using ./zwallet create-wallet command. Copy the client_id generated from here and paste in delegate_wallet: <your_new_client_id> in 0chain_blobber.yaml and 0chain_validatory.yaml files present at blobber/config directory.

  • Also, check if block_worker is set to http://198.18.0.98:9091/ in both of the above files.

  • Stop the sharders and miners containers and restart them. First start the sharder and when it is ready (try hitting the localhost:7171 to test) then start the miner.

  • Now start the blobbers and validators.

    1. Create a postgres db by pressing 1 and then again 1.

    2. Create a blobber by running the script again and press 1 and then 2.

    3. If the step2 works, start a new terminal window and run the script again, and press 1 and then 3 to start the validator.

    4. Repeat steps 2 and 3 to start multiple blobbers and validators by following the interactive cmd line.

Install git bash for windows. Instructions can be found .

Install TDM-GCC for Windows from .

Open git bashand follow steps from or .

Download the appropriate go binary from (arm or intel) for .

Run the script below as sudo to overcome the mac docker network issue before.

If you are on Mac M1. You need to start blobbers and validators by running the cli.sh script from . This is an interactive script. When you run it, you need to provide input for what you need to do. Follow these:

here
here
this folder
here
building zbox
registering a wallet
1KB
setup.0chain.ips.sh
WSL Install on Ubuntu
WSL Run
zwallet
building zbox