Skip to content

Validator

Andrei Montchik edited this page Apr 15, 2026 · 1 revision

Docs

Links

Notes

Components

Operate

Run

  1. cd ~
  2. rm -f logs/validator.log; rm -f nohup.out; nohup ./bin/validator.sh &

Validator Startup Sequence

  1. Download the latest full snapshot.
  2. Download the latest incremental snapshot.
  3. Rebuild the storages from downloaded snapshots.
  4. Rebuild the bank from snapshot storages and generate account indexes.
  5. Clean up accounts cache and verify the bank.
  6. Flush generated indexes to either in-memory or disk location, depending of the configuration.
  7. Start requesting and replaying shreds from other validators until it catches up.
  8. Start replaying the Leader generated blocks realtime.

Metrics

How To

CLI

  • Check the Validator startup replay status: solana catchup -um <IDENTITY_KEY>
  • Monitor Validator: solana-validator --ledger <LEDGER_DIR> monitor
  • Check if the Validator participating in Gossip: solana gossip -um | grep <IDENTITY_KEY>
  • Check if the Validator in the Solana Validators list: solana validators -um | grep <IDENTITY_KEY>
  • Gracefully stop the Validator: solana-validator --ledger <LEDGER_DIR> exit --monitor --skip-new-snapshot-check
  • Review the Validator log:
    • Startup parameters: grep -B1 -A61 "Starting validator with" <VALIDATOR_LOG>
    • Creation of snapshot directory: egrep "Creating bank snapshot for slot | bank serialize took" <VALIDATOR_LOG>
    • Creation of snapshot archive, either full of incremental: egrep "Generating snapshot archive for slot | Successfully created" <VALIDATOR_LOG>
  • RPC CLI
  • The Ledger CLI
  • The Cluster CLI

Clone this wiki locally