KCC Documents
  • Quickstart
  • Overview
    • Introduction
    • Features
    • Our Goal
    • Consensus Engine
    • Marketing Guide
      • Requirements
      • KCC Official Website Resource
      • KCC Social Media Promotion
      • PR & Third-Party Marketing Support
  • Developers
    • Network Endpoints
    • Deploy Smart Contract
      • Using Hardhat
      • Using Remix
    • Verify Smart Contract
      • Using Hardhat
      • Using Foundry
      • Using Remix
    • Issue ERC20 Token
    • Deploy NFTs
      • Create A Foundry Project
      • Create Your ERC721 Contract
      • Add Metadata
    • Run a Node
      • Hardware & System Requirements
      • Install KCC
      • Run A Full Node
      • Run A Validator Node
        • Block Rewards
        • Apply For Running A Validator
        • Manager Account And Validator Account
        • Run A Validator
      • Troubleshooting
    • Explorer
    • Oracles
      • KCC Oracle
    • Bridge
    • Dev Toolkit
    • Data
      • Indexing and Querying
        • The Graph
        • Using KCC's hosted subgraph
    • Gas Revenue Program
      • Rules for Calculation of Gas Revenue
      • How to Join the KCC Gas Revenue Program
  • Individuals
    • Wallet
      • Supported Wallet
      • Tutorial on how to set up wallet
      • Mutisig Wallet
        • Create New Safe
        • Send KCS From Your Safe
        • Use A DApp With Your Safe
    • Network Configuration
      • Configure Value
      • Tutorial on how to config KCC network in Metamask
      • Tutorial on how to config KCC network in Chainlist
    • Bridge Assets
      • Bridge assets from others chains
      • KCC Bridge
      • Bridge assets form Exchange
    • Find a dApp
      • Add Your dAPP
    • KCS Token
      • Get KCS
      • Stake KCS
        • How to participate in KCS Staking
        • How to redeem staked KCS
        • How to check or claim staking rewards
  • FAQs
    • FAQs
      • General FAQs
      • KCS and Staking FAQs
      • Validator FAQs
  • Future Developments
    • Milestone
  • CONTACT US
    • Contact Us
  • Disclosure
    • Disclaimers
    • Risk Statement
    • Media Kit
Powered by GitBook
On this page
  • How do I know whether my node is synchronized?
  • Why is my node stuck after restarting from crash?
  • Why cannot my node connect to any peers?
  1. Developers
  2. Run a Node

Troubleshooting

How do I know whether my node is synchronized?

If your node is not synchronized, you may see logs similar to the following:

INFO [12-07|10:04:51.115] Imported new chain segment       .... age=10d10h

The age=10d10h part shows that this node is still processing a block from 10 days ago.

If your node is well synchronized, you will still see logs starting with "Imported new chain segment", but there will be nothing like age=xxx in those lines.

Why is my node stuck after restarting from crash?

Sometimes, if your node exits unexpectedly, you may see logs like the following:

WARN [12-07|10:04:51.115] Head state missing, repairing  

In most cases, you must wait a little longer for it to recover. If you are not running an archive node, the state in the memory is occasionally flushed to the disk. If the state in the memory is not flushed to the disk yet, an unexpected exit will cause the missing state. Don't worry. The node will try to replay some blocks and recover the state automatically.

Why cannot my node connect to any peers?

If you see logs like the following, your node is not connected to any other nodes (peers):

INFO [12-07|10:04:51.115] Looking for peers                        peercount=0 tried=20 static=0

The peercount=0 signals that your node is not connected to any other nodes. The underlying wire protocol is TCP based. You should check your network and see if it can connect to another network peer that listens on port 30303/TCP.

PreviousRun A ValidatorNextExplorer

Last updated 2 years ago